https://github.com/kkoomen/omnitagger
Omnitagger is a CLI tool for beautifying your music files and adding metadata automatically to your files
https://github.com/kkoomen/omnitagger
beautify cli meta-tags music music-files omnitagger tagger
Last synced: about 1 year ago
JSON representation
Omnitagger is a CLI tool for beautifying your music files and adding metadata automatically to your files
- Host: GitHub
- URL: https://github.com/kkoomen/omnitagger
- Owner: kkoomen
- License: mit
- Created: 2017-01-22T20:17:51.000Z (over 9 years ago)
- Default Branch: develop
- Last Pushed: 2021-11-21T11:39:55.000Z (over 4 years ago)
- Last Synced: 2025-04-09T04:47:55.548Z (about 1 year ago)
- Topics: beautify, cli, meta-tags, music, music-files, omnitagger, tagger
- Language: Python
- Homepage:
- Size: 37.1 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# omnitagger
[](https://pypi.python.org/pypi/omnitagger)
[](https://codeclimate.com/github/kkoomen/omnitagger)
Omnitagger is a CLI tool for beautifying your music files and adding metadata
automatically to your files. It provides fingerprint lookup via
[acoustid](https://github.com/beetbox/pyacoustid). Wether this is specified or
not: after that it will check for the `artist - title.{mp3,flac,ogg}` format.
If that pattern isn't found either, it will check the directory the file is in,
since it is a common case that when you download an album, the structure is:
```
artist-name/
├── title.mp3
├── title.mp3
├── title.mp3
└── title.mp3
```
If that isn't an options either, it will skip the file and continue to the next
one. For more information on how omnitagger works, visit the
[How it works](https://github.com/kkoomen/omnitagger/wiki/How-it-works) page on
the wiki.
# Installation
NOTE: If you have python 3.7+ installed, you won't be able to use the
fingerprint module. This due to it needs the Chromaprint module and this one is
not compatible yet with Python 3.7+.
- `$ pip install omnitagger`
- Download the [Chromaprint](https://beets.readthedocs.io/en/v1.4.7/plugins/chroma.html#installing-the-library) library.
# Documentation
Visit the [documentation](https://github.com/kkoomen/omnitagger/wiki/Documentation)
on the wiki for further details on how to use omnitagger.
# The purpose of omnitagger
The purpose of omnitagger was a personal issue we all can relate to in the early
days: You download an album or song using a YouTube converter (or oldschool
Limewire/Frostwire back in those days) and the names do look horrible. Names
with numbers in front of it while it is already in the metatags, underscores
instead of spaces... you get it. This was an issue me and a friend of mine
always had and I suddenly had the idea to create a python script to make from an
ugly and horrible-looking filename a good-looking filename with metatags set
correctly automatically. Once I had the idea I kept building and building and
sometimes even rebuilding the whole script to make it better and more efficient.
# License
MIT.