Filebot - Bytesized Hosting Wiki

= FileBot - Bytesized Hosting Wiki =

== Details ==

== Version Management == Latest release that supports Java7 is 4.2, which is also the last version without license charges.
Due to FileBot's per-user license model, newer versions released after the licensing fee was introduced are not available.

== Changelog == '''14th of November 2019'''

  • FileBot is no longer the default app. Olaris-rename is now the default.
  • If you deployed your box after 1st of December 2019 and did not install FileBot manually, this page is no longer relevant.

'''3rd of November 2019'''

  • Added a note about FileBot licensing.

'''14th of June 2016'''

  • Added note to run manual parsing of files script in the home folder.

'''30th of April 2015'''

  • Added instructions for extraction during client installation to avoid manual editing later.

'''13th of February 2015'''

  • Disabled automatic extraction of content.
  • Re-enable by changing skipExtract=y to skipExtract=n in the wrapper for Deluge or rTorrent.

'''24th of July 2014'''

  • Enabled automatic English subtitle downloads.

'''27 July 25 created the mark up version'''

  • I could not get the license version into the text so you need to see the orignal page (same name without mark up) if you want that

== Description == FileBot is the ultimate tool for organizing and renaming your movies, TV shows, anime, and music, as well as downloading subtitles and artwork. It's smart and just works.

== What Do We Use It For? == We use FileBot to help Plex recognize content so Plex can play it properly.

When a download finishes, Deluge triggers FileBot to:

  • Check if content is compressed and uncompress it (if enabled). Plex cannot read compressed files (e.g., rar) by default.
  • Query databases like [https://thetvdb.com thetvdb.com] or [https://www.themoviedb.org themoviedb.org].
  • Create a symlink in ~/media and rename files in a Plex-friendly way.
    Example: Friends.S06E03.mkv → ~/media/TV Shows/Friends/Season 06/Friends.S06E03.mkv

A symlink is like a Linux shortcut. It uses no extra space.
However, when you delete the torrent via Deluge, you must also delete the version created by FileBot in your media folder (via PyDio, FTP, or SSH).

=== Using FileBot as the Deluge Postprocessing Script === The default postprocessing script for Deluge is olaris-rename. To use FileBot:

  • Edit ~/.config/deluge/filebot.py.
  • In the call_filebot() function, change the cmd variable:
    cmd = ("filebot -script fn:amc -non-strict --def ut_kind=multi --log all --log-file amc.log --def ut_dir=\"%s/%s\" " % (sys.argv[3], sys.argv[2]) + ' '.join(filebotOptions)).encode(u'utf-8')
    
  • Change the output folder in the filebotOptions list to ~/media instead of the default ~/torrents/data/media.

== Installing the License ==

  • FileBot can be installed via the Install Application button.
  • You must purchase a license from [http://filebot.net/ FileBot’s homepage].
  • During installation, paste the complete license into the license data field.

The license file must be complete and correctly formatted (not all on one line).
To verify if the license is installed, run:

filebot -script fn:sysinfo

The output should include:

License: FileBot License XXXXXXX (Valid-Until: YYYY-MM-DD)
:/n/nImgur/n/n

== Wrapper Files == Wrapper files for Deluge and rTorrent are found at:

  • Deluge: ~/.config/deluge/filebot.py
  • rTorrent: ~/.config/rtorrent/filebot

== Tips and Tricks ==

=== Manually Parse a Folder or Files === To force FileBot to scan content (e.g., uploaded manually), run in your home folder:

Using automatic detection script:

cd && filebotify ~/torrents/data/filepath

If that fails, try:

Using Deluge wrapper:

python ~/.config/deluge/filebot.py nothing . ~/torrents/data/my-folder

Using Deluge wrapper (folder names with spaces):

python ~/.config/deluge/filebot.py nothing . "~/torrents/data/Path To your DIR with Spaces/"

Using rTorrent wrapper:

bash ~/.config/rtorrent/filebot ~/path/to/containing/folder filename.mkv

=== Checking FileBot Logs === If symlinks are not created, check logs:

~/.filebot/logs/amc.log

=== Manually Creating Symlinks === To create a symlink manually:

cd ~/media/Movies
ln -s ../../torrents/data/your-folder/your-file

Use ../../ instead of absolute paths like /home/user/, otherwise Plex won’t follow links.

For directories with spaces:

ln -s ../../../torrents/data/"Folder Name With Spaces/Your Movie.mkv"
cd "~/torrents/data/Folder Name With Spaces/"

=== Enabling Small File Size and Short Video Recognition === Add these options to your FileBot configuration:

--def minFileSize=0
--def minLengthMS=0
  • minFileSize processes all files regardless of size (default 50 MB).
  • minLengthMS processes all videos regardless of length (default 10 minutes).

=== Fixing the extractFolder === A recent FileBot upgrade changed case sensitivity of extractFolder.
Edit the FileBot wrapper and change --def extractfolder to --def extractFolder.

=== Turn Off Subtitles / Download Multiple Subtitles === Edit the wrapper file and change SUBLANG:

  • Set to false to disable subtitles.
  • Use a comma-separated list (e.g., en,fr,nl) for multiple languages.

Last Author Contributors Versions Last update
SteveAndThom 71 Sat, 26 Jul 2025 21:37:00 +0200