radio-cli 0.13.0

A lightweight terminal radio and podcast player
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
# Changelog

## 0.13.0 — 2026-11-19

- Fix Enter doing nothing on Apple podcast search results. Convert the
  directory's media type into an actionable TUI row so results open their RSS
  preview and can be confirmed or revisited with Esc.

- Add podcast discovery with regional charts, 19 categories and random chart
  candidates in the CLI and TUI. Press D to discover and R to shuffle a chart.
  Resolve public feeds on selection, show known subscriptions, and keep directory
  refreshes in their current context with caching and rate-limit feedback.
- Restore podcast search, chart and preview results with their cursor and scroll
  on Esc, including after jumping to playback. Show playback state on the parent
  podcast independently of the user's selection.

- Add saved episodes, inbox and history views, bookmarks, chapters and
  per-show listening preferences. Restore the current episode across browsing
  views and keep failed browse requests from leaving the list loading.

- Generate TUI podcast captions incrementally from seekable audio windows.
  Publish each segment immediately, prioritize the playing position after seeks,
  keep the model warm, and resume saved partial coverage after cancellation.
  Full episode downloads are no longer required for TUI generation.

- Add podcast action menus for the playing or selected episode. Default common
  TUI commands to the player, show titles instead of IDs in download lists,
  and offer explicit local caption generation.
  Keep caption tasks running while browsing and bind imports to their named
  episode even when playback advances.

- Synchronize podcast VTT/SRT captions to playback, including resume, seeking,
  pause and speed changes. Fetch feed captions, import local files, or generate
  and cache speech segments from downloaded episodes using local models.
- Display wrapped subtitles with context in Details, highlight the active
  segment, and support manual scrolling, follow mode and an information toggle.
  Reduce the bottom subtitle strip to one status row.
- Restore the previous panel focus on Esc after locating the playing episode.
  Preserve the chosen view and caption reading mode across podcast navigation
  and Alt+Left/Right seeks. New playback sessions restore following.
- Label manual caption reading in Details and the bottom strip. Keep the
  shortcut to resume following visible on narrow terminals and show failures
  first when captions fail.

- Extract artist and track names from RadioInfo XML carried by HLS/ID3 or
  ICY streams, including Cidade. Use readable titles in playback and recording
  metadata while retaining station announcements and partial track names.
- Update bundled SQLite to 3.54.1 for RUSTSEC-2026-0459.

### Compatibility

- Building from source now requires Rust 1.89 or newer.
- Opening a database migrates it to schema v10, adding listening-library tables
  and revision tracking while preserving existing subscriptions, progress,
  downloads and queues. Version 0.12.0 and earlier cannot reopen the upgraded
  database. To retain the option of downgrading, close radio-cli and back up
  the entire data directory before upgrading.

## 0.12.0 — 2026-11-08

- Add public RSS/Atom podcast subscriptions, Apple directory search and feed
  discovery, episode progress and seeking, offline downloads with validated
  resume, an explicit listening queue, OPML exchange, and playback speed.
  Expose podcast commands in the CLI and TUI with English and Chinese messages.
  Keep finite episode completion separate from live radio reconnection.
- Restore the last episode and its page without autoplay in selection mode,
  or resume playback with the existing playback resume setting. Keep podcast
  subscriptions, progress, history, speed and queue independent of live radio.
- Validate partial response ranges and download media fingerprints, retain
  incomplete transfers for explicit resume, and replace outdated downloads
  only when downloading again. Keep queue changes and completion atomic while
  saving session progress and advancing playback away from media controls.
- Include English and Chinese podcast guides in release archives.

### Compatibility

- Existing databases migrate atomically to schema v9 on first open, adding
  podcast subscriptions, episodes, progress, history, downloads and queue
  tables. Earlier binaries, including 0.11.1, cannot open an upgraded database.
  Close radio-cli and back up the data directory before upgrading if you need
  to retain the option of downgrading.
- Public RSS 2.0 and Atom HTTP(S) audio feeds are supported. Private accounts,
  paid-content access and platform account synchronization are not supported.
  Playback and downloads still require external mpv, FFmpeg and ffprobe.

## 0.11.1 — 2026-11-06

- Accept Hong Kong and Macao short-name prefixes (`香港`, `澳门`, `香`, `澳`)
  in country filter candidates and `countries --prefix`, keeping full Chinese
  display names, country codes, and station counts.
