plex-tui 0.3.37__tar.gz → 0.3.41__tar.gz

{plex_tui-0.3.37 → plex_tui-0.3.41}/.github/workflows/post-release-homebrew.yml

@@ -101,6 +101,31 @@ jobs:
           brew tap so1omon563/plex-tui "https://x-access-token:${PACKAGING_PR_TOKEN}@github.com/so1omon563/homebrew-plex-tui.git"
           echo "path=$(brew --repo so1omon563/plex-tui)" >> "$GITHUB_OUTPUT"
 
+      - name: Wait for PyPI package availability
+        if: steps.release.outputs.publish == 'true'
+        env:
+          VERSION: ${{ steps.release.outputs.version }}
+        run: |
+          set -euo pipefail
+
+          for attempt in {1..30}; do
+            if python -m pip install \
+              --dry-run \
+              --ignore-installed \
+              --no-cache-dir \
+              --disable-pip-version-check \
+              "plex-tui==${VERSION}" >/dev/null 2>&1; then
+              echo "plex-tui ${VERSION} is available from PyPI."
+              exit 0
+            fi
+
+            echo "plex-tui ${VERSION} is not available from PyPI yet; retrying (${attempt}/30)."
+            sleep 10
+          done
+
+          echo "plex-tui ${VERSION} did not become available from PyPI in time." >&2
+          exit 1
+
       - name: Update formula source
         if: steps.release.outputs.publish == 'true'
         run: |

{plex_tui-0.3.37 → plex_tui-0.3.41}/AGENTS.md

@@ -218,6 +218,11 @@ GitHub Release publishing is controlled by release markers in PR titles only:
 unless the merge should publish PyPI, Homebrew, and AUR. PR bodies may mention
 release markers for explanation without publishing.
 
+Post-release package workflows may depend on newly published PyPI artifacts.
+Keep Homebrew tap publication waiting for `pip` to resolve the new
+`plex-tui==VERSION` before updating formula resources, so PyPI indexing lag does
+not break otherwise successful releases.
+
 GitHub CLI notes:
 
 - `gh auth status` may fail inside the sandbox even when the user is logged in

{plex_tui-0.3.37 → plex_tui-0.3.41}/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## Unreleased
 
+## 0.3.41 - 2026-06-16
+
+- Fixed Plex-transcoded resume playback by passing the resume offset into the
+  Plex stream request instead of relying only on mpv seeking.
+- Split playback controls so `p` starts selected media from the beginning and
+  `r` resumes from the saved Plex position when available.
+
+## 0.3.39 - 2026-06-16
+
+- Fixed playback resume so videos launched from in-progress rows start at the
+  displayed Plex resume position even when full metadata reloads omit it.
+- Made post-release Homebrew publishing wait for PyPI package availability before
+  resolving formula resources.
+
 ## 0.3.37 - 2026-06-15
 
 - Fell back to direct Plex root checks during browser login when PlexAPI's

