@ciphore/radiocli 0.1.8 → 0.2.0

package/CHANGELOG.md

@@ -7,6 +7,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-07-08
+
+### Added
+
+- Added update checks for npm releases, including a `radiocli update` command,
+  a `:update` command, and a Settings entry that reports the latest available
+  version and copies or runs the right npm or Homebrew update command.
+- Added lazy loading for long country station lists and search results, so
+  deeper directories continue loading as you scroll instead of stopping at the
+  first page.
+- Added mouse wheel scrolling across station, country, map, nearby, explore,
+  search, and library lists.
+
+### Changed
+
+- The footer now shows the installed RadioCLI version, and Settings includes
+  the current version beside update status.
+- Retuning now keeps the playback footer focused on the station currently
+  buffering, and mpv playback stays in loading until audio has actually started.
+
+## [0.1.9] - 2026-07-03
+
+### Changed
+
+- Nearby station discovery is now enabled by default for new libraries, and the
+  `l` shortcut is limited to Overview, Nearby, and Settings so country lists
+  keep normal letter navigation.
+- Favorite changes from Library now appear in the footer message row instead of
+  displacing the main page status.
+- The listening stats activity graph now uses solid truecolor cell backgrounds
+  with tighter rendering on short terminals and fewer split color runs.
+
+### Fixed
+
+- Nearby keeps showing the last loaded station list when location lookup is
+  turned off or temporarily unavailable.
+- Long country names are truncated to one terminal row so dense country lists do
+  not wrap into nearby entries.
+- Pressing `b` from a country station list now returns to Countries before
+  falling back to Overview.
+
 ## [0.1.8] - 2026-07-02
 
 ### Changed
@@ -178,6 +219,8 @@ Initial public release.
 [0.1.6]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.6
 [0.1.7]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.7
 [0.1.8]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.8
+[0.1.9]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.9
+[0.2.0]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.2.0
 [0.1.4]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.4
 [0.1.3]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.3
 [0.1.2]: https://github.com/Ciphore/RadioCLI/releases/tag/v0.1.2

package/README.md

@@ -76,7 +76,7 @@ Live public radio from around the world
 
 3 recent · 2 favorites · 1 imported
 
