|
|
# 📖 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
|
|
|
```bash
|
|
|
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
|
|
|
|
|
|
1. **Chụp screenshot** bài đăng → lưu thành `0_title.png`
|
|
|
2. **Chụp screenshot** comments → lưu thành `1_comment.png`, `2_comment.png`, ...
|
|
|
3. **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
|
|
|
```bash
|
|
|
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):
|
|
|
|
|
|
```toml
|
|
|
[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](file:///home/minhvu/projects/RedditVideoMakerBot/manual/__init__.py) | 🆕 Created | Module init |
|
|
|
| [manual/scanner.py](file:///home/minhvu/projects/RedditVideoMakerBot/manual/scanner.py) | 🆕 Created | Folder scanner & validator |
|
|
|
| [manual/tts_processor.py](file:///home/minhvu/projects/RedditVideoMakerBot/manual/tts_processor.py) | 🆕 Created | TTS processor |
|
|
|
| [manual/video_builder.py](file:///home/minhvu/projects/RedditVideoMakerBot/manual/video_builder.py) | 🆕 Created | Video assembler |
|
|
|
| [manual_main.py](file:///home/minhvu/projects/RedditVideoMakerBot/manual_main.py) | 🆕 Created | CLI entry point |
|
|
|
| [.gitignore](file:///home/minhvu/projects/RedditVideoMakerBot/.gitignore) | ✏️ Updated | Thêm `manual_posts/`, `manual_results/` |
|
|
|
|
|
|
---
|
|
|
|
|
|
## ⚠️ Lưu Ý
|
|
|
|
|
|
1. **FFmpeg** phải được cài sẵn trên hệ thống
|
|
|
2. **Background video** sẽ tự động tải từ YouTube lần đầu (cần internet)
|
|
|
3. Config.toml có thể trống — bot dùng built-in defaults (GoogleTranslate TTS)
|
|
|
4. Encoder mặc định là `libx264` (CPU) — phù hợp máy không có GPU NVIDIA
|
