{"id":26491452,"url":"https://github.com/amoscardino/renamer-core","last_synced_at":"2025-03-20T08:39:24.298Z","repository":{"id":42079460,"uuid":"241435295","full_name":"amoscardino/renamer-core","owner":"amoscardino","description":"CLI tool for renaming files for Plex.","archived":false,"fork":false,"pushed_at":"2024-10-14T20:46:44.000Z","size":81,"stargazers_count":20,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-11T12:55:38.712Z","etag":null,"topics":["cli","dotnet-core","plex"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amoscardino.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-18T18:22:55.000Z","updated_at":"2024-10-14T20:46:45.000Z","dependencies_parsed_at":"2022-08-12T04:20:23.966Z","dependency_job_id":null,"html_url":"https://github.com/amoscardino/renamer-core","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amoscardino%2Frenamer-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amoscardino%2Frenamer-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amoscardino%2Frenamer-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amoscardino%2Frenamer-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amoscardino","download_url":"https://codeload.github.com/amoscardino/renamer-core/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244581681,"owners_count":20476160,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","dotnet-core","plex"],"created_at":"2025-03-20T08:39:23.676Z","updated_at":"2025-03-20T08:39:24.293Z","avatar_url":"https://github.com/amoscardino.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Renamer Core\n\nCommand line tool to rename movie and show files for Plex.\n\n## Installation\n\n\u003e Requires [.NET 6](https://dotnet.microsoft.com)\n\nClone the repo to you computer. Pull to get updates. Open a command prompt to the source directory.\n\nIf you are updating, remove the old version first:\n\n```cmd\n\u003e dotnet tool uninstall -g renamer-core\n```\n\nTo install:\n\n```cmd\n\u003e dotnet build\n\u003e dotnet pack\n\u003e dotnet tool install -g --add-source ./dist renamer-core\n```\n\n## Usage\n\nThere are 3 commands: `config`, `m`, and `s`. The last two are the Movie Renamer and the Show Renamer, respectively.\n\n### The  `config` command\n\nThe `config` command is used to set the API key for The Movie DB API. You will need to get your own API key.\n\n```bash\n\u003e renamer config -tmdb \u003cAPIKEY\u003e\n```\n\nConfig values are stored in a JSON file in your local app storage directory (`~\\AppData\\Local` on Windows, `~/.config` on *nix).\n\n### Movie Renamer\n\n```bash\nrenamer m [OPTIONS]\n```\n\nThe Movie Renamer looks for any files in the input directly, runs them through a simple search algorithm against The Movie Database, then names them in a way that Plex likes.\n\nFor instance, given a file called `star.wars.1977.h264.foo.bar.mkv`, it will match against The Movie DB and rename the file to `Star Wars (1977).mkv`. Special tags will be added for 4k and 1080p movies if the original file name indicates the resolution. Subtitle files (`srt` and `sub` extensions) are treated as English, and `.en` will be inserted before the extension.\n\n\u003e New in 3.2: If the movie year prefixes the title, the year will be dropped before searching.\n\n#### Movie Renamer Options\n\n- `-i \u003cPATH\u003e` or `--input \u003cPATH\u003e` - Input Directory. Defaults to current directory.\n- `-o \u003cPATH\u003e` or `--output \u003cPATH\u003e` - Output Directory. Defaults to the input directory.\n  - Note that files will be **moved** if the input and output directories are not the same.\n- `-y` or `--yes` - Skip Confirmation. If provided, the confirmation prompt before renaming will be skipped. Be aware that files will be renamed (and possibly moved) immediately after matches are made.\n- `--verbose` - Verbose Output. Will show search queries as they are made, as well as other extra output.\n\n### Show Renamer\n\n```bash\nrenamer s [OPTIONS]\n```\n\nThe Show Renamer looks for any files in the input directly, attempts to match the show/season/episode to The Movie DB, then moves the files to a folder structure that Plex likes.\n\nFor instance, given a file called `doctor.who.2005.s01e01.mkv`, it will be moved to `Doctor Who (2005)\\Season 01\\Doctor Who (2005) - s01e01 - Rose.mkv`. In order for the episode to be matched correctly, the season and episode must be in the file name using `sXXeYY` or `YYxZZ`. Any text before the season/episode info is considered to be the show name and is searched against The Movie DB using a similar algorithm to the movie renamer.\n\n\u003e NEW! In 2.4+, you can now prepend the show ID from The Movie DB to the beginning of the filename. Wrap it in double-square brackets to override the show name search. For example, you can name the file something like `[[12345]]some.show.name.s01e01.mkv` to have the show matched directly based on the ID `12345`.\n\n#### Show Renamer Options\n\n- `-i \u003cPATH\u003e` or `--input \u003cPATH\u003e` - Input Directory. Defaults to current directory.\n- `-o \u003cPATH\u003e` or `--output \u003cPATH\u003e` - Output Directory. Defaults to the input directory.\n  - Note that files will be **moved** if the input and output directories are not the same.\n- `-f` or `--files-only` - Files Only Mode. Will not create folders for shows or seasons. Only the files will be renamed. They may still be moved to the output directory.\n- `-r` or `--recurse` - Recursive Mode. Will recursively scan all folders and subfolders to find files in the Input Directory.\n- `-y` or `--yes` - Skip Confirmation. If provided, the confirmation prompt before renaming will be skipped. Be aware that files will be renamed (and possibly moved) immediately after matches are made.\n- `--verbose` - Verbose Output. Will show search queries as they are made, as well as other extra output.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famoscardino%2Frenamer-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famoscardino%2Frenamer-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famoscardino%2Frenamer-core/lists"}