backpack-backtrack 0.3.0__tar.gz → 0.3.2__tar.gz

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backpack-backtrack
-Version: 0.3.0
+Version: 0.3.2
 Summary: Terminal music player with VLC playback, lyrics sync, and metadata editing.
 License: MIT
 Project-URL: Homepage, https://github.com/RedEraRrow/backtrack
@@ -21,7 +21,7 @@ Requires-Dist: numpy>=1.24
 Requires-Dist: pyperclip>=1.11.0
 Requires-Dist: python-vlc>=3.0.21203
 Requires-Dist: colorama>=0.4.6
-Requires-Dist: backpack-backbone<0.4,>=0.3
+Requires-Dist: backpack-backbone<0.4,>=0.3.2
 Dynamic: license-file
 
 # Backtrack
@@ -87,9 +87,11 @@ and has a tag editor (ID3, MP4 and Vorbis comments) with bulk operations for who
 
 macOS, starting from nothing:
 ```bash
-# Homebrew, if you don't have it yet (it asks for your password, and on Apple
-# Silicon prints two lines to run afterwards: run them)
+# Homebrew, if you don't have it yet (it asks for your password)
 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+# put brew on your PATH, now and in new windows (Apple Silicon; does nothing on an Intel Mac)
+echo 'eval "$(/opt/homebrew/bin/brew shellenv 2>/dev/null)"' >> ~/.zprofile
+eval "$(/opt/homebrew/bin/brew shellenv 2>/dev/null)"
 
 brew install pipx
 brew install --cask vlc
@@ -155,13 +157,19 @@ last run's queue. In the player, `f` hides or shows the tab bar (also Settings
 The player sits in boxes while the tab bar or a panel shows, at any window size, and edge to edge
 only with neither (`f` hides the bar). The
 boxes fill the window with no gaps between them: the art and the details in a box as wide as the art
-with the panels (`w`) in columns beside it when they get room enough there, else under it; and along the
+with the panels (`w`) in columns beside it wherever they fit without leaving the art much smaller
+(the player's box gives up width for them; a column on each side can differ in width, as can the
+panels stacked in one), else under it, as in a tall, narrow window; and along the
 bottom the controls, the progress bar, the times and the speed or sleep timer. In a short, wide
 window the art sits beside the details instead of over them, so it stays as big as it can be.
 In a tiny window it's just the transport: boxed in 3 to 5 rows, bare in 1 or 2 (and the tab bar and
 status line step aside under 6 rows). As it narrows the row gives things up in turn, never cutting
 any short: the bar, then the length (the position alone), then the time, then previous, then next,
-leaving play/pause, and last the box. The art is a square
+leaving play/pause, and last the box. Screens never show without their boxes: one in a window
+too small for them (under 10 rows, or 9 columns) gives way to that same transport, alone, until the
+window grows and it comes back as you left it. Meanwhile the transport's own keys work (play/pause,
+next, previous, seeking, volume) and `:` opens the command line; nothing else reaches the screen.
+The art is a square
 that fills its space (a cover that isn't square is cropped about its centre), in the player,
 Browse's preview and the tag editor's picture screens alike; an audiobook's booklet picture too.
 The people panel
@@ -260,11 +268,11 @@ by screen, with more than one key per action if you like), and every hint bar sh
 | `←` / `→` | Seek ∓5 s |
 | `j` / `l` | Seek ∓1 s |
 | `,` / `.` | Seek ∓30 s |
-| `+` / `-` | Volume up / down |
+| `+` / `-` | Volume up / down, here and on any list (the level shows for a moment over the middle of the screen); in a text field they're typed |
 | `m` | Show or hide the track details line (year · genre · disc/track …); remembered. Also Settings → Track details in player |
 | `w` | Choose the panels: a box over the player to tick Lyrics, People, Queue and Chapters (one this track has nothing for says so). Its **Arrange panels…** moves them: `Tab` from panel to panel (the one moving is outlined in the accent), `↑` / `↓` up or down its column, `←` / `→` to the other side of the player, `↵` done. A wide window and a tall one each keep their own arrangement: wide, the panels are columns beside the player (either side, or both); tall, they're under it, side by side when there's room. Remembered |
-| `↑` / `↓` | With the queue panel showing: a cursor through the queue. `↵` plays the track at it, `J` / `K` move it up / down, `d` removes it, `x` shuffles what's coming, `c` clears what's coming, `u` undoes the last queue change |
-| `?` | Show or hide the key hints, on every screen: they start hidden. Each screen's top line ends in `[?] help`; in a text field, where `?` is typed, it says `[^/] help` and the key is Ctrl+/ (which works everywhere). Clicking the key in the corner works too. In the player it stays in the hint bar. Settings → Help toggle hides `[?] help` everywhere; `?` still works |
+| `↑` / `↓` | With the queue panel showing: a cursor through the queue (the mouse wheel or a trackpad over the panel moves it too). `↵` plays the track at it, `J` / `K` move it up / down, `d` removes it, `x` shuffles what's coming, `c` clears what's coming, `u` undoes the last queue change |
+| `?` | Show or hide the key hints, on every screen: they start hidden. Each screen's top line ends in `[?] help`; in a text field, where `?` is typed, it says `[^/] help` and the key is Ctrl+/ (macOS's Terminal sends nothing for that, so there it says `[^g] help` and the key is Ctrl+G; either works anywhere it arrives). Clicking the key in the corner works too. In the player it stays in the hint bar. Settings → [?] help toggle hides `[?] help` everywhere; `?` still works |
 | `[` / `]` | Previous / next track |
 | `e` | Edit the playing track's tags |
 | `a` / `A` | Go to the playing track's album / artist in Browse (`Esc` from there goes up through Browse) |

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/README.md

@@ -61,9 +61,11 @@ and has a tag editor (ID3, MP4 and Vorbis comments) with bulk operations for who
 
 macOS, starting from nothing:
 ```bash
