Vesari Stylus ← vesaristylus.com

Help  /  Your library

Tagging DTS, AC-3 and WAV files (.tags sidecars)

Some audio formats have nowhere inside them to put a title, an artist or an album. For those, Vesari Stylus keeps the tags in a small companion file that sits next to the audio and travels with it.

Which formats need a sidecar

Six file types are treated as raw bitstreams: .dts, .dtshd, .ac3, .eac3, .thd and .truehd. Each is an audio stream on its own, with no container around it and so no agreed place to put a tag. Editing one of these tracks never writes into the audio file, because there is nothing to write into.

WAV is a different case

WAV was also defined without a tag area, but a long-standing convention added one: an ID3 chunk, the same sort of tag an MP3 carries. A WAV's tags go inside the WAV itself, and a .tags sidecar is never written beside one, not even a WAV holding a DTS stream from an old audio-CD rip. See Tags will not save to a WAV file.

What the sidecar actually is

A plain UTF-8 JSON text file, sitting in the same folder as the audio and named after the whole audio filename with .tags on the end. Concert.dtshd gets Concert.dtshd.tags, so a.dts and a.dtshd in one folder never fight over the same sidecar.

Inside is a list of tag entries in the shape foobar2000's m-TAGS component uses, with field names from the Vorbis and Picard vocabulary FLAC users will recognise.

What travels in it What does not
TITLE, ARTIST, ALBUMARTIST, ALBUM Cover art of any kind
Track and disc numbers and totals Loudness measurements
DATE, original date, GENRE, COMMENT Play counts, favourites, ratings
Composer, conductor, work, movement, BPM, key
Label, catalogue number, copyright, lyrics, sort names, MusicBrainz ids

Each entry also carries an @ field holding the audio file's name with no folder path in it, which keeps the pair matched after a move to a different folder. Keys written by other tagging programs survive a rewrite, and a field you clear in the tag editor is cleared here too. Artwork is not carried, so for these tracks put a cover image in the album folder instead. See Cover art.

How one gets written

  1. Edit the track and save. Open a raw-bitstream track in the tag editor, change what you need and press Save. Your library updates and the sidecar is rewritten to match. See The tag editor.
  2. Backfill in bulk. Library Health carries a card called DTS/AC-3 tag sidecars with a Write .tags button. It walks every raw-bitstream track in your library, writes a sidecar for each one that has something worth writing, then reports how many it wrote out of how many it found, how many had no metadata, and how many failed. It is the quick way to make Super-Tag results portable.

The card counts raw-bitstream tracks whose sidecar has not been written or has gone stale. It does not add to the headline count of tracks needing attention, because nothing here is broken, and once every sidecar is current it shows a tick instead. See Library Health counts.

Three things catch people out:

How it gets read back

If the audio moves without it

Treat the .tags file as part of the track.

Still not right

If a raw-bitstream track shows no tags even though a .tags file sits beside it, check the two names match exactly, then report it from the Report a Bug section in Settings. See How to report a bug.