Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A command line based audio file tagger

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 man
Octocat-spinner-32 src
Octocat-spinner-32 tests
Octocat-spinner-32 .gitignore
Octocat-spinner-32 CMakeLists.txt
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md
Octocat-spinner-32 screenshot.png
README.md

Introduction

btag is a command line based audio file tagger. It retains information about the filesystem structure so that you can tag a bunch of albums with ease. In some ways, btag can be compared to graphical taggers like EasyTAG as both allow you to tag a lot of audio files in batches.

btag screenshot

A brief list of features:

  • Tagging of a vast number of formats supported by TagLib
  • Tag normalization and filtering
  • Locale-aware title capitalization
  • Renaming of files and directories
  • Reading metadata from cue sheets

Usage

Simply launch btag specifying the directory containing the audio files you want to tag:

$ btag /music/stuff

The media files in the directory will be read and their tags will be presented in your terminal. You can choose to edit the value of the tags or to simply confirm the values that were read from the file.

In order to extract the most from btag, configure it so that it can filter the values read from the tags before they are presented to you. That allows you to have btag apply title capitalization to the values in the tags, for instance. Use the command line switches specified in btag(1) to configure the filters btag will use.

You might want to set a shell alias instead of typing all the switches every time you run btag:

$ alias btag='btag -f title -t en -d "%album (%year)" -r "%track. %title"'

Note that you can override the switches you specified in the alias.

Installing

The easiest way to install btag is through Homebrew. There is a formula for btag in my Homebrew tap.

If you're compiling from source, you will need:

To compile and install:

cd /path/to/source
cmake .
make install

Credits

btag was created by Fernando Tarlá Cardoso Lemos.

License

btag is available under the BSD 2-clause license. See the LICENSE file for more information.

Something went wrong with that request. Please try again.