- Match country filter candidates by code or Chinese-name prefix, including
  single characters, in the TUI and `countries --prefix`. Keep country codes
  and station counts in the results and apply limits after matching.

## 0.11.0 — 2026-11-01

- Keep TUI volume preferences and playback history off the media thread,
  coalescing preference updates for up to 250 ms and flushing queued changes
  during normal shutdown. Report terminal writer failures and finish cleanup
  even when persistence fails; report continuous database lock contention after
  thirty seconds and reject further queued updates. During shutdown, use the
  separate cleanup deadline for flush retries. Report writer thread panics as
  terminal failures without waiting for the cleanup deadline.
- Preserve the normal five-second lock wait for favorites, custom stations,
  refreshed stream metadata, and recording index writes. These operations may
  still wait briefly during catalog publication; background session writes
  use a separate connection with a 100 ms lock wait and retries.
- Interrupt superseded list, position, and facet queries while they run.
  Invalidate list caches only for relevant content changes, keeping random
  pages stable when preferences or unrelated library data change.
- Publish catalog snapshots by updating changed stations and facet counts,
  retaining indexes for unchanged data. Drive history queries from the bounded
  playback log and use an index for recording-library date ordering.
- Share typed station commands and diagnostics between CLI and TUI.

### Compatibility

- Existing databases migrate atomically to schema v8 on first open. Upgrading
  from v6 adds `content_revisions`, twelve revision triggers across stations,
  favorites, history, and recordings, and the `recording_started` expression
  index. Binaries supporting schema v6 or earlier cannot open an upgraded
  database; keep a pre-upgrade copy if downgrade support is needed.
- Rust library API: `Engine` no longer dereferences to `Session`, and `Session`
  is private. Replace field reads with `status()`, `config()`, `store()`,
  `subtitles()`, and `playback_failed()`. These return read access; mutate
  playback through `Engine` methods instead of changing session fields.
- Replace mutable store access through `Engine` with `toggle_favorite()` and
  `change_station(StationCommand::{Add, Edit, Remove, Backups})`. Directory
  operations are available through `bootstrap()`, `sync()`,
  `sync_with_policy()`, `refresh_station()`, and `report_click()`; directory
  calls perform blocking I/O. `refresh_station()` fetches metadata without
  persisting it. `Store::list_revision()` exposes an opaque list cache key;
  `Store::revision()` remains connection activity for diagnostics only.
- Abrupt termination can lose queued TUI preferences or recent playback-history
  entries. Sustained database lock contention also leaves queued changes unsaved
  and reports a terminal writer failure after thirty seconds; session persistence
  stays unavailable until the TUI is restarted. Normal shutdown attempts to flush
  pending changes within its cleanup budget and reports failure if they cannot
  be saved.

## 0.10.0 — 2026-10-31

- Add offline world-map exploration to the TUI. Open **Explore** in Sources or
  run `:explore`; wide terminals show the map beside the station list, and
  narrow ones focus it with `6`. Click a map cell to list its stations, move the
  cursor with arrows or `hjkl`, zoom with `z` / `Z` up to 8×, zoom the wheel
  around the pointer, return to the world with `0`, and press `Enter` to focus
  the results. `:focus` accepts `map` beside the existing panels.
- Render the map from the bundled public-domain Natural Earth 110m land outline
  without online tiles. Keep the fine Braille dots — up to eight subpixels per
  terminal cell — and color them by station density: blue, teal, amber, and red
  mark 1–9, 10–49, 50–199, and 200+ stations per cell, with a legend under the
  map. Stations in empty sea cells use a single dot, the selected cell uses a
  large circle that keeps its density color, and monochrome mode underlines
  station cells without colors.
- Browse stations without coordinates by country/region with `c` in Explore,
  returning to the map with `Esc`. Clearing search and filters keeps the
  selected map cell.
- Store station coordinates and expose them as nullable `geo_lat` and
  `geo_long` in JSON station objects; existing fields are unchanged.
- Keep the map responsive: interactive queries preempt in-progress map reads,
  filtered geographic queries use the new spatial index, and coordinates are
  computed once per write.

### Compatibility

- Existing databases migrate atomically to schema v6 on first open, adding the
  coordinate columns, a partial spatial index, and a geographic revision
  counter, and backfilling coordinates from stored station JSON. Older binaries
  cannot open the upgraded database; keep a pre-upgrade copy if downgrade
  support is needed.
