Wiki: Filebot wiki page

Details

Name: FileBot

Website: http://filebot.net/

Added on: 19th of July 2014

Version management

Latest release that supports Java7, 4.2 at this time. Can expect updates whenever support for Java8 is broader.

Changelog

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=y to skipExtract=n in the wrapper for either Deluge or rTorrent.

24th of July 2014

Enabled automatic English subtitle downloads.

Description

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.

What do we use it for?

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 ~/media and rename it in such a way that Plex is likely to identify the content correctly. For instance Friends.S06E03.mkv will be moved and renamed to ~/media/TV Shows/Friends/Seasons 06/Friends.S06E03.mkv or 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.

Wrapper files

We build wrapper files to be used by Deluge and rTorrent, they can be found in the following locations.

Deluge

~/.config/deluge/filebot.py

rTorrent

~/.config/rtorrent/filebot

Tips and Tricks

Manually parse a folder or files

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

Checking out what Filebot is doing

Sometimes symlinks are not created, I recommend you view the log files in this instance which can be found in.

~/.filebot/logs/amc.log

This will often tell you why this is happening.

Manually creating symlinks

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 ~/media/Movies.

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

Fixing the extractFolder

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.

Change or turn-off subtitle

Edit your wrapper file, paths specified above, and look for the SUBLANG in rTorrent or subtitles change 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