{"id":13862484,"url":"https://github.com/tdeerenberg/Musort","last_synced_at":"2025-07-14T12:30:55.225Z","repository":{"id":65545686,"uuid":"592419505","full_name":"tdeerenberg/Musort","owner":"tdeerenberg","description":"A command-line tool for effortlessly organizing and renaming your music files based on metadata","archived":false,"fork":false,"pushed_at":"2024-02-07T21:07:00.000Z","size":69,"stargazers_count":86,"open_issues_count":1,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-08-05T06:05:54.794Z","etag":null,"topics":["music","python","tools"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tdeerenberg.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-01-23T17:36:58.000Z","updated_at":"2024-07-17T14:32:27.000Z","dependencies_parsed_at":"2024-02-07T22:25:46.531Z","dependency_job_id":"66226321-1fa8-4e49-8e2a-5a0ea37e1aff","html_url":"https://github.com/tdeerenberg/Musort","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdeerenberg%2FMusort","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdeerenberg%2FMusort/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdeerenberg%2FMusort/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdeerenberg%2FMusort/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tdeerenberg","download_url":"https://codeload.github.com/tdeerenberg/Musort/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225974480,"owners_count":17553959,"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":["music","python","tools"],"created_at":"2024-08-05T06:01:45.512Z","updated_at":"2025-07-14T12:30:55.200Z","avatar_url":"https://github.com/tdeerenberg.png","language":"Python","funding_links":[],"categories":["Python","\u003ca name=\"file-renamer\"\u003e\u003c/a\u003eFile renamers"],"sub_categories":[],"readme":"\u003e Backup/Mirror of this repository (in case anything happens to this repo on GitHub): \u003cbr\u003e https://git.vigenere.nl/tdeerenberg/Musort\n\nhttps://github.com/tdeerenberg/Musort/assets/113618658/38ce8dc2-7a5f-4edd-9d56-11408d1d56dd\n\n# Musort\nMusort: Effortlessly organize your music library with this Python3 program. Rename selected music/audio files in a folder using a customizable naming convention based on metadata (ID3) from the audio files. Ensure accurate metadata by using popular tools like MusicBrainz Picard, Beets, or EasyTAG before running Musort. Simplify your music organization and enhance file names for a more enjoyable library experience.\n\n## Features\n\n* Rename many audio files at once\n* Rename audio files in subdirectories as well (recursive)\n* Choose the naming convention (ex. track.title.flac or artist.track.year.mp3)\n* Give a separator for the naming of the file (ex. track.title.flac or track_title.flac)\n* Works on all systems that can run Python\n* Supported audio formats  \n  * MP3/MP2/MP1 (ID3 v1, v1.1, v2.2, v2.3+)\n  * Wave/RIFF\n  * OGG\n  * OPUS\n  * FLAC\n  * WMA\n  * MP4/M4A/M4B/M4R/M4V/ALAC/AAX/AAXC\n  * AIFF/AIFF-C\n\n## Dependencies\n**Make sure to install these programs to be able to run Musort**\n- [Python3](https://www.python.org/)\n- [Docker (Optional)](https://docker.com)\n\nThe Python3 library TinyTag is also used, but is already included in this repository. Therefore, there is no need to install TinyTag for only this project.\n\n## Installation and Usage\n\n### Method 1: Run installation script (Unix/Linux based OS only)\n\nThe installation script will move the python program to `~/.local/bin`. The installation directory can be changed in the `install.sh` script. **Note: The installation directory should be added to $PATH**\n``` Bash\ngit clone https://github.com/tdeerenberg/Musort.git\ncd Musort\nchmod +x install.sh\n./install.sh\n```\nAfter that, simply use the command `musort` to use the program.\n\u003chr\u003e\n\n### Method 2: Clone repo and run manually (All Operating Systems)\n\nClone the repository and run the Python program\n``` Bash\ngit clone https://github.com/tdeerenberg/Musort.git\ncd Musort\npip install requirements.txt\n```\nAfter that, run the program with `python3 musort.py`.\n\u003chr\u003e\n\n### Method 3: Docker installation\n\n``` Bash\ngit clone https://github.com/tdeerenberg/Musort.git\ncd Musort\ndocker build -t musort .\n```\nAfter the Docker installation/build is complete, Musort can be run with: \n\n`docker run --name musort --rm -v \"[music_directory_host]:[music_directory_container]\" -it musort [music_directory_container]`\n\nThe music folder must be mounted to the Docker container, therefore the `-v` option must be used to mount the directory.\n\nAn example of running Musort in Docker, using `/home/user/music` as music folder:\n\n`docker run --name musort --rm -v '/home/user/music:/music' -it musort /music`\n\n## Manual with options and arguments (`musort --help`)\n```\nUSAGE:\nmusort [DIRECTORY] [OPTIONAL_PARAMETERS]\n    USAGE EXAMPLES:\n    musort ~/music\n    musort /local/music -f disc.artist.title.album -r\n    musort ~/my_music -s _ -r\n    \nOPTIONAL OPTIONS:\n-h, --help           Show the help menu\n-f, --format         set the naming convention (see 'NAMING CONVENTION:' below)\n-s, --separator      Set the separator for the filename (ex. '-s .' -\u003e 01.track.flac and '-s -' -\u003e 01-track.mp3)\n                     Default separator '_' will be used if none is given\n-r, --recursive      Rename files in subdirectories as well\n-v, --version        Prints the version number\n\nNAMING CONVENTION:\nFORMAT_OPTION.FORMAT_OPTION...      The amount of format options does not matter.\n                                    It can be one, two, three, even all of them.\n                                    (See FORMAT OPTIONS below for all options)                      \nFORMAT OPTIONS:\nalbum           album as string\nalbumartist     album artist as string\nartist          artist name as string\naudio_offset    number of bytes before audio data begins\nbitdepth        bit depth for lossless audio\nbitrate         bitrate in kBits/s\ncomment         file comment as string\ncomposer        composer as string \ndisc            disc number\ndisc_total      the total number of discs\nduration        duration of the song in seconds\nfilesize        file size in bytes\ngenre           genre as string\nsamplerate      samples per second\ntitle           title of the song\ntrack           track number as string\ntrack_total     total number of tracks as string\nyear            year or date as string\n```\n\n## Possible features to add\n* Rename single file\n* Other installation methods (e.g. via AUR)\n* Open for suggestions!\n* Feel free to open a pull request or issue!\n\n## Authors\n\n- [@tdeerenberg](https://github.com/tdeerenberg)\n\n## License\n\n[GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0/)\nPermissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftdeerenberg%2FMusort","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftdeerenberg%2FMusort","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftdeerenberg%2FMusort/lists"}