Skip to content

Home

Jump to bottom
tim000x3 edited this page Nov 12, 2025 · 10 revisions

CommercialBreaker & Toonami Tools

Welcome to the comprehensive documentation for CommercialBreaker & Toonami Tools - the ultimate solution for recreating the authentic Toonami experience with your anime collection.

What is this project?

CommercialBreaker & Toonami Tools automate a continuous Toonami marathon by intelligently inserting commercial breaks into anime episodes and organizing them with authentic Toonami bumps. The tools slice up your anime, add nostalgic commercial breaks, and create seamless marathon experiences that feel just like those late-night Toonami sessions.

Key Features

  • CommercialBreaker: Intelligently detects and creates commercial break points in anime episodes
  • Cutless Mode: Preserve original files while adding virtual commercial breaks
  • ComBreakDirect: Self-contained continuous MPEG-TS streaming server with beautiful WebUI - no DizqueTV or Tunarr required
    • Studio → FIFO → Broadcast FFmpeg → BroadcastTower architecture for true broadcast streaming
    • Truly continuous streams with seamless program transitions (Broadcast FFmpeg's +genpts prevents freezing)
    • Multi-client support - watch on multiple devices simultaneously
    • Toonami-themed web interface with setup instructions and copy-to-clipboard URLs
    • Configurable audio track selection (defaults to English for Toonami dubs)
    • HDHomeRun emulation for Plex & Jellyfin DVR integration
  • Toonami Tools: Generate custom lineups with authentic bump integration
  • Multiple Interfaces: GUI (TOM), Web UI (Absolution), and CLI (Clydes)
  • Multi‑Network Support: Not just Toonami — switch the active network from the Advanced settings in TOM/Absolution or at Clydes startup. Includes Networkless mode to bypass Wikipedia validation and use any custom content collection
  • Platform Support: Works with DizqueTV, Tunarr, or self-hosted ComBreakDirect
  • Plex Integration: Seamless integration with your existing Plex library and HDHomeRun-style discovery

Quick Start

  1. Installation Guide - Get up and running quickly
  2. User Guides - Choose your interface and start creating
  3. Configuration - Customize your setup

Documentation Sections

User Documentation

Technical Documentation

Reference Materials

Project Structure

The project is organized into several key directories, each serving a specific purpose:

CommercialBreaker/
├── main.py                 # Entry point - selects which interface to run
├── API/                    # Core application logic and orchestration
├── GUI/                    # Graphical User Interfaces (TOM, Absolution)
├── CLI/                    # Command-Line Interfaces (clydes)
├── ComBreak/               # Commercial detection and processing tools
├── ComBreakDirect/         # Self-hosted continuous MPEG-TS streaming server
│   ├── ComBreakDirectServer.py  # Flask application
│   ├── docks/             # Core processing modules (Loading, Factory, Unloading)
│   ├── utilities/         # BroadcastTower, audio selection, pre-rendering
│   └── UI/                # WebUI with landing page
├── ToonamiTools/           # All the tools for Toonami channel creation: Plex integration, media/bump handling, lineup scheduling, and platform deployment
└── ExtraTools/             # Case Use tools and utilities

Getting Help

  • FAQ - Check common questions first
  • Troubleshooting - Solve specific issues
  • Discord: Join our community
  • GitHub Issues: Report bugs and request features
  • ChatGPT: Give all these documents and a link to the repo to ChatGPT for assistance

Contributing

See our Developer Guide for information on contributing to the project.

"Until next time, Space Cowboy!"

Clone this wiki locally