tphim 2.1.0 → 2.2.2

package/README.md

@@ -1,15 +1,24 @@
-# 💎 TPHIM - Ultimate Video Pipeline
+# 💎 TPHIM - Ultimate Video Pipeline v2.2.1
 
 **TPHIM** là bộ công cụ tối thượng để xây dựng hệ thống VOD (Video on Demand) chuyên nghiệp. Hỗ trợ tự động hóa từ khâu tải video, transcode HLS đa chất lượng, tạo phụ đề AI và upload lên Cloud (S3/Tebi).
 
 ## 🚀 Tính năng vượt trội
 - **Batch Pipeline:** Xử lý hàng loạt phim chỉ với 1 dòng lệnh.
 - **AI Subtitles:** Tự động tạo phụ đề Tiếng Việt/Tiếng Anh bằng công cụ AI (Whisper) chạy offline. Hỗ trợ bỏ qua phụ đề để tăng tốc độ.
+- **Resume Upload:** Tự động lưu tiến trình upload, tiếp tục từ điểm dừng nếu bị gián đoạn.
 - **Cloud Ready:** Upload trực tiếp lên Tebi.io hoặc bất kỳ S3-compatible storage nào.
 - **Interactive CLI:** Giao diện terminal đẹp mắt với neon theme.
+- **🆕 Dual Preview Sprites:** Tự động tạo cả High-Res và Low-Res preview sprites cho tối ưu mobile/desktop.
 
 ---
 
+## 📋 Changelog v2.2.1
+- ✨ **NEW:** Dual Preview Sprites (High-Res + Low-Res) với FFmpeg Complex Filter
+- ⚡ **OPTIMIZATION:** Tiết kiệm CPU với single-pass processing 
+- 📱 **MOBILE:** Low-Res sprites (80x45 tiles) tối ưu cho mobile và preview nhanh
+- 🔧 **TECH:** Sử dụng `child_process.spawn` thay cho `execSync` để better performance
+- 🚀 **VPS:** Auto-detect Ubuntu VPS và tối ưu FFmpeg parameters (preset: superfast, tune: zerolatency)
+i
 ## 🛠️ Hướng dẫn cài đặt (VPS Ubuntu / Google Cloud / Linux)
 
 Để chạy được bộ công cụ này trên Linux/VPS, bạn cần cài đặt các "vũ khí" sau:
@@ -172,6 +181,7 @@ TEBI_PUBLIC_URL=https://your-bucket.tebi.io
 - Tự động fetch metadata từ video
 - Chọn ngôn ngữ phụ đề (VI/EN/Both/Skip)
 - Batch processing với progress bar
+- **Resume Upload**: Tự động tiếp tục upload nếu bị gián đoạn
 
 **Help System:**
 ```bash
@@ -180,7 +190,31 @@ ntxa --help        # Tương tự
 ntxa -h           # Tương tự
 ```
 
+## 🔄 Resume Upload Feature
+
+**Tự động lưu và khôi phục tiến trình upload:**
+
+- **Progress Tracking**: Tạo file `.upload-progress.json` trong thư mục HLS
+- **Smart Resume**: Chỉ upload những file chưa có trên cloud
+- **Crash Recovery**: Nếu mất kết nối, chạy lại là tiếp tục từ điểm dừng
+- **Auto Cleanup**: Xóa progress file khi upload hoàn tất
+
+**Cách hoạt động:**
+```bash
+# Lần đầu chạy
+☁️  Uploading 1227 files to Tebi.io... (0 already uploaded)
+   ↳ 107/1227 files...
+
+# Nếu bị gián đoạn và chạy lại
+🔄 Found progress file. Resuming from 106 uploaded files...
+☁️  Uploading 1121 files to Tebi.io... (106 already uploaded)
+   ↳ 113/1227 files...
+
+# Bỏ qua file đã tồn tại
+⏭ Skipping hls/test-phim-2024/1080p/index.m3u8 (already exists on cloud)
+```
+
 ---
 
-*Phát triển bởi TXA - Ultimate Video Pipeline 2030 v2.1.0* 🍿🎬
-*Last Update: February 2026*
+*Phát triển bởi TXA - Ultimate Video Pipeline 2030 v2.2.2* 🍿🎬
+*Last Update: March 2026*

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tphim",
-  "version": "2.1.0",
-  "description": "TPHIM - Ultimate Video Pipeline: Download, Transcode HLS, AI Subtitles (with skip option), and Cloud Upload.",
+  "version": "2.2.2",
+  "description": "TPHIM - Ultimate Video Pipeline: Download, Transcode HLS, AI Subtitles (with skip option), Resume Upload, and Cloud Upload.",
   "main": "index.js",
   "type": "module",
   "bin": {
@@ -67,4 +67,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}

