2013-01-01 22:50:25 +01:00
|
|
|
opustags
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
View and edit Opus comments.
|
|
|
|
|
|
2018-10-28 02:23:24 +02:00
|
|
|
The current code quality of this project is in a sorry state, but that might
|
|
|
|
|
change in the near future. It is expected to work well though, so please do
|
|
|
|
|
open an issue if something doesn't work. New contributions are welcome but make
|
|
|
|
|
sure you read CONTRIBUTING.md first.
|
2017-10-01 12:26:56 +02:00
|
|
|
|
2018-10-28 02:23:24 +02:00
|
|
|
Until opustags becomes top-quality software, if it ever does, you might want to
|
|
|
|
|
check out these more mature tag editors:
|
2017-10-01 12:26:56 +02:00
|
|
|
|
|
|
|
|
- [EasyTAG](https://wiki.gnome.org/Apps/EasyTAG)
|
|
|
|
|
- [Beets](http://beets.io/)
|
|
|
|
|
- [Picard](https://picard.musicbrainz.org/)
|
|
|
|
|
- [puddletag](http://docs.puddletag.net/)
|
|
|
|
|
- [Quod Libet](https://quodlibet.readthedocs.io/en/latest/)
|
|
|
|
|
- [Goggles Music Manager](https://gogglesmm.github.io/)
|
|
|
|
|
|
|
|
|
|
See also these libraries if you need a lower-level access:
|
|
|
|
|
|
|
|
|
|
- [TagLib](http://taglib.org/)
|
|
|
|
|
- [mutagen](https://mutagen.readthedocs.io/en/latest/)
|
|
|
|
|
|
2013-01-02 10:04:25 +01:00
|
|
|
Requirements
|
|
|
|
|
------------
|
|
|
|
|
|
2018-10-30 23:28:12 +01:00
|
|
|
* a C++14 compiler,
|
2018-10-31 00:14:34 +01:00
|
|
|
* CMake,
|
2018-10-30 23:28:12 +01:00
|
|
|
* a POSIX-compliant system,
|
2013-01-02 10:04:25 +01:00
|
|
|
* libogg.
|
|
|
|
|
|
2013-01-01 22:50:25 +01:00
|
|
|
Installing
|
|
|
|
|
----------
|
|
|
|
|
|
2018-10-31 00:14:34 +01:00
|
|
|
opustags is a commonplace CMake project.
|
|
|
|
|
|
|
|
|
|
Here's how to install it in your .local, under your home:
|
|
|
|
|
|
|
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
cmake -DCMAKE_INSTALL_PREFIX=~/.local ..
|
2013-01-01 22:50:25 +01:00
|
|
|
make
|
2018-10-31 00:14:34 +01:00
|
|
|
make install
|
|
|
|
|
|
|
|
|
|
Note that you don't need to install opustags in order to run it, as the executable is standalone.
|
2013-01-01 22:50:25 +01:00
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Usage: opustags --help
|
|
|
|
|
opustags [OPTIONS] FILE
|
|
|
|
|
opustags OPTIONS FILE -o FILE
|
|
|
|
|
|
|
|
|
|
Options:
|
|
|
|
|
-h, --help print this help
|
|
|
|
|
-o, --output write the modified tags to a file
|
|
|
|
|
-y, --overwrite overwrite the output file if it already exists
|
|
|
|
|
-d, --delete FIELD delete all the fields of a specified type
|
|
|
|
|
-a, --add FIELD=VALUE add a field
|
|
|
|
|
-s, --set FIELD=VALUE delete then add a field
|
|
|
|
|
-D, --delete-all delete all the fields!
|
|
|
|
|
-S, --set-all read the fields from stdin
|
|
|
|
|
|
|
|
|
|
See the man page, `opustags.1`, for extensive documentation.
|
