opustags/README.md

65 lines
1.8 KiB
Markdown
Raw Normal View History

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
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.