plexbar 0.1.2__tar.gz → 0.1.4__tar.gz

{plexbar-0.1.2 → plexbar-0.1.4}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.3
 Name: plexbar
-Version: 0.1.2
+Version: 0.1.4
 Summary: A command-line TUI music player for Plex
 Author: Christopher Patti
 Author-email: Christopher Patti <feoh@feoh.org>
 Requires-Dist: platformdirs>=4.10.0
 Requires-Dist: plexapi>=4.18.1
 Requires-Dist: textual>=8.2.7
+Requires-Dist: textual-image>=0.13.2
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 
@@ -16,12 +17,15 @@ Plexbar is a keyboard-driven terminal music player for Plex. It gives you a
 simple Textual TUI for browsing and playing your Plex music library without
 opening a web browser.
 
+![PlexBar screenshot](PlexBar.png)
+
 ## Features
 
 - First-run Plex connection setup
 - Browse by Artists, Albums, Tracks, and Playlists
 - Search your Plex music library
 - Queue tracks, albums, artists, and playlists
+- Show cover art for the currently playing track or album
 - Play, pause/resume, stop, and skip with keyboard shortcuts
 - Local playback through `mpv`
 
@@ -33,6 +37,20 @@ opening a web browser.
 - A Plex server with at least one music library
 - A Plex token
 
+## Installation
+
+Install Plexbar as a standalone command with `uv`:
+
+```bash
+uv tool install plexbar
+```
+
+Run Plexbar:
+
+```bash
+plexbar
+```
+
 ## Installation for development
 
 Clone the repository and sync dependencies with `uv`:

{plexbar-0.1.2 → plexbar-0.1.4}/README.md

@@ -4,12 +4,15 @@ Plexbar is a keyboard-driven terminal music player for Plex. It gives you a
 simple Textual TUI for browsing and playing your Plex music library without
 opening a web browser.
 
+![PlexBar screenshot](PlexBar.png)
+
 ## Features
 
 - First-run Plex connection setup
 - Browse by Artists, Albums, Tracks, and Playlists
 - Search your Plex music library
 - Queue tracks, albums, artists, and playlists
+- Show cover art for the currently playing track or album
 - Play, pause/resume, stop, and skip with keyboard shortcuts
 - Local playback through `mpv`
 
@@ -21,6 +24,20 @@ opening a web browser.
 - A Plex server with at least one music library
 - A Plex token
 
+## Installation
+
+Install Plexbar as a standalone command with `uv`:
+
+```bash
+uv tool install plexbar
+```
+
+Run Plexbar:
+
+```bash
+plexbar
+```
+
 ## Installation for development
 
 Clone the repository and sync dependencies with `uv`:

{plexbar-0.1.2 → plexbar-0.1.4}/pyproject.toml

@@ -1,11 +1,16 @@
 [project]
 name = "plexbar"
-version = "0.1.2"
+version = "0.1.4"
 description = "A command-line TUI music player for Plex"
 readme = "README.md"
 authors = [{ name = "Christopher Patti", email = "feoh@feoh.org" }]
 requires-python = ">=3.12"
-dependencies = ["platformdirs>=4.10.0", "plexapi>=4.18.1", "textual>=8.2.7"]
+dependencies = [
+    "platformdirs>=4.10.0",
+    "plexapi>=4.18.1",
+    "textual>=8.2.7",
+    "textual-image>=0.13.2",
+]
 
 [project.scripts]
 plexbar = "plexbar.app:main"
@@ -15,9 +20,4 @@ requires = ["uv_build>=0.9.18,<0.10.0"]
 build-backend = "uv_build"
 
 [dependency-groups]
-dev = [
-    "mypy>=2.1.0",
-    "pre-commit>=4.6.0",
-    "pytest>=9.0.3",
-    "ruff>=0.15.16",
-]
+dev = ["mypy>=2.1.0", "pre-commit>=4.6.0", "pytest>=9.0.3", "ruff>=0.15.16"]

{plexbar-0.1.2 → plexbar-0.1.4}/src/plexbar/app.py

@@ -1,6 +1,8 @@
 """Textual application for Plexbar."""
 
 from collections.abc import Callable
+from io import BytesIO
+from urllib.request import urlopen
 
 from textual import on, work
 from textual.app import App, ComposeResult
@@ -17,6 +19,7 @@ from textual.widgets import (
     ListView,
     Static,
 )
+from textual_image.widget import AutoImage
 
 from plexbar.models import BrowserItem, ItemKind, QueueTrack
 from plexbar.playback import MpvNotFoundError, MpvPlayer, PlaybackQueue
@@ -164,6 +167,12 @@ class PlexbarApp(App[None]):
         border-top: solid $primary;
     }
 
