rockbox_ffi 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35a95e714d15cbe6ef8a424ae9ba8313a57c8a130a7c7ef01f77d56bb087c6b0
-  data.tar.gz: 568caa44c1c1792fd2f084c9e07e7e8d7d9d354394b14a9a53f6e59363df67af
+  metadata.gz: 7ea9e94f1a583732d3b06ddbb9f6f41e5777a37f2151054820116773d908f8b1
+  data.tar.gz: bd92c9ab53fb42598aa6e3d918956e21751d695b4bf7a75be65e9ce7ac8181d5
 SHA512:
-  metadata.gz: a5c84973dcb05221f7d190ebb59e9e5ed3916123a3799ecf523db9257de84fe5fbba7fbd822f4a9e8ab49907952ae3c93d0d703e2328a7a6259312c670463e04
-  data.tar.gz: b1b75343e699340e46957efd6de84c5ac9680707eff819ea8e68a9e1043d9e274f4962c801c9196e8d65a8f45e5dafcfc05accfe3f42c960d54b674c1947e6f2
+  metadata.gz: fe5e0733d3540168cf8b31a5c2f910dd0968fdc2883778a24d3e46e92c48f3edc7fcd5fcbab4eae97b11177fa7cf49f86348c41dbb00b015f0a32f09ebaf5f22
+  data.tar.gz: debc3b1bc0f7d340f17ee881d1454e7dd98fe7bf907c8c3e95375ddc863144c2c98509121b4ccc4208a4ca81f1ba4423a3c1412ac353650416a0e7cb00dc6ed4

data/README.md

@@ -68,8 +68,8 @@ RockboxFFI::Player.open(volume: 0.8) do |player|
   player.set_replaygain(RockboxFFI::ReplayGainMode::TRACK, 0.0, true)
   player.set_crossfade(RockboxFFI::CrossfadeMode::ALWAYS)
   # Queue entries may be local files, http(s):// URLs to remote media,
-  # or live-radio / streaming URLs — mix and match freely.
-  player.set_queue(["a.flac", "https://example.com/b.mp3", "http://radio.example/stream"])
+  # or live-radio streams, or HLS / MPEG-DASH manifests (.m3u8/.mpd) — mix and match freely.
+  player.set_queue(["a.flac", "https://example.com/b.mp3", "http://radio.example/stream", "https://cdn.example.com/live/main.m3u8"])
   player.play
   player.status   # => {state: "playing", index: 0, ...}
 end

data/examples/play.rb

@@ -1,8 +1,14 @@
 # frozen_string_literal: true
 
-# Play a local audio file or an http(s):// URL through the real output device.
+# Play an audio source through the real output device.
 #
-# Run: ruby -Ilib examples/play.rb [path-to-audio | http(s)-url]
+# The queue entry can be a local file, a remote http(s):// URL, an
+# internet-radio stream, or an HLS (.m3u8) / MPEG-DASH (.mpd) manifest —
+# the engine detects each kind automatically.
+#
+# Run: ruby -Ilib examples/play.rb [path-or-URL]
+#      ruby -Ilib examples/play.rb hls    # public HLS test stream
+#      ruby -Ilib examples/play.rb dash   # public MPEG-DASH test stream
 
 $LOAD_PATH.unshift File.expand_path("../lib", __dir__)
 require "rockbox_ffi"
@@ -10,8 +16,15 @@ require "rockbox_ffi"
 REPO = File.expand_path("../../..", __dir__)
 FIXTURE = File.join(REPO, "crates", "rocksky", "fixtures", "08 - Internet Money - Speak(Explicit).m4a")
 
-# The queue accepts local files and http(s):// URLs (remote media / live radio).
-file = ARGV[0] || FIXTURE
+# Public adaptive-streaming test streams (see crates/rockbox-playback/README.md
+# for more).
+HLS_DEFAULT = "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8"
+DASH_DEFAULT = "https://dash.akamaized.net/akamai/bbb_30fps/bbb_30fps.mpd"
+
+# The queue accepts local files, http(s):// URLs (remote media / live radio),
+# and HLS / MPEG-DASH manifest URLs.
+arg = ARGV[0] || FIXTURE
+file = { "hls" => HLS_DEFAULT, "dash" => DASH_DEFAULT }.fetch(arg, arg)
 if !RockboxFFI.is_url?(file) && !File.exist?(file)
   abort "no such file: #{file}"
 end