-# Homebrew, if you don't have it yet (it asks for your password, and on Apple
-# Silicon prints two lines to run afterwards: run them)
+# Homebrew, if you don't have it yet (it asks for your password)
 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+# put brew on your PATH, now and in new windows (Apple Silicon; does nothing on an Intel Mac)
+echo 'eval "$(/opt/homebrew/bin/brew shellenv 2>/dev/null)"' >> ~/.zprofile
+eval "$(/opt/homebrew/bin/brew shellenv 2>/dev/null)"
 
 brew install pipx
 brew install --cask vlc
@@ -129,13 +131,19 @@ last run's queue. In the player, `f` hides or shows the tab bar (also Settings
 The player sits in boxes while the tab bar or a panel shows, at any window size, and edge to edge
 only with neither (`f` hides the bar). The
 boxes fill the window with no gaps between them: the art and the details in a box as wide as the art
-with the panels (`w`) in columns beside it when they get room enough there, else under it; and along the
+with the panels (`w`) in columns beside it wherever they fit without leaving the art much smaller
+(the player's box gives up width for them; a column on each side can differ in width, as can the
+panels stacked in one), else under it, as in a tall, narrow window; and along the
 bottom the controls, the progress bar, the times and the speed or sleep timer. In a short, wide
 window the art sits beside the details instead of over them, so it stays as big as it can be.
 In a tiny window it's just the transport: boxed in 3 to 5 rows, bare in 1 or 2 (and the tab bar and
 status line step aside under 6 rows). As it narrows the row gives things up in turn, never cutting
 any short: the bar, then the length (the position alone), then the time, then previous, then next,
-leaving play/pause, and last the box. The art is a square
+leaving play/pause, and last the box. Screens never show without their boxes: one in a window
+too small for them (under 10 rows, or 9 columns) gives way to that same transport, alone, until the
+window grows and it comes back as you left it. Meanwhile the transport's own keys work (play/pause,
+next, previous, seeking, volume) and `:` opens the command line; nothing else reaches the screen.
+The art is a square
 that fills its space (a cover that isn't square is cropped about its centre), in the player,
 Browse's preview and the tag editor's picture screens alike; an audiobook's booklet picture too.
 The people panel
@@ -234,11 +242,11 @@ by screen, with more than one key per action if you like), and every hint bar sh
 | `←` / `→` | Seek ∓5 s |
 | `j` / `l` | Seek ∓1 s |
 | `,` / `.` | Seek ∓30 s |
-| `+` / `-` | Volume up / down |
+| `+` / `-` | Volume up / down, here and on any list (the level shows for a moment over the middle of the screen); in a text field they're typed |
 | `m` | Show or hide the track details line (year · genre · disc/track …); remembered. Also Settings → Track details in player |
 | `w` | Choose the panels: a box over the player to tick Lyrics, People, Queue and Chapters (one this track has nothing for says so). Its **Arrange panels…** moves them: `Tab` from panel to panel (the one moving is outlined in the accent), `↑` / `↓` up or down its column, `←` / `→` to the other side of the player, `↵` done. A wide window and a tall one each keep their own arrangement: wide, the panels are columns beside the player (either side, or both); tall, they're under it, side by side when there's room. Remembered |
