◆ ContentForge

AI-Powered Short-Form Video Content Production

Riset → Script → Footage → SEO — Semuanya dalam satu aplikasi desktop

---

📑 Daftar Isi

• Fitur Utama
• Tampilan Aplikasi
• Instalasi
• Cara Penggunaan
• Tema
• Shortcut Keys
• Tech Stack
• Struktur Project
• Testing
• Build to EXE
• Troubleshooting
• License
• Kontribusi

---

✨ Fitur Utama

Fitur	Deskripsi
🎯 Riset Topik AI	Generate 5-10 topik viral dengan skor S/A/B/C
✍️ Script Generator	Naskah voice-over 60-90 detik, 5 gaya penulisan
🎬 Footage Finder	Cari video dari Pexels, Pixabay, X/Twitter (API resmi)
🔍 SEO Engine	Judul, deskripsi, keywords, hashtags otomatis
🌐 Multi-Bahasa	Auto-detect & translate ke 14 bahasa
📊 Competitor Analysis	Analisis kompetitor YouTube
📈 Trending Feed	Ide konten dari Google Trends & YouTube
⏱️ Script Timer	Estimasi durasi voice-over
💾 Session Save	Simpan & load pekerjaan
🎨 Dark/Light Mode	Toggle tema sesuai selera
🎭 Niche Templates	Custom niche untuk riset topik
🎙️ Voice Over TTS	Generate audio dari naskah (edge-tts)
📋 Batch Mode	Generate banyak topik & script sekaligus
📝 SRT Subtitle	Export subtitle dari timeline
🎬 EDL Export	Export timeline untuk video editor
🔑 Secure Keys	API key tersimpan di OS vault (keyring)
🔌 Test Connection	Test API key sebelum digunakan
📦 Build to EXE	PyInstaller script untuk Windows installer

---

📸 Tampilan Aplikasi

Tab 1: Riset Topik

┌──────────────────────────────────────────────────────────────────┐
│  ◆ ContentForge   [1. Riset] ── [2. Naskah] ── [3. Video] ── [4. SEO] │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌─ Riset Topik AI ─────────────────────────────────────────┐   │
│  │  Topik: [Cara bikin konten viral________________]        │   │
│  │  [✓ Generate Topics]  [Spinner...]                       │   │
│  │                                                           │   │
│  │  ┌─────────────────────────────────────────────────┐     │   │
│  │  │ 1. Kenapa Konten Kucing Selalu Viral?      [S] │     │   │
│  │  │    "Konten kucing menang karena emosi..."       │     │   │
│  │  │    + Kuriositas Ekstrem  + Storytelling         │     │   │
│  │  ├─────────────────────────────────────────────────┤     │   │
│  │  │ 2. Rahasia Algoritma YouTube 2026          [A] │     │   │
│  │  │    "Algoritma YouTube kini menprioritaskan..."  │     │   │
│  │  │    + Mind-Blowing  + Ilmiah/Fakta               │     │   │
│  │  └─────────────────────────────────────────────────┘     │   │
│  └───────────────────────────────────────────────────────────┘   │
│                                                                  │
│  Provider: OpenRouter/gemma-4-26b-a4b-it:free                    │
└──────────────────────────────────────────────────────────────────┘

Tab 2: Script Generator + Translate

┌──────────────────────────────────────────────────────────────────┐
│  ┌─ Naskah ─────────────────────────────────────────────────┐   │
│  │  Pernah gak sih, kamu lagi scroll-scroll Twitter...      │   │
│  │  tiba-tiba nemu video kucing yang lucu banget?           │   │
│  │  Nah, itu bukan kebetulan. Ada ilmu di baliknya...       │   │
│  │                                                           │   │
│  │  342 karakter │ 1:22 │ Target: 60s                       │   │
│  └───────────────────────────────────────────────────────────┘   │
│  [Copy] [Download .txt] [Save Session] [Lanjut Tahap 3 →]       │
│                                                                  │
│  ┌─ Translate / Multi-Bahasa ──────────────────────────────┐   │
│  │  [Bahasa Indonesia ▾] [Auto Detect] [Translate]         │   │
│  └───────────────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────────┘

