olaris-rename

olaris-rename is the default media renaming tool on all Bytesized Appbox installations since December 2019. It is a lightweight alternative to Filebot — it doesn't aim for 100% accuracy but reliably gets content renamed "good enough" for Plex to identify it correctly.

olaris-rename is installed system-wide and does not need to be installed separately. It is called automatically by Deluge and rTorrent after a download completes.

What it supports:

Identification of movies and TV series via TMDB
Automatic extraction of compressed archives
Symlinking, hardlinking, copying or moving
Recursive folder scanning

What it does not support:

Anime content (identification is unreliable)
Music identification

For a more powerful and accurate renaming tool, see Filebot. To switch between the two, see Filebot and olaris-rename.

Manual processing

If files were missed by the automatic processing, run olaris-rename manually:

olaris-rename --filepath ~/path/to/files

Options reference

Option	Default	Description
`-filepath`	—	Path to scan (file or folder) — required
`-action`	`symlink`	How to act on files: `symlink`, `hardlink`, `copy` or `move`
`-skip-extracting`	false	Disable automatic extraction of archives
`-extract-path`	`~/media/extracted`	Path to extract content to
`-movie-folder`	`~/media/Movies`	Destination folder for movies
`-series-folder`	`~/media/TV Shows`	Destination folder for TV series
`-music-folder`	`~/media/Music`	Destination folder for music
`-movie-format`	`{n} ({y})/{n} ({y}) {r}`	Naming format for movies
`-series-format`	`{n}/Season.{s}/{n}.S{s}E{e}.{r}`	Naming format for series
`-min-file-size`	`120` (MB)	Minimum file size to process
`-recursive`	true	Scan subfolders recursively
`-tmdb-lookup`	true	Use TMDB for improved matching
`-dry-run`	false	Simulate without modifying any files
`-log-to-file`	false	Write logs to file in addition to stdout
`-verbose`	false	Show debug log output

Olaris Rename

olaris-rename

Manual processing

Options reference

Related guides