- Existing catalogs carry no coordinates until `radio sync` runs, so the map
  starts empty. The map uses only complete, valid coordinate pairs and never
  infers locations; stations without coordinates stay reachable through the
  country chooser, Favorites, and the list.
- Geographic metadata comes from station submissions and may be inaccurate.
  Small islands and enlarged coastlines are simplified in the bundled outline.

## 0.9.2 — 2026-10-29

- Render TUI artwork with native Sixel in compatible tmux sessions, using the
  attached client's features and pixel cell size without enabling passthrough.
  Require the server's Sixel build flag (tmux 3.6+) and retry failed queries once.
  Keep Unicode half blocks on older tmux versions, when detection fails, or
  when Sixel is unavailable.

## 0.9.1 — 2026-10-28

- Add the upstream SenseVoice Small preset `sensevoice-small-int8` and make it
  the default subtitle model, with punctuation, inverse text normalization,
  and Cantonese, Mandarin, English, Japanese, and Korean recognition. Its
  weights use the FunASR Model Open Source License Agreement. The Cantonese-only
  `sensevoice-small-yue-int8` preset stays available for existing configurations.
  When upgrading from 0.9.0 without an explicit `subtitles.model`, install
  `sensevoice-small-int8` before enabling subtitles, or explicitly select the
  previous preset; see [subtitle setup]docs/configuration.md#live-subtitles.
- Allow slow systems up to ten seconds to start mpv IPC, reducing playback
  startup failures on loaded machines.

## 0.9.0 — 2026-10-28

- Add optional local live subtitles in the TUI, with SenseVoice Cantonese and
  Qwen3 model presets, explicit verified downloads, and scrollable session
  history. Speech uses an isolated runtime and a separate stream connection;
  subtitles may lag behind or differ in timing from playback. Model downloads
  support a configurable mirror, disk space checks, and official fallback
  while retaining fixed SHA-256 verification.
- Bound subtitle reconnects until speech production stays stable for a minute,
  preserve Chinese captions in short terminals, and make persistent speech
  failures available through `?` and the activity log. Keep subtitle popups
  and panel layouts consistent across terminal resizes; suppress track artwork
  probes throughout enabled subtitle sessions. Support Unicode transcripts
  under legacy locales, improve model diagnostics, and avoid repeated work
  while subtitles are disabled or waiting for playback.
- Reuse model verification for unchanged files within a TUI session to avoid
  hashing large models on every subtitle reconnect. Explicit verification,
  diagnostics, and installation retain full SHA-256 checks.
- Keep receiving track updates when mpv sends invalid UTF-8 in metadata,
  preserving readable Unicode and recoverable legacy title bytes.
- Show a replacement character for truncated UTF-8 in Chinese ICY titles
  instead of displaying the incomplete bytes as Latin-1 characters.
- Recover GBK ICY titles containing valid UTF-8 subsequences through mpv IPC,
  including names such as 张国荣 and 河图.
- Add an opt-in `asiafm_metadata_patch` setting to remove the fixed Cantonese
  station watermark and clarify damaged track fields without guessing songs.

## 0.8.3 — 2026-10-23

- Keep TUI shortcut key highlighting consistent in filter and confirmation
  dialogs and command/search hints, and clarify the English panel and search
  labels. Show the alternative detail-scrolling keys with a slash separator.
- Handle both string and array registry responses when skipping an already
  published npm version, and report unexpected lookup responses explicitly.
- Require matching version tags for manual crates.io and npm publishing;
  allow npm release jobs to skip versions uploaded before a partial failure.
- Anchor crate package inputs to the repository root so npm templates and
  generated packages stay out of the crates.io archive.
- Check the resolved crate package list in CI and before crates.io upload, and
  document how to interpret a duplicate-version result when rerunning.

## 0.8.2 — 2026-10-23

- Highlight literal keys in the TUI's bottom shortcut hints and make the
  separate `[` and `]` source-switching keys visually distinct from the slash
  separator.
- Move detailed installation instructions into paired English and Chinese
  guides and keep the README quick start short.

## 0.8.1 — 2026-10-23

- Distribute the binary through npm as `@hmgle/radio-cli`, with per-platform
  packages that carry the prebuilt binary, published from GitHub Actions with
  trusted publishing and provenance. Install with `npm install -g
  @hmgle/radio-cli`.
- Publish the crate to crates.io from a GitHub Actions workflow through trusted
  publishing, so no long-lived API token is stored, and install the binary with
  `cargo install radio-cli --locked`.
