2013-01-01 22:50:25 +01:00
|
|
|
opustags
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
View and edit Opus comments.
|
|
|
|
|
|
2018-11-22 03:40:08 +01:00
|
|
|
The current code quality of this project is getting better, and is suitable for reliably editing any
|
|
|
|
|
Opus file provided it does not contain other multiplexed streams. Only UTF-8 is currently supported.
|
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.
|
|
|
|
|
|
2018-11-25 18:11:36 +01:00
|
|
|
Here's how to install it in your `.local`, under your home:
|
2018-10-31 00:14:34 +01:00
|
|
|
|
|
|
|
|
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:
|
2018-12-18 02:00:27 +01:00
|
|
|
-h, --help print this help
|
|
|
|
|
-o, --output FILE specify the output file
|
|
|
|
|
-i, --in-place overwrite the input file
|
|
|
|
|
-y, --overwrite overwrite the output file if it already exists
|
|
|
|
|
-a, --add FIELD=VALUE add a comment
|
|
|
|
|
-d, --delete FIELD[=VALUE] delete previously existing comments
|
|
|
|
|
-D, --delete-all delete all the previously existing comments
|
|
|
|
|
-s, --set FIELD=VALUE replace a comment
|
|
|
|
|
-S, --set-all import comments from standard input
|
2013-01-01 22:50:25 +01:00
|
|
|
|
|
|
|
|
See the man page, `opustags.1`, for extensive documentation.
|