{plex_tui-0.3.37 → plex_tui-0.3.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plex-tui
-Version: 0.3.37
+Version: 0.3.41
 Summary: A small standalone Plex terminal UI.
 Project-URL: Homepage, https://github.com/so1omon563/plex-tui
 Project-URL: Issues, https://github.com/so1omon563/plex-tui/issues
@@ -197,19 +197,21 @@ See `config.example.toml` for optional settings.
 ## Playback
 
 Playback is launched through `mpv`; plex-tui does not embed a video player.
-While playback is active, Plex progress is updated in the background. Saved
-audio/subtitle language preferences are applied when matching streams are
-available, and the details pane shows the effective playback choices. Playback
-mode defaults to direct/default behavior and can be changed in Settings to force
-Plex transcoding with Original, 1080p 8 Mbps, 720p 4 Mbps, or 480p 2 Mbps
-quality presets.
+Use `p` to start the selected item from the beginning, or `r` to resume from
+the saved Plex position when one is available. While playback is active, Plex
+progress is updated in the background. Saved audio/subtitle language
+preferences are applied when matching streams are available, and the details
+pane shows the effective playback choices. Playback mode defaults to
+direct/default behavior and can be changed in Settings to force Plex
+transcoding with Original, 1080p 8 Mbps, 720p 4 Mbps, or 480p 2 Mbps quality
+presets.
 
 ## Key Bindings
 
 | Key | Action |
 | --- | --- |
 | `q` | Quit |
-| `r` | Reload Plex connection |
+| `ctrl+r` | Reload Plex connection |
 | `/` | Search current library |
 | `g` | Search all libraries |
 | `?` | Show help |
@@ -221,7 +223,8 @@ quality presets.
 | `,` | Show settings |
 | `escape` | Clear search, go back, or close current view |
 | `enter` | Open selected item |
-| `p` | Play selected item with `mpv` |
+| `p` | Play selected item from the beginning |
+| `r` | Resume selected item from the saved Plex position |
 | `a` / `s` | Choose audio / subtitle preference |
 | `A` / `S` | Clear audio preference / cycle subtitle mode |
 | `x` | Stop launched `mpv` |
@@ -234,7 +237,7 @@ quality presets.
 - List view plus configurable-density grid view with terminal poster artwork.
 - External subtitle support and direct playback for embedded PGS/VOBSUB tracks.
 - Audio and subtitle pickers with saved language preferences.
-- Plex resume support and playback progress reporting.
+- Separate play-from-start and resume actions with Plex progress reporting.
 - Settings screen for stream preferences, playback mode and transcode quality,
   artwork modes, grid density, page size, auto-load threshold, grid artwork
   prefetching, media view, and `mpv` window size.

{plex_tui-0.3.37 → plex_tui-0.3.41}/README.md

@@ -160,19 +160,21 @@ See `config.example.toml` for optional settings.
 ## Playback
 
 Playback is launched through `mpv`; plex-tui does not embed a video player.
-While playback is active, Plex progress is updated in the background. Saved
-audio/subtitle language preferences are applied when matching streams are
-available, and the details pane shows the effective playback choices. Playback
-mode defaults to direct/default behavior and can be changed in Settings to force
-Plex transcoding with Original, 1080p 8 Mbps, 720p 4 Mbps, or 480p 2 Mbps
-quality presets.
+Use `p` to start the selected item from the beginning, or `r` to resume from
+the saved Plex position when one is available. While playback is active, Plex
+progress is updated in the background. Saved audio/subtitle language
+preferences are applied when matching streams are available, and the details
+pane shows the effective playback choices. Playback mode defaults to
+direct/default behavior and can be changed in Settings to force Plex
+transcoding with Original, 1080p 8 Mbps, 720p 4 Mbps, or 480p 2 Mbps quality
+presets.
 
 ## Key Bindings
 
 | Key | Action |
 | --- | --- |
 | `q` | Quit |
-| `r` | Reload Plex connection |
+| `ctrl+r` | Reload Plex connection |
 | `/` | Search current library |
 | `g` | Search all libraries |
 | `?` | Show help |
@@ -184,7 +186,8 @@ quality presets.
 | `,` | Show settings |
 | `escape` | Clear search, go back, or close current view |
 | `enter` | Open selected item |
-| `p` | Play selected item with `mpv` |
+| `p` | Play selected item from the beginning |
+| `r` | Resume selected item from the saved Plex position |
 | `a` / `s` | Choose audio / subtitle preference |
 | `A` / `S` | Clear audio preference / cycle subtitle mode |
 | `x` | Stop launched `mpv` |
@@ -197,7 +200,7 @@ quality presets.
 - List view plus configurable-density grid view with terminal poster artwork.
 - External subtitle support and direct playback for embedded PGS/VOBSUB tracks.
 - Audio and subtitle pickers with saved language preferences.
-- Plex resume support and playback progress reporting.
+- Separate play-from-start and resume actions with Plex progress reporting.
 - Settings screen for stream preferences, playback mode and transcode quality,
   artwork modes, grid density, page size, auto-load threshold, grid artwork
   prefetching, media view, and `mpv` window size.

{plex_tui-0.3.37 → plex_tui-0.3.41}/ROADMAP.md

@@ -53,8 +53,9 @@
   server response.
 - Alphabet navigation is available for loaded browse lists and grids with
   previous/next section jumps.
-- Explicit playback controls are available for direct/default playback versus
-  selected transcode quality presets.
+- Explicit playback controls are available for play-from-start versus resume,
+  direct/default playback versus selected transcode quality presets, and
+  Plex-side resume offsets for transcoded streams.
 - Later design passes: profile switching with auto sign-in, visible movie
   edition handling, and in-playback audio/subtitle switching through mpv IPC.
 

{plex_tui-0.3.37 → plex_tui-0.3.41}/docs/plex-integration-research.md

@@ -38,54 +38,42 @@ Already covered:
 
 - Plex PIN login and server selection.
 - Library list browsing with paged loading and automatic load-more.
+- Continue Watching as a top-level browse entry.
+- Selective library display in Settings.
+- Library submenus for Library, Recommended, Collections, and Playlists.
+- Alphabet navigation for loaded browse lists and grids.
 - Current-library and global search.
 - Show/season/episode child browsing through PlexAPI child helpers.
-- Resume offset playback and progress reporting.
+- Separate play-from-start and resume controls, including Plex-side resume
+  offsets for transcoded streams and progress reporting.
 - Saved audio/subtitle language preferences plus per-item stream pickers.
 - Direct playback paths where possible, with transcode fallback through PlexAPI.
+- Explicit video quality/direct/transcode preference in Settings and playback.
 - Details pane metadata, audio/subtitle stream display, and playback readiness.
 
 Not yet covered:
 
-- Continue Watching as a top-level browse entry.
-- Selective library display in Settings.
 - User/profile switching and auto sign-in.
-- Library submenus for Recommended, Collections, Playlists, and Categories.
-- Alphabet side navigation for full-library browsing.
+- Library Categories where PlexAPI exposes them cleanly.
 - Movie editions as distinct, visible item variants.
-- Explicit video quality/direct/transcode preference in Settings and playback.
 - In-playback audio/subtitle switching after mpv has launched.
 
 ## Recommended Sequence
 
-1. Continue Watching entrypoint.
-   Add a top-level browse row backed by Plex in-progress/on-deck style data.
-   This is the highest-value 240-MP idea because it is small, terminal-friendly,
-   and matches how users resume media.
+1. Library Categories.
+   Add Categories to the library submenu after mapping PlexAPI support against
+   real server responses. Keep the default browse path simple so
+   Enter-on-library behavior stays fast.
 
-2. Selective library visibility.
-   Add a Settings multiselect-style workflow for hiding noisy Plex libraries.
-   This reduces browse clutter without changing playback behavior.
-
-3. Library submenu mode.
-   Add optional library entrypoints for Library, Collections, Playlists,
-   Categories, and Recommended where Plex exposes them. Keep the default path
-   simple so existing Enter-on-library behavior stays fast.
-
-4. Alphabet navigation for full-library views.
-   Add a keyboard-friendly jump mode for large libraries. This should come after
-   library submenu work so it is only active in full-library lists.
-
-5. Playback quality controls.
-   Add a setting for direct/default versus selected transcode qualities. This
-   needs careful testing because plex-tui currently relies on PlexAPI stream URL
-   behavior and direct track arguments.
-
-6. Profile switching and auto sign-in.
+2. Profile switching and auto sign-in.
    Useful, but more invasive than the browse entrypoints because it changes auth
    and account-token assumptions. Treat it as a separate design pass.
 
-7. In-playback track switching.
+3. Movie editions.
+   Surface editions as distinct item variants once enough real-library examples
+   are available to keep the UI compact.
+
+4. In-playback track switching.
    Defer until there is a clear design for driving mpv IPC track changes and
    reconciling Plex stream state after launch.
 

{plex_tui-0.3.37 → plex_tui-0.3.41}/packaging/aur/.SRCINFO

@@ -1,6 +1,6 @@
 pkgbase = plex-tui
 	pkgdesc = Standalone Plex terminal UI with mpv playback
-	pkgver = 0.3.35
+	pkgver = 0.3.39
 	pkgrel = 1
 	url = https://github.com/so1omon563/plex-tui
 	arch = any
@@ -16,7 +16,7 @@ pkgbase = plex-tui
 	depends = python-plexapi
 	depends = python-rich
 	depends = python-textual
-	source = plex-tui-0.3.35.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.3.35.tar.gz
-	sha256sums = 9ef3e6be46a7fe3176c9d69dc491a006054afe82c79618d9ee2117a088a067fc
+	source = plex-tui-0.3.39.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.3.39.tar.gz
+	sha256sums = 1e799c3f9635dc8e36b1da8ace89a1c3776fb9414a40e74c635f803864c48fad
 
 pkgname = plex-tui

{plex_tui-0.3.37 → plex_tui-0.3.41}/packaging/aur/PKGBUILD

@@ -1,6 +1,6 @@
 # Maintainer: so1omon
 pkgname=plex-tui
-pkgver=0.3.35
+pkgver=0.3.39
 pkgrel=1
 pkgdesc="Standalone Plex terminal UI with mpv playback"
 arch=("any")
@@ -22,7 +22,7 @@ makedepends=(
   "python-wheel"
 )
 source=("$pkgname-$pkgver.tar.gz::$url/archive/refs/tags/v$pkgver.tar.gz")
-sha256sums=("9ef3e6be46a7fe3176c9d69dc491a006054afe82c79618d9ee2117a088a067fc")
+sha256sums=("1e799c3f9635dc8e36b1da8ace89a1c3776fb9414a40e74c635f803864c48fad")
 
 build() {
   cd "$pkgname-$pkgver"

{plex_tui-0.3.37 → plex_tui-0.3.41}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "plex-tui"
-version = "0.3.37"
+version = "0.3.41"
 description = "A small standalone Plex terminal UI."
 readme = "README.md"
 license = "MIT"

{plex_tui-0.3.37 → plex_tui-0.3.41}/src/plextui/__init__.py

@@ -1,3 +1,3 @@
 """Plex TUI prototype."""
 
-__version__ = "0.3.37"
+__version__ = "0.3.41"

{plex_tui-0.3.37 → plex_tui-0.3.41}/src/plextui/app.py

@@ -56,6 +56,7 @@ from .player import (
     play_with_mpv,
     preferred_audio_choice,
     preferred_subtitle_choice,
+    resume_offset_ms,
     same_stream,
     stop_mpv,
     stream_language_key,
@@ -430,7 +431,7 @@ class PlexTuiApp(App[None]):
 
     BINDINGS = [
         Binding("q", "quit", "Quit"),
-        Binding("r", "reload", "Reload"),
+        Binding("ctrl+r", "reload", "Reload"),
         Binding("/", "focus_search", "Search"),
         Binding("g", "focus_global_search", "Global"),
         Binding("tab", "focus_next", "Next"),
@@ -447,6 +448,7 @@ class PlexTuiApp(App[None]):
         Binding("comma", "show_settings", "Settings"),
         Binding("escape", "back_or_clear", "Back"),
         Binding("p", "play_selected", "Play"),
+        Binding("r", "resume_selected", "Resume"),
         Binding("a", "audio_picker", "Audio"),
         Binding("s", "subtitle_picker", "Subtitles"),
         Binding("A", "clear_audio_preference", "Clear audio"),
@@ -2194,6 +2196,12 @@ class PlexTuiApp(App[None]):
                 self.open_library_menu(state.selected_library)
 
     def action_play_selected(self) -> None:
+        self.play_selected_media(resume=False)
+
+    def action_resume_selected(self) -> None:
+        self.play_selected_media(resume=True)
+
+    def play_selected_media(self, resume: bool) -> None:
         media = self.selected_media()
         if media is None:
             self.set_status("No media selected")
@@ -2201,6 +2209,9 @@ class PlexTuiApp(App[None]):
         if not media.playable:
             self.set_status("Selected item is not directly playable")
             return
+        if resume and not resume_offset_ms(media.raw):
+            self.set_status("No resume position for selected media; press p to play from the beginning")
+            return
         subtitle_choice = preferred_subtitle_choice(
             media.raw,
             self.config.preferred_subtitle_language,
@@ -2216,6 +2227,7 @@ class PlexTuiApp(App[None]):
                 window_size=self.config.mpv_window_size,
                 playback_mode=self.config.playback_mode,
                 transcode_quality=self.config.transcode_quality,
+                resume=resume,
             )
         except PlayerError as exc:
             self.clear_playback_footer()
@@ -2816,7 +2828,8 @@ def render_help() -> str:
         "g: search all libraries",
         "",
         "Playback",
-        "p: play selected media with mpv",
+        "p: play selected media from beginning",
+        "r: resume selected media",
         "x: stop launched mpv",
         "",
         "Streams",
@@ -2827,7 +2840,7 @@ def render_help() -> str:
         "",
         "Settings",
         ",: show settings",
-        "r: reconnect / reload libraries",
+        "ctrl+r: reconnect / reload libraries",
         "PLEX_TUI_PERF_LOG=1: write browsing timings and navigation diagnostics",
         "PLEX_TUI_ARTWORK_LOG=1: include verbose grid artwork internals",
         "?: show help",
@@ -2885,12 +2898,12 @@ def context_hint(row: object) -> str:
         return "Media: Enter loads next page"
     if isinstance(row, MediaRow):
         if row.media.playable:
-            return "Media: Enter selects / p plays / a audio / s subtitles"
+            return "Media: Enter selects / p plays from start / r resumes / a audio / s subtitles"
         return "Media: Enter opens item"
     if isinstance(row, MediaGrid):
         media = row.selected_media
         if media is not None and media.playable:
-            return "Grid: Arrows/page select card / p plays / a audio / s subtitles"
+            return "Grid: Arrows/page select card / p plays from start / r resumes / a audio / s subtitles"
         return "Grid: Arrows/page select card / Enter opens item"
     if isinstance(row, ServerRow):
         return "Servers: Enter selects server"

{plex_tui-0.3.37 → plex_tui-0.3.41}/src/plextui/player.py

@@ -60,11 +60,13 @@ def play_with_mpv(
     window_size: str = "",
     playback_mode: str = "auto",
     transcode_quality: str = "original",
+    resume: bool = True,
 ) -> PlayerHandle:
     if shutil.which("mpv") is None:
         log_debug("playback error: mpv was not found in PATH")
         raise PlayerError("mpv was not found in PATH. Install mpv and make sure it is available on PATH.")
 
+    selected_start_offset = resume_offset_ms(item)
     item = full_metadata(item)
     selected_subtitle = resolve_subtitle_choice(item, subtitle_choice)
     selected_audio = resolve_audio_choice(item, audio_choice)
@@ -80,6 +82,11 @@ def play_with_mpv(
     if force_transcode:
         stream_kwargs.update(transcode_quality_kwargs(transcode_quality))
 
+    title = getattr(item, "title", "Plex")
+    start_offset = (resume_offset_ms(item) or selected_start_offset) if resume else 0
+    if start_offset and direct_url is None:
+        stream_kwargs["offset"] = plex_stream_offset(start_offset)
+
     try:
         url = direct_url or item.getStreamURL(**stream_kwargs)
     except Exception as exc:
@@ -89,15 +96,15 @@ def play_with_mpv(
         log_debug("playback error: Plex returned an empty stream URL")
         raise PlayerError("Plex returned an empty stream URL")
 
-    title = getattr(item, "title", "Plex")
-    start_offset = resume_offset_ms(item)
+    stream_mode = "direct" if direct_url else "transcode"
+    monitor_base_offset = start_offset if stream_mode == "transcode" and stream_kwargs.get("offset") else 0
     socket_path = Path(tempfile.gettempdir()) / f"plex-tui-mpv-{os.getpid()}-{int(time.time() * 1000)}.sock"
     args = [
         "mpv",
         "--force-media-title=" + title,
         "--input-ipc-server=" + str(socket_path),
     ]
-    if start_offset:
+    if start_offset and not monitor_base_offset:
         args.append(f"--start={start_offset / 1000:.3f}")
     if window_size:
         args.append(f"--autofit={window_size}")
@@ -106,7 +113,6 @@ def play_with_mpv(
         args.append("--sub-file=" + subtitle)
     args.append(url)
     command = sanitize_command(args)
-    stream_mode = "direct" if direct_url else "transcode"
     quality_label = transcode_quality_label(transcode_quality) if stream_mode == "transcode" else "original"
     log_debug(
         "launching mpv: "
@@ -127,7 +133,7 @@ def play_with_mpv(
         log_debug(f"playback error: failed to launch mpv: {exc}; args={command!r}")
         raise PlayerError(f"failed to launch mpv: {exc}") from exc
     subtitle_count = active_subtitle_count(item, selected_subtitle)
-    monitor = ProgressMonitor(item, process, socket_path, start_offset)
+    monitor = ProgressMonitor(item, process, socket_path, start_offset, base_offset=monitor_base_offset)
     monitor.start()
     return PlayerHandle(
         title=title,
@@ -142,11 +148,19 @@ def play_with_mpv(
 
 
 class ProgressMonitor:
-    def __init__(self, item: Any, process: subprocess.Popen[bytes], socket_path: Path, start_offset: int) -> None:
+    def __init__(
+        self,
+        item: Any,
+        process: subprocess.Popen[bytes],
+        socket_path: Path,
+        start_offset: int,
+        base_offset: int = 0,
+    ) -> None:
         self.item = item
         self.process = process
         self.socket_path = socket_path
         self.last_ms = start_offset
+        self.base_offset = base_offset
         self._stop = threading.Event()
         self._thread = threading.Thread(target=self._run, name="plex-tui-progress", daemon=True)
 
@@ -186,7 +200,7 @@ class ProgressMonitor:
         if value is None:
             return None
         try:
-            return max(0, int(float(value) * 1000))
+            return max(0, self.base_offset + int(float(value) * 1000))
         except (TypeError, ValueError):
             return None
 
@@ -235,6 +249,10 @@ def resume_offset_ms(item: Any) -> int:
         return 0
 
 
+def plex_stream_offset(milliseconds: int) -> int:
+    return max(0, milliseconds // 1000)
+
+
 def full_metadata(item: Any) -> Any:
     if not hasattr(item, "reload"):
         return item

{plex_tui-0.3.37 → plex_tui-0.3.41}/tests/test_app_helpers.py

@@ -823,6 +823,9 @@ def test_render_help_groups_key_bindings():
     assert "d: focus details" in rendered
     assert "v: toggle list/grid view" in rendered
     assert "left/right: move across grid cards" in rendered
+    assert "p: play selected media from beginning" in rendered
+    assert "r: resume selected media" in rendered
+    assert "ctrl+r: reconnect / reload libraries" in rendered
     assert "PLEX_TUI_ARTWORK_LOG=1" in rendered
     assert "?: show help" in rendered
 
@@ -1024,9 +1027,9 @@ def test_context_hints_for_media_and_load_more():
     setting_action = next(row for row in settings if getattr(row, "action", "") == "cycle_grid_density")
     setting_value = next(row for row in settings if getattr(row, "label_text", "").strip().startswith("Server:"))
 
-    assert context_hint(MediaRow(playable)) == "Media: Enter selects / p plays / a audio / s subtitles"
+    assert context_hint(MediaRow(playable)) == "Media: Enter selects / p plays from start / r resumes / a audio / s subtitles"
     assert context_hint(MediaRow(container)) == "Media: Enter opens item"
-    assert context_hint(grid) == "Grid: Arrows/page select card / p plays / a audio / s subtitles"
+    assert context_hint(grid) == "Grid: Arrows/page select card / p plays from start / r resumes / a audio / s subtitles"
     assert context_hint(LoadMoreRow(100, 200)) == "Media: Enter loads next page"
     assert context_hint(LibraryMenuRow(LibraryItem("Movies", "1", "movie", object()), "library", "Library", "All items")) == (
         "Library: Enter opens browse mode"

{plex_tui-0.3.37 → plex_tui-0.3.41}/tests/test_app_navigation.py

@@ -405,6 +405,18 @@ def test_playback_footer_shows_active_playback():
     asyncio.run(run_playback_footer_check())
 
 
+def test_playback_action_starts_from_beginning():
+    asyncio.run(run_playback_starts_from_beginning_check())
+
+
+def test_resume_action_uses_saved_position():
+    asyncio.run(run_resume_action_check())
+
+
+def test_resume_action_requires_saved_position():
+    asyncio.run(run_resume_requires_position_check())
+
+
 def test_quick_preference_actions_update_config():
     asyncio.run(run_quick_preference_action_check())
 
@@ -1757,6 +1769,7 @@ async def run_playback_footer_check():
 
         assert launch.call_args.kwargs["playback_mode"] == "transcode"
         assert launch.call_args.kwargs["transcode_quality"] == "720p_4"
+        assert launch.call_args.kwargs["resume"] is False
         footer = app.query_one("#playback-footer")
         assert footer.display
         assert footer.content == (
@@ -1766,6 +1779,74 @@ async def run_playback_footer_check():
         )
 
 
+async def run_playback_starts_from_beginning_check():
+    class ResumableRaw(Raw):
+        viewOffset = 65_000
+
+    app = PlexTuiApp()
+    async with app.run_test() as pilot:
+        await pilot.pause(1.0)
+        app.config = AppConfig("http://plex", "token", "client-id")
+        app.show_media("Movies", [MediaItem("Movie", "", "movie", "1", True, ResumableRaw())])
+        await pilot.pause(0.2)
+
+        player = SimpleNamespace(
+            title="Movie",
+            start_offset_ms=0,
+            stream_mode="transcode",
+            subtitle_count=0,
+            process=SimpleNamespace(poll=lambda: None),
+        )
+        with patch("plextui.app.play_with_mpv", return_value=player) as launch:
+            app.action_play_selected()
+        await pilot.pause(0.2)
+
+        assert launch.call_args.kwargs["resume"] is False
+        assert "resume" not in app.query_one("#playback-footer").content
+
+
+async def run_resume_action_check():
+    class ResumableRaw(Raw):
+        viewOffset = 65_000
+
+    app = PlexTuiApp()
+    async with app.run_test() as pilot:
+        await pilot.pause(1.0)
+        app.config = AppConfig("http://plex", "token", "client-id")
+        app.show_media("Movies", [MediaItem("Movie", "", "movie", "1", True, ResumableRaw())])
+        await pilot.pause(0.2)
+
+        player = SimpleNamespace(
+            title="Movie",
+            start_offset_ms=65_000,
+            stream_mode="transcode",
+            subtitle_count=0,
+            process=SimpleNamespace(poll=lambda: None),
+        )
+        with patch("plextui.app.play_with_mpv", return_value=player) as launch:
+            app.action_resume_selected()
+        await pilot.pause(0.2)
+
+        assert launch.call_args.kwargs["resume"] is True
+        assert "resume 1:05" in app.query_one("#playback-footer").content
+
+
+async def run_resume_requires_position_check():
+    app = PlexTuiApp()
+    async with app.run_test() as pilot:
+        await pilot.pause(1.0)
+        app.config = AppConfig("http://plex", "token", "client-id")
+        app.show_media("Movies", [MediaItem("Movie", "", "movie", "1", True, Raw())])
+        await pilot.pause(0.2)
+
+        with patch("plextui.app.play_with_mpv") as launch:
+            app.action_resume_selected()
+        await pilot.pause(0.2)
+
+        assert not launch.called
+        assert app.query_one("#status").content == "No resume position for selected media; press p to play from the beginning"
+
+
 async def run_quick_preference_action_check():
     app = PlexTuiApp()
     async with app.run_test() as pilot:

{plex_tui-0.3.37 → plex_tui-0.3.41}/tests/test_player.py

@@ -9,6 +9,7 @@ from plextui.player import (
     PlayerError,
     ProgressMonitor,
     StreamChoice,
+    plex_stream_offset,
     play_with_mpv,
     preferred_audio_choice,
     preferred_subtitle_choice,
@@ -112,12 +113,54 @@ def test_playback_applies_selected_streams_and_resume_offset(debug_log_path):
     args = popen.call_args.args[0]
     assert handle.start_offset_ms == 65000
     assert handle.command[0] == "mpv"
-    assert "--start=65.000" in args
+    assert "--start=65.000" not in args
     assert "--sub-file=http://plex/library/streams/1" in args
-    assert item.kwargs == {"audioStreamID": 42}
+    assert item.kwargs == {"audioStreamID": 42, "offset": 65}
     assert "launching mpv" in debug_log_path.read_text(encoding="utf-8")
 
 
+def test_playback_can_start_from_beginning_instead_of_resuming():
+    item = Item()
+
+    with (
+        patch("plextui.player.shutil.which", return_value="/usr/bin/mpv"),
+        patch("plextui.player.ProgressMonitor.start"),
+        patch("plextui.player.subprocess.Popen", return_value=Proc()) as popen,
+    ):
+        handle = play_with_mpv(item, resume=False)
+
+    args = popen.call_args.args[0]
+    assert handle.start_offset_ms == 0
+    assert "--start=65.000" not in args
+    assert item.kwargs == {}
+
+
+def test_playback_keeps_selected_resume_offset_when_reload_omits_it():
+    class FullItem(Item):
+        viewOffset = 0
+
+    class BrowseItem(Item):
+        def __init__(self):
+            self.full_item = FullItem()
+
+        def reload(self):
+            return self.full_item
+
+    item = BrowseItem()
+
+    with (
+        patch("plextui.player.shutil.which", return_value="/usr/bin/mpv"),
+        patch("plextui.player.ProgressMonitor.start"),
+        patch("plextui.player.subprocess.Popen", return_value=Proc()) as popen,
+    ):
+        handle = play_with_mpv(item)
+
+    args = popen.call_args.args[0]
+    assert handle.start_offset_ms == 65000
+    assert "--start=65.000" not in args
+    assert item.full_item.kwargs == {"offset": 65}
+
+
 def test_playback_applies_configured_mpv_window_size():
     item = Item()
 
@@ -144,7 +187,7 @@ def test_subtitle_none_disables_subtitle_selection():
 
     args = popen.call_args.args[0]
     assert handle.subtitle_count == 0
-    assert item.kwargs == {"subtitleStreamID": 0}
+    assert item.kwargs == {"subtitleStreamID": 0, "offset": 65}
     assert not any(arg.startswith("--sub-file=") for arg in args)
 
 
@@ -159,6 +202,19 @@ def test_progress_monitor_reports_progress_and_timeline():
     assert item.timeline == (123000, "playing")
 
 
+def test_progress_monitor_adds_base_offset_to_transcode_time():
+    item = Item()
+    monitor = ProgressMonitor(item, Proc(), Path("/tmp/socket"), 65000, base_offset=65000)
+
+    with patch("plextui.player.mpv_get_property", return_value=12.5):
+        assert monitor.current_time_ms() == 77500
+
+
+def test_plex_stream_offset_converts_milliseconds_to_seconds():
+    assert plex_stream_offset(65_999) == 65
+    assert plex_stream_offset(-1) == 0
+
+
 def test_direct_play_gets_mpv_track_hints_for_embedded_streams():
     class EmbeddedSubtitle(SubtitleStream):
         key = None
@@ -190,6 +246,7 @@ def test_direct_play_gets_mpv_track_hints_for_embedded_streams():
 
     args = popen.call_args.args[0]
     assert handle.stream_mode == "direct"
+    assert "--start=65.000" in args
     assert "--aid=1" in args
     assert "--sid=1" in args
 
@@ -229,8 +286,10 @@ def test_force_transcode_bypasses_direct_play_and_applies_quality():
         "subtitleStreamID": 1,
         "maxVideoBitrate": 4000,
         "videoResolution": "1280x720",
+        "offset": 65,
     }
     assert not any(arg.startswith("--sid=") for arg in args)
+    assert "--start=65.000" not in args
 
 
 def test_force_transcode_original_quality_omits_quality_kwargs():
@@ -244,7 +303,7 @@ def test_force_transcode_original_quality_omits_quality_kwargs():
         handle = play_with_mpv(item, playback_mode="transcode", transcode_quality="original")
 
     assert handle.stream_mode == "transcode"
-    assert item.kwargs == {}
+    assert item.kwargs == {"offset": 65}
 
 
 def test_preferred_choices_match_stream_language():