v2.2.1

2024-06-11 – v2.2.1

• Make JSON override switchable (settings.autocue.cue_file.use_json_metadata).
  Defaults to true.
• Minor code cleanup (thanks @vitoyucepi).

v2.1.0

2024-06-09 – v2.1.0

• Prepare for third-party pre-processing software:
  • A JSON file (or stdin) can now be used to set or override any of the
    known tags (see help). Values from JSON override values read from the
    audio file’s tags.
  • This can be used, for example, to set values from a database (like
    AzuraCast’s cue and fade data from their Visual Cue Editor).
  • cue_file might still decide a re-analysis being necessary, so it’s
    wise to re-consolidate the data after cue_file has returned its results.
• More robust variable reading from tags or JSON:
  • Booleans can be bool or string
  • Typechecking on tags with unit suffixes, especially liq_true_peak,
    which was a "dbFS"-suffixed string in v1.2.3 and now is a linear float.
• Added liq_fade_in & liq_fade_out to known tags. We don’t use these,
  but pre-processors might want to set them.
• More advance example in test_autocue.cue_file.liq that shows how
  annotations can be used to play 15-second snippets of songs.

v2.0.3

2024-06-08 - v2.0.3

• Fix ffmpeg erroneously treating .ogg files with cover image as video. The .ogg filetype is now handled by Mutagen.

v2.0.2

2024-06-05 - v2.0.2

• Show autocue.cue_file version number in Liquidsoap log on startup,
  to ease bug hunting. Your cue_file should use the same version.

The log entry looks like this:

2024/06/05 16:16:03 [autocue.cue_file:2] You are using autocue.cue_file version 2.0.2.
2024/06/05 16:16:03 [autocue.cue_file:2] Assure that the external "cue_file" has the same version!

No need to update if you don’t need the version number. v2.0.1 is still fine.

v2.0.1

2024-06-04 - v2.0.1

• Fix small bug when reading already stored liq_true_peak that contained
  a dBFS value from v1.2.3.

v1.2.3

• Safe tag writing: ffmpeg as a tagwriter limited to file types where it’s safe to use.
• Added Mutagen support. If installed, it provides support for:
  • many more file types
  • safe tag writing to the correct tags
  • Install using pip3 install mutagen (preferred), or sudo apt install python3-mutagen
• Much more error checking:
  • Command line parameters now checked for valid ranges
  • Tag writer only writes when safe, and the audio file is writable (not read-only)
  • Various file types, variants and tag formats tested on hundreds of test files.
• Help much more informative, shows:
  • better descriptions
  • whether Mutagen is installed or not
  • supported file types
  • supported and known tags
• Currently supported file types, in alphabetical order:
  • .aac, .aif, .aifc, .aiff, .alac, .ape, .asf, .flac, .m2a, .m4a, .m4b, .m4p,
    .m4r, .m4v, .mp+, .mp2, .mp3, .mp4, .mpc, .ofr, .ofs, .oga, .ogg, .ogv, .opus,
    .spx, .wav, .wma, .wmv, .wv.

Enjoy.