5.8 KiB

Raw Blame History Unescape Escape

📖 Hướng Dẫn Sử Dụng Manual Pipeline

Tóm tắt: Tạo video từ screenshots chụp tay (Reddit, Threads, X) mà không cần API.

🚀 Quick Start (3 bước)

Bước 1: Tạo folder cho post mới

cd /home/minhvu/projects/RedditVideoMakerBot
python manual_main.py init my_first_post --platform reddit

Kết quả:

manual_posts/my_first_post/
├── meta.json           ← (optional) metadata
├── 0_title.txt         ← Chỉnh text cho TTS ở đây
└── 1_comment.txt       ← Chỉnh text comment ở đây

Bước 2: Thêm screenshots + text

Chụp screenshot bài đăng → lưu thành 0_title.png
Chụp screenshot comments → lưu thành 1_comment.png, 2_comment.png, ...
Sửa file .txt tương ứng — nhập nội dung text mà bot sẽ đọc thành giọng nói

manual_posts/my_first_post/
├── meta.json
├── 0_title.png         ← Screenshot bài đăng
├── 0_title.txt         ← "What's the most underrated life hack?"
├── 1_comment.png       ← Screenshot comment 1
├── 1_comment.txt       ← "I always put my phone on airplane mode..."
├── 2_comment.png       ← Screenshot comment 2
└── 2_comment.txt       ← "Using a binder clip as a phone stand..."

[!IMPORTANT] Mỗi file .png bắt buộc phải có file .txt cùng số thứ tự. Số 0 luôn là title/bài đăng chính.

Bước 3: Render video

python manual_main.py render my_first_post

Video sẽ được lưu tại: manual_results/my_first_post.mp4

📋 Tất Cả Commands

Command	Mô tả
`python manual_main.py init <post_id>`	Tạo folder mới với template files
`python manual_main.py init <post_id> --platform threads`	Tạo folder cho Threads post
`python manual_main.py render <post_id>`	Render 1 post thành video
`python manual_main.py render --all`	Render tất cả posts chưa render
`python manual_main.py render <post_id> --force`	Re-render (dù đã render trước đó)
`python manual_main.py list`	Liệt kê tất cả posts + trạng thái

📁 Quy Tắc Đặt Tên File

<số_thứ_tự>_<loại>.<ext>

File	Ý nghĩa
`0_title.png`	Screenshot bài đăng chính (bắt buộc)
`0_title.txt`	Text TTS cho bài đăng (bắt buộc)
`1_comment.png`	Screenshot comment 1
`1_comment.txt`	Text TTS cho comment 1
`N_comment.png/txt`	Comment thứ N
`meta.json`	Metadata (optional)

[!TIP]
File .txt hỗ trợ dòng comment bắt đầu bằng # — những dòng này sẽ bị bỏ qua khi TTS.

⚙️ Cấu Hình

Thêm section [manual] vào config.toml (hoặc để trống — bot sẽ dùng defaults):

[manual]
input_dir = "manual_posts"        # Thư mục input
output_dir = "manual_results"     # Thư mục output
encoder = "libx264"               # CPU encoder (hoặc h264_nvenc nếu có GPU)
resolution_w = 1080               # Width video
resolution_h = 1920               # Height video (1080x1920 = portrait)
opacity = 0.9                     # Độ trong suốt screenshot overlay
background_video = "minecraft"    # Video nền
background_audio = "lofi"         # Audio nền
background_audio_volume = 0.15    # Âm lượng audio nền (0 = tắt)
max_video_length = 120            # Max thời lượng video (giây)
watermark_enabled = true          # Enable/disable watermark overlay
watermark_path = "assets/backgrounds/transparent-bg.png"  # Path to watermark PNG file

Watermark:

watermark_enabled: Set to true để thêm watermark vào tất cả videos, false để tắt
watermark_path: Đường dẫn tới file PNG watermark (mặc định: assets/transparent-bg.png)
- File phải có kích thước 1080×1920 pixels với alpha transparency
- Vùng transparent sẽ hiển thị video phía dưới
- Watermark xuất hiện suốt thời lượng của video

TTS engine được lấy từ section [settings.tts] trong config.toml. Mặc định dùng GoogleTranslate (không cần API key).

🏗️ Kiến Trúc Module

manual/
├── __init__.py          # Module docstring
├── scanner.py           # Quét folders, validate, build post_object
├── tts_processor.py     # TTS: text → MP3 (reuse TTS/ engines)
└── video_builder.py     # FFmpeg: screenshots + audio → video

manual_main.py           # CLI entry point (init, render, list)

Hoàn toàn tách biệt với flow cũ (main.py). Không sửa bất kỳ file nào của flow cũ.

Files đã tạo/sửa

File	Action	Mô tả
manual/init.py	🆕 Created	Module init
manual/scanner.py	🆕 Created	Folder scanner & validator
manual/tts_processor.py	🆕 Created	TTS processor
manual/video_builder.py	🆕 Created	Video assembler
manual_main.py	🆕 Created	CLI entry point
.gitignore	✏️ Updated	Thêm `manual_posts/`, `manual_results/`

⚠️ Lưu Ý

FFmpeg phải được cài sẵn trên hệ thống
Background video sẽ tự động tải từ YouTube lần đầu (cần internet)
Config.toml có thể trống — bot dùng built-in defaults (GoogleTranslate TTS)
Encoder mặc định là libx264 (CPU) — phù hợp máy không có GPU NVIDIA

5.8 KiB Raw Blame History Unescape Escape