Media Management
Control how movies are named and organized on disk. Luminarr can rename files and folders on import using configurable token-based format strings.
Rename Movies
When enabled, Luminarr renames movie files to match your configured format at import time. When disabled, files are imported with their original names unchanged.
Rename enabled
Files and folders are renamed on import using your format string. Existing files in the library can be renamed in bulk from the movie detail page.
Rename disabled
Files keep their original names. Luminarr still tracks them in the database; only the on-disk filename is unaffected.
Renaming existing files requires that all library paths are writable by the Luminarr process. Files on read-only mounts cannot be renamed.
Standard Movie Format
The movie file format is a template string that controls how the filename (without extension) is constructed. Insert tokens anywhere in the string — Luminarr replaces them at import time.
| Token | Example output | Notes |
|---|---|---|
{Movie Title} |
The Dark Knight | Full title from TMDB, including articles |
{Movie CleanTitle} |
The Dark Knight | Title with special characters removed or replaced |
{Release Year} |
2008 | Four-digit theatrical release year from TMDB |
{Quality Full} |
Bluray-1080p x265 | Source, resolution, and codec combined |
{MediaInfo VideoCodec} |
x265 | Codec as reported by ffprobe; empty if scan not run |
Example format string
{Movie CleanTitle} ({Release Year}) {Quality Full}
Produces: The Dark Knight (2008) Bluray-1080p x265
File extension is always preserved. Luminarr appends the original extension (e.g. .mkv, .mp4) automatically — do not include it in your format string.
Movie Folder Format
Each movie is stored in its own subfolder inside your root library path. The folder name is controlled by a separate format string using the same token set.
{Movie CleanTitle} ({Release Year})
Produces a folder like /movies/The Dark Knight (2008)/ containing the movie file
and any extra files (subtitles, NFO, etc.) you have configured to import.
Folder renaming follows the same rename toggle as files. When renaming is disabled, new folders are created using the original download folder name.
Colon Replacement
Colons in movie titles (e.g. Mission: Impossible) are illegal in Windows and macOS filenames. Choose how Luminarr handles them:
| Mode | Input | Result |
|---|---|---|
| Delete | Mission: Impossible | Mission Impossible |
| Dash | Mission: Impossible | Mission - Impossible |
| Space dash | Mission: Impossible | Mission — Impossible |
| Smart | Mission: Impossible | Mission： Impossible (Unicode fullwidth colon) |
Smart mode uses the Unicode fullwidth colon character (：),
which is visually identical to a colon but valid on all filesystems. This is the recommended
setting for most users.
Import Extra Files
Luminarr can copy additional files alongside the movie file during import. Enable this option and specify which extensions to include.
Subtitle files
Common extensions: srt, ass, ssa, sub, idx. Imported with the same base filename as the movie.
Metadata files
Common extensions: nfo, jpg, png. Useful for media servers that read local NFO files.
Enter a comma-separated list of extensions in the Extra File Extensions field,
without leading dots: srt, ass, nfo.
Only files with a matching base name are imported. Extra files in the download folder that share the movie's filename (minus extension) will be included; unrelated files are ignored.
Unmonitor Deleted Movies
When the library scanner detects that a movie file has been deleted from disk, Luminarr can automatically unmonitor that movie so it is not re-grabbed on the next RSS sync.
Enabled (recommended)
Deleted files cause the movie to be unmonitored automatically. Re-monitor manually if you want Luminarr to search again.
Disabled
Movies remain monitored after files are deleted. Luminarr will search for and re-download them on the next RSS sync or manual search.
Temporary removal: If you delete a file temporarily (e.g. to free space), disable this setting beforehand to avoid losing the monitored state.