Tab 3: Video & Footage

┌──────────────────────────────────────────────────────────────────┐
│  ┌─ Pencarian Video ───────────────────────────────────────┐   │
│  │  Keywords: [kucing lucu, viral content, binatang____]    │   │
│  │  [Search Footage]                                       │   │
│  └───────────────────────────────────────────────────────────┘   │
│                                                                  │
│  ┌─ Timeline (AI Generated) ─┐  ┌─ Hasil Pencarian ──────────┐ │
│  │  0:00-0:15 Scene 1        │  │  Video 1 - Pexels           │ │
│  │  Keywords: cute cat,      │  │  [Open URL]                 │ │
│  │  funny pet, animal        │  │                              │ │
│  ├───────────────────────────┤  │  Video 2 - Pixabay          │ │
│  │  0:15-0:30 Scene 2        │  │  [Open URL]                 │ │
│  │  Keywords: cat playing,   │  └──────────────────────────────┘ │
│  │  viral moment             │                                   │
│  └───────────────────────────┘                                   │
└──────────────────────────────────────────────────────────────────┘

Tab 4: SEO & Export

┌──────────────────────────────────────────────────────────────────┐
│  ┌─ SEO YouTube ───────────────────────────────────────────┐   │
│  │  Judul: 5 Rahasia Konten Kucing Viral yang Jarang...    │   │
│  │  Deskripsi: Dalam video ini, kita akan membahas...       │   │
│  │  Keywords: [kucing] [viral] [konten] [tips] [算法]       │   │
│  │  Hashtags: [#kucing] [#viral] [#konten] [#tips]         │   │
│  └───────────────────────────────────────────────────────────┘   │
│  [Copy Keywords] [Copy Hashtags]                                 │
│                                                                  │
│  ┌─ Export ────────────────────────────────────────────────┐    │
│  │  [Export Report .txt] [Export Timeline .csv] [Export .json] │  │
│  └───────────────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────────┘

---

🚀 Instalasi

Prasyarat

• Python 3.10 atau lebih baru
• API Key (pilih salah satu atau lebih):
  • OpenRouter — gratis
  • Groq — gratis
  • Gemini — gratis
  • OpenAI — berbayar
  • DeepSeek — murah
  • Qwen — murah

Cara Install

# 1. Clone repository
git clone https://github.com/Chukie99/content_forge.git
cd content_forge

# 2. Install dependencies
pip install -r requirements.txt

# 3. Jalankan aplikasi
python main.py

Setup API Key

1. Buka aplikasi
2. Klik File → Settings (atau tekan Ctrl+,)
3. Pilih provider (OpenRouter atau Groq)
4. Masukkan API Key
5. Klik Save

---

📖 Cara Penggunaan

Workflow Singkat

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  1. RISET   │ →  │  2. NASKAH  │ →  │  3. VIDEO   │ →  │  4. SEO     │
│  Topik      │    │  Script     │    │  Footage    │    │  Judul/Tag  │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       ▼                  ▼                  ▼                  ▼
  Generate Topik    Copy Naskah       Download Video     Copy ke YouTube
  Pilih yang S/A    untuk Voice Over  dari Pexels        untuk Upload

Tahap 1: Riset Topik

1. Klik "Generate Topics"
2. Tunggu AI generate topik
3. Klik topik yang diinginkan
4. Otomatis lanjut ke Tahap 2

Tahap 2: Buat Naskah

1. Pilih gaya penulisan
2. Klik "Generate Script"
3. Naskah muncul di textbox
4. Lihat durasi di bawah (M:SS)
5. Copy untuk voice over

Tahap 3: Cari Video

1. Keyword otomatis dari naskah
2. Klik "Search Footage"
3. Buka URL untuk download
4. Timeline AI muncul (4-6 scene)

Tahap 4: SEO & Publish

1. Klik "Generate SEO"
2. Copy judul, deskripsi, keywords
3. Paste ke YouTube saat upload

---

🎨 Tema

Tema	Trigger
🌙 Dark	Default
☀️ Light	Settings → Theme → Light

---

⌨️ Shortcut Keys

Shortcut	Fungsi
Ctrl+S	Save Session
Ctrl+H	Buka History
Ctrl+T	Trending Topics
Ctrl+M	Competitor Analysis
Ctrl+B	Batch Mode
Ctrl+,	Settings

---

🛠️ Tech Stack

Komponen	Teknologi
UI Framework	PyQt6
AI Providers	OpenRouter, Groq, Gemini, OpenAI, DeepSeek, Qwen
Video Source	Pexels API, Pixabay API, X/Twitter
Database	SQLite
Video Tool	yt-dlp
TTS Engine	edge-tts (gratis, tanpa API key)
Credential Vault	keyring (OS native)
Build Tool	PyInstaller
Testing	pytest

---

📁 Struktur Project

content_forge/
├── main.py                 # Entry point
├── requirements.txt        # Dependencies
├── core/
│   ├── ai_client.py       # AI API client
│   ├── db.py              # Database
│   ├── topic_engine.py    # Topic generation
│   ├── script_engine.py   # Script generation
│   ├── seo_engine.py      # SEO generation
│   ├── video_scraper.py   # Video search + keywords
│   ├── timeline_engine.py # Timeline generation
│   ├── translate_engine.py # Multi-language
│   ├── trending_engine.py # Trending topics
│   ├── competitor_engine.py # Competitor analysis
│   └── export_engine.py   # Export tools
├── ui/
│   ├── tab_topic.py       # Tab 1: Riset
│   ├── tab_script.py      # Tab 2: Naskah
│   ├── tab_video.py       # Tab 3: Video
│   ├── tab_seo.py         # Tab 4: SEO
│   ├── tab_history.py     # History
│   ├── tab_trending.py    # Trending
│   ├── tab_competitor.py  # Competitor
│   ├── settings_dialog.py # Settings
│   └── components/        # UI components
├── style/
│   ├── theme.qss          # Dark theme
│   └── theme_light.qss    # Light theme
└── assets/
    └── fonts/             # Custom fonts

---

✅ Testing

Proyek ini menggunakan pytest dengan test untuk mesin core (AI, DB, engine) dan komponen UI.

# Jalankan semua test
python -m pytest tests/ -v

• 405 test passing (bot)
• Coverage modul teruji: core.db, core.ai_client, core.secure_store, core.script_engine, core.translate_engine, core.batch_renderer, core.ab_settings, core.analytics, core.realtime_analytics, core.export_engine, core.trending_engine, core.competitor_engine, dll.
• CI otomatis dijalankan via GitHub Actions pada tiap push ke master (Python 3.10/3.11/3.12).

---

📦 Build to EXE

Bangun aplikasi menjadi satu executable Windows:

pip install pyinstaller
python build.py
# Output: dist/ContentForge.exe

Catatan: build.py perlu --add-data untuk config/selectors.json, style/*.qss, dan assets/fonts/* agar hasil EXE punya fixture scraping, tema, dan font lengkap (lihat Langkah 9 laporan audit).

---

⚠️ Troubleshooting

Masalah	Solusi
API Key error	Settings → masukkan key baru
No response	Coba provider lain (Groq/OpenRouter)
Video not found	Ganti keyword
Script too long	Kurangi topik di Tahap 1
App not starting	pip install --upgrade PyQt6

---

📄 License

MIT License - Silakan gunakan dan modifikasi.

---

🤝 Kontribusi

Contributions welcome! Fork repo, buat branch, dan submit PR.

---

Made with ❤️ for Content Creators