A media server is a very literal piece of software. It doesn't watch your files, it reads their names, and then it goes looking for a match in an online database. Almost everything that looks like a mysterious server bug is really the server reading an ambiguous filename and guessing wrong.
The good news: the conventions are simple, and getting them right is permanent.
The shape that always works
TV Shows/
Show Name (2005)/
Season 01/
Show Name (2005) - S01E01 - Episode Title.mkv
Show Name (2005) - S01E02 - Episode Title.mkv
Movies/
Movie Name (1999)/
Movie Name (1999).mkvFour rules do most of the work:
- One folder per show, one per season. Loose files in a single directory work far less reliably.
- Always include the year in the show or movie folder name.
- Always use
SxxExx— zero-padded, capital S and E. - Episode titles are optional. The numbers do the matching; titles are for humans.
The year is not decoration
Title collisions are everywhere. A hit series gets an international remake under the same name. A long-running show gets revived a decade later and the revival is also season one. A film gets remade twice. Without a year, the server picks whichever match is most popular — which is right until the day it isn't, and then it's confidently, invisibly wrong.
Adding (2005) is the single highest-value habit in library organization. When
two versions of a show exist, it's the only thing preventing a coin flip.
Dates instead of numbers
Daily shows — talk shows, news, some reality — are frequently catalogued by air date rather than episode number. Those want a date-based name:
Show Name (2015) - 2026-07-28 - Episode Title.mkv
Trying to force a daily show into SxxExx tends to produce a season 0 full of
mystery entries. If a show has more than 200 episodes a year, check whether it's dated.
Specials belong in season 00
Christmas episodes, retrospectives, and behind-the-scenes material usually live in
Season 00 and are numbered S00E01 and up. Putting a special
into a real season shifts everything after it, which produces exactly the offset-description
problem that has its own article.
Be aware that databases disagree about which specials exist and in what order more than they disagree about anything else. If you have a large pile of untitled entries in season 0, that's usually the cause, and it's mostly harmless.
Double episodes
A single file containing two episodes is written with both numbers:
Show Name (2005) - S04E01-E02 - Episode Title.mkvThis is correct and widely supported — but only if your server is counting episodes the same way the filename does. When it isn't, you get the single most confusing failure in home media. It has a whole article, because it deserves one.
Things that quietly break matching
| Don't | Why |
|---|---|
1x01 instead of S01E01 | Supported inconsistently. Just use SxxExx. |
| Release-group noise before the show name | The name should start with the title. |
| Two versions of an episode in one folder | Pick one, or the server may show duplicates. |
| Everything in one flat folder | Season folders make matching far more reliable. |
| Renaming after the fact, casually | It can reset watch progress. Deliberate is fine; casual isn't. |
When the server still gets it wrong
Occasionally a show is named perfectly and still matches to something else entirely. Every major server has a Fix Match function that lets you search manually and lock the correct result. Use it rather than fighting the filename — once matched explicitly, it stays matched.
If a show matched wrong and you've since renamed things, do the fix-match after the rename, not before. Otherwise you're locking in a match against names that no longer exist.
The short version
Show Name (Year)/Season 01/Show Name (Year) - S01E01 - Title.ext- The year prevents the most common wrong match there is.
- Specials go in season 00. Daily shows use dates.
- Double episodes are
S04E01-E02— valid, but check your ordering setting. - When all else fails, Fix Match and lock it.