Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fernandotcl/btag
Command line based audio file tagger
https://github.com/fernandotcl/btag
Last synced: about 2 months ago
JSON representation
Command line based audio file tagger
- Host: GitHub
- URL: https://github.com/fernandotcl/btag
- Owner: fernandotcl
- License: bsd-2-clause
- Created: 2010-08-09T00:04:30.000Z (about 14 years ago)
- Default Branch: master
- Last Pushed: 2020-11-17T10:13:07.000Z (almost 4 years ago)
- Last Synced: 2024-05-02T11:58:47.049Z (5 months ago)
- Language: C++
- Homepage:
- Size: 192 KB
- Stars: 7
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# btag
[](https://travis-ci.com/fernandotcl/btag)
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.
[easytag]: http://easytag.sourceforge.net/
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
[taglib]: http://developer.kde.org/~wheeler/taglib.html
## Usage
Simply launch btag specifying the directory containing the audio files you want to tag:
```sh
$ 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:
```sh
$ 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][tap].
[homebrew]: http://mxcl.github.com/homebrew/
[tap]: https://github.com/fernandotcl/homebrew-fernandotcl
If you're compiling from source, you will need:
* [Boost][] >= 1.49.0 (filesystem, locale and system)
* [libcue][]
* [libedit][]
* [TagLib][]
* [pkg-config][]
* [CMake][]
[boost]: http://www.boost.org/
[libcue]: http://sourceforge.net/projects/libcue/
[libedit]: https://www.thrysoee.dk/editline/
[taglib]: http://taglib.github.com/
[pkg-config]: http://www.freedesktop.org/wiki/Software/pkg-config
[cmake]: http://www.cmake.org/
To compile and install:
```sh
cd /path/to/source
cmake .
make install
```
## Credits
btag was created by [Fernando Tarlá Cardoso Lemos][fernando].
[fernando]: mailto:[email protected]
## License
btag is available under the BSD 2-clause license. See the LICENSE file for more information.