- Show the `F` filters shortcut in the bottom shortcut row beside the station
  panels.
- Package only build inputs and user-facing files, keeping internal design
  notes, packaging scripts, and test fixtures out of the published crate.

## 0.8.0 — 2026-10-22

- Reorganize the public documentation into synchronized English and Chinese
  entry points, add detailed configuration, recording, troubleshooting, and JSON
  references, and remove version-pinned release download examples.
- Keep list rows and the current selection visible during background refreshes
  triggered by playback confirmation, including while navigating with j/k.
- Make Ctrl-e/Ctrl-y scroll the list viewport by one line, preserving selection
  unless the selected row would leave the screen, as in Vim.
- Keep small terminals usable, isolate deletion confirmations, and make list
  query failures visible with bounded retries and stale-result protection.
- Edit and measure complete Unicode grapheme clusters, handle bracketed paste,
  and ignore repeat events for one-shot actions when the terminal identifies them.
- Unify playback markers and recording timers, and allow locating the last
  requested station after playback fails without replaying it.
- Build localized keyboard help from structured sections, give diagnostic
  popups specific titles, and scroll long content through its measured extent.
- Expire ordinary notices, name copy and favorite targets, restore cancelled
  search positions, and remember each source's page and row for the session.
- Group and align station details, identify their source, show backup lookup
  states, and reuse wrapped content when calculating artwork space.
- Exclude commands containing URL credentials from command history with a
  notice. Redact credentials in TUI diagnostics and explain OSC 52 truncation.
- Anchor scrolled task logs, count new messages, and add H/M/L and zt/zz/zb
  viewport navigation with a one-second sequence timeout.
- Resolve interface theme styles before painting widgets, preserve artwork
  colors in light mode, and keep monochrome terminal output free of SGR.
- Build release binaries for size with opt-level s and fat LTO. The static
  Linux executable is about a third smaller, while a full catalog sync runs
  about ten percent slower.

## 0.7.0 — 2026-10-21

- Cache distinct station facets and index normalized stream URLs, removing
  catalog-wide token splitting and JSON decoding from interactive queries.
- Use FTS5 trigram candidates for selective substring searches, with exact
  literal checks and scan paths for short, special, or broad queries. Keep
  Chinese territory matching and existing sorting and pagination behavior.
- Run TUI catalog queries on a persistent reader thread so slow searches do
  not delay media controls. Coalesce requests, discard stale results, cache
  exact totals across pages, and interrupt queries during shutdown.
- Locate stations through indexed sort ranges and reduce text copying when
  publishing TUI logs and rendering station rows.
- Collect search-planning statistics after catalog publication without holding
  the main database write lock, then replace the hints in a short transaction.

### Compatibility

- Existing databases migrate atomically to schema v5 on first open. This
  builds search indexes and facet caches without requiring a catalog sync;
  first open takes longer and the database uses additional disk space.
  Older binaries cannot open the upgraded database; keep a pre-upgrade copy
  if downgrade support is needed. CLI options and JSON output are unchanged.
- For scale, the deterministic 200,000-station fixture occupies about 243 MiB
  with schema v5 (about 144 MiB for the equivalent v2 fixture). Its first-open
  v2-to-v5 migration took about 5.3 seconds on the development machine. The name
  and bitrate indexes together occupy about 32 MiB; they speed up those optional
  sorting modes.
  These are fixture measurements, not a fixed overhead: station text, catalog
  contents, SQLite free pages, and hardware affect disk use and migration time.

## 0.6.1 — 2026-10-20

- Display country/region names in Chinese in the TUI using a pinned Unicode
  CLDR 48 name table keyed by the upstream `countrycode`. Details, the filter
  popup and its candidates show localized names while storage, JSON output and
  `--country` keep the upstream codes, so existing catalogs need no resync.
- Match Chinese country/region names in search without a database migration.
  Queries of two or more characters resolve to territory codes at query time;
  single-character queries keep matching station text only, because one
  character is shared by too many territories.
- Fall back to the upstream catalog name, then the code, then unknown when a
  country code is missing or absent from the CLDR table, so details no longer
  discard usable catalog metadata.
- Render the catalog source notice in the active interface language instead of
  always in Chinese, and include the Unicode data license in release archives.
- Label the `state` field as state/province/area and clarify third-party
  catalog provenance and local caching in the guides.

### Compatibility

