tucue 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97054b40943e2128666fdce09762dcc347ed314e8f61cb3af56fb4150379fca5
-  data.tar.gz: d713fe563c046f18a36123afe12d1f1ce5fdcfb33cc56bc7d374ce83ffb7417f
+  metadata.gz: b13df268982a614c075c660f19f057f249be6f0da5f542cd48755bf3f10ba79d
+  data.tar.gz: d44cddbf91c73703b81d359dfabbf23af5e05507af59e8a16fdc166d1acbdcea
 SHA512:
-  metadata.gz: 4f810dcd87e5ede57616c2672572da421cb98d242af2b22e0e5355f9bf3f7989159d552e0939d02a8c4ce62d0d95fe185d42727371fa9428ce226f8097801174
-  data.tar.gz: 0cf0d7c900293762b8d3a924a12be24679e94e0dc42d26ba382a1666813adfc380c84e857d4f52cf2f8894a6fa70efee68f321ccc0c9c6542866b88f0317df36
+  metadata.gz: df62e31a13f104dc63717aecaefc7dd41ae64463db3730a283a7f67d528ae0c9e61edaa983274cdf55643c10eb3fbefe0b8fb09e57381363092f845e8be03b9b
+  data.tar.gz: ee69e7d79e3ecd3a19803e4044b248a34018f6985d33389f5db083626a084dffb1da4f366bf41c8f488a1a96b06402bb1b13b649901b7b75613a8f8943465bb1

data/CLAUDE.md

@@ -23,6 +23,7 @@ moments, and exporting them.
 
 - [x] Play mp3 / wav files
 - [x] Rewind / fast-forward in 5- and 15-second steps
+- [x] Adjust playback speed in steps (0.5x – 2.0x)
 - [x] Mark the current position (with an optional label)
 - [x] Export the mark list to a file (CSV / JSON)
 
@@ -99,6 +100,9 @@ IPC notes (see `lib/tucue/player.rb`):
 | `←` | -5 seconds |
 | `]` | +15 seconds |
 | `[` | -15 seconds |
+| `+` / `=` | Speed up one step (max 2.0x) |
+| `-` | Slow down one step (min 0.5x) |
+| `0` | Reset speed to 1.0x |
 | `m` | Mark the current position |
 | `e` | Export the marks |
 | `q` | Quit |

data/README.md

@@ -11,11 +11,12 @@ The name is a blend of **TUI** and **Cue** (pronounced "too-cue").
 ```
 ┌─────────────────────────────────┐
 │  File: interview.mp3            │
-│  00:01:23 / 00:45:10  ####----  │
+│  00:01:23 / 00:45:10  ####----  1.25x  │
 ├─────────────────────────────────┤
 │  [Space] play/pause             │
 │  [<-] -5s   [->] +5s            │
 │  [[] -15s   []] +15s            │
+│  [-] slower  [+] faster  [0] reset speed │
 │  [m] mark   [e] export          │
 │  [q] quit                       │
 ├─────────────────────────────────┤
@@ -81,6 +82,9 @@ bundle exec tucue --start 01:02:03 interview.mp3
 | `←` | -5 seconds |
 | `]` | +15 seconds |
 | `[` | -15 seconds |
+| `+` / `=` | Speed up one step (max 2x) |
+| `-` | Slow down one step (min 0.5x) |
+| `0` | Reset speed to 1x |
 | `m` | Mark the current position (prompts for an optional label) |
 | `e` | Export the marks |
 | `q` | Quit |

data/lib/tucue/player.rb

@@ -16,6 +16,10 @@ module Tucue
     # Max seconds to wait for the IPC socket to appear.
     SOCKET_TIMEOUT = 5
 
+    # Selectable playback speeds, from half to double, centered on 1.0.
+    SPEED_STEPS = [0.5, 0.75, 1.0, 1.25, 1.5, 1.75, 2.0].freeze
+    DEFAULT_SPEED_INDEX = SPEED_STEPS.index(1.0)
+
     def initialize(file, socket_path: "/tmp/tucue.sock", start_at: nil, extra_args: [])
       @file = file
       @socket_path = socket_path
@@ -25,6 +29,7 @@ module Tucue
       @socket = nil
       @request_id = 0
       @mutex = Mutex.new
+      @speed_index = DEFAULT_SPEED_INDEX
     end
 
     attr_reader :file
@@ -71,6 +76,29 @@ module Tucue
       command("seek", seconds, "relative")
     end
 
+    # Current playback speed multiplier (e.g. 1.0, 1.25).
+    def speed
+      SPEED_STEPS[@speed_index]
+    end
+
+    # Step the speed up one notch (capped at the fastest step).
+    def speed_up
+      @speed_index = [@speed_index + 1, SPEED_STEPS.size - 1].min
+      apply_speed
+    end
+
+    # Step the speed down one notch (capped at the slowest step).
+    def speed_down
+      @speed_index = [@speed_index - 1, 0].max
+      apply_speed
+    end
+
+    # Reset the speed back to 1.0.
+    def reset_speed
+      @speed_index = DEFAULT_SPEED_INDEX
+      apply_speed
+    end
+
     # Current playback position in seconds, or nil if unavailable.
     def time_pos
       get_property("time-pos")
@@ -92,6 +120,12 @@ module Tucue
 
     private
 
+    # Push the current speed to mpv and return it.
+    def apply_speed
+      set_property("speed", speed)
+      speed
+    end
+
     def mpv_available?
       ENV["PATH"].to_s.split(File::PATH_SEPARATOR).any? do |dir|
         File.executable?(File.join(dir, "mpv"))

data/lib/tucue/ui.rb

@@ -72,6 +72,12 @@ module Tucue
         @player.seek(SEEK_LARGE)
       when "["
         @player.seek(-SEEK_LARGE)
+      when "+", "="
+        @status = "Speed #{format_speed(@player.speed_up)}"
+      when "-"
+        @status = "Speed #{format_speed(@player.speed_down)}"
+      when "0"
+        @status = "Speed #{format_speed(@player.reset_speed)}"
       when "m"
         add_mark
       when "e"
@@ -125,7 +131,7 @@ module Tucue
       pos = @player.time_pos
       dur = @player.duration
       @window.setpos(row, 0)
-      @window.addstr("  #{format_time(pos)} / #{format_time(dur)}  #{progress_bar(pos, dur)}")
+      @window.addstr("  #{format_time(pos)} / #{format_time(dur)}  #{progress_bar(pos, dur)}  #{format_speed(@player.speed)}")
 
       row += 1
       @window.setpos(row, 0)
@@ -135,6 +141,7 @@ module Tucue
         "[Space] play/pause",
         "[<-] -#{SEEK_SMALL}s   [->] +#{SEEK_SMALL}s",
         "[[] -#{SEEK_LARGE}s   []] +#{SEEK_LARGE}s",
+        "[-] slower  [+] faster  [0] reset speed",
         "[m] mark   [e] export",
         "[q] quit"
       ].each do |line|
@@ -172,6 +179,11 @@ module Tucue
       ("#" * filled) + ("-" * (PROGRESS_WIDTH - filled))
     end
 
+    # Format a speed multiplier compactly, e.g. 0.5x, 1x, 1.25x.
+    def format_speed(value)
+      "#{format("%g", value)}x"
+    end
+
     # Format seconds as HH:MM:SS.
     def format_time(seconds)
       return "--:--:--" if seconds.nil?

data/lib/tucue/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tucue
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tucue
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - takkanm