opustags/README.md
2020-12-26 16:51:36 +01:00

2.2 KiB

opustags

View and edit Ogg Opus comments.

opustags is designed to be fast and as conservative as possible, to the point that if you edit tags then edit them again to their previous values, you should get a bit-perfect copy of the original file. No under-the-cover operation like writing "edited with opustags" or timestamp tagging will ever be performed.

It currently has the following limitations:

  • The total size of all tags cannot exceed 64 kB, the maximum size of one Ogg page.
  • Multiplexed streams are not supported.
  • Newlines inside tags are not supported by --set-all.

If you'd like one of these limitations lifted, please do open an issue explaining your use case. Feel free to ask for new features too.

Requirements

  • a POSIX-compliant system,
  • a C++17 compiler,
  • CMake ≥ 3.9,
  • libogg 1.3.3.

The version numbers are indicative, and it's very likely opustags will build and work fine with other versions too, as CMake and libogg are quite mature.

Installing

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

Note that you don't need to install opustags in order to run it, as the executable is standalone.

Documentation

Usage: opustags --help
       opustags [OPTIONS] FILE
       opustags OPTIONS -i FILE...
       opustags OPTIONS FILE -o FILE

Options:
  -h, --help                    print this help
  -o, --output FILE             specify the output file
  -i, --in-place                overwrite the input files
  -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
  -e, --edit                    edit tags interactively in VISUAL/EDITOR
  --raw                         disable encoding conversion

See the man page, opustags.1, for extensive documentation.