-| `↑` / `↓` | With the queue panel showing: a cursor through the queue. `↵` plays the track at it, `J` / `K` move it up / down, `d` removes it, `x` shuffles what's coming, `c` clears what's coming, `u` undoes the last queue change |
-| `?` | Show or hide the key hints, on every screen: they start hidden. Each screen's top line ends in `[?] help`; in a text field, where `?` is typed, it says `[^/] help` and the key is Ctrl+/ (which works everywhere). Clicking the key in the corner works too. In the player it stays in the hint bar. Settings → Help toggle hides `[?] help` everywhere; `?` still works |
+| `↑` / `↓` | With the queue panel showing: a cursor through the queue (the mouse wheel or a trackpad over the panel moves it too). `↵` plays the track at it, `J` / `K` move it up / down, `d` removes it, `x` shuffles what's coming, `c` clears what's coming, `u` undoes the last queue change |
+| `?` | Show or hide the key hints, on every screen: they start hidden. Each screen's top line ends in `[?] help`; in a text field, where `?` is typed, it says `[^/] help` and the key is Ctrl+/ (macOS's Terminal sends nothing for that, so there it says `[^g] help` and the key is Ctrl+G; either works anywhere it arrives). Clicking the key in the corner works too. In the player it stays in the hint bar. Settings → [?] help toggle hides `[?] help` everywhere; `?` still works |
 | `[` / `]` | Previous / next track |
 | `e` | Edit the playing track's tags |
 | `a` / `A` | Go to the playing track's album / artist in Browse (`Esc` from there goes up through Browse) |

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backpack_backtrack.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: backpack-backtrack
-Version: 0.3.0
+Version: 0.3.2
 Summary: Terminal music player with VLC playback, lyrics sync, and metadata editing.
 License: MIT
 Project-URL: Homepage, https://github.com/RedEraRrow/backtrack
@@ -21,7 +21,7 @@ Requires-Dist: numpy>=1.24
 Requires-Dist: pyperclip>=1.11.0
 Requires-Dist: python-vlc>=3.0.21203
 Requires-Dist: colorama>=0.4.6
-Requires-Dist: backpack-backbone<0.4,>=0.3
+Requires-Dist: backpack-backbone<0.4,>=0.3.2
 Dynamic: license-file
 
 # Backtrack
