Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/krmax44/taggler
Quickly equip your local music files with high quality ID3 tags.
https://github.com/krmax44/taggler
cli id3 music tagger tagging tool
Last synced: 4 days ago
JSON representation
Quickly equip your local music files with high quality ID3 tags.
- Host: GitHub
- URL: https://github.com/krmax44/taggler
- Owner: krmax44
- License: mit
- Created: 2019-08-12T15:34:45.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-05-16T19:26:30.000Z (over 2 years ago)
- Last Synced: 2024-05-22T18:07:03.819Z (6 months ago)
- Topics: cli, id3, music, tagger, tagging, tool
- Language: TypeScript
- Size: 722 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Taggler
[](https://travis-ci.com/krmax44/taggler)
Taggler is a CLI to quickly equip your local music files with high quality ID3 tags. It supports multiple data sources and ID3 writers.
## Installation and Usage
With `npm`:
```bash
npm i -g taggler # you may need to run it as root, depending on your npm install
taggler "Smash Mouth - All Star.mp3"
```
or run it without installing using `npx`:
```bash
npx taggler "Smash Mouth - All Star.mp3"
```
You can also tag multiple files or directories at once:
```bash
taggler "Cory Wong - The Optimist/" # tag whole directory
taggler . # tag all files in current directory
taggler "Smash Mouth - All Star.mp3" "Cory Wong - Light as Anything.mp3" # tag multiple files
```
## System
Taggler is divided up into scrapers, writers and the Taggler CLI, that communicates with the former ones. Scrapers (like the Spotify scraper) try to find as much metadata about a file, which is then passed to a writer (like the ffmpeg writer) which actually bakes the data into the previously untagged file. This allows for various data sources and infinite customisability.
## Contributing
```bash
# 1. Fork the repo and clone it:
git clone "https://github.com/$USER/taggler.git"
cd taggler
# 2. Install dependencies and link them
yarn
yarn bootstrap
# 3. Create a branch
git checkout -b feat/my-cool-feature
# 4. Begin coding!
code . && exit
# 5. Push and create PR
git push
```