- Existing configuration and schema-v2 databases remain supported. Upstream
  `country` and `countrycode` values are preserved in local storage and JSON
  output; `--country` and `countries` keep using upstream codes. Geographic
  names and codes serve station search and display only. The CLDR name table is
  covered by the Unicode License V3 and is regenerable with
  `uv run scripts/update_territories.py`.

## 0.6.0 — 2026-10-20

- Add optional station logos and current-track covers in the TUI details panel
  through `artwork = "logo"` or `artwork = "track"`; the default remains `"off"`.
  Use Kitty, Sixel or iTerm2 graphics when detected and Unicode half blocks as
  fallback. tmux uses half blocks; monochrome and small layouts remain text-only.
- Center artwork in the space below station details without moving the text.
  Fix clipped graphics in Kitty/Ghostty and use a larger half-block area in tmux.
  Encode outside the render loop and preserve startup keys during capability
  detection, including keys arriving before terminal replies.
- Fetch station logos from catalog `favicon` URLs independently of audio.
  Bound JPEG/PNG downloads and decoding, reuse a bounded disk cache, and prune
  stale temporary files. Sync existing catalogs to populate favicon fields.
- Read track covers from validated ICY `StreamUrl` metadata with track/station
  association checks and logo fallback. Keep the two-upstream-audio-connection
  budget during playback and recording, cancel probes promptly, and bound
  connection handoffs before starting playback or recording. HLS and stations
  without usable image metadata retain the logo or text details.
- Add experimental native macOS Apple Silicon and Intel release archives,
  alongside the primary static Linux x86_64 musl build. Validate both macOS
  architectures in CI, smoke-test extracted packages, include `BUILDINFO`, shell
  completions and the manual, and provide a combined `SHA256SUMS`.
- Isolate pseudo-terminal tests from user configuration.

### Compatibility

- Existing configuration and schema-v2 databases remain supported. Artwork is
  opt-in and existing station rows need `radio sync` to obtain catalog logos.
  Track probing only runs for the visible, playing station when recording does
  not use the second audio connection; it may count as a listener upstream.
- External mpv and FFmpeg/ffprobe remain required on every platform. macOS
  downloads are not Developer ID-signed or notarized; see the READMEs for
  checksum verification and quarantine handling. Linux remains the primary
  platform; abrupt media-child cleanup is still not guaranteed on macOS.

## 0.5.0 — 2026-10-20

- Play HTTP(S) stream URLs directly from the CLI or TUI without saving stations,
  history, or resume preferences. Temporary streams support inspection; save
  them as custom stations before recording. Bound display names to 60 characters.
- Play a station by double-clicking its list row within 500 ms. Preserve
  single-click selection, including border clicks, and cancel gestures after
  movement, keyboard input, popups, or row changes.
- Select an mpv output with `audio_device` and enumerate current devices with
  `radio devices`, including legacy JSON and versioned JSON responses.
  Preserve `audio_device_failed` and its device parameter through CLI shutdown.
- Add opt-in `normalize_loudness` using a short-window mpv dynaudnorm filter.
  Probe support once per configured executable per process, sharing concurrent
  probes; keep recordings as unmodified stream copies.
- Accept `resume = "selection"` to restore the source and last station page
  without starting audio. Share the startup query with the TUI worker and consume
  the restore target after the first matching page, even when it is absent.
- Freeze the known track title when recording is requested and include it in
  the filename and optional `track` metadata. Collapse track-word whitespace to
  underscores and bound UTF-8 filename bytes; keep old names when titles are unknown.
- End local player startup and configured-device failures without retrying
  stream URLs, random stations, or directory refreshes. This includes transient
  IPC/socket startup timeouts: retrying playback requires a new play request.
  Stream connection failures retain candidate fallback and bounded reconnection.
- Support basic CLI/TUI operation on macOS, with a macOS CI job and source
  installation instructions. Use the native directory opener and make terminal
  tests portable. Linux remains the primary platform and release target;
  macOS does not guarantee media-child cleanup after abrupt frontend death.
- Recover recording publication interrupted between creating a hard link and
  removing the temporary name. Verify file identity before removing the partial
  name; unrelated files and symlink destinations remain protected.
- Stop playback from failing when the mpv IPC socket path exceeds the
  100-byte Unix socket limit: use a shorter socket name under the runtime
  directory and fall back to the system temp directory with the full UUID
  for deep paths. The default macOS per-user application-support directory
  came close enough that ordinary user names could trip this on every start;
  rejections now include the offending path.
