README.md

clid

Note: Clid is being rewritten at the moment, in the 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 for detailed installation instructions.

Using pip

$ [sudo] pip3 install clid

From Source

$ git clone https://github.com/GokulSoumya/clid.git
$ cd clid
$ [sudo] python3 setup.py install

Updating

To update the app, run

$ [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 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, a Python wrapper around ncurses.
• stagger, an ID3v1/ID3v2 tag manipulation package written in pure Python 3
• configobj, a Python 3+ compatible port of the configobj library