ai-sub-translator 1.0.2 → 1.1.0

package/dist/ffmpeg.d.ts

@@ -0,0 +1,13 @@
+import { FFmpegDownloadOptions, VideoInfo } from './types.js';
+export declare const initializeFFmpeg: (options: FFmpegDownloadOptions) => Promise<string>;
+export declare const getFfmpegExecPath: (outputDir: string) => string;
+export declare function downloadFFmpeg(options: FFmpegDownloadOptions): Promise<string>;
+/**
+ * Default ffmpeg directory in user's cache
+ */
+export declare const getUserDataDir: () => string;
+/**
+ * Gets information about a video file, including available subtitle tracks
+ */
+export declare function getVideoInfo(videoPath: string): Promise<VideoInfo>;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/dist/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../src/ffmpeg.ts"],"names":[],"mappings":"AASA,OAAO,EACH,qBAAqB,EACrB,SAAS,EACZ,MAAM,YAAY,CAAC;AAapB,eAAO,MAAM,gBAAgB,GAAU,SAAS,qBAAqB,KAAG,OAAO,CAAC,MAAM,CAYrF,CAAA;AAQD,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,WAElD,CAAA;AAyBD,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiJpF;AAsBD;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,MAGjC,CAAC;AAEF;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAIxE"}

package/dist/ffmpeg.js

