Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Dumpstarr/Database/llms.txt
Use this file to discover all available pages before exploring further.
Dumpstarr applies consistent naming formats across Radarr and Sonarr to produce filenames that are human-readable, scraper-friendly, and rich with metadata tokens. Renaming is enabled for both applications.
{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.
When present in a filename, {[Custom Formats]} injects the names of all custom formats that matched the release into square brackets. For example, a release matching HDR.10+ and Atmos formats would produce [HDR10Plus][Atmos] in the filename.
This makes it trivially easy to see at a glance which quality attributes drove a download decision, without opening the application.
Misc settings
These settings apply to both Radarr and Sonarr:
radarr:
propersRepacks: doNotPrefer
enableMediaInfo: true
sonarr:
propersRepacks: doNotPrefer
enableMediaInfo: true
| Setting | Value | Effect |
|---|
propersRepacks | doNotPrefer | Propers and repacks are not automatically preferred over the original release. Custom format scores determine upgrades instead. |
enableMediaInfo | true | Sonarr and Radarr will read MediaInfo from downloaded files to populate codec, audio, and HDR tokens in filenames. |