@@ -87,9 +87,11 @@ and has a tag editor (ID3, MP4 and Vorbis comments) with bulk operations for who
 
 macOS, starting from nothing:
 ```bash
-# Homebrew, if you don't have it yet (it asks for your password, and on Apple
-# Silicon prints two lines to run afterwards: run them)
+# Homebrew, if you don't have it yet (it asks for your password)
 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+# put brew on your PATH, now and in new windows (Apple Silicon; does nothing on an Intel Mac)
+echo 'eval "$(/opt/homebrew/bin/brew shellenv 2>/dev/null)"' >> ~/.zprofile
+eval "$(/opt/homebrew/bin/brew shellenv 2>/dev/null)"
 
 brew install pipx
 brew install --cask vlc
@@ -155,13 +157,19 @@ last run's queue. In the player, `f` hides or shows the tab bar (also Settings
 The player sits in boxes while the tab bar or a panel shows, at any window size, and edge to edge
 only with neither (`f` hides the bar). The
 boxes fill the window with no gaps between them: the art and the details in a box as wide as the art
-with the panels (`w`) in columns beside it when they get room enough there, else under it; and along the
+with the panels (`w`) in columns beside it wherever they fit without leaving the art much smaller
+(the player's box gives up width for them; a column on each side can differ in width, as can the
+panels stacked in one), else under it, as in a tall, narrow window; and along the
 bottom the controls, the progress bar, the times and the speed or sleep timer. In a short, wide
 window the art sits beside the details instead of over them, so it stays as big as it can be.
 In a tiny window it's just the transport: boxed in 3 to 5 rows, bare in 1 or 2 (and the tab bar and
 status line step aside under 6 rows). As it narrows the row gives things up in turn, never cutting
 any short: the bar, then the length (the position alone), then the time, then previous, then next,
-leaving play/pause, and last the box. The art is a square
+leaving play/pause, and last the box. Screens never show without their boxes: one in a window
+too small for them (under 10 rows, or 9 columns) gives way to that same transport, alone, until the
+window grows and it comes back as you left it. Meanwhile the transport's own keys work (play/pause,
+next, previous, seeking, volume) and `:` opens the command line; nothing else reaches the screen.
+The art is a square
 that fills its space (a cover that isn't square is cropped about its centre), in the player,
 Browse's preview and the tag editor's picture screens alike; an audiobook's booklet picture too.
 The people panel
@@ -260,11 +268,11 @@ by screen, with more than one key per action if you like), and every hint bar sh
 | `←` / `→` | Seek ∓5 s |
 | `j` / `l` | Seek ∓1 s |
 | `,` / `.` | Seek ∓30 s |
-| `+` / `-` | Volume up / down |
+| `+` / `-` | Volume up / down, here and on any list (the level shows for a moment over the middle of the screen); in a text field they're typed |
 | `m` | Show or hide the track details line (year · genre · disc/track …); remembered. Also Settings → Track details in player |
 | `w` | Choose the panels: a box over the player to tick Lyrics, People, Queue and Chapters (one this track has nothing for says so). Its **Arrange panels…** moves them: `Tab` from panel to panel (the one moving is outlined in the accent), `↑` / `↓` up or down its column, `←` / `→` to the other side of the player, `↵` done. A wide window and a tall one each keep their own arrangement: wide, the panels are columns beside the player (either side, or both); tall, they're under it, side by side when there's room. Remembered |
-| `↑` / `↓` | With the queue panel showing: a cursor through the queue. `↵` plays the track at it, `J` / `K` move it up / down, `d` removes it, `x` shuffles what's coming, `c` clears what's coming, `u` undoes the last queue change |
-| `?` | Show or hide the key hints, on every screen: they start hidden. Each screen's top line ends in `[?] help`; in a text field, where `?` is typed, it says `[^/] help` and the key is Ctrl+/ (which works everywhere). Clicking the key in the corner works too. In the player it stays in the hint bar. Settings → Help toggle hides `[?] help` everywhere; `?` still works |
+| `↑` / `↓` | With the queue panel showing: a cursor through the queue (the mouse wheel or a trackpad over the panel moves it too). `↵` plays the track at it, `J` / `K` move it up / down, `d` removes it, `x` shuffles what's coming, `c` clears what's coming, `u` undoes the last queue change |
+| `?` | Show or hide the key hints, on every screen: they start hidden. Each screen's top line ends in `[?] help`; in a text field, where `?` is typed, it says `[^/] help` and the key is Ctrl+/ (macOS's Terminal sends nothing for that, so there it says `[^g] help` and the key is Ctrl+G; either works anywhere it arrives). Clicking the key in the corner works too. In the player it stays in the hint bar. Settings → [?] help toggle hides `[?] help` everywhere; `?` still works |
 | `[` / `]` | Previous / next track |
 | `e` | Edit the playing track's tags |
 | `a` / `A` | Go to the playing track's album / artist in Browse (`Esc` from there goes up through Browse) |

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backpack_backtrack.egg-info/SOURCES.txt

@@ -107,6 +107,7 @@ tests/test_lyrics_editor_keys.py
 tests/test_md_overlay.py
 tests/test_moved_files.py
 tests/test_panels.py
+tests/test_player_details.py
 tests/test_player_layout.py
 tests/test_player_panes.py
 tests/test_player_seek_keys.py

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backpack_backtrack.egg-info/requires.txt

@@ -4,4 +4,4 @@ numpy>=1.24
 pyperclip>=1.11.0
 python-vlc>=3.0.21203
 colorama>=0.4.6
-backpack-backbone<0.4,>=0.3
+backpack-backbone<0.4,>=0.3.2

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/bulk_pattern.py

@@ -235,7 +235,7 @@ def validate_schedule_rows(rows: list, n_tracks: int) -> tuple:
             errors.append(f"row {i}: FROM/TO must both be track positions")
             continue
         if lo > hi:
-            errors.append(f"row {i}: FROM ({lo}) is after TO ({hi})")
+            errors.append(f"row {i}: FROM {lo} is after TO {hi}")
             continue
         if hi < 1 or lo > n_tracks:
             errors.append(f"row {i}: positions {lo}-{hi} are outside 1-{n_tracks}")

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/id3/bulk_art.py

@@ -124,14 +124,14 @@ def set_album_art_op(paths: list, library: list, header) -> None:
     # 1) Matching strategy. Each answer is kept in `state`, so a screen reopened
     # by walking back holds what it was left holding, including covers chosen by
     # hand in the preview, which survive the plan being rebuilt.
-    _MODES = ["Auto-detect (recommended)",
+    _MODES = ["Auto-detect",
               "One cover per disc / series / work",
               "Matching file name",
               "Track number / order",
-              "Name pattern (%token%)"]
-    _GROUPS = {"Auto (disc, else series, else work)": 'auto',
+              "Name pattern"]
+    _GROUPS = {"Auto: disc, else series, else work": 'auto',
                "Disc number": 'disc',
-               "Series / season (SxxExx)": 'season',
+               "Series or season, from SxxExx": 'season',
                "Work / grouping": 'work'}
     _POLICIES = ["Fill blanks only", "Overwrite existing"]
     state: dict = {'mode': _MODES[0], 'group': list(_GROUPS)[0], 'pattern': None,
@@ -160,7 +160,7 @@ def set_album_art_op(paths: list, library: list, header) -> None:
 
     def _ask_pattern():
         """The image-name pattern; only asked for pattern matching."""
-        if state['mode'] != "Name pattern (%token%)":
+        if state['mode'] != "Name pattern":
             return _SKIP
         picked = _cover_pattern_prompt(header)
         if picked is None:
@@ -232,7 +232,7 @@ def set_album_art_op(paths: list, library: list, header) -> None:
             """Cell text for a track's planned cover: label, plus a "has art" badge if replacing."""
             img = plan.get(p)
             if not img:
-                return "none (d to choose)"
+                return "none, d chooses"
             label = cover_label(img, os.path.dirname(os.path.abspath(p)))
             if existing_art[p]:
                 return [(label, 'normal'), ('  · has art', 'static-dim')]
@@ -256,7 +256,7 @@ def set_album_art_op(paths: list, library: list, header) -> None:
             state['manual'][p] = img        # remembered if this screen is revisited
             if img is None:
                 plan[p] = None
-                ch.cells = [os.path.basename(p), "none (d to choose)", '']
+                ch.cells = [os.path.basename(p), "none, d chooses", '']
                 ch.checked = False
             else:
                 plan[p] = img
@@ -338,11 +338,11 @@ def set_album_art_op(paths: list, library: list, header) -> None:
             if nk:
                 bits.append(f"{nk} ticked")
             elif n_match:
-                bits.append("0 ticked (existing art); Overwrite or Space/a to tick")
+                bits.append("0 ticked: they have art already. Overwrite, or Space or a, ticks them")
             return header(" · ".join(bits))()
 
         sel = prompt.select(
-            "Preview (↵ applies):",
+            "Preview, ↵ applies:",
             choices=preview_choices, columns=_COVER_PREVIEW_COLUMNS,
             header=_preview_header, multi=True,
             extra_hints={'tags.details': 'choose cover'}, on_inspect=_reassign,

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/id3/bulk_assign.py

@@ -264,7 +264,7 @@ def bulk_fraction_editor(paths: list, tag_id: str, library: list, header) -> Non
             bits.append(f"{skipped_fmt} non-ID3 skipped")
         return header(' · '.join(bits))()
 
-    sel = prompt.select("Preview (↵ applies):", choices=choices,
+    sel = prompt.select("Preview, ↵ applies:", choices=choices,
                         columns=_RENUMBER_COLUMNS, header=_frac_header, multi=True)
     if sel is None:
         return
@@ -360,9 +360,9 @@ def assign_by_pattern(paths: list, library: list, header) -> None:
     def _modes() -> list:
         """The assignment modes this tag supports (schedules need a date frame)."""
         info = get_tag_info(state['tag'])
-        modes = ["Ranges (from-to → value)", "Every N tracks → value"]
+        modes = ["Ranges: from-to → value", "Every N tracks → value"]
         if info and info.format_spec == 'ISO8601':
-            modes += ["Date schedule", "Schedule per range (own start + interval)"]
+            modes += ["Date schedule", "Schedule per range: its own start and interval"]
         return modes
 
     def _ask_mode() -> bool:
@@ -576,7 +576,7 @@ def assign_by_pattern(paths: list, library: list, header) -> None:
             return False
         sub = f"{tag_id} · {ui.plural(len(choices), 'file')}" + (
             f" · {n_mp4} non-ID3 skipped" if n_mp4 else "")
-        sel = prompt.select("Preview (↵ applies):", choices=choices,
+        sel = prompt.select("Preview, ↵ applies:", choices=choices,
                             columns=_PATTERN_COLUMNS, header=header(sub), multi=True)
         if sel is None:
             return False

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/id3/bulk_menu.py

@@ -68,8 +68,8 @@ def renumber_tracks_op(paths: list, library: list, header) -> None:
         ui.show_status("No taggable tracks to renumber.")
         return
 
-    _MODES = ["Continuous (album-relative): 1…N across all discs",
-              "Per-disc (disc-relative): restart at 1 each disc"]
+    _MODES = ["Continuous: 1…N across all discs",
+              "Per disc: restart at 1 each disc"]
     state: dict = {'mode_sel': _MODES[0], 'apply_set': set()}
 
     def _ask_mode() -> bool:
@@ -99,7 +99,7 @@ def renumber_tracks_op(paths: list, library: list, header) -> None:
             for (pos, name, why), c in zip(bo.position_rows(plan), plan.changes)]
         sub = ui.plural(len(choices), "file") + (
             f" · {skipped_fmt} unsupported skipped" if skipped_fmt else "")
-        sel = prompt.select("Preview (↵ applies):", choices=choices,
+        sel = prompt.select("Preview, ↵ applies:", choices=choices,
                             columns=_RENUMBER_COLUMNS, header=header(sub), multi=True)
         if sel is None:
             return False
@@ -320,7 +320,7 @@ def bulk_id3_manager(library: list, album_name: str | None = None, paths: list |
             "Set album art from files",
             "Assign by range / schedule",
             "Apply sort orders",
-            "Renumber tracks (disc ↔ continuous)",
+            "Renumber tracks",
             "Reflow disc numbering",
             "Remove single-disc numbering",
             "Strip stale length tags",
@@ -346,7 +346,7 @@ def bulk_id3_manager(library: list, album_name: str | None = None, paths: list |
         "Set album art from files": "Set Album Art",
         "Assign by range / schedule": "Assign By Pattern",
         "Apply sort orders": "Apply Sort Orders",
-        "Renumber tracks (disc ↔ continuous)": "Renumber Tracks",
+        "Renumber tracks": "Renumber Tracks",
         "Reflow disc numbering": "Reflow Discs",
         "Remove single-disc numbering": "Strip Single Disc",
         "Strip stale length tags": "Strip Length Tags",
@@ -534,15 +534,15 @@ def bulk_id3_manager(library: list, album_name: str | None = None, paths: list |
 
                 source = prompt.select(
                     "Value source:",
-                    choices=["Enter a value", "Find & replace (regex)",
-                             "From file name / folder (regex)"],
+                    choices=["Enter a value", "Find and replace with a regex",
+                             "Regex on the file or folder name"],
                     header=_bulk_header())
                 if not source:
                     return
 
                 if source == "Enter a value":
                     target_val = prompt_for_value(first_tag, current_value=fallback_val)
-                elif source == "Find & replace (regex)":
+                elif source == "Find and replace with a regex":
                     pat = prompt.text("Regex to find in each value:")
                     if not pat:
                         return
@@ -556,7 +556,7 @@ def bulk_id3_manager(library: list, album_name: str | None = None, paths: list |
                         return
                     set_spec = {'mode': 'replace', 'rx': rx, 'repl': repl}
                     target_val = "_regex_"   # sentinel so the None-guard below doesn't bail
-                else:  # From file name / folder (regex)
+                else:  # regex on the file or folder name
                     against = prompt.select("Match regex against:",
                                             choices=["File name", "Folder path"],
                                             header=_bulk_header())
@@ -686,7 +686,7 @@ def bulk_id3_manager(library: list, album_name: str | None = None, paths: list |
             return _bulk_header(" · ".join(bits))()
 
         picked_rows = prompt.select(
-            "Preview (↵ applies):",
+            "Preview, ↵ applies:",
             choices=art_choices, columns=_COVER_PREVIEW_COLUMNS,
             header=_art_header, multi=True)
         if picked_rows is None:

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/id3/bulk_names.py

@@ -64,7 +64,7 @@ def _detail_view(path, derived, plan: dict, present: dict, apply_fields: set,
         elif f == 'disc':
             val = _num_pair(d['disc'], d.get('total_discs'))
         if f not in supported:
-            action = 'n/a (MP4)'
+            action = 'not in MP4'
         elif f in plan:
             action = 'write'
         else:
@@ -156,9 +156,9 @@ def derive_from_filename(paths: list, library: list, header) -> None:
 
     # 1) Which fields to write (Title on by default: the automatic baseline).
     _FIELDS = [("title", "Title: from file name"),
-               ("track", "Track number (+ total)"),
-               ("disc", "Disc number (+ total)"),
-               ("disc_subtitle", "Disc subtitle: from folder (not MP4)"),
+               ("track", "Track number and total"),
+               ("disc", "Disc number and total"),
+               ("disc_subtitle", "Disc subtitle from the folder, not MP4"),
                ("album", "Album: from folder"),
                ("album_artist", "Album artist: from parent folder"),
                ("artist", "Track artist: from file name / folder"),
@@ -329,7 +329,7 @@ def derive_from_filename(paths: list, library: list, header) -> None:
                          apply_fields, overwrite, header)
 
         selected = prompt.select(
-            "Preview (↵ applies):",
+            "Preview, ↵ applies:",
             choices=preview_choices, columns=prev_cols,
             header=header(sub), multi=True,
             extra_hints={'tags.details': 'details'}, on_inspect=_show_detail,
@@ -447,7 +447,7 @@ def rename_files_op(paths: list, library: list, header) -> None:
                    for i, (p, o, n) in enumerate(changed)]
         sub = f"{len(changed)} to rename" + (
             f" · {skipped_fmt} unsupported skipped" if skipped_fmt else "")
-        sel = prompt.select("Preview (↵ renames):", choices=choices,
+        sel = prompt.select("Preview, ↵ renames:", choices=choices,
                             columns=_RENAME_COLUMNS, header=header(sub), multi=True)
         if sel is None:
             return False

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/id3/bulk_sort.py

@@ -238,7 +238,7 @@ def _review_sort_people(plan: _SortPlan, header, note: str = "") -> set | None:
     choices = _choices()
     files = len({p for ps in plan.entries.values() for p in ps})
     sub = f"{ui.plural(len(choices), 'name')} · {ui.plural(files, 'file')}{note}"
-    sel = prompt.select("Preview (↵ applies):", choices=choices,
+    sel = prompt.select("Preview, ↵ applies:", choices=choices,
                         columns=_SORT_VALUE_COLUMNS, header=header(sub), multi=True,
                         row_edit=_options, row_edit_commit=_commit, row_edit_col=1)
     return None if sel is None else set(sel)

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/id3/tag_handler.py

@@ -37,7 +37,7 @@ _EXT_TO_MIME: dict[str, str] = {
 keys.define("tags", "Tag editor", [
     ("add", ("a",), "add a tag, or a person"),
     ("trim", ("t",), "trim the audio"),
-    ("details", ("d",), "the row's details (description, cover, preview)"),
+    ("details", ("d",), "the row's details: description, cover, preview"),
 ], within=("list", "global"))
 
 
@@ -148,7 +148,7 @@ def pick_nearby_cover(file_path: str, *, tokens: dict | None = None,
         choices.append(prompt.Choice(title="No art for this file", value='__none__',
                                      cells=["No art for this file", '', '']))
 
-    msg = title or "Album art (top row is the best guess):"
+    msg = title or "Album art, best guess first:"
     hdr = header(ui.plural(len(ranked), "candidate")) if header else None
     sel = prompt.select(msg, choices=choices, columns=_COVER_PICK_COLUMNS,
                         header=hdr, index=cur_idx)
@@ -510,7 +510,7 @@ def _prompt_for_equalisation(current_value: Any) -> dict | None:
 def _prompt_for_rva2(current_value: Any) -> dict | None:
     """Interactive gain meter for a single-channel RVA2 frame."""
     cur = float(current_value.gain) if (current_value is not None and hasattr(current_value, 'gain')) else 0.0
-    gain = prompt.rva2_edit("Volume adjustment (master channel):", gain=cur)
+    gain = prompt.rva2_edit("Master volume adjustment:", gain=cur)
     if gain is None:
         return None
     return {'__rva2__': True, 'gain': gain}
@@ -683,7 +683,7 @@ def _prompt_for_compilation(current_value: Any) -> str | None:
     """Yes/No toggle for the TCMP compilation flag (stored as '1'/'0')."""
     cur = _current_text(current_value).strip()
     is_comp = cur not in ('', '0')
-    sel = prompt.select("Part of a compilation (various-artists album)?",
+    sel = prompt.select("Part of a various-artists compilation?",
                         choices=[prompt.Choice(title='Yes', value='1'),
                                  prompt.Choice(title='No', value='0')],
                         index=0 if is_comp else 1)
@@ -693,7 +693,7 @@ def _prompt_for_compilation(current_value: Any) -> str | None:
 def _prompt_for_rbuf(current_value: Any) -> dict | None:
     """Numeric editor for the RBUF recommended-buffer-size frame (bytes)."""
     cur = int(getattr(current_value, 'size', 0) or 0) if current_value is not None else 0
-    n = prompt.number_edit("Recommended buffer size (bytes):", value=cur, minimum=0)
+    n = prompt.number_edit("Recommended buffer size in bytes:", value=cur, minimum=0)
     if not isinstance(n, int):
         return None
     return {'__rbuf__': True, 'size': int(n)}

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/lyrics/editor_keys.py

@@ -376,7 +376,7 @@ class _KeyHandlers:
         _restore_term_attrs(self.fd, self.old)
         sys.stdout.write("\033[?1000l\033[?1006l")
         _ans = _prompt_text(
-            f"Write spoken words (Whisper format) to "
+            f"Write spoken words in Whisper format to "
             f"{os.path.basename(self.aux['jpath'])}? (y/N)")
         _set_raw(self.fd)
         sys.stdout.write("\033[?1000h\033[?1006h")
@@ -468,7 +468,7 @@ class _KeyHandlers:
             _restore_term_attrs(self.fd, self.old)
             sys.stdout.write("\033[?1000l\033[?1006l")
             _prompt = ("Stage direction text:" if self.segs[self.cursor].get("kind") == "stage_dir"
-                       else "Stage direction (blank = silence):")
+                       else "Stage direction, or blank for silence:")
             _new_lbl = _prompt_text(_prompt, default=_cur_lbl)
             _set_raw(self.fd)
             sys.stdout.write("\033[?1000h\033[?1006h")

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/lyrics/editor_view.py

@@ -36,8 +36,8 @@ keys.define("lyrics", "Lyrics editor", [
     ("play", ("p",), "play / stop"),
     ("save", ("s",), "save the working copy"),
     ("undo", ("u",), "undo"),
-    ("verify", ("V",), "verify against the markdown (transcripts)"),
-    ("write", ("W",), "write the transcript file (transcripts)"),
+    ("verify", ("V",), "verify against the markdown, for transcripts"),
+    ("write", ("W",), "write the transcript file, for transcripts"),
     ("back", ("ESC",), "back"),
     ("quit", ("q",), "quit the app"),
 ])
@@ -48,7 +48,7 @@ keys.define("lyrics_lines", "Lyrics editor: lines", [
     ("move_up", ("J",), "move the line up"),
     ("move_down", ("K",), "move the line down"),
     ("split", ("/",), "split the line"),
-    ("words", ("w",), "open the line's words (transcripts)"),
+    ("words", ("w",), "open the line's words, for transcripts"),
     ("tap", ("t",), "tap sync"),
     ("audition", ("b",), "audition"),
     ("dead_air", ("a",), "add dead air"),
@@ -60,7 +60,7 @@ keys.define("lyrics_lines", "Lyrics editor: lines", [
     ("overlay", ("m",), "import or remove the markdown"),
     ("commit_dirs", ("M",), "commit stage directions"),
     ("credits", ("c",), "add credits"),
-    ("speaker_split", ("S",), "split by speaker (transcripts)"),
+    ("speaker_split", ("S",), "split by speaker, for transcripts"),
     ("review", ("R",), "review issues"),
     ("review_dirs", ("D",), "review directions"),
     ("review_long", ("L",), "review long lines"),
@@ -343,7 +343,7 @@ def _draw(segs, cursor, seg_cursor, mode, prev_mode, selected, viewport,
                       (K('lyrics_lines.label'), 'label'), (K('lyrics_lines.air_dir'), 'air↔dir'),
                       (K('lyrics_lines.fill_gaps'), 'fill gaps'), (K('lyrics_lines.overlay'), _md_label)]
             if is_sdir:
-                pairs.append((K('lyrics_lines.kind'), 'kind (inline/tone/external)'))
+                pairs.append((K('lyrics_lines.kind'), 'kind'))
             if _has_sdir: pairs.append((K('lyrics_lines.commit_dirs'), 'commit stage dirs'))
             pairs += [(K('lyrics_lines.credits'), 'credits'), (K('lyrics_lines.mark'), 'mark')]
             if _HAS_VLC: pairs.append((K('lyrics.play'), 'preview'))
@@ -491,7 +491,8 @@ def _draw_tap(B, avail, cursor, hit_map, indent, mode, n, out, play_pos, playing
     if total_s > 0:
         pct = min(play_pos / total_s, 1.0)
         _clock = f"{timefmt.clock(play_pos)} / {timefmt.clock(total_s)}"
-        bar = ui.get_progress_bar(pct, max(4, B - len(_clock) - 4))  # -4: bar's own [ ] + 2-space gap
+        caps = not _promptmod.box_fits()
+        bar = ui.get_progress_bar(pct, max(4, B - len(_clock) - 2 - ui.progress_caps_width(caps)), caps=caps)  # 2: gap before the clock
         out.append(f"{indent}{C.DIM}{bar}  {_clock}{C.RESET}")
     else:
         out.append("")
@@ -563,11 +564,12 @@ def _draw_audition(B, aud_editing, aud_now, avail, cursor, edit, hit_map, indent
     if total_s > 0:
         pct = min(play_pos / total_s, 1.0)
         _clock = f"{timefmt.clock(play_pos)} / {timefmt.clock(total_s)}"
-        _bar_w = max(4, B - len(_clock) - 4)   # -4: bar's own [ ] + 2-space gap
-        bar = ui.get_progress_bar(pct, _bar_w)
+        caps = not _promptmod.box_fits()
+        _bar_w = max(4, B - len(_clock) - 2 - ui.progress_caps_width(caps))   # 2: gap before the clock
+        bar = ui.get_progress_bar(pct, _bar_w, caps=caps)
         out.append(f"{indent}{C.DIM}{bar}  {_clock}{C.RESET}")
-        # Clickable: the bar's first cell sits one column past its '[' cap.
-        prog_geo = (len(out) - 1, ui.MARGIN_H + 2, _bar_w)
+        # Clickable: the bar's first cell sits just past its left cap.
+        prog_geo = (len(out) - 1, ui.MARGIN_H + 1 + len(ui.progress_caps(caps)[0]), _bar_w)
     else:
         out.append("")
 

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/main.py

@@ -177,6 +177,10 @@ def _wire_playback() -> None:
             a.next()
         elif action == 'prev':
             a.prev()
+        elif action in ('vol_up', 'vol_down'):
+            a.set_volume(max(0, min(100, a.get_volume() + (5 if action == 'vol_up' else -5))))
+            from backtrack.playback.player_ui import volume_changed
+            volume_changed()                       # the level, for a moment, over whatever's showing
         elif action == 'time':
             from backtrack.playback.player_ui import toggle_chapter_time
             toggle_chapter_time()

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/menus/__init__.py

@@ -12,9 +12,10 @@ def main_menu(library_ref: list, on_start=None) -> None:
     """Run the app as tabs, starting on Browse, until q (or Settings → Exit).
     `on_start()` runs first, on Browse (the offer to resume), so what it opens
     has the tabs too."""
-    from backtrack.playback.player import NOW_PLAYING_TAB
+    from backtrack.playback.player import NOW_PLAYING_TAB, cramped_view
     from backtrack.menus.command_line import command_line
-    prompt.set_command_line(lambda: command_line(library_ref))
+    prompt.set_command_line(lambda around=None: command_line(library_ref, around))
+    prompt.core.set_cramped_view(cramped_view)
     pending = [on_start]
 
     def browse() -> None:

{backpack_backtrack-0.3.0 → backpack_backtrack-0.3.2}/backtrack/menus/activity.py

@@ -63,7 +63,7 @@ def activity_centre() -> None:
                         key = ''
                     if key == '\x1b' or keys.action(key, 'list') in ('list.back', 'list.quit'):
                         break
-                time.sleep(0.08)
+                pc._wait_for_keypress(0.08)             # the shared tick: the miniplayer when too small
         finally:
             sys.stdout.write("\033[?1000l\033[?1006l")   # disable mouse
             sys.stdout.flush()