https://github.com/blackvoidx/musort
This project is a toolkit to streamline music file management, allowing interactive metadata editing and automated renaming based on chosen metadata fields.
https://github.com/blackvoidx/musort
Last synced: 5 days ago
JSON representation
This project is a toolkit to streamline music file management, allowing interactive metadata editing and automated renaming based on chosen metadata fields.
- Host: GitHub
- URL: https://github.com/blackvoidx/musort
- Owner: blackvoidx
- Created: 2024-10-31T12:20:07.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-31T13:22:22.000Z (over 1 year ago)
- Last Synced: 2025-09-08T22:32:42.529Z (10 months ago)
- Language: Python
- Size: 6.84 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Musort & Muedit Music Metadata Toolkit.
## Overview
**Musort** and **Muedit** are Python-based scripts designed to streamline music file organization and metadata management. `muedit.py` enables interactive editing of music file metadata, while `musort.py` renames files based on metadata fields, helping to keep your music library organized.
---
## Installation
Ensure Python 3 is installed, then install the required packages:
```bash
pip install mutagen colorama
```
For metadata editing, make sure **ffmpeg** is installed:
```bash
# Install ffmpeg on Ubuntu
sudo apt install ffmpeg
# Install ffmpeg on MacOS
brew install ffmpeg
```
---
## Usage
### Muedit.py
Use `muedit.py` to view and edit metadata for a single music file or an entire folder interactively.
#### Command
```bash
python muedit.py /path/to/music_or_folder --sort
```
#### Example
```bash
python muedit.py /music/collection --sort
```
#### Explanation
- **`--sort`**: After editing metadata, this option triggers `musort.py` to rename the files based on chosen metadata fields.
> **Note:** `--sort` assumes that `musort.py` is in the same directory as `muedit.py`.
---
### Musort.py
Use `musort.py` to rename music files based on specific metadata fields.
#### Command
```bash
python musort.py /path/to/music_or_folder -f artist.title -s "-"
```
#### Example
```bash
python musort.py /music/collection -f album.artist -s "_"
```
#### Explanation
- **`-f`**: Sets the renaming format, e.g., `artist.title`.
- **`-s`**: Defines a separator between fields (default: "-").
---
## Contributing
Contributions to `musort` and `muedit` are welcome! Please fork the repository and submit a pull request. Make sure to follow standard code formatting and add appropriate comments to new functionality.