Repository navigation
Releases
v0.13.0
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.
v0.12.0
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 --lockedFull changelog: v0.11.1...v0.12.0
v0.11.1
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 --prefixby 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 --lockedFull changelog: v0.11.0...v0.11.1
v0.11.0
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 addscontent_revisions, twelve revision triggers across stations,
favorites, history, and recordings, and therecording_startedexpression
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:
Engineno longer dereferences toSession, andSession
is private. Replace field reads withstatus(),config(),store(),
subtitles(), andplayback_failed(). These return read access; mutate
playback throughEnginemethods instead of changing session fields. - Replace mutable store access through
Enginewithtoggle_favorite()and
change_station(StationCommand::{Add, Edit, Remove, Backups}). Directory
operations are available throughbootstrap(),sync(),
sync_with_policy(),refresh_station(), andreport_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
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 with6. Click a map cell to list its stations, move the cursor with arrows orhjkl, zoom withz/Zup to 8×, zoom the wheel around the pointer, return to the world with0, and pressEnterto focus the results.:focusacceptsmapbeside 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
cin Explore, returning to the map withEsc. Clearing search and filters keeps the selected map cell. - Store station coordinates and expose them as nullable
geo_latandgeo_longin 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 syncruns, 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
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
- Add the upstream SenseVoice Small preset
sensevoice-small-int8and 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-int8preset stays available for existing configurations.
When upgrading from 0.9.0 without an explicitsubtitles.model, install
sensevoice-small-int8before 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
- 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_patchsetting to remove the fixed Cantonese
station watermark and clarify damaged track fields without guessing songs.
v0.8.3
- 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
- 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.