package/pipeline.mjs

@@ -1,8 +1,14 @@
 #!/usr/bin/env node
-// pipeline.mjs
+// pipeline.mjs v2.2.2
 // Usage: node pipeline.mjs "URL_hoac_duong_dan_mp4" "slug" "Tên Phim" [vi|en|both|skip]
-
-import { execSync } from 'child_process';
+// 
+// v2.2.2 FEATURES:
+// - Track and Display Total Execution Time (xxhxxmxxs)
+// - Dual Preview Sprites (High-Res + Low-Res) with FFmpeg Complex Filter
+// - Optimized CPU usage with single-pass processing
+// - Low-Res sprites optimized for mobile/preview (80x45 tiles, lighter file)
+
+import { execSync, spawn } from 'child_process';
 import { existsSync, mkdirSync, writeFileSync, rmSync, unlinkSync, readFileSync } from 'fs';
 import os from 'os';
 import path, { dirname } from 'path';
@@ -14,8 +20,44 @@ import { generateReadme } from './scripts/gen-readme.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const IS_WIN = os.platform() === 'win32';
+const IS_LINUX = os.platform() === 'linux';
 const SHELL_OPTS = IS_WIN ? { shell: 'cmd.exe' } : {};
 
+// Function to detect if running on Ubuntu VPS and optimize accordingly
+function detectVPSOptimization() {
+    if (!IS_LINUX) return { isVPS: false, cpuCores: 4, preset: 'ultrafast', tune: 'fastdecode' };
+
+    try {
+        // Check for Ubuntu/Debian
+        const releaseInfo = readFileSync('/etc/os-release', 'utf8');
+        const isUbuntu = releaseInfo.includes('ubuntu') || releaseInfo.includes('Ubuntu');
+
+        // Check if running in cloud environment (VPS indicators)
+        const isVPS = existsSync('/proc/vz') || // Virtuozzo/OpenVZ
+            existsSync('/proc/xen') || // Xen
+            existsSync('/sys/class/dmi/id/product_name') &&
+            readFileSync('/sys/class/dmi/id/product_name', 'utf8').toLowerCase().includes('cloud');
+
+        // Get CPU cores for optimization
+        const cpuCores = os.cpus().length;
+
+        // Optimize FFmpeg parameters based on environment
+        let preset = 'ultrafast';
+        let tune = 'fastdecode';
+
+        if (isVPS && isUbuntu) {
+            console.log('   🚀 VPS Ubuntu detected - Applying performance optimizations...');
+            preset = 'superfast'; // Balance between speed and quality
+            tune = 'fastdecode,zerolatency'; // Optimize for streaming
+        }
+
+        return { isVPS, isUbuntu, cpuCores, preset, tune };
+    } catch (error) {
+        console.log('   ⚠ Could not detect VPS environment, using default settings');
+        return { isVPS: false, cpuCores: 4, preset: 'ultrafast', tune: 'fastdecode' };
+    }
+}
+
 // Resolve binaries
 const FFMPEG_BIN = ffmpeg || 'ffmpeg';
 const YTDLP_BIN = 'yt-dlp'; // default to PATH if not found in project
