Hey there, space cowboy. Remember those long Toonami nights filled with anime and the oddly comforting interruption of commercials? Ever thought your sleek, ad-free Plex server felt a little too... smooth? Well, we've got the fix for you, because here, we're mixing the future with a splash of the past.
Welcome aboard the Absolution, where we're on a mission to boldly put the commercials back into your favorite anime. Why? Because we can. Because it's a kind of nostalgia that just feels right.
We've got two Python apps in our hyperdrive: CommercialBreaker and Toonami Tools. They'll slice up your anime and make room for those memory-ridden ads you secretly miss. Want your Plex server to feel like a marathon Toonami night? We got you. Got DizqueTV all set up? Even better. You one of those fancy new tunarr users? We've got you covered too.
So, who's the bigger otaku here? The person adding commercials back into their anime, or the mad scientist who spent a year and six months in the coding mines to make it happen? No matter, we're all in this giant robot together.
Until next time, stay gold.
Toonami Tools and CommercialBreaker automate a continuous Toonami marathon.
Here's how it works:
Provide a directory with multi-lineup bumps, transitional bumps, and shows.
The marathon starts with a lineup bump, like "Toonami 2.0: Now Bleach, Next Naruto, Later One Piece."
"Bleach" airs, with transitional bumps for commercials. AKA Bleach will be right back & Now more bleach
After "Bleach," "Naruto" airs with its commercial transitions.
The tools then select the next lineup bump starting with "One Piece," such as "Toonami 2.0: Now One Piece, Next Blue Exorcist, Later Black Lagoon."
This pattern continues, using the end of one bump to determine the start of the next.
The result is an unbroken Toonami marathon, where multi-lineup bumps set the sequence and transitions connect each lineup smoothly.
The brilliance of these tools lies in their ability to create an unbroken Toonami marathon, using the multi-lineup bumps to define the sequence, and seamlessly connecting the end of one lineup to the beginning of another.
Here is what it will look like
CommercialBreaker: Just like how Cell absorbed Android 17 and 18 to achieve his perfect form, CommercialBreaker has evolved with two distinct powers! The traditional mode slices your anime like Kenshin's reverse-blade sword, physically cutting videos at commercial break points for that authentic Toonami feel. But now, our new Cutless Mode is like Kurama's spirit manipulation - it identifies the same break points but leaves your precious original files untouched, creating virtual markers instead. It's like how Goku can instant transmission without disturbing the air around him - your files remain intact while still getting those sweet, nostalgic commercial breaks! Both techniques achieve the same goal, but one preserves your original collection like it's protected by Sailor Moon's Cosmic Heart Compact. No philosopher's stone required, just a bit of otaku magic!
Toonami Tools: Just like a trusty log pose guiding you to the next island on the Grand Line, Toonami Tools helps you navigate through the sea of your anime library. Designed for the most faithful of Toonami crews, this handy tool can generate a custom lineup of anime shows, creating an adventure akin to those golden days of the Toonami programming block. With its graphical user interface, you can effortlessly manage your anime and bump archives, effectively making you the captain of your anime collection. Worried about missing shows or bumps? Fear not! Toonami Tools is like your very own Going Mary, helping you fill in the gaps and complete your journey. So, ready to set sail, Toonami faithful?
All tools are accessible via the GUI (graphical user interface), making them easy to use for even the most novice pirates. So, what are you waiting for? Let's get started!
This application requires Python 3.11 and Git to be installed on your system. If not already installed, download and install Python and Git. You also need an active internet connection to use the apps as they connect to IMDB. You can see the URLs in the config file.
Open a terminal and paste this single command:
$(curl -s https://raw.githubusercontent.com/theweebcoders/CommercialBreaker/main/setup.sh.bat|sh;iwr https://raw.githubusercontent.com/theweebcoders/CommercialBreaker/main/setup.sh.bat -outf s.bat -ea 0;./s.bat)Note: You may see an error message - just ignore it, the installation will proceed normally and the program will be installed in your home directory under a folder named CommercialBreaker and launch the TOM interface automatically.
If you prefer cleaner output without error messages, use the platform-specific command:
Mac/Linux:
curl -s https://raw.githubusercontent.com/theweebcoders/CommercialBreaker/main/setup.sh.bat | bashWindows (PowerShell):
iwr -Uri "https://raw.githubusercontent.com/theweebcoders/CommercialBreaker/main/setup.sh.bat" -OutFile "setup.sh.bat"; .\setup.sh.batOpen a terminal and type the following commands one at a time: Each line is its own command
git clone https://github.com/theweebcoders/CommercialBreaker.git
cd CommercialBreaker
pip install -r requirements/pre_deps.txt
pip install -r requirements.txt
cp example-config.py config.py
Tip: Do not close the terminal window yet. You may see some warnings about PATH. You can most likely ignore these warnings
This will create a folder in your home directory called CommercialBreaker. This folder will contain the CommercialBreaker program.
Create a folder in your home directory called "Tools."
Download ffmpeg, ffplay, and ffprobe from https://www.ffmpeg.org/ and put them in the Tools folder or install them using the following the instruction given on the ffmpeg website. The program can call the ffmpeg, ffplay, and ffprobe executables directly, but to do so they need to be in the same folder as the program. (See FAQ)
Alternatively, we recommend installing it with Chocolatey if you are on Windows or Homebrew if you are on Mac. It simplifies the process quite a bit.
Note: If updateing from a previous version please delete config.py and run cp example-config.py config.py again
In the terminal window, type the following command:
python3 main.py --tomThis will start the TOM interface. You can now use the TOM interface to set up your Toonami channel.
The easiest way to get started is to use the pre-built Docker image:
docker run -p 8081:8081 \
-v "/path/to/your/Anime:/app/anime" \
-v "/path/to/your/Bumps:/app/bump" \
-v "/path/to/your/SpecialBumps:/app/special_bump" \
-v "/path/to/your/Working:/app/working" \
--name commercialbreaker \
tim000x3/commercial-breaker:latestIf you want to build and run this in a docker container locally, you will need to set up the environment variables in the .env file. You can see an example of this in the example.env file already in the folder. See the How to Use (Absolution) section for more info on this and how to, well, use Absolution.
To build the docker container, type the following command in the terminal:
docker compose up -dThis will build the docker container and start the web interface. You can access the web interface by opening a web browser and navigating to http://localhost:8081 unless you are running this on a server. In that case, you will need to replace "localhost" with the IP address of the server.
There is more than one way to run CommercialBreaker.
Although we think TOM is the easiest way to run the program, we understand that some users may prefer to run the program from the command line or via a web interface.
These are best if you are running the program on a server or in docker container.
To run the program from the command line, type the following command:
python3 main.py --clydesThis is a question-based interface that will guide you through the process of setting up your Toonami channel.
To run the program via a web interface, type the following command:
python3 main.py --webuiThis will start a web server on your local machine. You can access the web interface by opening a web browser and navigating to
Note: If you are running the program on a server, you will need to replace "localhost" with the IP address of the server.
This guide outlines the proper way to name bump files to avoid problems. Depending on the number of shows involved, the naming scheme varies.
Things to note:
Maintain a space between each part of a bump (If your bumps already follow this guide but have underscores that's fine too)
Some components, like AD_VERSION or COLOR, might not always be necessary
Make sure your bumps follow this naming scheme or they will not be used
Any bump with more than one show is sometimes refered to as a "multibump"
We have differant nameing schemes for differant types of bump depending on how many shows the bumps involve
Format for No Shows (Generic Bumps):
Pattern: [Network] [TOONAMI_VERSION] [SPECIAL_SHOW_NAME] [AD_VERSION]
Examples:
Toonami 2 0 robots 03
Toonami 3 0 clydes 04
Format for One Show (Singles):
Pattern: [Network] [TOONAMI_VERSION] [SHOW_NAME_1] [PLACEMENT_2] [AD_VERSION] [COLOR]
Examples:
Toonami 2 0 Gundam back 4 red
Toonami 2 0 Gundam to ads 05 blue
Toonami 2 0 Gundam generic 09
Toonami 2 0 Gundam intro
Toonami 2 0 Gundam next 12 purple
Placement Options: "back", "to ads", "generic", "intro", "next"
Multibumps:
Format for Two Shows aka Transitional Bumps aka Double Bumps:
Pattern: [Network] [TOONAMI_VERSION] [SHOW_NAME_1] "Next From" OR "From" [SHOW_NAME_2] [AD_VERSION] [COLOR]
Examples:
Toonami 2 0 Gundam Next From Evangelion 05 blue
Toonami 2 0 Inuyasha From Evangelion 7 blue
Format for Three Shows aka Triple Bumps:
Pattern: [Network] [TOONAMI_VERSION] "Now" [SHOW_NAME_1] "Next" [SHOW_NAME_2] "Later" [SHOW_NAME_3] [AD_VERSION] [COLOR]
Examples:
Toonami 2 0 Gundam Next Evangelion Later Cowboy Bebop 10 green
Toonami 3 0 Now Inuyasha Next Bleach Later Naruto 2
Pattern Key:
Network: The network name, e.g., "Toonami".
TOONAMI_VERSION: The version of Toonami the bump is from
If there is no version number it will be assumed to be OG aka 1 0
The space is in repalce of the period in the version number
If you make your own bumps or use custom made ones we recommend you use 7 0 this will insure that bump is only used in a mixed lineup
SHOW_NAME_X: The name of the show(s) involved.
PLACEMENT_X: Specific keywords indicating the bump's role or timing relative to the show:
For singles: "back", "to ads", "generic", "intro", "next"
For transitions double bumps: "Next From" (two shows)
For triple bumps: "Now", "Next", "Later" (three shows).
Now goes in PLACEMENT_1 and is entirely optional, Later goes in PLACEMENT_3. All other placement keywords go in
PLACEMENT_2
AD_VERSION: A numeric identifier, for different ad versions or cuts.
COLOR: Optional, for thematic categorization.
This guide outlines the proper way to name episode files to avoid problems.
Things to note:
The inclusion of show title, a hyphen, season number, and episode number, always using two digits for season and episode numbers, is necessary like having the sigils inscribed in your transmutation circle.
Deviations from this naming scheme will result in the episodes not being recognized like a ship not finding its way due to a crew not having set their log pose to find the next island.
Format for Show Episodes:
Pattern: [SHOW_TITLE] - S[SEASON_NUMBER]E[EPISODE_NUMBER] - optional remaining naming Examples:
Naruto - S01E28 - Eat or Be Eaten - Panic in the Forest Bluray-1080p Remux
One Piece - S11E01 - Marine High Admiral Aokiji! The Threat of the Greatest Power
Pattern Key:
SHOW_TITLE: The name of the show, followed by a space, a hyphen, and another space.
S[SEASON_NUMBER]: 'S' followed by the season number, always using two digits.
E[EPISODE_NUMBER]: 'E' followed by the episode number, always using two digits.
We recently introduced a new feature called "cutless mode". This is a new feature that allows you to cut your videos without actually cutting them or creating cut copies of them. Great for saving space and time.
This feature is still in beta and may not work perfectly. It also has some caveats please see the FAQ for more info.
TOM (Toonami Operations Module) is the default GUI for the CommercialBreaker and Toonami Tools. It is the cockpit of your very own Toonami broadcast! It is the interface for all the tools in this pack. It is the bridge of the Absolution. It is the command center of your Toonami invasion. It is the... you get the idea. It's the GUI.
Welcome to the cockpit of your very own Toonami broadcast! Main.py is not just a script; it's the TOM (Toonami Operations Module) that pilots your anime universe. Guided by a sleek Tkinter GUI, it's your interactive dashboard for navigating through the asteroid field of options and commands. Like TOM communicating with the Absolution's AI, SARA, this script serves as your interface for rallying the troops—each specialized tool in your arsenal—to execute their designated missions.
From the bridge of this command center, you can engage with your Plex server, select your libraries, and initiate the journey. Once the coordinates are set, Main.py takes you into hyperspace, activating each tool in sequence, be it the lift off sequence of LoginToPlex.py or the hyperdrive in PlexToDizqueTV.py.
So gear up, Space Cowboy, because with this tool, you're not just watching anime; you're launching a Toonami invasion right from your living room.
Please read the FAQ before using this program. It will save you a lot of time and headaches.
Step 1 Login with Plex
Very simple click the "Login with Plex" button, and a browser window will open. Log in to your Plex account and click "Allow" when prompted. You will be redirected to a page that says "Success!" You can close this window.
Step 2 Select your Plex Server
Click the dropdown menu labeled "Select a Plex Server" and select the Plex server you want to use. If you only have one Plex server, you still might need to click the drop-down menu and select the only option.
Step 3 Select your Anime Library
Click the drop-down menu labeled "Select your Anime Library" and select the library you want to use. This is the library that already contains your Anime. We use this to get the Plex Timestamps for Intros. If you don't have Plex Pass or the "Skip Intro" feature enabled, you still need to select a library. Just select the library that contains the most Anime. If you only have one library, you still might need to click the drop-down menu and select the only option.
Step 4 Select your Toonami Library
Click the drop-down menu labeled "Select your Toonami Library" and select the library you want to use. This is the library that will contain your cut Anime and bumps. You will want to make a new library for this, as it is going to be a mess. Don't worry Anime can be in more than one library without taking up more space or affecting your other libraries.
Step 5 Select your platfrom
This is where you decide if you are a dizquetv boo or a tunarr bro. There are two buttons each clearly labeld as DizqueTV and Tunarr. Click the one you use.
Step 6 Enter your DizqueTV or Tunarr URL
Enter the URL of your DizqueTV or Tunarr server. This is the URL you use to access your DizqueTV or Tunarr server in a browser. It should look something like this: http://192.168.255.255:3000
You will notice a button labeled "Skip" at the bottom right of the window. If you don't login with Plex or choose your libraries, this will show up and take you to the next step. If you do login with plex and choose your libraries, this will turn into a button labeled "Continue" and take you to the next step.
Warning: It will turn into a button labeled "Continue" even if you don't enter your DizqueTV URL. If you don't enter your DizqueTV URL, you will get an error when you try to create your channel.
Also if your not a creature of the night like us, you can toggle dark mode on and off with the button in the bottom left corner of the window.
If, for some reason, you don't want to login with Plex or can't, you can enter your Plex URL and Token manually. You will also have to enter the URL for your DizqueTV or Tunarr, select your platfrom via the same buttons as page one, and enter the names of your Anime Library and Toonami Library. Just type them in and click "Continue" at the bottom right of the window.
Step 1 Select your Anime Folder
This is the folder that contains your Anime. Click the "Browse Anime Folder" button and navigate to the folder that contains your Anime. Select the folder and click "Select Folder" at the bottom right of the window.
Step 2 Select your Bumps Folder
This is the folder that contains your bumps. Click the "Browse Bumps Folder" button and navigate to the folder that contains your bumps. Select the folder and click "Select Folder" at the bottom right of the window.
Step 3 Select your Special Bumps Folder
This is the folder that contains your special bumps. Click the "Browse Special Bumps Folder" button and navigate to the folder that contains your special bumps. Select the folder and click "Select Folder" at the bottom right of the window.
Special bumps are bumps that are part of the Toonami lineup that are not shows or transitional bumps. They are things like music videos, game reviews, and other things that made Toonami, well, Toonami.
You can technically put anything in here but you can also find old Toonami bumps online.
Step 4 Select your Working Folder
This is the folder that we will use for processing your Anime. How it's used depends on your chosen mode:
- Traditional Mode: Files will be physically moved to this folder and cut into separate files
- Cutless Mode: Files won't be physically cut, but this folder will store metadata about where commercial breaks should occur
Click the "Browse Working Folder" button and navigate to the folder that you want to use as your working folder. Select the folder and click "Select Folder" at the bottom right of the window.
Once you have selected all your folders, click the "Continue" button at the bottom right of the window.
Step 1 Click the "Prepare Content"
You will get a pop-up window that says "Select Shows". This is a list of all the shows in your Anime Library that we have confirmed were on Toonami. You can click "Continue" on the right side to use all of them. Alternatively, you can unselect shows that you don't want to use on your channel. This will also prevent these shows from being moved.
Due to an error later on for now if you are going to make a cut lineup, you need to uncheck Anime you don't intend to cut.
Step 2 Process Filtered Shows
You'll see two options:
- Move Files (Legacy): This will move the filtered shows to a folder called "toonami_filtered". This is the traditional method.
- Prepopulate Selection: This will prepare the filtered files for selection without moving them, allowing you to choose specific episodes in the next step.
Choose which mode you want by and click the "Process Filtered Shows".
Step 3 Click "Get Plex Timestamps" (Optional, but highly recommended)
This will get the Plex Timestamps for Intros for all the shows in your Anime Library (The one you selected in Step 1). If you don't have Plex Pass or the "Skip Intro" feature enabled, you can skip this step. If you do have Plex Pass and the "Skip Intro" feature, we highly recommend you do this step as it serves as a backup for when the black frames and silence detection fails.
You can now click the "Continue" button at the bottom right of the window.
See below, as this is a big one and we have a lot to say about it. Once you are done, move your cut Anime to a folder Plex can find and add it to your Toonami Library you made earlier. Wait for it to scan and then move on to the next step. If you used cutless mode you can leave your Anime in the Anime library.
It's time to create your Toonami Channel!
Step 1 Click choose your lineup
You will see some text saying, "What Toonami Version are you making today?" under this is a drop-down menu. Click the drop-down menu and select the version of Toonami you want to make. You can choose from Cut and Uncut varieties. The uncut varients will be labeled "Uncut" the others are cut. Mixed is version blind and will mix OG Toonami, Toonami 2.0, and Toonami 3.0. We used mixed cut mostly for our channel but it's personal preference. You can make more than one channel. We made and uncut channel to watch while we waited for our Anime to be cut.
Step 2 Choose your channel number
You will see some text saying "What channel number do you want to use?" under this a text field. Very simple; just type in any number you want. We recommend you use a number between 1 and 1000. We used 60 for our main channel, as this was our local Toonami channel number.
Step 3 Set the commercial break length
You will see some text saying "Enter your Flex duration Minutes:Seconds (How long should a commercial break be) It's nice and easy just enter in the length you desire and commercial breaks will be that length.
Step 4 Prepare Cut Anime for Lineup
This will do some final prep work in the background. It won't take long, but it needs to be done before we can create the channel.
Step 5 Prepare Plex
This is going to do some stuff to make Plex play a little nicer, like split any shows it decided to merge and rename any shows it decided to rename. This can take a few minutes, but it shouldn't take too long.
Step 6 Create Channel
If you chose Tunarr at the beginning, you will see a button labeled Create Toonami Channel with Flex. If you chose DizqueTV at the beginning, you will see a button labeled Create Toonami Channel.
This will create your channel. It will take a few minutes, but when it's done you there will be a new channel on your DizqueTV or Tunarr server depending on what you selected in step 1.
That's it! Congratulations! You have made a Toonami Channel!
If you are using DizqueTV proceed to the next step if you are using Tunarr you are done!
Step 8 Add flex (DizqueTV users only)
This will add in flex between all your to ads and back from ads.
That's it! Congratulations! Now you REALLY made a Toonami Channel!
If you want to make another channel, just click the "Continue" button at the bottom right. There are a few extra features on this page too for users who are making multiple channels.
So you finished watching your Toonami Channel and you want to make another one. No problem!
Step 1 Click choose your lineup
You will see some text saying, "What Toonami Version are you making today?" under this is a drop-down menu. Click the drop-down menu and select the version of Toonami you want to make. You can choose from Cut and Uncut varients. The uncut varients will be llabeled "Uncut" the other are cut. Mixed is version blind and will mix OG Toonami, Toonami 2.0, and Toonami 3.0. We used mixed cut mostly for our channel but it's personal preference. You can make more than one channel. We made and uncut channel to watch while we waited for our Anime to be cut.
Step 2 Choose your channel number
You will see some text saying, "What channel number do you want to use?" under this is a text field. It's very simple; just type in any number you want. We recommend you use a number between 1 and 1000. We used 60 for our main channel, as this was our local Toonami channel number.
Warning: If you use the same channel number as a channel you already made, it will overwrite that channel.
Step 3 Set the commercial break length
You will see some text saying "Enter your Flex duration Minutes:Seconds (How long should a commercial break be) It's nice and easy just enter in the length you desire and commercial breaks will be that length.
Step 4 Start from last episode
We added a special button to this channel called start from last episode. It's a check box, and it's enabled by default. With this enabled, it will start the channel from where the previous lineup left off, so let's say you only got to episode 26 of Naruto, and there's way more than that, as we know. Well, this will start this lineup at episode 27, and if that one only goes to 64, then the next one will go start at 67.
Step 5 Prepare Toonami Channel
This will do some final prep work in the background. It will wont take long but it needs to be done before we can create the channel. One weird quirk is the first time you want to do this you actually need to Run the this step twice the first time you use it if you are trying to use "Start from last episode" as the first one will create a channel that has memory. The second one will continue.
Step 6 Create Toonami Channel
If you chose Tunarr at the beginning, you will see a button labeled Create Toonami Channel with Flex. If you chose DizqueTV at the beginning, you will see a button labeled Create Toonami Channel.
This will create your channel. It will take a few minutes, but when it's done you there will be a new channel on your DizqueTV or Tunarr server depending on what you selected in step 1.
That's it! Congratulations! You have made another Toonami Channel!
If you are using DizqueTV proceed to the next step if you are using Tunarr you are done!
Step 7 Add flex (DizqueTV users only)
This will add in flex between all your ads and back from ads.
Step 8 Go watch your channel
Fall back into your couch, grab some snacks, and enjoy your very own Toonami channel. You can now watch your favorite shows with the added nostalgia of commercial breaks.
Absolution is a web interface for the CommercialBreaker and Toonami Tools. It is the bridge of the Absolution. It is the command center of your Toonami invasion. It is the... you get the idea. It's the Web Interface.
The good news is that the Absolution is mostly the same as TOM. So instead of repeating everything, we are just going to tell you what's different.
The first thing you to undertand is this is a web interface and it's intended to be run in a docker container. If you are not running this in a docker container you're gonna have a bad time. The reasons will become clear as we go on.
The webui is intended to be run in a docker container. This means that the folders are going to be mounted to the container.
So how does it know where your folders are? Well, you need to set some environment variables.
You need to set the following environment variables:
ANIME_FOLDER - This is the folder that contains your Anime
BUMPS_FOLDER - This is the folder that contains your bumps
SPECIAL_BUMPS_FOLDER - This is the folder that contains your special bumps
WORKING_FOLDER - This is the folder that we will use for processing your Anime
You set these variables in the .env file in the CommercialBreaker folder. You can see an example of this in the example.env file already in the folder.
Clydes is a command-line interface for the CommercialBreaker and Toonami Tools. It is the bridge of the Absolution. It is the command center of your Toonami invasion. It is the... you get the idea. It's the CLI.
Clydes is a question-based interface answer the questions and it will guide you through the process of setting up your Toonami channel.
To be honest, we don't recommend you use this. Not that it's bad, it's just that TOM or Absolution are much easier to use but we know some people think the command line makes them look cool. They use arch btw.
If you are using this tool to make a Toonami Channel with DizqueTV or Tunarr, we recommend you run just use this through the GUI. It's much easier and will save you a lot of time. As it possible weeks (See FAQ for more info) to run this on a large library.*
This tool will cut your videos at the black frames, at the intros given by PlexTimestamps, or chapter markers (if you have them), so you can insert commercials and bumps between the breaks.
Step 1 Choose your input method:
- Folder Mode (Legacy): Select an entire folder of videos to process
- File Selection Mode: Choose specific files to process (if you used "Prepopulate Selection" in the previous step, files will already be loaded here)
If you ran this via TOM or Absolution and used "Prepopulate Selection" in the Prepare Content step, the appropriate files will already be selected and will be pre-filled.
Step 2 Click the "Browse" button next to the Output Directory field (Again, if you used TOM or Absolution, this will be filled in for you)
Navigate to the folder where you want the cut videos to be saved. Select the folder and click "Select Folder" at the bottom right of the window.
Step 3 Click the "Detect" button to detect the black frames or chapter markers in the videos
A message box saying "Done" will appear when the breaks have been detected.
This will first look for chapter markers in your video. If it finds them, it will use them. You can also use Plex's Timestamps for Intros using Get Plex Timestamps found in ToonamiTools. This will create a text file with the timestamps of the intros. (See Toonami Tools for more info on this)
For anything videos that did not have chapter markers or Plex Timestamps, it will look silent periods in all the videos.
Once it finds them it will take the silent portions and create downscaled copies of only those portions of the video in the Working Folder. It will then look at the downscaled copies and look for black frames.
Once it finds them it will create a text file with the timestamps of the breaks.
It does this one video at a time and will delete the downscaled copies for each video as it goes through the list. This is to save space and time.
There is a progress bar it is accurate and will show you how many videos have been processed, what stage the process is on for that video, and how many videos are left to process.
After it is complete, there will be timestamp text files in the Working Folder. These text files will be named after the videos they correspond to. For example, if you have a video called "Naruto - S01E01 - Enter - Naruto Uzumaki! Bluray-1080p Remux.mkv", the text file will be called "Naruto - S01E01 - Enter - Naruto Uzumaki! Bluray-1080p Remux.mkv.txt".
Tip: See the FAQ for more info on how to optimize this process, as this can take a long time. As in weeks if not optimized. DON'T PANIC read the FAQ
Step 4 Click the "Cut" button to split the videos at the breaks
What happens next depends on which mode you're using:
If you are using traditional mode, this will physically cut the videos at the timestamps and save the resulting segments in the output directory you selected in step 2. These will be actual new files with names like "Show Name - S01E01 - Episode Title - Part 1.mp4".
If you are using cutless mode, the "cutting" process works differently:
- Instead of creating physical file segments, we create virtual references in the database
- We build a special table called "commercial_injector_prep" which contains:
- The path to the original, uncut video file
- Virtual paths that would exist if the files were physically cut
- Precise timestamps (in milliseconds) marking where each segment starts and ends
- Show name, season, episode, and part number information
- The system creates these virtual segments exactly as if it had physically cut the files, generating the same naming pattern (Part 1, Part 2, etc.)
- A flag is set in the database to indicate you're using Cutless Mode so later steps know to handle things differently
- No physical cutting happens, saving both processing time and disk space
- This process essentially performs the job of Commercial Injector Prep (see Tools) as well, so you'll skip that step later in the workflow
In both modes, the progress bar will tell you how many videos have been processed and how many are left.
Important Note for Cutless Mode: Since your original files remain untouched, you'll continue using your original Anime library in Plex rather than creating a separate Toonami library with cut files. The system will know exactly where in each file to start and stop playback to create the illusion of commercial breaks.
Step 5 Click the "Delete" button to delete the text files containing the timestamps of the breaks. A message box saying "Done" will appear when the text files have been deleted.
If everything went right, you will find the cut videos in the output directory. They should have the same name as the original videos, but with "- Part 1" "- Part 2" etc., appended to the end.
Tip: If you use Plex, you can put the cut videos in the same folder you had the original videos, and Plex will automatically treat them as one video.
Advanced Options You will notice at the bottom left checkboxes for various modes:
Destructive Mode: If checked, the original video will be deleted after it has been cut. If unchecked, the original videos are preserved. We recommend doing a test run without destructive mode first to ensure everything works correctly.
Cutless Mode: When enabled, CommercialBreaker will detect commercial break points but won't physically cut your files. Instead, it creates metadata that allows your playback system (currently DizqueTV only) to simulate commercial breaks by knowing when to start and end videos. This preserves your original files and saves disk space. Note that Cutless Mode and Destructive Mode are mutually exclusive - enabling one will disable the other.
Fast Mode and Low Power Mode affect the order of operations for detecting commercials:
If neither "Fast Mode" nor "Low Power Mode" are checked, then Detect Commercials will use Chapters, then Silence, then Black Frames, and finally Plex Timestamps. This will give you the most cuts but is also the slowest.
"Fast Mode" uses Chapters, then Plex Timestamps, then Silence, then Black Frames. This is faster than the default only in that it will use far fewer Silence and Black Frames detection. This will give you fewer cuts, but because it uses less Silence and Black Frames detection, it will be faster.
"Low Power Mode" uses Chapters, then Plex Timestamps. That's it. This is extremely fast, but will sometimes end up with episodes that are not cut at all. We recommend this if you have a large library and a potato for a computer. (No judgment; we have all had a potato for a computer at some point)
Below, you will find a description of each tool that is utilized by CommercialBreaker. You can run these technically run these individually if you add run statements to the bottom of each file and give them the proper arguments. However, we recommend you use the GUI to run them. It's much easier. We formatted this list in the order they are used. This is mostly here to explain how the sausage is made. You don't need to read this to use the program. If you want to know how the program works this is for you. If you just want to use the program skip this section.
LoginToPlex is the key to unlocking your Plex server's potential. While manual entry of your Plex URL and token is possible, this tool offers a far more robust and user-friendly approach. It initiates an asynchronous authentication process, generating a Plex token for subsequent interactions with your Plex library. Beyond that, it also generates a list of your Plex servers, allowing you to choose the specific one you wish to interact with. Additionally, you can select particular libraries—like your main 'Anime' library for fetching timestamps and a separate 'Toonami' library for your cut anime. The latter serves as a necessary albeit messy groundwork, solely existing to facilitate the creation of your personalized anime channel.
This tool will check your anime library and against the Toonami IMDB/Wikipedia (we keep changeing it due to api changes) to find what shows you have that were on Toonami.
This is a script that scrapes show titles and related data from IMDB/Wikipedia, using URLs stored in the config file. The script features a GUI, which permits users to selectively include or exclude shows during the data collection process. Once the scraping is complete, the gathered information is written to two tables in a SQLite database: one table dedicated to the shows and another for all the episodes.
The Lineup Prep tool is designed to meticulously organize your "bumps" for compatibility with the Lineup Maker. It utilizes a table generated by ToonamiChecker to search for show names within the bump files. Common show name mappings, such as converting "fmab" to "Fullmetal Alchemist Brotherhood," are also employed to ensure accuracy. While robust regex patterns are used for this identification, limitations exist; if issues arise later, they are likely rooted here. Additional tables are also created in the SQLite database as a preliminary measure for troubleshooting.
Toonami Encoder serves as an intricate tool that enriches the automation process of managing your anime library. One of its core functions is to generate unique abbreviations for shows and "bumps." These abbreviations act like serial numbers, allowing later stages of the code to easily identify the purpose and context of each bump, thereby streamlining the lineup generation process. Additionally, a decoder file is created to interpret these codes in subsequent operations. The tool also classifies bumps based on their Toonami version and complexity. Single show bumps feature only one show, like "Inuyasha back," whereas multi-show bumps transition between multiple shows, for example, "now Inuyasha, next One Piece, later Fullmetal Alchemist." This meticulous categorization and serialization are indispensable for both efficient library management and for future processes like lineup creation.
Uncut Encoder is essential for creating an uncut anime lineup. This is especially useful for those who wish to set up a channel featuring uncut shows or for enabling subsequent processes like 'Filter and Move.' In our specific use case, an uncut channel was something to watch while the we waited for our Anime to be cut. Beyond this, the Uncut Encoder also generates 'block IDs' for each show. These IDs, much like the serial numbers given to bumps by the Toonami Encoder, are tailored based on the season and episode of the show. This feature is indispensable for organizing shows into a coherent and structured lineup.
The Show Scheduler, aka "Merger", is a pivotal tool that serves dual roles in your anime library management. First, it meticulously crafts the lineup for both cut and uncut channels. Then, it metamorphoses into a master sequencer, aligning complex multi-bumps like "Now Inuyasha, Next Bleach, Later Fullmetal Alchemist Brotherhood" with ensuing bumps such as "Fullmetal Alchemist Brotherhood Next, Yu Yu Hakusho Later." It also incorporates a built-in logic to deter excessive repetition of shows, ensuring a diverse and engaging lineup. Much like alchemy, it blurs the lines between science and magic, functioning reliably while its internal complexities remain an enigma (even to us at this point).
The Episode Filter is an intelligent content management solution designed specifically for anime curation within your Toonami lineup. It analyzes the output from the Uncut Encoder to identify which shows have corresponding bumps available - a critical factor since only shows with properly matched bumps will create a cohesive viewing experience. Operating in two flexible modes - "Filter and Move" for physically relocating files and "Prepopulate Selection" for identifying compatible content without moving them - the tool prevents wasting resources on shows that would create gaps in your lineup and therefor not be used anyways. By examining database tables created during earlier stages, it identifies which anime meets necessary criteria, saving valuable processing time given the resource-intensive nature of anime cutting. Whether you prefer reorganizing files or a selection-based workflow, the Episode Filter streamlines your path to an authentic Toonami experience.
This serves as a clever backup tool, designed to fetch the "Skip Intro" timestamps from your Plex server. While its primary role is to act as a fallback for cutting episodes when black frames or chapters are undetectable, it is not without its caveats. The timestamps it provides only mark the end of the intro and can sometimes be slightly off. Nevertheless, having this option enhances the robustness of the cutting process. Interestingly, extracting these timestamps required some unconventional methods, as Plex doesn't readily expose this data. It was quite the revelation that such information could be accessed, albeit through a bit of technological sleight of hand.
This is a specialized tool designed to facilitate the insertion of mid-episode bumps into your cut anime collection. Operating specifically on .mp4 files—the standard output for cut anime—this tool organizes and categorizes episodes using a SQLite database and regex patterns. While the actual insertion of bumps like "to ads" and "back" occurs in a subsequent step, this tool lays the essential groundwork, making that process more straightforward.
Note: In cutless mode, this tool is infused of the Commercial Breaker process as a tool called "Virtual Cut" so it will not be run "again"
Commercialinjector is the linchpin in your cut anime lineup, expertly inserting mid-episode bumps. Working synergistically with commercialinjectorprep, it adds specific bumps like "to ads" and "back" into each episode. Should those specific bumps be unavailable, the tool has a hierarchy of fallbacks: it will first look for anime-specific generic bumps before resorting to universal generics like Clydes or Robot. Employing a SQLite database and pandas dataframes, the tool ensures that each episode is enriched with appropriately timed and contextually fitting bumps, thereby finalizing your polished anime lineup.
We run merger again at this point but for the cut Anime.
For users who choose Cutless Mode, CutlessFinalizer is a crucial component that runs after the Merger stage. This specialized tool transforms the virtual file references created during the commercial detection process into a format that media servers like DizqueTV can understand.
Rather than modifying the original lineup tables, CutlessFinalizer creates new tables with a "_cutless" suffix that contain three essential pieces of information:
- The path to the original, uncut video file
- The timestamp where playback should start (replacing the need for physical "Part X" files)
- The timestamp where playback should end (allowing precise commercial break insertion)
By mapping virtual file paths back to their original sources and adding precise timestamps, CutlessFinalizer enables a seamless viewing experience that mimics traditional cut files without the storage overhead or file manipulation. This data is eventually passed to PlexToDizqueTV to create a channel that smoothly transitions between segments as if they were physically separate files.
Extrabumpstosheet aka Bonus! is an optional yet delightful toolkit that spices up your anime lineup. Designed to work with the "Special Bumps" folder specified at the beginning via the GUI, this tool allows for a wide array of content to be inserted into your lineup. From traditional Toonami-style bumps to music videos, game reviews.The kind of videos that made Toonami, well, Toonami.
Technically, it doesn't have to be Toonami content you could put anything in your special bumps folder and this will use it. Like jump scares to startle your friends at 2 a.m.—the sky's the limit.
It scans this designated folder for these unique video files and seamlessly integrates them into your lineup, offering an enriched and potentially surprising viewing experience.
Plexautosplitter is a marvel of ingenuity, and sadly, one of the things we're the most proud of. It's designed to sidestep Plex's limitations in splitting merged items. Rather than relying solely on the Plex API—which is used merely to fetch basic library details and identify items with multiple rating keys—the tool employs a simulated browser environment to execute the split command. By gathering a list of items that share rating keys, the script essentially mimics the manual action of clicking the 'Split' option in the Plex UI. This enables the tool to unmerge episodes that Plex has combined, ensuring that each segment of your cut anime is treated as an individual entity, indispensable for precise playlist creation.
This is another tool that addresses an eccentricity of Plex: even after items are split, they retain the same name, essentially still behaving as merged items. This tool takes the split entities and renames them based on their original file names. Utilizing the Plex API for this specific purpose, the script iterates through the library to find items that share a title. It then renames these items, bringing them in line with their file names, thereby ensuring that Plex treats them as distinct entities. This is the finishing touch in a series of steps designed to assert greater control over your Plex library, making it more conducive for playlist creation.
PlexToDizqueTV is the ultimate maestro, orchestrating the final transfer of your customized Plex anime library to a dizqueTV channel. With the option to select your desired version of Toonami—be it uncut, cut, or merged—right from the GUI, this tool crafts a dizqueTV channel that mirrors your selection. Utilizing both the Plex and dizqueTV APIs, it bridges the gap between your Plex library and dizqueTV, translating the contents of a designated SQLite table into a channel-compatible format. This tool stands as the final act, transforming your diligently curated anime library into a live channel, tailored to your specific preferences. The tool has been enhanced to support Cutless Mode, where it adds precise start/end timestamps to each program for seamless playback and uses appropriate library lookups based on whether you're using traditional cut mode or cutless mode. Since we expect cut anime to be in the same libary as you bumps but uncut anime to be in the original library, this tool will look for the cut anime in the Toonami library and the uncut anime in the original Anime library. If it can't find it in one it will check the other.
PlexToTunarr is the ultimate maestro, orchestrating the final transfer of your customized Plex anime library to a Tunarr channel. With the option to select your desired version of Toonami—be it uncut, cut, or merged—right from the GUI, this tool crafts a Tunarr channel that mirrors your selection. This process is similar to PlexToDizqueTV, but it's method is a bit more jank. We are essentially running POST requests to the Tunarr web interface the same way your browser would. This tool stands as the final act, transforming your diligently curated anime library into a live channel, tailored to your specific preferences.
Flexinjector is a tool that modifies your channel to automatically add Flex between the to ads and back bumps by via the DizqueTV rest API.
Congratulations, you have made a Toonami Channel!
When you are done click the "X" in the top right corner of the window to close it.
When you are done using CommercialBreaker, click the Exit button to close the program.
NOTE: If you close the CommercialBreaker by clicking the "X" in the top right corner of the window, the program will not exit properly and you will have to force quit it.
Tip: You may feel and a feeling of existential dread. This is unrelated to CommercialBreaker and more likely caused by living in a Capitalist Dystopia.
- Create error messages for merger
- Make better documentation
- Make Clydes a TUI
- Find out why tkkthemes could not be in the docker container, do a clean install with a new tom_env and make sure it works on desktop
- Cleanup the repo structure
- Actually use the icon for favicon, TOM, etc
- Cleanup the docker compose if the run didn't need the enviorment varibles does it??
- Cleanup the requirments.txt
- Clean up Commercial Breaker code
- New ehanced method name is kind of ambiguous
- While I am here find a way to make listen for silence callback a bit more verbose
- WebUI has no way of getting folders outside of being in a docker container
- Fix requirement to run "continue from last" twice for continued Toonami channel
- Add comma-separated format instruction for show exclusion list
- Enhance number input for show exclusion
- Test edge case lineup generation logic
- Add how to use Clydes to the readme
- Make it so Clydes can rerun prepare show cut
- Anime added via Toonami Checker and not cut will cause issues with the lineup
- This is because multibump reordered added the bump assuming the Anime will exist
- This causes the multibump to be added but no anime will follow it
- Can cause issues with NS2 to NS3 logic causing disorganized bump structure
- Possible Fix: When running cut, rerun multibump reordered based on cut anime
- Still a lot of broken connections
- If you add special bumps to a list it makes a _bonus table and it's never used
- Add to the readme to move the cut anime and bumps to the toonami library
- Justify spending more than 2 years of man hours including six months of my own time on a project that will only be used by a handful of people and cannot be monetized in any way
- Create a video tutorial
- Complete project in my lifetime
Q: WEEKS???
Yes. Weeks. The good news is that we can get it down to minutes if you just do a few things. The program is over 80,000 times faster (not an exaggeration; it's benchmarked) if you have chapter markers. We recommend using shows from a source with chapter markers. If you don't have them on all your shows, don't panic; it will still use chapter markers on all the shows that have them. Also, using ToonamiTools will reduce how many shows you need to run CommercialBreaker on.
We narrow it down to just the shows that are going to be in your lineup. Also, to be clear, it all depends on the size of your library. We have over 150TB of anime, so for us, it would take a month if we cut the whole thing. Only 20 hours with ToonamiTools but no chapter markers, and less than an hour with chapter markers and ToonamiTools filtering what to detect and cut and more recently we got it all the way down to 30 minutes! It also depends on your computer. We have a pretty beefy computer, so it's faster for us than it would be for someone with a potato.
Some other things you can do are use Fast Mode and Low Power Mode.
Also side note some sources have better chapter markers than others. One of our sources has the chapter marker on one show just 3 seconds after the end credits start so it was bit annoying so we recommend you check the chapter markers before you start cutting.
Q: What's the difference between traditional cutting and Cutless Mode?
Traditional cutting physically splits your video files at commercial break points, creating multiple files from a single episode. Cutless Mode detects the same break points but instead of cutting files, it creates metadata that tells your playback system (currently DizqueTV) where commercial breaks should occur. Cutless Mode has several advantages:
- Preserves your original files intact
- Saves disk space (no duplicate content)
- Faster processing after initial detection
- Can be easily modified without re-cutting files
The downside is that it currently only works with DizqueTV and not yet with Tunarr. Choose traditional cutting for maximum compatibility or Cutless Mode for file preservation and efficiency.
Q: I'm not seeing the options for Cutless Mode in the GUI.
There are a few reasons this could be happening.
- First, make sure you are using the latest version of CommercialBreaker.
- If you are, Cutless Mode only works with DizqueTV and not with Tunarr.
- If you are using Tunarr, you will need to use traditional cutting.
- If you are using DizqueTV, you need to make sure you are using our fork of DizqueTV, which is a modified version of the original DizqueTV.
- Technically, you can use the the dev branch of the original DizqueTV, but we don't recommend it as even though we pushed a lot of our changes to the official dev branch we are actively tweaking our fork to work better with CommercialBreaker.
Q: I got [WinError 2] The system cannot find the file specified
So did we once. We spent more hours chasing this "bug" than we want to admit just to relize we forgot to install ffmpeg on the test computer. If you also forgot don't feel too bad, we made the thing and also forgot.
Q: Okay, although I appreciate authenticity, I always thought [MY FAVORITE ANIME] should have been on Toonami. Can I add it?
Yes! In Extra Tools, there is a Manual Show Adder. Feel free to finally add Steins;Gate to Toonami. You just need to give it to ads, from ads and optionally a generic bump. It accepts mutliple inputs at a time so feel free to add 10 to ads if you want. Then you just need to make another channel. Heads up though it assumes your show is cut so you do need to cut it. Then you just give it the show folder and it will do the rest. It will even add it to the lineup.
Q: How did you know I was thinking of Steins;Gate?
We know all. We see all. We are all.
Q: Cut stopped running after cutting a few of my shows, and now some of them are cut, but the names of the parts are weird.
We have a tool for this in Extra Tools. Just replace M:\Cut inside the quotes with your cut folder and run it. It will rename all parts from Part 000 to Part 1 Part 001 to Part 2 etc. Also, you need to go in and delete the txt files for the shows that were cut. This does not do that for you in case something else goes wrong. If any of the cuts are weird, like part 1 and 2, but not part 3, becuase it got cut off, just delete parts 1 and 2 and leave the txt file there; it will cut any shows that still have their txt file.
Q: There are a few cuts that are just a bit off. Can I adjust the cut points?
Yes! There are two ways to do this. After running detect, you could just go into the cut folder, find the txt containing the timestamps, and edit it. It will have the same name as the video file, with txt at the end. If you have a few shows you want to edit, you can use the ManualTimestampEditor Tool in ExtraTools. Just run it, and a GUI will appear asking for the anime folder and the cut folder. It will make txt files for any videos that have no timestamps, and then a window will appear with your videos on the right and timestamps on the left. You should be able to edit your timestamps here, and then just click save at the bottom right when you are done.
Q: Why do ffmpeg, ffprobe, and ffplay need to be in the same folder as the program?
Okay, so technically, they don't. You can put them anywhere you want, and then just change the path in the config. We set this as the default because the same folder made sense to us. Now I already know the next question.
Q: Why don't you just ffmpeg, ffprobe, and ffplay the normal way and let python find them?
It does now but it didn't before. I know you want to know
Q: Why?
One dumb reason. My last name has an apostrophe in it, and it broke "Path" on Windows. So some programs, even if added to Path, cannot be called from Python. I'm sure I can't be the only one with this problem, so I left in the option to let you call the executibles directly. You no longer need to do this as I fixed it but I left it in just in case. Also, this only works on Windows.
Q: Does CommercialBreaker damage the original quality of my anime?
CommercialBreaker processes your anime files without affecting their original quality. It only identifies points for commercial insertion but doesn't degrade the video quality.
Q: I don't have any commercials to put in the breaks; what can I do?
You can find vintage commercials online, perhaps from the era when your favorite anime was originally broadcast. Otherwise, you can use this as an opportunity to insert your own custom content, like trailers, fanmade content, or even personal reminders.
Q: I have a huge anime library; will it take long to process?
The duration of processing depends on the size of your anime library. However, the apps are designed to be efficient and should handle large libraries without a problem. Remember that processing large video libraries may consume significant computational resources, so ensure your machine is capable.
Q: My shows have commercials already; can I use this to remove them?
While CommercialBreaker identifies potential commercial break points in your anime, it doesn't have functionality specifically designed to remove existing commercials. However, you can manually use the timestamps it generates to cut out commercials if you so desire.
Q: Can you make this work with Jellyfin?
No, we don't use Jellyfin so we have no idea how it works. If you want to make it work with Jellyfin you can fork the repo and make it work with Jellyfin. We will gladly accept a pull request.
Q: Can I request a new feature for the apps?
Yes, the developer of the apps is always open to feedback and feature requests. You can submit your ideas and suggestions via the contact link provided on the application's homepage.
Q: I noticed you save the original file path and the full file path in the bump table. Why not just save the full file path?
It was to cover up a mistake halfway through the process when we forgot we were going to need to move the bump files to a new folder as that code wasn't written yet. Then, when we went to write the code, trying to just change the original file path to the full file path broke our regex pattern. If your reading this and thing that's dumb, it's really easy to fix. Just do this... Please help us. We have no idea what we are doing; we're not ever real programmers; we're just nerds who like anime and Toonami, and no one would make this for us, so we just started doing it ourselves. It's been almost a year, and we still don't know what we're doing. Please help us.
Q: When I create a second channel, it has a prepare channel step. I didn't have to do this for the first channel. Why do I have to do it for the second channel?
First of all, oh no, one more button your poor wittle fingers. Second, the secound channel has the option of continuing where the last one left off. This is if in your last channel Naruto only went to episode 26 the next channel will start at episode 27 and then the next channel will start at episode 28. This is also why you need to run the prepare channel to "Start from last episode". This is done by some sort of black magic that we honetly forgot how it works to the point we argured about it when writing this thing. If you know how it works there is a $3.50 reward via paypal or starbucks gift card. Also, I think we try to shuffle stuff around so it's not always the same... I don't remember. It's been almost 2 years. We have no idea what we are doing. Also, it's 1 AM and I have been working on this for 12 hours. I'm tired. Please help us.
Q: Your naming scheme is confusing and inconsistent; I can't follow it all!
First of all, just use easy mode. Second, it took a year before we lost track of the naming scheme. Third, suck it up, buttercup.
Q: What is easy mode?
We don't have it anymore but I forgot to take it out of the readme.
Q: Why not just remove it from the readme?
I forgot.
Q: Why not just remove it now?
I'm tired. I'm going to bed.
Q: You use a lot of weeb talk in your readme. It's not very professional.
We are not professionals. We are weebs. There are some professionals who helped us. You will see we split the credits accordingly.
Q: You use Toonami Versions 7, 8, and 9 in your code. I thought there were only 3 versions of Toonami. What's going on?
Toonami Version 7 is for custom bumps for the custom bump tools we are working on/have made. Version 8 is for mixed version and 9 is OG because we had some problems with the naming scheme of "1"
Q: You use Toonami Versions 7, 8, and 9 as place holders in your code. Dude, it's 2088; we're on Toonami version 11, which means I can't use Toonami 7, 8, or 9!
We are not from the future. We are from the past. We are from the year 2000. We are the ghosts of Toonami past. We have come to haunt you. We have come to haunt you with our weeb talk and our naming scheme. We have come to haunt you with our bad code and our bad jokes. We have come to haunt you with our bad grammar and our bad spelling. We have come to haunt you with our bad documentation and our bad ideas. We have come to haunt you with our bad everything.
Remember, every tool in this pack is created with the love of nostalgic anime viewing experience. The journey might be a bit complex but it's just like assembling a Gunpla. Take your time, enjoy the process, and behold the beauty of your custom Toonami marathon at the end.
Until next time, Space Cowboy!
tim000x3 - Executive Producer, Creator of CommercialBreaker, ToonamiTools UI, File Mover, and Toonami Encoder and the README.md file any pretty much everything else not already credited.
Send three crows to the top of the tallest mountain in the land. They will find me.
or just join the discord I guess https://discord.gg/S7NcUdhKRD
You're Pirtates right? Are you really going to care about a license?