https://github.com/sudormrfbin/clid
Edit mp3 tags in the terminal, tui style
https://github.com/sudormrfbin/clid
cli command-line command-line-tool curses-ui id3v2 id3v2-tag mp3-files mp3-tags music ncurses tagger tagging taggingtools tags terminal tui ubuntu
Last synced: 10 months ago
JSON representation
Edit mp3 tags in the terminal, tui style
- Host: GitHub
- URL: https://github.com/sudormrfbin/clid
- Owner: sudormrfbin
- License: mit
- Created: 2017-05-21T09:25:55.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-06-22T16:55:49.000Z (over 5 years ago)
- Last Synced: 2025-03-27T21:38:55.285Z (10 months ago)
- Topics: cli, command-line, command-line-tool, curses-ui, id3v2, id3v2-tag, mp3-files, mp3-tags, music, ncurses, tagger, tagging, taggingtools, tags, terminal, tui, ubuntu
- Language: Python
- Homepage:
- Size: 845 KB
- Stars: 16
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# clid
> Note: Clid is being rewritten at the moment, in the [rewrite](https://github.com/gokulsoumya/clid/tree/rewrite)
> branch. Don't let that stop you from opening issues, though :)
Clid is a command line app for editing tags of mp3 files. Clid is different from other
command line tools to edit tags, as you can edit tags in a curses based ui.
## Installation
See [wiki](docs/docs/index.md) for detailed installation instructions.
### Using pip
```shell
$ [sudo] pip3 install clid
```
### From Source
```shell
$ git clone https://github.com/GokulSoumya/clid.git
$ cd clid
$ [sudo] python3 setup.py install
```
### Updating
To update the app, run
```shell
$ [sudo] pip install -U clid
```
You can launch the app by entering `clid` in the command line.
## Usage
### Quick Start
1. Move with arrow keys or `j` and `k`.
2. Enter to select a file.
3. Edit the tags.
4. `OK` to save the tags or `Cancel` to abort edit.
5. Type `:q` at main window to quit.
See the [wiki](docs/docs/index.md) for documentation and additional details.
## Changelog
### v0.7.0
- Fix resize issue
- Created documentation
- Customizable keybindings
- Refactor the whole codebase
- Autocomplete in genre tag field
- Key binding for quitting app(^Q)
- Tag multiple files at the same time
- Invert selection made for batch tagging
- Edit filename from inside the tag editor
- Show correct tag preview when changing directory
- Option for using regular expressions while searching
- Genre can now be displayed in the status line preview
- Short description of preferences option in status line
- Save position of cursor in the tag editorwhen editing files
### v0.6.3
- Vi keybindings
- Added option for smooth scroll
- Preferences are now saved when updating the app
- Validators for `smooth_scroll` and `preview_format`
- Display a "What's New" Popup when app is run after an update
## Thanks
I couldn't have made this app without these amazing libraries:
- [npyscreen](https://bitbucket.org/npcole/npyscreen), a Python wrapper around ncurses.
- [stagger](https://github.com/lorentey/stagger), an ID3v1/ID3v2 tag manipulation package written in pure Python 3
- [configobj](https://github.com/DiffSK/configobj), a Python 3+ compatible port of the configobj library