+    #cover-art {
+        width: 100%;
+        height: 18;
+        margin: 0 1 1 1;
+    }
+
     .panel-title {
         text-style: bold;
         padding: 0 1;
@@ -187,6 +196,7 @@ class PlexbarApp(App[None]):
         self.client: PlexMusicClient | None = None
         self.player: MpvPlayer | None = None
         self.queue = PlaybackQueue()
+        self.current_track: QueueTrack | None = None
         self.history: list[list[BrowserItem]] = []
         self.items: list[BrowserItem] = []
 
@@ -199,6 +209,7 @@ class PlexbarApp(App[None]):
                 yield ListView(id="browser-list")
             with Vertical(id="side"):
                 yield Label("Now Playing", classes="panel-title")
+                yield AutoImage(id="cover-art")
                 yield Static("Nothing playing", id="now-playing")
                 yield Label("Queue", classes="panel-title")
                 yield Static("Queue is empty", id="queue")
@@ -207,6 +218,8 @@ class PlexbarApp(App[None]):
 
     def on_mount(self) -> None:
         self.query_one("#search", Input).display = False
+        self.query_one("#cover-art", AutoImage).display = False
+        self.set_interval(0.5, self.advance_finished_track)
         if config_exists():
             try:
                 self.start_with_config(load_config())
@@ -344,9 +357,22 @@ class PlexbarApp(App[None]):
             self.player.pause_resume()
 
     def action_next_track(self) -> None:
+        self.play_next_track("End of queue.")
+
+    def advance_finished_track(self) -> None:
+        """Continue playback when mpv exits at the end of a track."""
+
+        if self.player is None or not self.player.reap_finished():
+            return
+        self.play_next_track("End of queue.")
+
+    def play_next_track(self, end_status: str) -> None:
+        """Advance the queue and play the next track, if any."""
+
         track = self.queue.next()
         if track is None:
-            self.set_status("End of queue.")
+            self.clear_now_playing()
+            self.set_status(end_status)
             self.refresh_queue()
             return
         self.play(track)
@@ -355,6 +381,7 @@ class PlexbarApp(App[None]):
     def action_stop(self) -> None:
         if self.player is not None:
             self.player.stop()
+        self.clear_now_playing()
         self.set_status("Stopped.")
 
     def append_item(self, item: BrowserItem) -> None:
@@ -372,10 +399,46 @@ class PlexbarApp(App[None]):
         if self.player is None:
             self.set_status("mpv is not available.")
             return
+        self.current_track = track
         self.player.play(track)
         self.query_one("#now-playing", Static).update(track.label)
+        self.show_cover_art(track)
         self.set_status(f"Playing {track.label}")
 
+    def show_cover_art(self, track: QueueTrack) -> None:
+        """Load and display the current track's Plex artwork."""
+
+        cover_art = self.query_one("#cover-art", AutoImage)
+        cover_art.image = None
+        cover_art.display = False
+        if track.artwork_url:
+            self._load_cover_art(track.artwork_url)
+
+    @work(thread=True)
+    def _load_cover_art(self, artwork_url: str) -> None:
+        try:
+            with urlopen(artwork_url, timeout=10) as response:
+                image_bytes = response.read()
+        except Exception:  # noqa: BLE001 - missing artwork should not stop playback
+            return
+        self.call_from_thread(self._set_cover_art, artwork_url, image_bytes)
+
+    def _set_cover_art(self, artwork_url: str, image_bytes: bytes) -> None:
+        if self.current_track is None or self.current_track.artwork_url != artwork_url:
+            return
+        cover_art = self.query_one("#cover-art", AutoImage)
+        cover_art.image = BytesIO(image_bytes)
+        cover_art.display = True
+
+    def clear_now_playing(self) -> None:
+        """Clear the now-playing label and cover art."""
+
+        self.current_track = None
+        self.query_one("#now-playing", Static).update("Nothing playing")
+        cover_art = self.query_one("#cover-art", AutoImage)
+        cover_art.image = None
+        cover_art.display = False
+
     def focused_item(self) -> BrowserItem | None:
         browser = self.query_one("#browser-list", ListView)
         row = browser.highlighted_child

{plexbar-0.1.2 → plexbar-0.1.4}/src/plexbar/models.py

@@ -48,6 +48,7 @@ class QueueTrack:
     artist: str
     album: str
     stream_url: str
+    artwork_url: str = ""
 
     @property
     def label(self) -> str:

{plexbar-0.1.2 → plexbar-0.1.4}/src/plexbar/playback.py

@@ -29,9 +29,10 @@ class PlaybackQueue:
     def append(self, tracks: list[QueueTrack]) -> None:
         """Append tracks to the queue."""
 
+        first_new_index = len(self.tracks)
         self.tracks.extend(tracks)
-        if self.current_index == -1 and self.tracks:
-            self.current_index = 0
+        if self.current_index == -1 and tracks:
+            self.current_index = first_new_index
 
     def replace(self, tracks: list[QueueTrack]) -> QueueTrack | None:
         """Replace the queue and return the first track."""
@@ -100,6 +101,15 @@ class MpvPlayer:
         self._process.stdin.flush()
         self._paused = not self._paused
 
+    def reap_finished(self) -> bool:
+        """Clear and report a naturally finished mpv process."""
+
+        if self._process is None or self._process.poll() is None:
+            return False
+        self._process = None
+        self._paused = False
+        return True
+
     def stop(self) -> None:
         """Stop mpv if it is running."""
 

{plexbar-0.1.2 → plexbar-0.1.4}/src/plexbar/plex_client.py

@@ -136,6 +136,7 @@ class PlexMusicClient:
             artist=_safe_title(track, "grandparentTitle"),
             album=_safe_title(track, "parentTitle"),
             stream_url=track.getStreamURL(),
+            artwork_url=_artwork_url(track),
         )
 
     def _default_music_library(self, preferred_name: str | None) -> MusicSection:
@@ -184,6 +185,17 @@ def _safe_title(item: Any, attr: str) -> str:
     return str(getattr(item, attr, "") or "")
 
 
+def _artwork_url(track: Track) -> str:
+    for attr in ("squareArtUrl", "thumbUrl", "artUrl"):
+        try:
+            url = getattr(track, attr, None)
+        except Exception:  # noqa: BLE001 - artwork is optional metadata
+            continue
+        if url:
+            return str(url)
+    return ""
+
+
 def _is_track(item: Any) -> bool:
     return isinstance(item, Track) or getattr(item, "TYPE", None) == "track"