- Preserve one-shot ICY song-title updates with a bounded 512 KiB back buffer;
  keep its memory budget separate from the forward cache.
- Repair ICY titles whose UTF-8 bytes were re-encoded as Latin-1, when the
  entire conversion produces valid UTF-8. Apply this before filtering control
  characters; leave ordinary file-title tags unchanged.

### Compatibility

- Existing schema-v2 databases and boolean `resume` settings remain supported;
  `false` remains the default. `normalize_loudness` defaults to false, and absent
  or empty `audio_device` preserves mpv automatic output selection.
- Recording metadata adds an optional `track`; old records remain readable.
  JSON device listing adds a new command without changing existing success shapes.
- Prebuilt downloads remain Linux x86_64 musl; macOS is supported from source.
  External mpv and FFmpeg/ffprobe remain required on both platforms.

## 0.4.0 — 2026-10-19

- Retry truncated HTTP/ICY recording connections with bounded backoff, including
  disconnects before AAC startup parameters are available. Preserve finite-source
  EOF behavior and partial files when retries fail.
- Retain the latest 8 KiB of recording diagnostics with line breaks, including
  messages containing equals signs and errors accompanying premature stream EOF.
- Preserve recording reconnect counts through finalization and recovery; warn
  that audio may have gaps even when the recording completes successfully.
  Print full diagnostic tails in the CLI text list as well as JSON and sidecars.
- Check recording space before creating destination directories; clear inactive
  playback state after stop or failure and cancel stale candidate retry timers.
- Localize top-level CLI help descriptions and playback progress; validate
  message keys in direct and explicit-locale lookups and integration tests.
- Retry failed TUI backup queries with backoff, suppress repeated errors and
  retain station details; invalidate cached results when station rows refresh.
- Share case-insensitive facet matching between navigation and rendering;
  debounce queries for the active field and prefix, with at most 100 candidates.
- Add a configurable normal-mode shortcut to locate the playing station without
  restarting playback. Accept an empty binding to disable it, reject incomplete
  named keys and normalize shifted control keys consistently.
- Generate release manuals in English regardless of packaging host language.
- Count HLS segment re-fetch failures as reconnects so HLS recordings also warn
  about possible audio gaps.
- Keep tab characters in CLI recording diagnostic lines so column alignment
  survives; other control characters remain filtered.
- Ignore commented-out message lookups when validating catalog keys, covering
  nested block comments and comment-like text inside strings and raw strings.
- Generate release shell completions in English as well as the manual, with
  tests guarding the packaging script and locale-invariant completions.
- Mark reconnected recordings in the TUI recording list so potential audio
  gaps are visible without opening the details panel.

### Compatibility

- Existing configuration and schema-v2 databases continue to work. The new
  `keybindings.jump_to_playing` setting defaults to `''` and can be set to an
  empty string to disable the shortcut.
- The supported release target remains Linux x86_64. External mpv and
  FFmpeg/ffprobe remain required.

## 0.3.1 — 2026-10-19

Post-release review fixes tracked in #83.

- Renew reconnect budgets after confirmed playback; cap flapping streams at six
  retries per minute and clear completed recording status when switching stations.
- Request audio/format bitrate from ffprobe for recording preflight. Prefer audio
  bitrate and explicitly report reserve-only checks for unknown duration/bitrate.
  `recording_min_free_mb` must be positive and convertible to bytes.
- Coalesce TUI list refreshes, avoid unchanged preference writes, and load backup
  URLs only for selected or explicitly inspected stations.
- Filter facet choices by the typed prefix and display up to eight candidates.
- Show observed mute state, restore narrow list/details focus navigation, retain
  titles in short wide windows, and keep recording-source actions consistent.
- Return JSON usage envelopes for malformed v2 flags, declare domain exit codes
  explicitly, and report `placeholder_kept` when station removal retains a row.
  Legacy always-JSON commands and the existing `removed` field remain compatible.
- Localize CLI operation progress and validate message keys across all modules.
- Package only user-facing guides from fresh staging, check nonempty files, and
  run the packager in CI. Internal review notes are excluded from new archives.
- Repeat paired catalog benchmarks to record comparative evidence and limits;
  retain the 100 ms absolute search budget.

## 0.3.0 — 2026-10-19

