tlk-tune v0.2.0

Added

• The cover is drawn as a real picture in terminals that speak kitty's
  graphics protocol or sixel, at the resolution the panel can actually hold
  rather than one pixel per half cell. AlbumArtMode picks the protocol, or
  leaves it to be worked out from the terminal; half blocks stay the default
  and the fallback.
• --config <file> points the whole profile — settings, session, statistics —
  at another folder, so the player can run from a stick.
• --preview takes --rows for a given window height and --screen for the
  settings and help screens, and renders the frame the window really settles
  on rather than an empty one.
• Linux and macOS builds. --install has a unix half: ~/.local/bin, plus a
  desktop entry on Linux so a file manager offers it for audio files.
• Releases carry a SHA256SUMS file, and CI checks the declared minimum Rust
  version and the advisory database.
• Sorting by album, which groups a library the way it was bought rather than
  the way it was named. Files with no album tag group by folder instead.
• w saves the queue, or whatever the list is showing after a search or a
  filter, as an extended m3u8 beside your music. Paths are written
  relative where they can be, so moving the folder does not break the list.

Changed

• The PCM buffer is taken in blocks rather than one allocation sized from
  the duration in the container. A stream that would not say how long it
  was used to stop after ten minutes, and a short track paid for a long
  one.

Fixed

• --preview looked for a cover inside the file but not beside it, unlike the
  player itself.
• Whether a console was really attached was only ever checked on Windows, so
  redirecting the output anywhere else would have drawn frames forever.
• The manifest claimed a minimum Rust version that its own dependencies did
  not support.

Checking a download

sha256sum -c SHA256SUMS            # linux, macos
Get-FileHash <file> -Algorithm SHA256   # windows

tlk-tune v0.1.0

First release.

Playback

• Native decoding through symphonia for MP3, FLAC, WAV, OGG, Opus, M4A, AAC
  and AIFF. No ffmpeg, no codec pack, one executable.
• WASAPI output through cpal. The device opens on the first track and stays
  open, so track changes are gapless.
• Optional crossfade of up to twelve seconds, started before the outgoing
  track ends so the two actually overlap.
• Ten band equaliser, 31 Hz to 16 kHz at ±12 dB, with seven presets. Flat is
  bypassed entirely.
• Volume levelling to EBU R 128. Each track is measured once and corrected
  from the first sample on every later play, with a soft limiter in place of
  hard clipping.
• Playback starts while the file is still decoding; seeking is clamped to what
  has been decoded so it never lands in silence.

Library

• Folders and m3u, m3u8 and pls playlists are both valid library roots.
  ~, %VAR% and $VAR are expanded.
• Tag reads are cached by size and modification time, so only new or edited
  files are opened again on a later start.
• Search ignores accents: oguzhan finds Oğuzhan, dunya finds Dünya.
• Views for all, liked, most played and recently played, plus artist and
  folder filters and four sort orders.
• Play counts are recorded once a track has really been listened to.

Interface

• Mouse throughout: the transport buttons, the waveform as a seek bar, the
  volume bar, rows, the queue, the wheel, and every control in the settings.
• Album art drawn in colour from the embedded cover or a cover.jpg beside
  the track; a procedural spinning record when there is none.
• Live FFT spectrum, braille waveform, and an audio reactive sphere.
• Synced lyrics with word level highlighting from a sidecar .lrc or LRCLIB,
  shiftable per track when the published timings do not match the recording.
• Settings screen with seven tabs covering colours, elements, animation, the
  equaliser, library folders, hotkeys and about.
• English and Turkish, switchable without restarting.
• Fits the window: the list shrinks on a short terminal and the record panel
  steps aside rather than letting the frame scroll away.

Elsewhere

• Online search, streaming over HTTP range requests and downloads through
  yt-dlp when it is installed.
• Media keys work while the terminal is in the background.
• The track, position, volume and queue survive between runs.
• --config points the whole profile — settings, session and statistics — at
  another folder, so the player can run from a stick.
• --install puts the player on the user PATH under both tlk-tune and
  tune, and adds a right-click entry for audio files. --uninstall reverses
  all of it. Neither needs administrator rights.