FileBot

Automated media library organization and renaming

FileBot - Automated Media Management

FileBot is the ultimate tool for organizing and renaming your Movies, TV Shows, and Anime libraries. It automatically fetches metadata, downloads subtitles, organizes your files into a clean directory structure, and integrates seamlessly with popular download clients for post-processing automation.

What is FileBot?

FileBot is a sophisticated media library manager that:

• Automatic Renaming - Intelligently renames files based on metadata
• Library Organization - Structures media into organized directories
• Subtitle Downloads - Fetches subtitles in multiple languages
• Metadata Fetching - Retrieves artwork, descriptions, and episode information
• Post-Processing - Integrates with torrent/usenet clients for automation
• Format Customization - Define custom naming schemes and organization patterns

Installation

Basic Installation

Install FileBot for a specific user:

qb install filebot -u username

This will:

• Install FileBot with Java 17 runtime
• Create the default media directory structure (/home/username/Media)
• Prompt for license activation (or skip with -o web flag)

Custom Media Path

Specify a custom media directory during installation:

qb install filebot -u username -mp '/mnt/storage/media'

Installation with Download Client Integration

FileBot can automatically configure post-processing for your download clients:

Install with Deluge integration:

qb install filebot -u username -o 'deluge'

Install with multiple integrations:

qb install filebot -u username -o 'deluge' -o 'nzbget'

Supported integrations:

• -o 'deluge' - Deluge torrent client
• -o 'nzbget' - NZBGet usenet client
• -o 'rtorrent' - rTorrent/ruTorrent client
• -o 'sabnzbd' - SABnzbd usenet client

CLI Commands

Basic Operations

Usage Examples

Basic installation:

qb install filebot -u myuser

Install with custom media path:

qb install filebot -u myuser -mp '/mnt/nas/media'

Install with Deluge post-processing:

qb install filebot -u myuser -o 'deluge'

Install with multiple download clients:

qb install filebot -u myuser -o 'rtorrent' -o 'sabnzbd'

Reinstall (preserves license and config):

qb reinstall filebot -u myuser

Remove FileBot:

qb remove filebot -u myuser

Supported Integrations

QuickBox Pro automatically configures FileBot with your installed download clients:

Enhanced Features

FileBot on QuickBox Pro includes several advanced configurations:

Configuration

Default Media Directory Structure

FileBot creates the following directory structure:

Naming Format

QuickBox Pro includes pre-configured naming formats:

Movies:

Movies/{Movie Name} ({Year})/{Movie Name} ({Year}) {lang} {vf} {VC}

TV Shows:

TV/{Show Name}/Season {Season Number}/{S00E00} - {Episode Title} {vf} {VC}

Anime:

Anime/{Show Name}/Season {Season Number}/{S00E00} - {Episode Title} {vf} {VC}

Music:

Music/{Artist Name}/{Album}/{Track Number}. {Artist} - {Title}

License Activation

During Installation

When installing without the -o web flag, you’ll be prompted:

Would you like to activate your license? [y/n]:
> y
Please copy/paste the full contents of your license file.
Press ctrl+D when done to continue.
> [paste license content]

Via Dashboard

1. Navigate to QuickBox Dashboard → Applications
2. Select FileBot from installed applications
3. Upload your license file (filebot_license.psm)

Manual Activation

# Copy license to config directory
cp filebot_license.psm /home/username/.config/Filebot/
 
# Activate license
/usr/local/bin/username/filebot --license /home/username/.config/Filebot/filebot_license.psm

Download Client Integration

Deluge Integration

When installed with -o 'deluge', FileBot configures:

Location: /home/username/.config/Filebot/deluge-postprocess.sh

Deluge Setup:

1. Open Deluge Web UI
2. Navigate to Preferences → Execute Plugin (enable in Plugins if needed)
3. Add execution:
   • Event: Torrent Complete
   • Command: /home/username/.config/Filebot/deluge-postprocess.sh

rTorrent Integration

When installed with -o 'rtorrent', FileBot automatically adds to .rtorrent.rc:

