Skip to content

Studio

The Studio is the main screen of CineRename: this is where you preview and validate each renaming. Any destructive operation first goes through here.

Screen anatomy

  • Drop zone — in the center, accepts files, folders, and archives.
  • Virtual list — displays up to thousands of files without slowdowns (Svelte 5 virtualization).
  • Details panel — when you click on a row, displays found metadata, alternatives, and output format.
  • Actions — buttons Rename, Clear list, Export report.

Media recognition

CineRename uses a multi-pass heuristic:

  1. Filename parsing — season/episode (S01E02, 1x02, Episode 2...), year, quality, codec, language.
  2. Type identification — movie, series, anime — via patterns + databases.
  3. Metadata query — TheTVDB for movies/series, TVmaze for TV series as a fallback, internal database for animes.
  4. Scoring — all candidates are scored. The best one is selected, the others remain available in the selector.

Manual editing

For each entry, you can:

  • Force a match — manually select the right movie/episode among the candidates.
  • Edit the title — typo, extended version ("Director's Cut")...
  • Ignore a row — exclude from the final renaming (useful for .txt, .nfo that slipped in).

Naming presets

Configure in Settings → Naming templates. Each template has a language:

ModeWhen to use it
TokensSimple substitution patterns: {title} - S{season}E{episode} - {episode_title} — covers 95% of cases. Integrated FileBot format importer to retrieve existing patterns.
JavaScriptAdvanced patterns: ternaries, regex, closures, string manipulation. The embedded QuickJS engine is immediate and much faster than FileBot's Java virtual machine. See JavaScript Templates.

Variables available in both modes:

VariableDescription
{title} / titleMedia title
{media_kind} / media_kindType (movie, episode or anime)
{year} / yearRelease year
{season} / seasonSeason number (zero-padded in tokens)
{episode} / episodeEpisode number (zero-padded in tokens)
{absolute_episode} / absolute_episodeAbsolute number (anime)
{episode_title} / episode_titleEpisode title
{resolution} / resolutionResolution (1080p, 4K, 720p...)
{source} / sourceSource (BluRay, WEB-DL, HDTV...)
{video_codec} / video_codecVideo codec (x265, HEVC, AV1...)
{audio_codec} / audio_codecAudio codec (DTS-HD, Atmos...)
{dynamic_range} / dynamic_rangeDynamic range (HDR10, DV...)
{bit_depth} / bit_depthBit depth (8bit, 10bit...)

Plex friendly

The default preset is calibrated for Plex and Jellyfin. If you change it, verify with your library scanner that the files are still recognized.

DVD / BluRay linear pairing

If you import a disc rip folder (VTS_01_1.VOB, 00001.m2ts, BDMV/STREAM/…), the Studio detects these files and displays a Linear pairing… button in the toolbar.

The workflow:

  1. Search for the series in the metadata search bar (TheTVDB / TVmaze)
  2. Select the correct candidate and the relevant season
  3. (Optional) Start at an episode other than 1 — useful for discs containing the second half of a season
  4. (Optional) Filter small fragments (< 50 MB) to ignore DVD menus / intros
  5. Click Generate plan — each file (sorted alphabetically) is paired to episode[i] and the current batch is replaced by the result

You then validate via the usual Rename button.

File operations

In Settings → Pipeline, choose what CineRename does when you validate a renaming:

ModeEffect
Move (default)Moves the file to the new path / name. Classic behavior.
CopyCopies the file keeping the original intact. Useful for preserving a seedbox.
HardlinkCreates a hard link — zero extra bytes on the disk (same filesystem required).
SymlinkCreates a symbolic link — the original is referenced.

For Move, undo via the History restores the original name. For other modes, the original is unchanged so undo simply deletes the created copy / link.

Checksums

Select one or more entries and click Calculate checksums to generate CRC32 / MD5 / SHA-1 / SHA-256 hashes, exportable as a sidecar manifest (.sfv, .md5, .sha1, .sha256). The Verify a manifest… button in the same dialog rereads an existing manifest and flags altered or missing files. See Checksums.

Security

  • No disk writes before validation.
  • Atomic renaming — if a file cannot be renamed (permissions, name conflict), the operation stops cleanly and nothing is left half-done.
  • Conflicts detected — if two files would result in the same output name, CineRename refuses to continue and reports the conflict.

Keyboard shortcuts

ActionWindows / LinuxmacOS
Select allCtrl + ACmd + A
Start renamingCtrl + EnterCmd + Enter
Clear the listCtrl + BackspaceCmd + Delete
Open SettingsCtrl + ,Cmd + ,
Move through the file list / / Page Up / Page DownSame
Select the focused fileSpaceSame
Open the focused file reviewEnterSame
Open the focused file menuMenu or Shift + F10Same

CineRename Documentation