Skip to content

Refiners

Jump to bottom Edit New page
pannal edited this page Apr 5, 2018 · 6 revisions

With the release of Sub-Zero 2.5, several procedures have been implemented to retrieve more information about renamed files.

Refiners

Sonarr/Radarr

If you use Sonarr or Radarr, select Sonarr/Radarr in the I rename my files using dropdown. You will need to fill out:

  • App URL (including URL base if set). Example: http://127.0.0.1:8989/sonarr
  • API key (you can get this at Sonarr or Radarr's general settings page).

Once you have filled out this information (and saved it), Sub-Zero will query these apps to retrieve the source and release group of your renamed files.

Filebot

If you use Filebot, select Filebot in the I rename my files using dropdown. Filebot stores the original filename, along with some extra metadata, in each file's extended attributes.

Note about extended attribute fetching

If Sub-Zero is running on Linux, it is recommended to have the attr package to view extended attributes more efficiently.

Sonarr/Radarr/Filebot

If you use a combination of Filebot and Sonarr/Radarr select Sonarr/Radarr/Filebot in the I rename my files using dropdown. This refiner will try to access Filebot's extended attributes, then it will query Sonarr/Radarr if Filebot did not rename the file. You must still specify Sonarr/Radarr's App URL and API key.

file_info index files

If you use Filebot and Plex accesses its media files over a network share (e.g. smb), extended attribute fetching may not work. In that case, or if you have another renaming workflow, you can still use Sub-Zero. Select none of the above in the I rename my files using dropdown, and check the Retrieve original filename from .file_info/file_info index files box.

This is also helpful for people who create their own media files and thus, don't have an "original" filename available. Adding info about the source of the media file (e.g. DVDRip, BluRay, HDTV) helps finding subtitles.

If the option is checked, Sub-Zero will look for a file named file_info or .file_info containing information about the original filenames in the following format:

  • file_info/.file_info file sits next to media files
  • it's expected to be UTF-8 encoded
  • One file_info file per folder, only referencing "sister" media files in the same folder
  • One entry per line in file_info file
  • Each line consists of the following information: current filename.ext="old.filename.ext" (or current filename.ext="filename.with.more.info.ext")

Example

Directory Structure

▼ Show
— ▼ Season 1
——— .file_info
——— Show - S01E01 - Hello World.mkv
——— Show - S01E02 - Goodbye World.mkv

.file_info Contents

Show - S01E01 - Hello World.mkv="show.S01E01.720p.HDTV.x264-KILLERS.mkv"
Show - S01E02 - Goodbye World.mkv="show.s01e02.1080p.WEB-DL.H.264-VISUM.mkv"

Sub-Zero was created by pannal if you like it, then consider buying him a beer! Donate
or join Sub-Zero Patreon starting at 1 $ / month:

Clone this wiki locally