@@ -85,6 +127,82 @@ function getRandomProxy(proxies, exclude = []) {
 
 const PROXY_LIST = loadProxies();
 
+// Function to create dual preview sprites using complex filter
+function generateDualPreviewSprites(mp4Path, outputDir) {
+    return new Promise((resolve, reject) => {
+        const highResPath = path.join(outputDir, 'preview.jpg');
+        const lowResPath = path.join(outputDir, 'preview_low.jpg');
+
+        console.log('   📸 [2.5/5] Generating Dual Preview Sprites (High-Res + Low-Res)...');
+
+        // Complex filter để tạo cả 2 phiên bản từ 1 luồng
+        const complexFilter = [
+            '[0:v]split=2[v0][v1]', // Split video stream thành 2 nhánh
+            '[v0]fps=1/10,scale=160:90,tile=10x10,format=yuv420p[v_high]', // High-res version
+            '[v1]fps=1/10,scale=80:45,tile=10x10,format=yuv420p[v_low]'  // Low-res version (50% size)
+        ].join(';');
+
+        const args = [
+            '-i', mp4Path,
+            '-filter_complex', complexFilter,
+            '-map', '[v_high]',
+            '-q:v', '3', // Higher quality for high-res
+            '-y',
+            highResPath,
+            '-map', '[v_low]',
+            '-q:v', '8', // Lower quality for low-res (lighter file)
+            '-y',
+            lowResPath
+        ];
+
+        const ffmpeg = spawn(FFMPEG_BIN, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: IS_WIN
+        });
+
+        let stdout = '';
+        let stderr = '';
+
+        ffmpeg.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+
+        ffmpeg.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+
+        ffmpeg.on('close', (code) => {
+            if (code === 0) {
+                console.log('   ✅ Dual Preview Sprites ready (High-Res + Low-Res).');
+                resolve({ highResPath, lowResPath });
+            } else {
+                console.error('   ⚠ Dual sprite generation failed:', stderr);
+                reject(new Error(`FFmpeg exited with code ${code}`));
+            }
+        });
+
+        ffmpeg.on('error', (error) => {
+            console.error('   ⚠ FFmpeg spawn error:', error);
+            reject(error);
+        });
+    });
+}
+
+function formatDuration(ms) {
+    const seconds = Math.floor((ms / 1000) % 60);
+    const minutes = Math.floor((ms / (1000 * 60)) % 60);
+    const hours = Math.floor((ms / (1000 * 60 * 60)) % 24);
+    const days = Math.floor(ms / (1000 * 60 * 60 * 24));
+
+    const parts = [];
+    if (days > 0) parts.push(`${days}d`);
+    if (hours > 0 || days > 0) parts.push(`${hours}h`);
+    if (minutes > 0 || hours > 0 || days > 0) parts.push(`${minutes}m`);
+    parts.push(`${seconds}s`);
+
+    return parts.join('');
+}
+
 export async function run() {
     // Nếu chạy trực tiếp từ CLI
     let [, , input, slug, title = slug, langArg = 'vi'] = process.argv;
@@ -116,6 +234,7 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
     mkdirSync('downloads', { recursive: true });
     mkdirSync(path.join('hls', slug), { recursive: true });
 
+    let startTime = Date.now();
     // ─── BƯỚC 1: Download ─────────────────────────────────────────
     const mp4Path = existsSync(input) && input.toLowerCase().endsWith('.mp4')
         ? input
@@ -159,6 +278,7 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
             }
         };
 
+        startTime = Date.now();
         let downloaded = false;
 
         // Attempt 1: Direct download (no proxy)
@@ -220,6 +340,13 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
     const spritePath = path.join('hls', slug, 'preview.jpg');
     const nokia3gpPath = path.join('hls', slug, `${slug}.3gp`);
 
