Skip to content

Releases

v0.13.0

Choose a tag to compare

@hmgle hmgle released this 19 Nov 08:57
96f65c1

radio-cli 0.13.0 adds regional podcast discovery, more listening controls, and synchronized episode captions.

  • Browse regional charts by category and preview Apple Podcasts search results before subscribing.
  • Use saved episodes, the inbox, bookmarks, chapters, and per-show preferences. Jump to the playing episode and press Esc to return to your previous panel and browsing position.
  • Read feed-provided VTT/SRT captions or generate captions locally as an episode plays. Scroll manually in Details and press End there to resume following.
  • See readable artist and track titles from RadioInfo carried by HLS/ID3 and ICY streams, including Cidade.
  • Update bundled SQLite to 3.54.1 for RUSTSEC-2026-0459. Source builds now require Rust 1.89.

0.13.0 新增分地区播客发现、分类榜单、收藏与收听库、书签和章节。定位当前单集后,按 Esc 可恢复原来的面板和浏览位置。TUI 支持同步显示播客源字幕、边播放边本地生成字幕,以及手动阅读后恢复跟随。Cidade 等电台的 RadioInfo 元数据现在会显示为可读的歌名和艺人名。

内置 SQLite 已升级至 3.54.1。从源码构建需要 Rust 1.89 或更新版本。

Database upgrade. The first open upgrades the database to schema v10. The upgrade preserves subscriptions, progress, downloads, and queues. Back up the entire data directory with radio-cli closed if you need to downgrade to v0.12.0 or earlier.

数据库升级。 首次打开将数据库迁移至 schema v10,原有订阅、进度、下载和队列会保留。如需降级到 v0.12.0 或更早版本,请在升级前退出 radio-cli 并备份整个数据目录。

Download the Linux x86_64, macOS Intel, or macOS Apple Silicon archive and verify it with SHA256SUMS. The archives include the bilingual guides. Playback and recording use mpv, FFmpeg, and ffprobe.

Podcast guide · 中文播客指南 · Full changelog

v0.12.0

Choose a tag to compare

@hmgle hmgle released this 08 Nov 05:24

Public podcasts now work alongside live radio in the CLI and TUI.

  • Subscribe to public RSS 2.0 and Atom audio feeds, search Apple Podcasts, and discover feed links. Preview search results before subscribing in the TUI.
  • Resume episodes, seek, mark played or unplayed, and use playback speeds from 0.5× to 3×. Podcast subscriptions, progress and history are separate from the radio catalog.
  • Download episodes for offline playback with validated Range resume and media fingerprints. In the TUI, up to two downloads run in the background.
  • Manage an explicit listening queue with optional automatic next playback, and import or export subscriptions with OPML.
  • Read the English podcast guide or 中文播客指南. Both guides are included in the release archives.

CLI 与 TUI 现支持公开 RSS/Atom 播客:Apple 目录搜索与订阅预览、单集续听与定位、已听标记、0.5–3 倍速、可校验续传的离线下载、手动队列与可选连播,以及 OPML 导入导出。播客订阅、进度和历史独立于电台目录;TUI 最多同时运行两个后台下载。

Upgrade: Existing databases migrate to schema v9 on first open. Earlier binaries, including 0.11.1, cannot open the upgraded database. If you need rollback support, close radio-cli and back up the entire data directory before upgrading. Existing stations, favorites and recordings are retained.

升级提示: 首次打开数据库会迁移至 schema v9,包括 0.11.1 在内的旧版程序无法打开迁移后的数据库。如需保留降级能力,请先关闭 radio-cli 并备份整个数据目录。既有电台、收藏和录音会保留。

Prebuilt archives are available for Linux x86_64 (musl), macOS Intel, and macOS Apple Silicon. Verify downloads with SHA256SUMS. Runtime dependencies remain mpv, FFmpeg and ffprobe.

Install or update:

npm install -g @hmgle/radio-cli@0.12.0
# or
cargo install radio-cli --version 0.12.0 --locked

Full changelog: v0.11.1...v0.12.0

v0.11.1

Choose a tag to compare

@hmgle hmgle released this 06 Nov 09:16

Country/region filter completion now accepts Chinese name prefixes, including single characters and the common short names for Hong Kong and Macao.

  • Match TUI country/region candidates and radio countries --prefix by code or Chinese-name prefix, applying limits after matching.
  • Accept 香港, 澳门, 香, and 澳 while preserving full Chinese display names, country codes, and station counts.
  • Keep English and Chinese usage documentation in sync.

国家/地区筛选候选和 radio countries --prefix 现支持中文名称前缀(包括单个汉字),并支持 香港、澳门 及其单字前缀 香、澳。匹配后再限制候选数量,保留完整中文显示名称、地区代码和电台数量。

Prebuilt archives are available for Linux x86_64 (musl), macOS Intel, and macOS Apple Silicon. Verify downloads with SHA256SUMS. Playback and recording require external mpv, FFmpeg, and ffprobe.

Install or update:

npm install -g @hmgle/radio-cli@0.11.1
# or
cargo install radio-cli --version 0.11.1 --locked

Full changelog: v0.11.0...v0.11.1

v0.11.0

Choose a tag to compare

@hmgle hmgle released this 01 Nov 09:11

Changes

  • 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.

v0.10.0

Choose a tag to compare

@hmgle hmgle released this 31 Oct 03:29

Changes

  • 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.

v0.9.2

Choose a tag to compare

@hmgle hmgle released this 29 Oct 06:36

Changes

  • 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.

v0.9.1

Choose a tag to compare

@hmgle hmgle released this 28 Oct 12:18
  • 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.
  • Allow slow systems up to ten seconds to start mpv IPC, reducing playback
    startup failures on loaded machines.

v0.9.0

Choose a tag to compare

@hmgle hmgle released this 28 Oct 03:40
  • 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.

v0.8.3

Choose a tag to compare

@hmgle hmgle released this 23 Oct 14:13
  • 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.

v0.8.2

Choose a tag to compare

@hmgle hmgle released this 23 Oct 09:55
  • 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.