-↑/↓ move · Enter open · number jump · : command
+↑/↓ move · Enter open · number jump · l location · : command
 ←/→ tabs · F7/F9 or ,/. station · F8 pause · t/v display · +/- volume · ? help · q quit
 ```
 

package/dist/cli.js

@@ -9,6 +9,7 @@ import { JsonLibraryStore } from './storage/store.js';
 import { parsePlaylistFile, stationFromUrl, writeM3u } from './playlists/playlist.js';
 import { detectPlaybackBackends, playbackBackendStatusLines } from './player/backend-install.js';
 import { appVersion } from './version.js';
+import { checkForUpdate, updateCommandForInstall } from './update-check.js';
 if (isDirectRun(process.argv[1], import.meta.url)) {
     const args = process.argv.slice(2);
     if (args.length > 0) {
@@ -47,6 +48,20 @@ export async function runCommand(args) {
         printPlaybackBackendStatus(backends);
         return;
     }
+    if (command === 'update') {
+        const updateCheck = await checkForUpdate();
+        const updateCommand = updateCommandForInstall();
+        if (updateCheck.error) {
+            console.log(`update_check=failed ${updateCheck.error}`);
+        }
+        else {
+            console.log(`installed=${appVersion()}`);
+            console.log(`latest=${updateCheck.latestVersion ?? 'unknown'}`);
+            console.log(`available=${updateCheck.updateAvailable ? 'yes' : 'no'}`);
+        }
+        console.log(`command=${updateCommand.command}`);
+        return;
+    }
     if (command === 'check') {
         const store = new JsonLibraryStore();
         const providers = new ProviderManager();
@@ -121,6 +136,7 @@ Usage:
   radiocli version         Print the installed version
   radiocli check           Show provider/backend health
   radiocli doctor          Show local playback setup guidance
+  radiocli update          Show update availability and install command
   radiocli countries       Print top countries
   radiocli search <query>  Search public stations
   radiocli import <file>   Import .m3u, .pls, or .xspf streams
@@ -140,7 +156,7 @@ export function isDirectRun(entryPath, moduleUrl) {
     }
 }
 function isKnownCommand(command) {
-    return ['check', 'doctor', 'countries', 'search', 'import', 'export', 'add-url'].includes(command);
+    return ['check', 'doctor', 'update', 'countries', 'search', 'import', 'export', 'add-url'].includes(command);
 }
 function printPlaybackBackendStatus(backends) {
     for (const line of playbackBackendStatusLines(backends)) {

package/dist/player/player-controller.js

@@ -10,6 +10,7 @@ import { discoverAirPlayDevices } from './airplay-discovery.js';
 import { airPlaySenderHealth } from './airplay-sender-health.js';
 import { encodeWorkerStart, parseWorkerMessage, serializeWorkerMessage } from './airplay-worker-protocol.js';
 const minAirPlayTuneTimeoutSeconds = 30;
+const mpvAudioStartFallbackMs = 1500;
 export class PlaybackOutputError extends Error {
     constructor(message) {
         super(message);
@@ -726,6 +727,7 @@ export class PlayerController {
     async waitForReady(backend) {
         const timeoutMs = this.getSettings().tuneTimeoutSeconds * 1000;
         const started = Date.now();
+        let mpvPathReadyAt = 0;
         while (Date.now() - started < timeoutMs) {
             if (!this.process) {
                 throw new Error('Player exited before the stream became ready.');
@@ -737,7 +739,13 @@ export class PlayerController {
             if (this.ipcPath) {
                 try {
                     await this.queryMpv({ command: ['get_property', 'path'] });
-                    return;
+                    mpvPathReadyAt = mpvPathReadyAt || Date.now();
+                    if (await this.hasMpvAudioStarted()) {
+                        return;
+                    }
+                    if (Date.now() - mpvPathReadyAt >= mpvAudioStartFallbackMs) {
+                        return;
+                    }
                 }
                 catch {
                     // The IPC socket can exist briefly before accepting commands.
@@ -748,6 +756,13 @@ export class PlayerController {
         await this.stop();
         throw new Error(`Timed out while opening stream after ${this.getSettings().tuneTimeoutSeconds}s.`);
     }
+    async hasMpvAudioStarted() {
+        const [timePos, audioPts] = await Promise.all([
+            this.queryMpv({ command: ['get_property', 'time-pos'] }).catch(() => null),
+            this.queryMpv({ command: ['get_property', 'audio-pts'] }).catch(() => null)
+        ]);
+        return typeof timePos === 'number' || typeof audioPts === 'number';
+    }
     startMpvMetadataPolling() {
         this.stopMpvPolling();
         this.metadataTimer = setInterval(() => {

package/dist/providers/provider-manager.js

@@ -13,8 +13,8 @@ export class ProviderManager {
     popular(limit) {
         return this.radioBrowser.popular(limit);
     }
-    byCountry(countryCode, limit) {
-        return this.radioBrowser.byCountry(countryCode, limit);
+    byCountry(countryCode, limit, offset) {
+        return this.radioBrowser.byCountry(countryCode, limit, offset);
     }
     nearby(location, limit) {
         return this.radioBrowser.nearby(location, limit);
@@ -24,7 +24,7 @@ export class ProviderManager {
     }
     async search(query, settings, options = {}) {
         const radioBrowser = await this.radioBrowser.search(query, options);
-        if (!settings.enableRadioGarden && !options.includeExperimental) {
+        if ((!settings.enableRadioGarden && !options.includeExperimental) || (options.offset ?? 0) > 0) {
             return radioBrowser;
         }
         const experimental = await Promise.allSettled([this.radioGarden.search(query, options)]);

package/dist/providers/radio-browser.js

@@ -87,11 +87,12 @@ export class RadioBrowserProvider {
         }, { maxAgeMs: 15 * 60 * 1000 });
         return this.normalizeStations(rows);
     }
-    async byCountry(countryCode, limit = 100) {
+    async byCountry(countryCode, limit = 100, offset = 0) {
         const rows = await this.request('/json/stations/search', {
             countrycode: countryCode.toUpperCase(),
             hidebroken: 'true',
             limit: String(limit),
+            offset: String(Math.max(0, offset)),
             order: 'clickcount',
             reverse: 'true'
         }, { maxAgeMs: 30 * 60 * 1000 });
@@ -106,6 +107,7 @@ export class RadioBrowserProvider {
         const baseParams = {
             hidebroken: 'true',
             limit: String(limit),
+            offset: String(Math.max(0, options.offset ?? 0)),
             order: 'clickcount',
             reverse: 'true',
             ...(options.codec ? { codec: options.codec } : {}),

package/dist/storage/store.js

@@ -28,8 +28,7 @@ const stationSchema = z
     distanceKm: z.number().optional(),
     hls: z.boolean().optional(),
     lastCheckedOk: z.boolean().optional()
-})
-    .strict();
+});
 const defaultMediaKeys = {
     previous: [],
     playPause: [],
@@ -138,7 +137,7 @@ const settingsSchema = z.object({
     receiverStyleVersion: z.number().optional(),
     volume: z.number().min(0).max(100).default(70),
     enableRadioGarden: z.boolean().default(false),
-    enableNearbyLocation: z.boolean().default(false),
+    enableNearbyLocation: z.boolean().default(true),
     preferredBackend: z.enum(['auto', 'mpv', 'ffplay', 'vlc', 'airplay']).default('auto'),
     preferredAirPlayDevice: z.string().min(1).optional(),
     tuneTimeoutSeconds: z.number().min(3).max(45).default(12),
@@ -173,6 +172,15 @@ const librarySchema = z.object({
     }))
         .default([]),
     searchHistory: z.array(z.string()).default([]),
+    updateCheck: z
+        .object({
+        checkedAt: z.string(),
+        currentVersion: z.string(),
+        latestVersion: z.string().optional(),
+        updateAvailable: z.boolean(),
+        error: z.string().optional()
+    })
+        .optional(),
     activity: z
         .object({
         sessions: z
@@ -192,7 +200,7 @@ const librarySchema = z.object({
         receiverStyleVersion: 2,
         volume: 70,
         enableRadioGarden: false,
-        enableNearbyLocation: false,
+        enableNearbyLocation: true,
         preferredBackend: 'auto',
         tuneTimeoutSeconds: 12,
         skipBrokenStreams: true,
@@ -221,6 +229,11 @@ export class JsonLibraryStore {
         this.write();
         return this.snapshot();
     }
+    updateCheckState(updateCheck) {
+        this.state = { ...this.state, updateCheck };
+        this.write();
+        return this.snapshot();
+    }
     addRecent(station) {
         const key = stationKey(station);
         const recent = [
@@ -387,7 +400,7 @@ function defaultState() {
             receiverStyleVersion: 2,
             volume: 70,
             enableRadioGarden: false,
-            enableNearbyLocation: false,
+            enableNearbyLocation: true,
             preferredBackend: 'auto',
             tuneTimeoutSeconds: 12,
             skipBrokenStreams: true,