+    // Detect VPS environment and optimize
+    const vpsOpt = detectVPSOptimization();
+    console.log(`   💻 System: ${IS_LINUX ? 'Linux' : 'Windows'} | CPU Cores: ${vpsOpt.cpuCores}`);
+    if (vpsOpt.isVPS && vpsOpt.isUbuntu) {
+        console.log(`   🚀 Ubuntu VPS Mode: Enabled (preset: ${vpsOpt.preset}, tune: ${vpsOpt.tune})`);
+    }
+
     // Danh sách toàn bộ chất lượng hỗ trợ
     const ALL_QUALITIES = [
         { label: '1080p', w: 1920, h: 1080, bv: '4500k', ba: '192k' },
@@ -250,7 +377,7 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
 
         selectedQualities.forEach((q, i) => {
             maps += `-map 0:v -map 0:a `;
-            outputs += `-c:v:${i} libx264 -preset ultrafast -tune fastdecode -b:v:${i} ${q.bv} -s:v:${i} ${q.w}x${q.h} -c:a:${i} aac -b:a:${i} ${q.ba} -movflags +faststart `;
+            outputs += `-c:v:${i} libx264 -preset ${vpsOpt.preset} -tune ${vpsOpt.tune} -b:v:${i} ${q.bv} -s:v:${i} ${q.w}x${q.h} -c:a:${i} aac -b:a:${i} ${q.ba} -movflags +faststart `;
             varStreamMapArr.push(`v:${i},a:${i}`);
         });
 
@@ -258,9 +385,12 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
         const timestamp = Date.now();
         const encodedPrefix = Buffer.from(`txa_${timestamp}`).toString('base64').replace(/[^a-zA-Z0-9]/g, '').substring(0, 8);
 
+        // Optimize thread count based on CPU cores
+        const threadCount = vpsOpt.isVPS ? Math.min(vpsOpt.cpuCores, 8) : 0; // 0 = auto, but limit on VPS
+
         const ffmpegCmd = [
-            `"${FFMPEG_BIN}"`, '-i', `"${mp4Path}"`, 
-            '-threads 0', '-preset ultrafast', '-tune fastdecode',
+            `"${FFMPEG_BIN}"`, '-i', `"${mp4Path}"`,
+            `-threads ${threadCount}`, `-preset ${vpsOpt.preset}`, `-tune ${vpsOpt.tune}`,
             maps,
             outputs,
             '-var_stream_map', `"${varStreamMapArr.join(' ')}"`,
@@ -276,7 +406,7 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
         // --- BƯỚC 2.1: XUẤT 3GP CHO MÁY CỔ (NOKIA S40/S60) ---
         console.log('   [2.1/5] Exporting 3GP legacy format...');
         console.log('   📱 [2.1/5] Exporting 3GP legacy format...');
-        const nokiaCmd = `"${FFMPEG_BIN}" -i "${mp4Path}" -s 320x240 -vcodec mpeg4 -acodec aac -ar 16000 -ac 1 -b:v 250k -b:a 32k -f 3gp "${nokia3gpPath}"`;
+        const nokiaCmd = `"${FFMPEG_BIN}" -i "${mp4Path}" -s 320x240 -vcodec mpeg4 -acodec aac -ar 16000 -ac 1 -b:v 250k -b:a 32k -preset ${vpsOpt.preset} -f 3gp "${nokia3gpPath}"`;
         try {
             execSync(nokiaCmd, { stdio: 'ignore', ...SHELL_OPTS });
             console.log('   ✅ Legacy 3GP ready.');
@@ -288,15 +418,26 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
     }
 
     // --- STEP 2.5: PREVIEW SPRITE --- (Independent check)
-    if (!existsSync(spritePath)) {
-        console.log('   📸 [2.5/5] Generating Neon Preview SpriteSheet...');
-        const spriteCmd = `"${FFMPEG_BIN}" -i "${mp4Path}" -vf "fps=1/10,scale=160:90,tile=10x10" -q:v 3 "${spritePath}"`;
+    const spriteLowPath = path.join('hls', slug, 'preview_low.jpg');
+
+    if (!existsSync(spritePath) || !existsSync(spriteLowPath)) {
         try {
-            execSync(spriteCmd, { stdio: 'ignore', ...SHELL_OPTS });
-            console.log('   ✅ Preview SpriteSheet ready.');
-        } catch (e) { console.log('   ⚠ Preview generation failed.'); }
+            const outDir = path.join('hls', slug);
+            const { highResPath, lowResPath } = await generateDualPreviewSprites(mp4Path, outDir);
+            console.log('   ✅ Dual Preview Sprites generated successfully.');
+        } catch (e) {
+            console.log('   ⚠ Dual sprite generation failed, falling back to single sprite...');
+            // Fallback to original method
+            const spriteCmd = `"${FFMPEG_BIN}" -i "${mp4Path}" -vf "fps=1/10,scale=160:90,tile=10x10" -q:v 3 "${spritePath}"`;
+            try {
+                execSync(spriteCmd, { stdio: 'ignore', ...SHELL_OPTS });
+                console.log('   ✅ Fallback Preview SpriteSheet ready.');
+            } catch (fallbackError) {
+                console.log('   ⚠ All sprite generation methods failed.');
+            }
+        }
     } else {
-        console.log(`   ⏭  Preview SpriteSheet đã có sẵn`);
+        console.log(`   ⏭  Dual Preview Sprites already exist`);
     }
 
     // ─── BƯỚC 3: Tạo README ───────────────────────────────────────
@@ -333,14 +474,14 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
 
     // ─── BƯỚC 5: Upload Tebi.io ───────────────────────────────────
     console.log('\n🚀 [5/5] Deploying to Quantum Cloud (Tebi.io)...');
-    
+
     // Optimize upload with parallel processing
     const uploadCmd = `node ${path.join(__dirname, 'scripts', 'upload-tebi.mjs')} "${slug}"`;
-    
+
     // Run upload with higher process priority and optimized settings
     try {
-        execSync(uploadCmd, { 
-            stdio: 'inherit', 
+        execSync(uploadCmd, {
+            stdio: 'inherit',
             cwd: process.cwd(),
             maxBuffer: 1024 * 1024, // Increase buffer size
             env: {
@@ -357,18 +498,20 @@ export async function executePipeline({ input, slug, title, langArg = 'vi' }) {
     // --- FINAL STEP: GENERATE MASTER README.md ---
     const finalReadmePath = path.join('hls', slug, 'README.md');
     const bucketName = process.env.TEBI_BUCKET || "txa-vod";
-    const cloudUrl = `https://s3.tebi.io/${bucketName}/${slug}/${masterName}`;
-    const nokiaUrl = `https://s3.tebi.io/${bucketName}/${slug}/${slug}.3gp`;
+    const cloudUrl = `https://s3.tebi.io/${bucketName}/hls/${slug}/${masterName}`;
+    const nokiaUrl = `https://s3.tebi.io/${bucketName}/hls/${slug}/${slug}.3gp`;
 
     const report = `
 # 🎬 TXA PIPELINE REPORT: ${title}
 Generated on: ${new Date().toLocaleString()}
 
 ## 📦 Asset Checklist
+- [x] **Total Execution Time:** ${formatDuration(Date.now() - startTime)}
 - [x] **Master Playlist:** \`${masterName}\` (AUTO Quality)
 - [x] **Video Qualities:** ${selectedQualities.map(q => q.label).join(', ')} (Randomized)
 - [${existsSync(nokia3gpPath) ? 'x' : ' '}] **Legacy Format:** \`${slug}.3gp\` (Nokia S40/S60)
-- [${existsSync(spritePath) ? 'x' : ' '}] **Preview SpriteSheet:** \`preview.jpg\` (10x10 Grid)
+- [${existsSync(spritePath) ? 'x' : ' '}] **High-Res Preview SpriteSheet:** \`preview.jpg\` (160x90 tiles, 10x10 grid)
+- [${existsSync(spriteLowPath) ? 'x' : ' '}] **Low-Res Preview SpriteSheet:** \`preview_low.jpg\` (80x45 tiles, 10x10 grid)
 - [${existsSync(path.join('hls', slug, 'vi.vtt')) ? 'x' : ' '}] **Vietnamese Subtitles:** AI Generated
 - [${existsSync(path.join('hls', slug, 'en.vtt')) ? 'x' : ' '}] **English Subtitles:** AI Generated
 
@@ -378,6 +521,10 @@ Generated on: ${new Date().toLocaleString()}
 ## 📱 Legacy Mobile Link (Nokia/Java)
 > **[DOWNLOAD 3GP](${nokiaUrl})**
 
+## 🖼️ Preview Sprites Information
+- **High-Res Version:** \`preview.jpg\` - Full quality for desktop/fast connections
+- **Low-Res Version:** \`preview_low.jpg\` - Optimized for mobile/preview (50% size, lighter file)
+
 ---
 *Generated by Antigravity AI Engine v2030*
 `;
@@ -387,6 +534,9 @@ Generated on: ${new Date().toLocaleString()}
     console.log(`📄 Summary saved to: ${finalReadmePath}`);
     console.log(`🔗 Cloud URL: ${cloudUrl}`);
     if (existsSync(nokia3gpPath)) console.log(`📱 Nokia 3GP: ${nokiaUrl}`);
+    if (existsSync(spritePath)) console.log(`🖼️ High-Res Preview: https://s3.tebi.io/${bucketName}/hls/${slug}/preview.jpg`);
+    if (existsSync(spriteLowPath)) console.log(`📱 Low-Res Preview: https://s3.tebi.io/${bucketName}/hls/${slug}/preview_low.jpg`);
+    console.log(`⏱  TOTAL TIME: ${formatDuration(Date.now() - startTime)}`);
 
     // --- AUTO CLEANUP ---
     console.log('\n🧹 [CLEANUP] Purging local temporary files...');

package/pro-terminal.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
- * NROTXA ULTIMATE CLI 2030 EDITION
- * High-performance, Neon-infused Video Pipeline
+ * NROTXA ULTIMATE CLI 2030 EDITION v2.2.2
+ * High-performance, Neon-infused Video Pipeline with Resume Upload
  */
 
 import * as p from '@clack/prompts';
@@ -111,7 +111,7 @@ function showHelp() {
         )
     );
 
-    console.log(chalk.gray('  ⚡ TPHIM ULTIMATE VIDEO CORE v2.1.0 | STATUS: READY ⚡\n'));
+    console.log(chalk.gray('  ⚡ TPHIM ULTIMATE VIDEO CORE v2.2.2 | STATUS: READY ⚡\n'));
 
     console.log(`${neonPurple('📖 CÁCH SỬ DỤNG:')}`);
     console.log(chalk.cyan('  ntxa help                    - Hiển thị help này'));
@@ -131,6 +131,8 @@ function showHelp() {
     console.log(chalk.cyan('  • Download video từ multiple sources'));
     console.log(chalk.cyan('  • Transcode HLS 4-6 qualities'));
     console.log(chalk.cyan('  • AI Subtitle generation (Whisper)'));
+    console.log(chalk.cyan('  • Skip subtitle option (fast mode)'));
+    console.log(chalk.cyan('  • Resume upload (crash recovery)'));
     console.log(chalk.cyan('  • Upload cloud storage (Tebi.io)'));
     console.log(chalk.cyan('  • Batch processing support'));
     console.log(chalk.cyan('  • Proxy rotation tự động'));
@@ -168,7 +170,7 @@ async function main() {
         )
     );
 
-    console.log(chalk.gray('  ⚡ NEON-INFUSED VIDEO CORE v2.1.0 | STATUS: READY ⚡\n'));
+    console.log(chalk.gray('  ⚡ NEON-INFUSED VIDEO CORE v2.2.2 | STATUS: READY ⚡\n'));
 
     p.intro(`${neonPurple('▣ SYSTEM INITIALIZED - BATCH MODE ENABLED')}`);
 

package/scripts/gen-readme.mjs

@@ -64,6 +64,8 @@ export function generateReadme(slug, mp4Path, info = {}) {
   const duration = getVideoDuration(mp4Path);
   const totalSize = getFolderSizeMB(hlsDir);
   const tsCount = countFiles(hlsDir, '.ts');
+  const hasHighResSprite = fs.existsSync(path.join(hlsDir, 'preview.jpg'));
+  const hasLowResSprite = fs.existsSync(path.join(hlsDir, 'preview_low.jpg'));
   const hasSub = fs.existsSync(path.join(hlsDir, 'vi.vtt'));
   const hasSubEn = fs.existsSync(path.join(hlsDir, 'en.vtt'));
   const streamInfo = getStreamInfo(mp4Path);
@@ -101,14 +103,21 @@ export function generateReadme(slug, mp4Path, info = {}) {
   Master playlist : hls/${slug}/master.m3u8
                     → Đây là link chính truyền vào TXAPlayer
 
-📝  SUBTITLE
+�️  PREVIEW SPRITES
+  High-Res Sprite : ${hasHighResSprite ? 'preview.jpg ✅ (160x90 tiles)' : '❌ Chưa có'}
+  Low-Res Sprite  : ${hasLowResSprite ? 'preview_low.jpg ✅ (80x45 tiles)' : '❌ Chưa có'}
+  Usage           : Frontend có thể chọn dựa trên tốc độ mạng
+
+�  SUBTITLE
   Tiếng Việt  : ${hasSub ? 'hls/' + slug + '/vi.vtt ✅' : '❌ Chưa có'}
   Tiếng Anh   : ${hasSubEn ? 'hls/' + slug + '/en.vtt ✅' : '❌ Chưa có'}
   Tạo bởi     : faster-whisper model small (offline, CPU)
 
 ☁️  TEBI.IO (sau khi upload)
-  HLS URL  : ${publicUrl}/hls/${slug}/master.m3u8
-  VTT (VI) : ${publicUrl}/hls/${slug}/vi.vtt
+  HLS URL        : ${publicUrl}/hls/${slug}/master.m3u8
+  VTT (VI)       : ${publicUrl}/hls/${slug}/vi.vtt
+  High-Res Sprite: ${hasHighResSprite ? publicUrl + '/hls/' + slug + '/preview.jpg' : '❌ Chưa có'}
+  Low-Res Sprite : ${hasLowResSprite ? publicUrl + '/hls/' + slug + '/preview_low.jpg' : '❌ Chưa có'}
 
 ================================================================================
   ⚠️  Có thể xóa folder này sau khi upload lên Tebi.io thành công

package/scripts/upload-tebi.mjs

@@ -1,7 +1,7 @@
 // scripts/upload-tebi.mjs
 // Tebi.io S3-compatible — dùng @aws-sdk/client-s3 bình thường
-import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';
-import { readdirSync, readFileSync } from 'fs';
+import { S3Client, PutObjectCommand, HeadObjectCommand } from '@aws-sdk/client-s3';
+import { readdirSync, readFileSync, writeFileSync, existsSync, unlinkSync } from 'fs';
 import { join, extname, relative } from 'path';
 import { lookup } from 'mime-types';
 import 'dotenv/config';
@@ -19,14 +19,44 @@ const s3 = new S3Client({
 export async function uploadHLSFolder(slug) {
     const localDir = join('hls', slug);
     const files = getAllFiles(localDir);
+    const progressFile = join('hls', slug, '.upload-progress.json');
+    
+    // Load existing progress
+    let uploadedFiles = [];
+    if (existsSync(progressFile)) {
+        try {
+            const progressData = JSON.parse(readFileSync(progressFile, 'utf-8'));
+            uploadedFiles = progressData.uploadedFiles || [];
+            console.log(`\n🔄 Found progress file. Resuming from ${uploadedFiles.length} uploaded files...`);
+        } catch (e) {
+            console.log('\n⚠ Progress file corrupted, starting fresh...');
+        }
+    }
 
-    console.log(`\n☁️  Uploading ${files.length} files to Tebi.io...`);
-    let uploaded = 0;
+    // Filter files that haven't been uploaded yet
+    const filesToUpload = files.filter(file => !uploadedFiles.includes(relative('.', file).replace(/\\/g, '/')));
+    
+    console.log(`\n☁️  Uploading ${filesToUpload.length} files to Tebi.io... (${files.length - filesToUpload.length} already uploaded)`);
+    let uploaded = uploadedFiles.length;
 
-    for (const filePath of files) {
+    for (const filePath of filesToUpload) {
         const s3Key = relative('.', filePath).replace(/\\/g, '/');
         const ext = extname(filePath).toLowerCase();
 
+        // Check if file already exists on cloud
+        try {
+            await s3.send(new HeadObjectCommand({
+                Bucket: process.env.TEBI_BUCKET,
+                Key: s3Key
+            }));
+            console.log(`\n   ⏭ Skipping ${s3Key} (already exists on cloud)`);
+            uploaded++;
+            uploadedFiles.push(s3Key);
+            continue;
+        } catch (e) {
+            // File doesn't exist, proceed with upload
+        }
+
         const cacheMap = {
             '.ts': 'public, max-age=31536000',
             '.m3u8': 'public, max-age=300',
@@ -44,9 +74,30 @@ export async function uploadHLSFolder(slug) {
         }));
 
         uploaded++;
+        uploadedFiles.push(s3Key);
+        
+        // Save progress after each successful upload
+        writeFileSync(progressFile, JSON.stringify({
+            uploadedFiles,
+            totalFiles: files.length,
+            lastUpdate: new Date().toISOString()
+        }));
+        
         process.stdout.write(`\r   ↳ ${uploaded}/${files.length} files...`);
     }
 
+    // Clean up progress file when complete
+    if (uploaded === files.length) {
+        try {
+            if (existsSync(progressFile)) {
+                unlinkSync(progressFile);
+                console.log('\n   🧹 Cleaned up progress file');
+            }
+        } catch (e) {
+            // Ignore cleanup error
+        }
+    }
+
     const base = process.env.TEBI_PUBLIC_URL;
     const masterName = `txa-${slug}.m3u8`;
     const finalMasterUrl = `${base}/hls/${slug}/${masterName}`;
@@ -78,7 +129,7 @@ function getAllFiles(dir) {
     return result;
 }
 // Tự chạy nếu gọi trực tiếp
-if (import.meta.url.endsWith(process.argv[1].replace(/\\/g, '/')) || process.argv[1].endsWith('upload-tebi.mjs')) {
+if (import.meta.url.endsWith(process.argv[1]?.replace(/\\/g, '/')) || process.argv[1]?.endsWith('upload-tebi.mjs')) {
     const slug = process.argv[2];
     if (slug) {
         uploadHLSFolder(slug).catch(console.error);