Amc

AMC: What It Actually Does And Why You Shouldn't Run It Blind

AMC is a Python-based automation tool that watches a download folder, identifies media files, and reorganizes them into clean directory structures. It pulls metadata from TMDb, TheTVDB, or IMDb, renames files, and separates movies from TV shows. It also supports series renaming with season and episode numbering, movie collections, and some basic metadata scraping. The project is open source and maintained on GitHub. The tool lives primarily in the Python ecosystem, so you need Python 3.9 or newer installed first. Once that's running, you pull it through pip. The core package is available as amc or through the main repository. You'll also want to install the companion tools that feed it data, like the scraper libraries for TMDb and TheTVDB. After installation, you run a configuration step where you point the app at your input folders, output folder structure, and which metadata sources you trust. The configuration is a YAML file. It's not complicated, but it needs to be correct or the whole thing fails silently on the rename step. Most people mess this up because they skip the dry run. The --dry-run flag tells AMC to process everything but not actually move or rename any files. It prints what it would do. You run this first. You look at the output. You check whether the metadata it pulled matches what you actually have. If it pulled the wrong title or the wrong year, you adjust the configuration before letting it touch your real files.

The folder structure configuration is where people waste time. You define patterns like Movie Name (Year)/Movie Name (Year).ext for films and TV Show (Year)/Season XX/TV Show - SXXEXX.ext for series. The tool respects these patterns during the rename phase. You need to decide whether you want subtitles embedded or kept separate, whether you want artwork downloaded alongside files, and which language you want metadata in. All of this goes into the config file. I spent three hours once debugging why AMC was renaming my files to the wrong title. The problem was that the metadata source had a duplicate entry with a different year attached. The tool grabbed the wrong one because the year filter in the config was too loose. The fix was tightening the year match parameter and adding a strict mode flag to the scraper call. After that, it worked fine. This happens more often than you'd expect when you have a lot of international releases or re-releases in your library.

Running AMC in Practice

Once configured, you point AMC at your watch folder. Any file that lands there gets processed automatically. Movies get separated from TV shows. Both get renamed according to your pattern. Metadata gets scraped and attached. The whole operation for a typical batch of maybe 50 files takes roughly 5 to 10 minutes on a modern machine, depending on how fast your metadata requests are and how large the files are. It's not instantaneous but it's fast enough for daily runs. The web interface lets you queue files, check status, and adjust settings without touching the command line. It's lightweight. The API endpoints are straightforward if you want to script additional automation around it. I've seen people use it with Sonarr or Radarr as a preprocessing step before those tools pick up the newly organized files, though that's an edge case most users don't need.

Common Pitfalls and Where AMC Falls Apart

AMC assumes you already have a basic sense of what you're organizing. It does not fix broken metadata. If your source file is named something like show.s03e07.hdtv.x264.mp4 and the show has a slightly different name in the database, the lookup can fail and you end up with a file stuck in the input folder or misnamed entirely. There's no undo button. Once AMC renames and moves a file, that's it. Another issue is the tool struggles with anything that isn't a standard movie or TV episode. Documentaries, specials, anime with non-standard episode numbering, or collections with unusual naming conventions often get mishandled. You end up doing manual cleanup after the automated pass. For standard Western TV shows and mainstream movies, it works well. Outside that, you're on your own. The tool also doesn't handle incomplete or corrupted files gracefully. If a download is interrupted mid-transfer and AMC picks it up before it's finished, you'll get a renamed corrupt file. You need to ensure your download client moves completed files to the watch folder only after the download is fully verified. This is a setup issue, not a tool issue, but it costs people a lot of headaches if they skip it.

Alternatives Worth Knowing

If AMC doesn't fit your workflow, HandBrake plus a manual or script-based organizer is slower but more transparent. There are also heavier automation suites like Jellyfin combined with Radarr or Sonarr that handle organization as part of a larger stack. Those are more resource-intensive but offer better error handling and rollback capability. AMC is best for people who want something lean and scriptable without running an entire media server infrastructure.