method.set_key = event.download.finished,filebot,"execute.throw.bg={/home/username/.config/Filebot/rtorrent-postprocess.sh,$d.base_path=,$d.name=,$d.custom1=}"

No additional configuration needed - it’s automatic!

NZBGet Integration

When installed with -o 'nzbget', FileBot configures:

Location: /home/username/.config/NZBGet/scripts/nzbget-postprocess.sh

NZBGet Setup:

1. Open NZBGet Web UI
2. Navigate to Settings → Extension Scripts
3. Select nzbget-postprocess.sh for post-processing categories

SABnzbd Integration

When installed with -o 'sabnzbd', FileBot configures:

Location: /home/username/.config/SABnzbd/scripts/sabnzbd-postprocess.sh

SABnzbd Setup: QuickBox automatically configures:

• Script directory points to SABnzbd scripts folder
• Post-processing script enabled for Movies, TV, and Anime categories

Using FileBot

Command Line Usage

FileBot is accessible via the command line:

# Run as your user
/usr/local/bin/username/filebot [options]

Manual File Processing

Process a single file or directory:

/usr/local/bin/username/filebot -script fn:amc \
  --output /home/username/Media \
  --action hardlink \
  --conflict skip \
  /path/to/downloads

Options explained:

• --output - Destination media directory
• --action - How to handle files (hardlink, move, copy)
• --conflict - How to handle duplicates (skip, override)

AMC Script (Automated Media Center)

The AMC script is FileBot’s powerful automation tool:

filebot -script fn:amc \
  --output "/home/username/Media" \
  --action hardlink \
  --conflict skip \
  -non-strict \
  --log-file amc.log \
  --def unsorted=y music=y artwork=n \
  excludeList="/home/username/.config/Filebot/.excludes" \
  ut_dir="/path/to/completed" \
  ut_kind="multi"

Troubleshooting

License Issues

License not activating:

# Check license file exists
ls -la /home/username/.config/Filebot/*.psm
 
# Re-activate license
/usr/local/bin/username/filebot --license /home/username/.config/Filebot/filebot_license.psm

Permission Issues

FileBot can’t write to media directory:

# Fix ownership
sudo chown -R username:username /home/username/Media
 
# Fix permissions
sudo chmod -R 755 /home/username/Media

Post-Processing Not Running

Check post-processing script:

# Test script manually
bash -x /home/username/.config/Filebot/deluge-postprocess.sh \
  "torrent_id" "torrent_name" "/path/to/download"
 
# Check script permissions
ls -la /home/username/.config/Filebot/*-postprocess.sh
 
# Should be executable (chmod +x)

Check download client logs:

# Deluge
journalctl -u deluged@username -f
 
# rTorrent
tail -f /home/username/.sessions/rtorrent.log
 
# NZBGet
tail -f /home/username/.config/NZBGet/nzbget.log

Java Version Issues

FileBot requires Java 17:

# Check Java version
java -version
 
# Should show: openjdk version "17.x.x"
 
# Set Java 17 if multiple versions installed
sudo update-alternatives --config java

Advanced Configuration

Custom Naming Schemes

Edit /home/username/.config/Filebot/formatting:

# Movies with resolution and codec
movieFormat=Movies/"{n} ({y})/{n} ({y}) [{vf} {vc} {ac}]"
 
# TV shows with episode title
seriesFormat=TV/"{n}/Season {s.pad(2)}/{n} - {s00e00} - {t}"
 
# Anime with fansub group
animeFormat=Anime/"{n}/{n} - {s00e00} - {t} [{group}]"

Exclude Patterns

Add patterns to /home/username/.config/Filebot/.excludes:

# Exclude samples
*sample*
*SAMPLE*
 
# Exclude specific files
*.nfo
*.sfv
 
# Exclude paths
/path/to/exclude/*

Media Path Configuration

The media path is set during installation with -mp flag. To change:

1. Update post-processing scripts with new path
2. Ensure the new directory exists and is owned by your user
3. Update any hardcoded paths in custom scripts

Best Practices

Resources