Wiki: Filebot wiki page
Added on: 19th of July 2014
Latest release that supports Java7, 4.2 at this time. Can expect updates whenever support for Java8 is broader.
14th of June 2016
Added note to run manual parsing of files script in home folder
30th of April 2015
Ask about extraction during client installation to forgo manually editing after the fact.
13th of February 2015
Disabled automatic extracting of content. Can be turned on again by changing
skipExtract=n in the wrapper for either Deluge or rTorrent.
24th of July 2014
Enabled automatic English subtitle downloads.
FileBot is the ultimate tool for organizing and renaming your movies, tv shows or anime, and music well as downloading subtitles and artwork. It's smart and just works.
We use FileBot as a way to make it easy for Plex to recognise your content so there is a higher chance Plex can play it.
When a download is finished Deluge will tell Filebot to work it’s magic on the download, FileBot will do try to achieve the following things.
- It will check if the content is compressed and try to uncompress it if that’s the case and the setting is enabled. Plex can’t read rar-ed files by default, this makes that work because it extracts the content to a path Plex is watching.
- Next it will try to find the content on one of the known databases thetvdb.com, themoviedb.org etc.
- Based on what it finds FileBot will now create a symlink to the file in
~/mediaand rename it in such a way that Plex is likely to identify the content correctly. For instance
Friends.S06E03.mkvwill be moved and renamed to
~/media/TV Shows/Friends/Seasons 06/Friends.S06E03.mkvor similar.
You can compare a symlink to a shortcut to an existing file in linux. Because it's a shortcut no extra space is being used even though the 'file' exists twice on your filesystem. And because it's just a shortcut you can name it anything you want without disturbing the seeding torrent.
This does mean however that when you delete the torrent via Deluge you still need to delete the version that Filebot made for you in your media folder. You can do this via PyDio or FTP, SSH.
We build wrapper files to be used by Deluge and rTorrent, they can be found in the following locations.
You can use the following command if you have Deluge installed to force content to be scanned, for instance if you uploaded it yourself. Run one of the following commands in your home folder:
Using Deluge wrapper
python ~/.config/deluge/filebot.py nothing . ~/torrents/data/my-folder
Using rTorrent wrapper
bash ~/.config/rtorrent/filebot ~/path/to/containing/folder filename.mkv
Sometimes symlinks are not created, I recommend you view the log files in this instance which can be found in.
This will often tell you why this is happening.
Sometimes when Filebot misses a file you may want to manually create a symlink to the file yourself to try and get it to show in Plex. To do this you'll need to
cd into the directory you want to put your symlink in, usually something like
Once you're in your chosen directory you'll want to use this command to create a link to your file/folder. Note: you must use the format
../../ rather than an absolute link like
/home/yourusername/, otherwise Plex won't be able to follow the link from the container it runs in.
ln -s ../../torrents/data/your-folder/your-file
By default we setup Filebot to extract to
$HOME/torrents/extracted instead of extracting into the folder of the compressed files. However a recent Filebot upgrade has changed the case sensitivity of this option, therefor it won't work without like this any longer.
To get extraction back to our defaults you can edit the filebot wrapper (see paths to these files at the top of this page) and change
--def extractfolder to
--def extractFolder. Running Filebot on new files will now use the correct folder again.
Edit your wrapper file, paths specified above, and look for the
SUBLANG in rTorrent or
en to an other language or
false if you don't want to download subtitles.
|Last Author||Contributors||Versions||Last update|
|Maran||Crimestick, brooklynzoo, chaoschrist, gerbmango||19||Wed, 22 Mar 2017 11:01:22 +0100|