Modify timeblocks exported calendar title

Author: Lorite

docs/releases/unreleased.md

@@ -34,4 +34,5 @@ When a change has user-facing documentation, include a canonical tasknotes.dev l
 
 ## Added
 
+- Added a dedicated "Timeblock Event Title Template" setting so synced timeblock event names can differ from task event names
 - Added a dedicated Google Calendar integration setting to enable or disable timeblock synchronization independently from task synchronization

src/services/TimeblockCalendarSyncService.ts

@@ -96,6 +96,30 @@ export class TimeblockCalendarSyncService {
 		return lines.length > 0 ? lines.join("\n") : undefined;
 	}
 
+	/**
+	 * Apply the shared Google Calendar event title template to a timeblock.
+	 * Supports task placeholders for compatibility and adds timeblock-specific fields.
+	 */
+	private applyTitleTemplate(timeblock: TimeBlock, date: string): string {
+		const settings = this.plugin.settings.googleCalendarExport;
+		const template =
+			settings.timeblockEventTitleTemplate || settings.eventTitleTemplate || "{{title}}";
+		const fallbackTitle = timeblock.title || "Timeblock";
+
+		const rendered = template
+			.replace(/\{\{title\}\}/g, fallbackTitle)
+			.replace(/\{\{status\}\}/g, "")
+			.replace(/\{\{priority\}\}/g, "")
+			.replace(/\{\{due\}\}/g, "")
+			.replace(/\{\{scheduled\}\}/g, "")
+			.replace(/\{\{date\}\}/g, date)
+			.replace(/\{\{startTime\}\}/g, timeblock.startTime || "")
+			.replace(/\{\{endTime\}\}/g, timeblock.endTime || "")
+			.trim();
+
+		return rendered || fallbackTitle;
+	}
+
 	private toCalendarEvent(timeblock: TimeBlock, date: string): {
 		summary: string;
 		description?: string;
@@ -114,7 +138,7 @@ export class TimeblockCalendarSyncService {
 			end: { dateTime: string; timeZone: string };
 			colorId?: string;
 		} = {
-			summary: timeblock.title || "Timeblock",
+			summary: this.applyTitleTemplate(timeblock, date),
 			start: { dateTime: startDateTime, timeZone: timezone },
 			end: { dateTime: endDateTime, timeZone: timezone },
 		};

src/settings/defaults.ts

@@ -198,6 +198,7 @@ export const DEFAULT_GOOGLE_CALENDAR_EXPORT: GoogleCalendarExportSettings = {
 	syncOnTaskComplete: true,
 	syncOnTaskDelete: true,
 	eventTitleTemplate: "{{title}}", // Simple title by default
+	timeblockEventTitleTemplate: "{{title}}", // Timeblock title by default
 	includeDescription: true,
 	eventColorId: null, // Use calendar default color
 	syncTrigger: "scheduled", // Default to scheduled date

src/settings/tabs/integrationsTab.ts

@@ -974,6 +974,20 @@ export function renderIntegrationsTab(
 					})
 			);
 
+			// Timeblock event title template
+			group.addSetting((setting) =>
+				configureTextSetting(setting, {
+					name: "Timeblock Event Title Template",
+					desc: "Template for synced timeblock event titles (used when Sync timeblocks is enabled). Supports {{title}}, {{date}}, {{startTime}}, {{endTime}}.",
+					placeholder: "{{title}}",
+					getValue: () => plugin.settings.googleCalendarExport.timeblockEventTitleTemplate,
+					setValue: async (value: string) => {
+						plugin.settings.googleCalendarExport.timeblockEventTitleTemplate = value || "{{title}}";
+						save();
+					},
+				})
+			);
+
 			// Include description
 			group.addSetting(
 				(setting) =>

src/types/settings.ts

@@ -335,6 +335,7 @@ export interface GoogleCalendarExportSettings {
 	syncOnTaskComplete: boolean; // Update event when task is completed
 	syncOnTaskDelete: boolean; // Delete event when task is deleted
 	eventTitleTemplate: string; // Template for event title (e.g., "{{title}}" or "[TaskNotes] {{title}}")
+	timeblockEventTitleTemplate: string; // Template for timeblock event title
 	includeDescription: boolean; // Include task details in event description
 	eventColorId: string | null; // Optional: Google Calendar color ID for TaskNotes events (null = calendar default)
 	syncTrigger: "scheduled" | "due" | "both"; // Which date triggers event creation