@@ -0,0 +1,222 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import unzipper from 'unzipper';
+import { XzReadableStream } from 'xz-decompress';
+import { extract as tarExtract } from 'tar';
+import { detectSubtitles, } from './subtitle-extractor.js';
+import { Readable } from 'stream';
+import { promises as fsPromises } from 'fs';
+const { rename: moveFile, rm: removeDir, chmod: chmodFile, unlink: removeFile, stat: statFile, mkdir: makeDir } = fsPromises;
+const URL_MAC_X64 = 'https://evermeet.cx/pub/ffmpeg/ffmpeg-7.1.1.zip';
+const URL_MAC_ARM64 = 'https://www.osxexperts.net/ffmpeg711arm.zip';
+const URL_LINUX_X64 = 'https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz';
+const URL_LINUX_ARM64 = 'https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-arm64-static.tar.xz';
+const URL_WIN_X64 = 'https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-essentials.zip';
+export const initializeFFmpeg = async (options) => {
+    const downloadPath = getUserDataDir();
+    const execPath = getFfmpegExecPath(downloadPath);
+    if (execPath && fs.existsSync(execPath)) {
+        console.log(`Using existing ffmpeg at ${execPath}`);
+        return execPath;
+    }
+    else {
+        options.outputDir = downloadPath;
+    }
+    return downloadFFmpeg(options);
+};
+const getExecName = () => {
+    const platform = os.platform();
+    const extension = platform === 'win32' ? '.exe' : '';
+    return `ffmpeg${extension}`;
+};
+export const getFfmpegExecPath = (outputDir) => {
+    return path.join(outputDir, getExecName());
+};
+const findExecutable = async (dir, execName) => {
+    const files = fs.readdirSync(dir);
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        let stat;
+        try {
+            stat = await statFile(filePath);
+        }
+        catch (error) {
+            console.error(`Error getting stats for file ${filePath}:`, error);
+            continue;
+        }
+        if (stat.isFile() && execName === file) {
+            return filePath;
+        }
+        else if (stat.isDirectory()) {
+            const result = await findExecutable(filePath, execName);
+            if (result) {
+                return result;
+            }
+        }
+    }
+    return null;
+};
+export async function downloadFFmpeg(options) {
+    const platform = options.platform || os.platform();
+    const arch = os.arch();
+    const url = getFFmpegDownloadUrl(platform, arch);
+    let extension = url.split('.').pop();
+    if (extension === 'xz') {
+        extension = 'tar.xz';
+    }
+    // Create directory if it doesn't exist
+    if (!fs.existsSync(options.outputDir)) {
+        fs.mkdirSync(options.outputDir, { recursive: true });
+    }
+    const filename = `ffmpeg.${extension}`;
+    const outputPath = path.join(options.outputDir, filename);
+    try {
+        console.log(`Downloading ffmpeg from ${url}...`);
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to download ffmpeg: ${response.statusText}`);
+        }
+        const totalSize = parseInt(response.headers.get('content-length') || '0', 10);
+        const reader = response.body?.getReader();
+        if (!reader) {
+            throw new Error('Unable to read response body');
+        }
+        const writer = fs.createWriteStream(outputPath);
+        let receivedBytes = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            writer.write(Buffer.from(value));
+            receivedBytes += value.length;
+            if (options.onProgress && totalSize > 0) {
+                const progress = receivedBytes / totalSize;
+                options.onProgress(progress);
+            }
+        }
+        writer.end();
+        console.log(`FFmpeg downloaded successfully to ${outputPath}`);
+    }
+    catch (error) {
+        console.error('Error downloading ffmpeg:', error);
+        throw error;
+    }
+    // Extract the file
+    const extractDir = path.join(options.outputDir, 'extracted');
+    if (extension === 'zip') {
+        const zip = fs.createReadStream(outputPath);
+        const extract = unzipper.Extract({ path: extractDir });
+        zip.pipe(extract);
+        try {
+            await new Promise((resolve, reject) => {
+                zip.on('end', () => resolve());
+                zip.on('error', reject);
+            });
+        }
+        catch (error) {
+            console.error('Error unzipping ffmpeg:', error);
+            throw error;
+        }
+    }
+    else if (extension === 'tar.xz') {
+        try {
+            const decompressedFilePath = path.join(getUserDataDir(), 'ffmpeg.tar');
+            const decompressedFile = fs.createWriteStream(decompressedFilePath);
+            const compressedFile = fs.createReadStream(outputPath);
+            const webStream = Readable.toWeb(compressedFile);
+            const decompressor = new XzReadableStream(webStream);
+            const xzReader = decompressor.getReader();
+            while (true) {
+                const { done, value } = await xzReader.read();
+                if (done)
+                    break;
+                decompressedFile.write(Buffer.from(value));
+            }
+            decompressedFile.end();
+            await new Promise((resolve, reject) => {
+                decompressedFile.on('finish', resolve);
+                decompressedFile.on('error', reject);
+            });
+            await makeDir(extractDir, { recursive: true });
+            await tarExtract({
+                file: decompressedFilePath,
+                cwd: extractDir,
+            });
+            await removeFile(decompressedFilePath);
+        }
+        catch (error) {
+            console.error('Error decompressing ffmpeg:', error);
+            throw error;
+        }
+    }
+    else {
+        console.log(`Archive format not supported: ${extension}`);
+    }
+    const execName = getExecName();
+    const execOutputPath = getFfmpegExecPath(getUserDataDir());
+    const execExtractedOutputPath = await findExecutable(extractDir, execName);
+    try {
+        await moveFile(execExtractedOutputPath, execOutputPath);
+    }
+    catch (error) {
+        console.error('Error moving ffmpeg:', error);
+        throw error;
+    }
+    try {
+        await removeDir(extractDir, { recursive: true });
+    }
+    catch (error) {
+        console.error('Error removing extracted directory:', error);
+    }
+    try {
+        await removeFile(outputPath);
+    }
+    catch (error) {
+        console.error('Error removing extracted file:', error);
+    }
+    if (platform !== 'win32') {
+        try {
+            await chmodFile(execOutputPath, 0o755);
+        }
+        catch (error) {
+            console.error('Error chmodding ffmpeg:', error);
+            throw error;
+        }
+    }
+    return execOutputPath;
+}
+/**
+ * Gets the appropriate ffmpeg download URL based on the platform
+ */
+function getFFmpegDownloadUrl(platform, arch) {
+    switch (platform) {
+        case 'win32':
+            return URL_WIN_X64;
+        case 'darwin':
+            return arch === 'arm64'
+                ? URL_MAC_ARM64
+                : URL_MAC_X64;
+        case 'linux':
+            return arch === 'arm64'
+                ? URL_LINUX_ARM64
+                : URL_LINUX_X64;
+        default:
+            throw new Error(`Unsupported platform: ${platform}`);
+    }
+}
+/**
+ * Default ffmpeg directory in user's cache
+ */
+export const getUserDataDir = () => {
+    const home = os.homedir();
+    return path.join(home, '.cache', 'ai-sub-translator');
+};
+/**
+ * Gets information about a video file, including available subtitle tracks
+ */
+export async function getVideoInfo(videoPath) {
+    const ffmpegPath = await initializeFFmpeg({});
+    return detectSubtitles(videoPath, ffmpegPath);
+}
+//# sourceMappingURL=ffmpeg.js.map

package/dist/ffmpeg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../src/ffmpeg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EACH,eAAe,GAClB,MAAM,yBAAyB,CAAC;AAMjC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,IAAI,CAAC;AAE5C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC;AAE7H,MAAM,WAAW,GAAG,iDAAiD,CAAC;AACtE,MAAM,aAAa,GAAG,6CAA6C,CAAC;AACpE,MAAM,aAAa,GAAG,8EAA8E,CAAC;AACrG,MAAM,eAAe,GAAG,8EAA8E,CAAC;AACvG,MAAM,WAAW,GAAG,kEAAkE,CAAC;AAEvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAA8B,EAAmB,EAAE;IACtF,MAAM,YAAY,GAAG,cAAc,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAEjD,IAAI,QAAQ,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC;IACpB,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,SAAS,GAAG,YAAY,CAAC;IACrC,CAAC;IAED,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,GAAG,EAAE;IACrB,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,OAAO,SAAS,SAAS,EAAE,CAAC;AAChC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAE,EAAE;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,KAAK,EAAE,GAAW,EAAE,QAAgB,EAA0B,EAAE;IACnF,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,IAAc,CAAC;QACnB,IAAI,CAAC;YACD,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,gCAAgC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YAClE,SAAS;QACb,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACrC,OAAO,QAAQ,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACxD,IAAI,MAAM,EAAE,CAAC;gBACT,OAAO,MAAM,CAAC;YAClB,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAEvB,MAAM,GAAG,GAAG,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACrC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,SAAS,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,SAAU,CAAC,EAAE,CAAC;QACrC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,SAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,SAAS,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAU,EAAE,QAAQ,CAAC,CAAC;IAE3D,IAAI,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,2BAA2B,GAAG,KAAK,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QAE9E,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,MAAM,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAEhD,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAE5C,IAAI,IAAI;gBAAE,MAAM;YAEhB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAEjC,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC;YAE9B,IAAI,OAAO,CAAC,UAAU,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,QAAQ,GAAG,aAAa,GAAG,SAAS,CAAC;gBAC3C,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,GAAG,EAAE,CAAC;QAEb,OAAO,CAAC,GAAG,CAAC,qCAAqC,UAAU,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC;IAChB,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAU,EAAE,WAAW,CAAC,CAAC;IAC9D,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAElB,IAAI,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACxC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAChD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;SAAM,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC;YACD,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,YAAY,CAAC,CAAC;YACvE,MAAM,gBAAgB,GAAG,EAAE,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;YAEpE,MAAM,cAAc,GAAG,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACjD,MAAM,YAAY,GAAG,IAAI,gBAAgB,CAAC,SAAuC,CAAC,CAAC;YACnF,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC;YAC1C,OAAO,IAAI,EAAE,CAAC;gBACV,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC9C,IAAI,IAAI;oBAAE,MAAM;gBAChB,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/C,CAAC;YAED,gBAAgB,CAAC,GAAG,EAAE,CAAC;YAEvB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACxC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACvC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/C,MAAM,UAAU,CAAC;gBACb,IAAI,EAAE,oBAAoB;gBAC1B,GAAG,EAAE,UAAU;aAClB,CAAC,CAAC;YAEH,MAAM,UAAU,CAAC,oBAAoB,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YACpD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,cAAc,GAAG,iBAAiB,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3D,MAAM,uBAAuB,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE3E,IAAI,CAAC;QACD,MAAM,QAAQ,CAAC,uBAAwB,EAAE,cAAc,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC;IAChB,CAAC;IACD,IAAI,CAAC;QACD,MAAM,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,CAAC;QACD,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACD,MAAM,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAChD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IACD,OAAO,cAAc,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,QAAgB,EAAE,IAAY;IACxD,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,OAAO;YACR,OAAO,WAAW,CAAA;QACtB,KAAK,QAAQ;YACT,OAAO,IAAI,KAAK,OAAO;gBACnB,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,WAAW,CAAA;QACrB,KAAK,OAAO;YACR,OAAO,IAAI,KAAK,OAAO;gBACnB,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,aAAa,CAAA;QACvB;YACI,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE;IACvC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAChD,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAE9C,OAAO,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { translate } from './translator.js';
 export { parseSrt, formatSrt } from './srt-parser.js';
-export type { TranslateOptions, TranslateResult, SrtEntry } from './types.js';
+export { initializeFFmpeg, getFfmpegExecPath, getVideoInfo, getUserDataDir } from './ffmpeg.js';
+export { detectSubtitles, extractSubtitle, parseFfmpegSubtitleStreams } from './subtitle-extractor.js';
+export type { TranslateOptions, TranslateResult, SrtEntry, FFmpegDownloadOptions, SubtitleTrack, VideoInfo, ExtractSubtitleOptions } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACvG,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,QAAQ,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
 export { translate } from './translator.js';
 export { parseSrt, formatSrt } from './srt-parser.js';
+export { initializeFFmpeg, getFfmpegExecPath, getVideoInfo, getUserDataDir } from './ffmpeg.js';
+export { detectSubtitles, extractSubtitle, parseFfmpegSubtitleStreams } from './subtitle-extractor.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/subtitle-extractor.d.ts

@@ -0,0 +1,5 @@
+import { SubtitleTrack, VideoInfo } from './types.js';
+export declare function parseFfmpegSubtitleStreams(output: string): SubtitleTrack[];
+export declare function detectSubtitles(videoPath: string, ffmpegPath: string): Promise<VideoInfo>;
+export declare function extractSubtitle(videoPath: string, subtitleIndex: number): Promise<string>;
+//# sourceMappingURL=subtitle-extractor.d.ts.map

package/dist/subtitle-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitle-extractor.d.ts","sourceRoot":"","sources":["../src/subtitle-extractor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOtD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAgC1E;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmB/F;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B/F"}

package/dist/subtitle-extractor.js

@@ -0,0 +1,83 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as childProcess from 'child_process';
+import { promisify } from 'util';
+import { getFfmpegExecPath, getUserDataDir } from './ffmpeg.js';
+import { promises as fsPromises } from 'fs';
+const exec = promisify(childProcess.exec);
+const { readFile, unlink: rmFile } = fsPromises;
+export function parseFfmpegSubtitleStreams(output) {
+    const lines = output.split('\n');
+    const subtitles = [];
+    const streamRegex = /Stream #0:(\d+)(?:\((\w+)\))?: Subtitle: [^\s]+(?: \(([^\)]+)\))?(?: \(([^\)]+)\))?/i;
+    const titleRegex = /title\s+:\s+(.+)/i;
+    let currentStream = null;
+    for (const line of lines) {
+        const streamMatch = line.match(streamRegex);
+        if (streamMatch) {
+            const [, index, lang, flag1] = streamMatch;
+            currentStream = {
+                index: parseInt(index),
+                language: lang,
+                format: flag1,
+            };
+            subtitles.push(currentStream);
+            continue;
+        }
+        if (currentStream && line.includes('Metadata'))
+            continue;
+        const titleMatch = line.match(titleRegex);
+        if (titleMatch && currentStream) {
+            currentStream.title = titleMatch[1].trim();
+        }
+    }
+    return subtitles;
+}
+export async function detectSubtitles(videoPath, ffmpegPath) {
+    if (!fs.existsSync(videoPath)) {
+        throw new Error(`Video file does not exist: ${videoPath}`);
+    }
+    let commandOutput = '';
+    try {
+        await exec(`"${ffmpegPath}" -i "${videoPath}"`);
+    }
+    catch (error) {
+        commandOutput = error.message;
+    }
+    const subtitleTracks = parseFfmpegSubtitleStreams(commandOutput).filter((track) => track.format.includes('srt'));
+    return {
+        path: videoPath,
+        subtitleTracks
+    };
+}
+export async function extractSubtitle(videoPath, subtitleIndex) {
+    const outputPath = path.join(getUserDataDir(), `subtitle-${Date.now()}.srt`);
+    const ffmpegPath = getFfmpegExecPath(getUserDataDir());
+    if (!fs.existsSync(videoPath)) {
+        throw new Error(`Video file does not exist: ${videoPath}`);
+    }
+    // Ensure cache directory exists
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    try {
+        await exec(`"${ffmpegPath}" -i "${videoPath}" -map 0:${subtitleIndex} -y "${outputPath}"`);
+        if (!fs.existsSync(outputPath)) {
+            throw new Error('Subtitle extraction failed: Output file not created');
+        }
+        try {
+            const text = await readFile(outputPath, 'utf8');
+            return text;
+        }
+        catch (error) {
+            console.error('Error reading subtitle file:', error);
+            throw new Error(`Failed to read subtitle file: ${error.message || error}`);
+        }
+        finally {
+            await rmFile(outputPath);
+        }
+    }
+    catch (error) {
+        console.error('Error extracting subtitle:', error);
+        throw new Error(`Failed to extract subtitle: ${error.message || error}`);
+    }
+}
+//# sourceMappingURL=subtitle-extractor.js.map

package/dist/subtitle-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitle-extractor.js","sourceRoot":"","sources":["../src/subtitle-extractor.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -18,4 +18,64 @@ export interface TranslateResult {
     totalBatches: number;
     completedBatches: number;
 }
+export interface FFmpegDownloadOptions {
+    /**
+     * Directory where the ffmpeg executable will be saved
+     */
+    outputDir?: string;
+    /**
+     * Platform to download ffmpeg for: 'darwin' (macOS), 'win32' (Windows), or 'linux'
+     */
+    platform?: string;
+    /**
+     * Progress callback function that receives download progress percentage
+     */
+    onProgress?: (progress: number) => void;
+}
+export interface SubtitleTrack {
+    /**
+     * Subtitle track index in the video file
+     */
+    index: number;
+    /**
+     * Language of the subtitle track (if available)
+     */
+    language: string;
+    /**
+     * Title of the subtitle track (if available)
+     */
+    title?: string;
+    /**
+     * Format of the subtitle track (srt, ass, etc.)
+     */
+    format: string;
+}
+export interface VideoInfo {
+    /**
+     * Full path to the video file
+     */
+    path: string;
+    /**
+     * List of subtitle tracks found in the video
+     */
+    subtitleTracks: SubtitleTrack[];
+}
+export interface ExtractSubtitleOptions {
+    /**
+     * Path to the video file
+     */
+    videoPath: string;
+    /**
+     * Index of the subtitle track to extract
+     */
+    subtitleIndex: number;
+    /**
+     * Output path where the subtitle file will be saved
+     */
+    outputPath: string;
+    /**
+     * Path to the ffmpeg executable
+     */
+    ffmpegPath: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sub-translator",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "AI-powered subtitle translator using Google Gemini. Translates SRT subtitles to any language.",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,9 +34,13 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@google/genai": "^0.8.0"
+    "@google/genai": "^0.8.0",
+    "tar": "^7.4.3",
+    "unzipper": "^0.12.3",
+    "xz-decompress": "^0.2.2"
   },
   "devDependencies": {
+    "@types/unzipper": "^0.10.11",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   }