{Movie CleanTitle} {(Release Year)} {tmdb-{TmdbId}} {edition-{Edition Tags}} {[Custom Formats]}{[Quality Full]}{[MediaInfo 3D]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[Mediainfo VideoCodec]}{-Release Group}
| Token | Purpose |
|---|
{Movie CleanTitle} | Movie title with illegal characters removed |
{(Release Year)} | Theatrical release year in parentheses |
{tmdb-{TmdbId}} | TMDB ID prefixed with tmdb- for unambiguous library matching |
{edition-{Edition Tags}} | Edition label (e.g., edition-Director's Cut), omitted when empty |
{[Custom Formats]} | Active custom format tags applied to the release (see note below) |
{[Quality Full]} | Quality label including source and resolution (e.g., WEB-1080p) |
{[MediaInfo 3D]} | 3D tag when applicable, otherwise omitted |
{[MediaInfo VideoDynamicRangeType]} | HDR type (e.g., HDR, DV, SDR) |
{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]} | Audio codec and channel layout (e.g., EAC3 5.1) |
{[Mediainfo VideoCodec]} | Video codec (e.g., x264, x265, AV1) |
{-Release Group} | Release group name prefixed with a hyphen |
The Dark Knight (2008) {tmdb-155} [WEB-1080p][SDR][EAC3 5.1][x264]-GroupName
{Movie CleanTitle} ({Release Year}) {tmdb-{TmdbId}}
The Dark Knight (2008) {tmdb-155}
Including the TMDB ID in folder names significantly improves library matching accuracy. Media servers and metadata agents can use the ID directly instead of relying on fuzzy title searches, which prevents misidentification for movies with common or duplicate titles.
Colon replacement
colonReplacementFormat: smart
smart mode replaces colons contextually — for example, : becomes - while a colon mid-word may be handled differently. This produces natural-looking filenames without breaking word boundaries.replaceIllegalCharacters is set to false. Radarr will not strip characters such as colons outright; instead, colon handling is delegated entirely to colonReplacementFormat: smart.
{Series TitleYear} - S{season:00}E{episode:00} - {Episode CleanTitle} {[Custom Formats]}{[Quality Full]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[MediaInfo VideoCodec]}{-Release Group}
Series Name (2020) - S01E01 - Pilot Title [WEB-1080p][SDR][EAC3 5.1][x264]-GroupName
{Series TitleYear} - {Air-Date} - {Episode CleanTitle} {[Custom Formats]}{[Quality Full]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[MediaInfo VideoCodec]}{-Release Group}
{Series TitleYear} - S{season:00}E{episode:00} - {absolute:000} - {Episode CleanTitle} {[Custom Formats]}{[Quality Full]}{[MediaInfo VideoDynamicRangeType]}[{MediaInfo VideoBitDepth}bit]{[MediaInfo VideoCodec]}[{Mediainfo AudioCodec} { Mediainfo AudioChannels}]{MediaInfo AudioLanguages}{-Release Group}
{absolute:000} token (zero-padded three-digit absolute episode number) and expands media info to include bit depth and audio language tags.| Format | Value |
|---|
| Series folder | {Series TitleYear} {tvdb-{TvdbId}} |
| Season folder | Season {season:00} |
Breaking Bad (2008) {tvdb-81189}/
└── Season 01/
└── Breaking Bad (2008) - S01E01 - Pilot [WEB-1080p][SDR][EAC3 5.1][x264]-GroupName
Including the TVDB ID in series folder names lets Sonarr and media servers resolve the correct series without relying on title matching alone. This is especially useful for shows with identical names or foreign-language titles.
Multi-episode style
Style 5 is Prefixed Range, which formats multi-episode files as S01E01-E03 rather than listing each episode individually.Colon replacement
colonReplacementFormat: 4
customColonReplacementFormat: ''
4 maps to the Delete mode, which removes colons entirely. This differs from Radarr’s smart mode.replaceIllegalCharacters is set to false for Sonarr as well. Colon handling is managed solely by colonReplacementFormat.