Skip to content

sudormrfbin/clid

Repository files navigation

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.

clid main window

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