Complete roadmap stages S1–S3 (#36–#57); S4 (#58–#64) remains backlog.

- Fix whitespace search, favorite confirmations, full-catalog SQL random selection,
  atomic bootstrap, wide-character input cursors and source-specific hints.
- Introduce stable localized domain error codes and language selection. TUI static
  text and Clap help remain Chinese pending their separately scoped migration.
- Add transactional custom station editing, duplicate URL detection, backup URL
  management, remembered volume, opt-in resume, local filter facets, sorting,
  automatic stale-catalog refresh and one-action filter reset.
- Reconnect established streams with bounded retries while preserving history.
- Play and manage local recordings, confirm TUI deletion, open the recording
  directory, inspect full FFmpeg errors and refuse insufficient disk space.
- Add atomic `--json-v2` responses and exit codes; preserve legacy JSON shapes.
  Document the contract in `docs/json-contract.md`.
- Generate shell completions and `radio(1)`; include both in release archives.
- Improve 80×24 layouts; add default/mono/light themes and strict `NO_COLOR`.
  Show independent playback/recording stages and retain a visible exit hint.
- Share view snapshots, refresh the active source lazily, throttle progress,
  index history pruning and separate playback/recording resource ownership.
- Reuse Unicode editing in filters; add context completion, private persistent
  command history, command-specific help, runtime settings, mute and copying.
- Upgrade audited dependencies and check stable/all-features, Rust 1.88 and
  static x86_64 musl in CI. No advisory exceptions are configured.

### Compatibility

- Existing configuration and schema-v2 databases continue to work. New settings:
  `auto_sync_days = 7` (0 disables), `resume = false`, `probe_timeout_secs = 5`,
  `recording_min_free_mb = 16`, `theme = "default"`, `mouse = true`, and optional
  `language`. Volume is always remembered; resume is opt-in.
- `--json-v2` is opt-in; `search --json` remains an array throughout 0.3.x.
- Exit codes: 0 success, 1 operation failure, 2 usage, 3 missing executable,
  4 competing media session. Scripts that previously assumed every error was
  exit 1 should handle these specific codes.
- The supported release target is Linux x86_64. External mpv and FFmpeg/ffprobe
  remain required. NO_COLOR forces monochrome; clipboard copying uses OSC 52.

## 0.2.0 — 2026-10-18

### Fixes and improvements

- Keep Ctrl-W deletion on UTF-8 boundaries; honor Ctrl-C in every TUI mode and refresh terminal dimensions before interpreting keys.
- Apply rapid volume and favorite shortcuts to current state. Serialize favorite toggles across database connections.
- Retry queries after queue backpressure; refresh history, external database changes, and station details consistently.
- Add pagination and complete exports for favorites, history, and recordings. Keep recording order stable and prevent paging beyond known results.
- Preserve the latest recording progress and recover interrupted finalization without overwriting existing files.
- Isolate stale-recording recovery failures and add `recordings recover` for explicit retries.
- Keep playback controls responsive during network requests, probes, diagnostics, and recording finalization; bound shutdown waits and reclaim media subprocesses.
- Record the current TUI playback station with explicit behavior for pause, station changes, and shutdown.
- Share validated stream candidates between playback and standalone recording; fall back from invalid resolved URLs.
- Fetch each full directory from one server, restart failed snapshots on failover, and reject unexpected catalog shrinkage without repeatedly fetching replicas. Preserve diagnostics for all attempts.

### Compatibility

- `favorites list`, `history`, and `recordings list` JSON now returns `{items,total,limit,offset,has_more}`. With `--all`, `limit` is `null`. `search --json` keeps its array format.
- SQLite databases automatically migrate to schema v2. Explicit `recovery_pending` state replaces diagnostic-based retry selection; legacy pending recoveries are preserved. Recording JSON and sidecars include the new boolean field. Older binaries cannot open the migrated database.
- Catalog shrinkage greater than 25% requires `sync --accept-shrink`. A rejected snapshot preserves the existing catalog and stops the sync attempt.
- TUI recording belongs to the current playback session. Use `radio record UUID` for independent recording.
- Local finalization probing remains limited to 2 seconds, FFmpeg graceful stop to 3 seconds, and TUI finalization waiting to 6 seconds. Slow-disk failures preserve files and diagnostics.

### Distribution

The Linux x86_64 release archive contains a statically linked musl executable, documentation, and the MIT license. Playback and recording still require external `mpv` and `ffmpeg` / `ffprobe` executables. Checksums accompany the archive.

All issues #1–#13 are addressed.