feat: add audio hooks/music timeline support and sync with upstream timeline updates

electron-builder.json5

@@ -24,6 +24,10 @@
     {
       "from": "public/wallpapers",
       "to": "assets/wallpapers"
+    },
+    {
+      "from": "public/audio",
+      "to": "assets/audio"
     }
   ],
 

electron/electron-env.d.ts

@@ -77,6 +77,13 @@ interface Window {
 			fileName: string,
 		) => Promise<{ success: boolean; path?: string; message?: string; canceled?: boolean }>;
 		openVideoFilePicker: () => Promise<{ success: boolean; path?: string; canceled?: boolean }>;
+		openAudioFilePicker: () => Promise<{
+			success: boolean;
+			path?: string;
+			message?: string;
+			error?: string;
+			canceled?: boolean;
+		}>;
 		setCurrentVideoPath: (path: string) => Promise<{ success: boolean }>;
 		setCurrentRecordingSession: (
 			session: import("../src/lib/recordingSession").RecordingSession | null,

electron/ipc/handlers.ts

@@ -25,6 +25,15 @@ const PROJECT_FILE_EXTENSION = "openscreen";
 const SHORTCUTS_FILE = path.join(app.getPath("userData"), "shortcuts.json");
 const RECORDING_SESSION_SUFFIX = ".session.json";
 const ALLOWED_IMPORT_VIDEO_EXTENSIONS = new Set([".webm", ".mp4", ".mov", ".avi", ".mkv"]);
+const ALLOWED_IMPORT_AUDIO_EXTENSIONS = new Set([
+	".mp3",
+	".wav",
+	".m4a",
+	".aac",
+	".ogg",
+	".flac",
+	".webm",
+]);
 
 /**
  * Paths explicitly approved by the user via file picker dialogs or project loads.
@@ -56,6 +65,10 @@ function hasAllowedImportVideoExtension(filePath: string): boolean {
 	return ALLOWED_IMPORT_VIDEO_EXTENSIONS.has(path.extname(filePath).toLowerCase());
 }
 
+function hasAllowedImportAudioExtension(filePath: string): boolean {
+	return ALLOWED_IMPORT_AUDIO_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
+
 async function approveReadableVideoPath(
 	filePath?: string | null,
 	trustedDirs?: string[],
@@ -97,6 +110,33 @@ async function approveReadableVideoPath(
 	return normalizedPath;
 }
 
+async function approveReadableAudioPath(filePath?: string | null): Promise<string | null> {
+	const normalizedPath = normalizeVideoSourcePath(filePath);
+	if (!normalizedPath) {
+		return null;
+	}
+
+	if (isPathAllowed(normalizedPath)) {
+		return normalizedPath;
+	}
+
+	if (!hasAllowedImportAudioExtension(normalizedPath)) {
+		return null;
+	}
+
+	try {
+		const stats = await fs.stat(normalizedPath);
+		if (!stats.isFile()) {
+			return null;
+		}
+	} catch {
+		return null;
+	}
+
+	approveFilePath(normalizedPath);
+	return normalizedPath;
+}
+
 function resolveRecordingOutputPath(fileName: string): string {
 	const trimmed = fileName.trim();
 	if (!trimmed) {
@@ -724,6 +764,47 @@ export function registerIpcHandlers(
 		}
 	});
 
+	ipcMain.handle("open-audio-file-picker", async () => {
+		try {
+			const result = await dialog.showOpenDialog({
+				title: "Select audio",
+				defaultPath: app.getPath("music"),
+				filters: [
+					{
+						name: "Audio Files",
+						extensions: ["mp3", "wav", "m4a", "aac", "ogg", "flac", "webm"],
+					},
+					{ name: "All Files", extensions: ["*"] },
+				],
+				properties: ["openFile"],
+			});
+
+			if (result.canceled || result.filePaths.length === 0) {
+				return { success: false, canceled: true };
+			}
+
+			const approvedPath = await approveReadableAudioPath(result.filePaths[0]);
+			if (!approvedPath) {
+				return {
+					success: false,
+					message: "Selected file is not a supported audio file",
+				};
+			}
+
+			return {
+				success: true,
+				path: approvedPath,
+			};
+		} catch (error) {
+			console.error("Failed to open audio file picker:", error);
+			return {
+				success: false,
+				message: "Failed to open audio file picker",
+				error: String(error),
+			};
+		}
+	});
+
 	ipcMain.handle("reveal-in-folder", async (_, filePath: string) => {
 		try {
 			// shell.showItemInFolder doesn't return a value, it throws on error

electron/preload.ts

@@ -67,6 +67,9 @@ contextBridge.exposeInMainWorld("electronAPI", {
 	openVideoFilePicker: () => {
 		return ipcRenderer.invoke("open-video-file-picker");
 	},
+	openAudioFilePicker: () => {
+		return ipcRenderer.invoke("open-audio-file-picker");
+	},
 	setCurrentVideoPath: (path: string) => {
 		return ipcRenderer.invoke("set-current-video-path", path);
 	},

package.json

@@ -54,6 +54,7 @@
 		"dnd-timeline": "^2.2.0",
 		"emoji-picker-react": "^4.16.1",
 		"fix-webm-duration": "^1.0.6",
+		"fuse.js": "^7.3.0",
 		"gif.js": "^0.2.0",
 		"gsap": "^3.13.0",
 		"lucide-react": "^0.545.0",

scripts/i18n-check.mjs

@@ -11,7 +11,6 @@ import path from "node:path";
 
 const LOCALES_DIR = path.resolve("src/i18n/locales");
 const BASE_LOCALE = "en";
-const COMPARE_LOCALES = ["zh-CN", "zh-TW", "es", "tr", "ko-KR"];
 
 function getKeys(obj, prefix = "") {
 	const keys = [];