@@ -39,11 +52,15 @@ trap("INT") do
 end
 
 # Poll status until playback finishes (state returns to "stopped").
+# A live stream reports duration 0 and plays until Ctrl-C.
 loop do
   st = player.status
   pos = st[:position_ms] / 1000.0
   dur = st[:duration_ms] / 1000.0
-  printf("\r[%s] %.1fs / %.1fs   ", st[:state], pos, dur)
+  clock = dur.zero? ? format("%.1fs / LIVE", pos) : format("%.1fs / %.1fs", pos, dur)
+  # The codec label carries the protocol for adaptive streams (e.g. "HLS AAC").
+  codec = st.dig(:metadata, :codec) || ""
+  printf("\r[%s] %s %s   ", st[:state], codec, clock)
   $stdout.flush
 
   if st[:state] == "stopped" && st[:position_ms].positive?

data/lib/rockbox_ffi/ffi.rb

@@ -111,6 +111,7 @@ module RockboxFFI
     extern "void* rb_player_new()"
     extern "void* rb_player_new_with_config(uint32_t, float, float, int32_t, float, bool, int32_t, uint32_t, uint32_t, uint32_t, uint32_t, int32_t)"
     extern "void* rb_player_new_with_config_ex(uint32_t, float, float, int32_t, float, bool, int32_t, uint32_t, uint32_t, uint32_t, uint32_t, int32_t, void*, uint32_t)"
+    extern "void* rb_player_new_with_output(void*, uint32_t, float, float, int32_t, float, bool, int32_t, uint32_t, uint32_t, uint32_t, uint32_t, int32_t, void*, uint32_t)"
     extern "void rb_player_free(void*)"
     extern "void rb_player_set_queue_json(void*, void*)"
     extern "void rb_player_enqueue(void*, void*)"

data/lib/rockbox_ffi/player.rb

@@ -30,6 +30,13 @@ module RockboxFFI
       fade_in_delay_ms: 0,
       fade_in_duration_ms: 2000,
       mix_mode: MixMode::CROSSFADE,
+      # Audio output backend. nil/"" => cpal (the default device). Other specs:
+      #   "stdout" (or "-"), "fifo:/path", "unix:/path" (listen),
+      #   "unix-connect:/path", "tcp:host:port" (listen), "tcp-connect:host:port".
+      # A listening socket blocks until a client connects. In stdout mode fd 1 IS
+      # the raw S16LE stereo PCM stream, so the host must keep stdout clean
+      # (e.g. pipe to `ffplay -f s16le -ar 44100 -ac 2 -`).
+      output: nil,
       resume_file: nil, # an .m3u8 to auto-persist queue + position to
       resume_save_interval_ms: 0 # 0 => 5 s default
     }.freeze
@@ -55,11 +62,15 @@ module RockboxFFI
 
     # Create a player with configuration overrides (see DEFAULT_CONFIG keys).
     # sample_rate: 0 means the device default. Passing +resume_file:+ enables
-    # auto-persisting the queue + exact position to that .m3u8 file.
+    # auto-persisting the queue + exact position to that .m3u8 file. +output:+
+    # selects the audio backend (nil/"" => cpal; see DEFAULT_CONFIG for the
+    # full spec-string list).
     def initialize(**opts)
       c = DEFAULT_CONFIG.merge(opts)
       resume_file = c[:resume_file].nil? ? nil : c[:resume_file].to_s
-      ptr = Lib.rb_player_new_with_config_ex(
+      output = c[:output].nil? || c[:output].to_s.empty? ? nil : c[:output].to_s
+      ptr = Lib.rb_player_new_with_output(
+        output,
         Integer(c[:sample_rate]), Float(c[:buffer_seconds]), Float(c[:volume]),
         Integer(c[:replaygain_mode]), Float(c[:replaygain_preamp_db]),
         RockboxFFI.b(c[:replaygain_prevent_clipping]), Integer(c[:crossfade_mode]),

data/lib/rockbox_ffi/version.rb

@@ -1,3 +1,3 @@
 module RockboxFFI
-  VERSION = "0.5.1"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rockbox_ffi
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Tsiry Sandratraina
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-16 00:00:00.000000000 Z
+date: 2026-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiddle