Open Creators Box

Version 1.0.0 Professional

A unified and cross-platform Text-To-Speech (TTS) and Video Rendering Studio.

---

Overview

Open Creators Box (OCB) is a powerful, offline-first application designed for modern content creators. It seamlessly integrates state-of-the-art Text-to-Speech generation with an automated Video Studio, allowing you to generate perfectly synced audio, subtitles (.srt), and high-quality MP4 videos with zero cloud dependencies.

Key Features

• Professional Workspace: A unified, distraction-free text editor. Type your script, select your voice, and adjust the speaking speed.
• Offline Text-to-Speech: Powered by the ultra-fast Piper TTS engine, generating realistic human voices entirely on your local machine.
• Perfectly Synced Subtitles: OCB intrinsically understands the exact duration of every generated sentence, exporting flawless .srt files that are mathematically guaranteed to match your audio.
• Built-In Model Manager: Browse, search, and instantly download any Piper TTS voice model directly from HuggingFace without ever leaving the app.
• Video Studio Pro: An integrated rendering pipeline powered by ffmpeg.
  • Upload custom background images or videos.
  • Automatically extract video preview thumbnails.
  • Render in 720p, 1080p, or 4K UHD.
  • Export in Landscape (16:9) or Portrait (9:16) for YouTube Shorts or TikTok.
  • Hard-burn subtitles dynamically with automatic scaling and custom positioning.

---

🛠️ Installation

OCB requires Python 3.10+ and a local installation of ffmpeg.

1. Install System Dependencies (Linux/Debian)

sudo apt update
sudo apt install ffmpeg

2. Install Python Packages

pip install -r requirements.txt

3. Launch

python3 main.py

---

Usage Guide

The Workspace

1. Select an installed voice model from the dropdown (or download one in the Model Manager tab).
2. Adjust your Speed (e.g., 1.0x Normal or 1.5x Fast).
3. Paste your script into the Text Editor.
4. Click Generate Assets. The engine will cache your perfectly-timed audio and .srt file.
5. Manually save the Audio or SRT, or hit Play to hear a live preview with karaoke-style text highlighting.

The Video Studio

1. After generating your assets in the Workspace, head to the Video Studio tab.
2. Click Browse Custom Image/Video to select a background. The app will generate a live thumbnail.
3. Choose your Aspect Ratio, Resolution, and Compression Quality.
4. Check Burn Subtitles to automatically overlay your .srt file onto the video.
5. Click Render High Quality Video to export your final .mp4 masterpiece!

---

Architecture

The application strictly separates UI from core logic:

• ocb_ui/: Contains the modern, responsive sv_ttk powered interface and tabs.
• ocb_engine/: Contains the heavy-lifting logic:
  • tts_engine.py: Piper wrapper for audio synthesis.
  • video_renderer.py: Advanced ffmpeg subprocess controller.
  • model_manager.py: HuggingFace API integration for voice downloading.
  • audio_exporter.py & srt_generator.py: Formatting handlers.

---

Contributing

We welcome all contributions! If you have ideas for new features, bug fixes, or improvements:

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

For any major updates or architectural changes, please submit a Pull Request so we can review it together!

---

Open Creators Box is built for professionals who value speed, privacy, and flawless execution.