plex-tui 0.4.4__tar.gz → 0.4.7__tar.gz

{plex_tui-0.4.4 → plex_tui-0.4.7}/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.4.7 - 2026-06-19
+
+- Added playlist management for creating playlists from selected media, adding
+  selected media to existing playlists, and removing items from playlist views.
+- Added intentional collection-card artwork for hub, playlist, category, and
+  other container grid cards, with geometric glyphs and roomier spacing for
+  all-container grids such as Recommended.
+
 ## 0.4.4 - 2026-06-18
 
 - Added a keyboard action to mark the selected playable Plex item watched or

{plex_tui-0.4.4 → plex_tui-0.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plex-tui
-Version: 0.4.4
+Version: 0.4.7
 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
@@ -44,23 +44,86 @@ Description-Content-Type: text/markdown
 [![Homebrew](https://shieldcn.dev/badge/Homebrew-tap-blue.png?logo=homebrew)](https://github.com/so1omon563/homebrew-plex-tui)
 [![License](https://shieldcn.dev/github/so1omon563/plex-tui/license.png)](LICENSE)
 
-A standalone Python/Textual terminal UI for browsing Plex and launching playback
-through `mpv`.
+A terminal Plex client built for watching media, not managing servers.
 
-plex-tui is an early release. It supports Plex login, server selection, paged
-library browsing, search, list/grid views, stream preferences, terminal poster
-artwork, and playback progress reporting.
+There are plenty of tools for administering Plex from the command line.
+Surprisingly few are built for sitting down, browsing your library, and watching
+something without leaving the terminal.
+
+plex-tui is a standalone Textual application that brings Plex browsing, poster
+artwork, collection cards, playlists, search, stream preferences, and `mpv`
+playback into a keyboard-first terminal interface.
+
+Built for people who spend their day in a terminal and would rather stay there.
+
+## Why?
+
+Most terminal Plex tools are built for administration, automation, or quick
+status checks. Those are useful jobs, but they are not the same as browsing a
+library, comparing options, and choosing something to watch.
+
+Meanwhile, terminal applications got better. Tools like lazygit, gitui, btop,
+and modern Textual apps raised the bar for what a TUI can be: rich layouts,
+keyboard-first workflows, responsive interfaces, and even artwork are no longer
+unusual.
+
+plex-tui exists because browsing Plex and choosing something to watch deserves
+that same kind of terminal-native experience.
+
+## Project Status
+
+plex-tui is still early, but already usable. Login, server selection, library
+browsing, search, playlists, artwork, stream preferences, and playback are
+working today. Expect rough edges, but expect progress too.
 
 ## Screenshots
 
-### Grid view
+### Movie grid
 
 ![plex-tui grid view](docs/assets/grid-view.png)
 
+### TV show grid
+
+![plex-tui TV show grid view](docs/assets/grid-tv-shows.png)
+
+### Collection cards
+
+![plex-tui Recommended collection cards](docs/assets/collection-recommended.png)
+
+![plex-tui Categories collection cards](docs/assets/collection-categories.png)
+
 ### List view
 
 ![plex-tui list view](docs/assets/list-view.png)
 
+## Features
+
+- Plex PIN login and server selection.
+- Paged library browsing with automatic loading near the end of loaded items.
+- Library submenu entrypoints for all items, Recommended, Collections,
+  Playlists, and Categories. Library rows open all items by default; Space
+  opens the browse-mode menu, and Settings can swap the primary and alternate
+  actions.
+- Current-library search and bounded global search.
+- List view plus configurable-density grid view with terminal poster artwork,
+  missing-artwork placeholders, and intentional glyph cards for collections and
+  hubs.
+- External subtitle support and direct playback for embedded PGS/VOBSUB tracks.
+- Audio and subtitle pickers with saved language preferences.
+- Separate play-from-start and resume actions with Plex progress reporting.
+- Watched/unwatched toggling for selected playable Plex items.
+- Continue Watching episode rows show their show, season, and episode context,
+  and items can be removed from the Continue Watching view.
+- Playlist management for creating playlists from selected media, adding media
+  to existing playlists, and removing items while browsing a playlist.
+- Movie editions appear as distinct variants when Plex reports multiple
+  editions for a selected movie.
+- Settings screen for stream preferences, playback mode and transcode quality,
+  artwork modes, grid density, page size, auto-load threshold, grid artwork
+  prefetching, media view, library Enter behavior, and `mpv` window size.
+- App diagnostics view for version, paths, `mpv`, Plex connection, artwork, and
+  browsing settings.
+
 ## Requirements
 
 - Python 3.11 or newer
@@ -95,9 +158,9 @@ plex-tui
 ```
 
 This is the recommended cross-platform install path. It keeps Python
-dependencies isolated, but you still need to install `mpv` separately.
-If `pipx` is not installed, install it with your platform package manager first
-or follow the pipx installation guide.
+dependencies isolated, but you still need to install `mpv` separately. If
+`pipx` is not installed, install it with your platform package manager first or
+follow the pipx installation guide.
 
 ### Homebrew
 
@@ -108,14 +171,11 @@ brew install plex-tui
 plex-tui --smoke
 ```
 
-The Homebrew formula installs `mpv` automatically. Apple Silicon macOS installs
-use prebuilt bottles when available so Homebrew can pour the app virtualenv
-instead of rebuilding native Python dependencies such as `pillow` from source.
-Intel macOS installs still use Homebrew's source-build path while that platform
-continues to be supported.
-Homebrew 6 requires non-official taps to be trusted before Homebrew loads
-formulae from them. `plex-tui` only depends on formulae from Homebrew/core, so no
-additional tap trust is required for its dependencies.
+The Homebrew formula installs `mpv` automatically. Apple Silicon macOS uses
+prebuilt bottles when available, while Intel macOS still uses Homebrew's
+source-build path. Homebrew 6 requires non-official taps to be trusted before
+loading formulae from them; `plex-tui` only depends on formulae from
+Homebrew/core, so no additional tap trust is required for dependencies.
 
 ### Arch Linux
 
@@ -131,7 +191,7 @@ example.
 
 ```bash
 pipx install "git+https://github.com/so1omon563/plex-tui.git"
-pipx install "git+https://github.com/so1omon563/plex-tui.git@v0.2.1"
+pipx install "git+https://github.com/so1omon563/plex-tui.git@v0.4.4"
 ```
 
 Use this path for testing `main` before a tagged/PyPI release.
@@ -237,35 +297,12 @@ matching track.
 | `p` | Play selected item from the beginning |
 | `r` | Resume selected item from the saved Plex position |
 | `w` | Mark selected item watched / unwatched |
-| `backspace` / `delete` | Remove selected item from Continue Watching |
+| `P` | Add selected playable item to a playlist |
+| `backspace` / `delete` | Remove selected item from Continue Watching or a playlist |
 | `a` / `s` | Choose audio / subtitle preference |
 | `A` / `S` | Clear audio preference / cycle subtitle mode |
 | `x` | Stop launched `mpv` |
 
-## Features
-
-- Plex PIN login and server selection.
-- Paged library browsing with automatic loading near the end of loaded items.
-- Library submenu entrypoints for all items, Recommended, Collections,
-  Playlists, and Categories. Library rows open all items by default; Space
-  opens the browse-mode menu, and Settings can swap the primary and alternate
-  actions.
-- Current-library search and bounded global search.
-- 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.
-- Separate play-from-start and resume actions with Plex progress reporting.
-- Watched/unwatched toggling for selected playable Plex items.
-- Continue Watching episode rows show their show, season, and episode context,
-  and items can be removed from the Continue Watching view.
-- Movie editions appear as distinct variants when Plex reports multiple
-  editions for a selected movie.
-- Settings screen for stream preferences, playback mode and transcode quality,
-  artwork modes, grid density, page size, auto-load threshold, grid artwork
-  prefetching, media view, library Enter behavior, and `mpv` window size.
-- App diagnostics view for version, paths, `mpv`, Plex connection, artwork, and
-  browsing settings.
-
 ## Artwork
 
 Poster artwork renders as portable colored block art by default, so it works in
@@ -277,6 +314,12 @@ charge of layout and redraws while the terminal paints the poster inside those
 cells. Outside detected Kitty-compatible terminals, `auto` falls back to block
 art; `plex-tui --diagnostics` reports the active renderer status.
 
+Cards that represent collections, playlists, categories, hubs, or query shelves
+use geometric glyph artwork instead of pretending to be missing posters. Rows
+made entirely of those cards use roomier navigation-grid spacing. See
+`docs/collection-artwork-design.md` for the design notes behind that visual
+language.
+
 Grid view prefetches artwork for the visible page immediately and, by default,
 prepares three pages ahead in the background. `grid_prefetch_pages` can be set
 from `0` to `5`; use `0` to fetch only the visible page on slower systems.

{plex_tui-0.4.4 → plex_tui-0.4.7}/README.md

@@ -7,23 +7,86 @@
 [![Homebrew](https://shieldcn.dev/badge/Homebrew-tap-blue.png?logo=homebrew)](https://github.com/so1omon563/homebrew-plex-tui)
 [![License](https://shieldcn.dev/github/so1omon563/plex-tui/license.png)](LICENSE)
 
-A standalone Python/Textual terminal UI for browsing Plex and launching playback
-through `mpv`.
+A terminal Plex client built for watching media, not managing servers.
 
-plex-tui is an early release. It supports Plex login, server selection, paged
-library browsing, search, list/grid views, stream preferences, terminal poster
-artwork, and playback progress reporting.
+There are plenty of tools for administering Plex from the command line.
+Surprisingly few are built for sitting down, browsing your library, and watching
+something without leaving the terminal.
+
+plex-tui is a standalone Textual application that brings Plex browsing, poster
+artwork, collection cards, playlists, search, stream preferences, and `mpv`
+playback into a keyboard-first terminal interface.
+
+Built for people who spend their day in a terminal and would rather stay there.
+
+## Why?
+
+Most terminal Plex tools are built for administration, automation, or quick
+status checks. Those are useful jobs, but they are not the same as browsing a
+library, comparing options, and choosing something to watch.
+
+Meanwhile, terminal applications got better. Tools like lazygit, gitui, btop,
+and modern Textual apps raised the bar for what a TUI can be: rich layouts,
+keyboard-first workflows, responsive interfaces, and even artwork are no longer
+unusual.
+
+plex-tui exists because browsing Plex and choosing something to watch deserves
+that same kind of terminal-native experience.
+
+## Project Status
+
+plex-tui is still early, but already usable. Login, server selection, library
+browsing, search, playlists, artwork, stream preferences, and playback are
+working today. Expect rough edges, but expect progress too.
 
 ## Screenshots
 
-### Grid view
+### Movie grid
 
 ![plex-tui grid view](docs/assets/grid-view.png)
 
+### TV show grid
+
+![plex-tui TV show grid view](docs/assets/grid-tv-shows.png)
+
+### Collection cards
+
+![plex-tui Recommended collection cards](docs/assets/collection-recommended.png)
+
+![plex-tui Categories collection cards](docs/assets/collection-categories.png)
+
 ### List view
 
 ![plex-tui list view](docs/assets/list-view.png)
 
+## Features
+
+- Plex PIN login and server selection.
+- Paged library browsing with automatic loading near the end of loaded items.
+- Library submenu entrypoints for all items, Recommended, Collections,
+  Playlists, and Categories. Library rows open all items by default; Space
+  opens the browse-mode menu, and Settings can swap the primary and alternate
+  actions.
+- Current-library search and bounded global search.
+- List view plus configurable-density grid view with terminal poster artwork,
+  missing-artwork placeholders, and intentional glyph cards for collections and
+  hubs.
+- External subtitle support and direct playback for embedded PGS/VOBSUB tracks.
+- Audio and subtitle pickers with saved language preferences.
+- Separate play-from-start and resume actions with Plex progress reporting.
+- Watched/unwatched toggling for selected playable Plex items.
+- Continue Watching episode rows show their show, season, and episode context,
+  and items can be removed from the Continue Watching view.
+- Playlist management for creating playlists from selected media, adding media
+  to existing playlists, and removing items while browsing a playlist.
+- Movie editions appear as distinct variants when Plex reports multiple
+  editions for a selected movie.
+- Settings screen for stream preferences, playback mode and transcode quality,
+  artwork modes, grid density, page size, auto-load threshold, grid artwork
+  prefetching, media view, library Enter behavior, and `mpv` window size.
+- App diagnostics view for version, paths, `mpv`, Plex connection, artwork, and
+  browsing settings.
+
 ## Requirements
 
 - Python 3.11 or newer
@@ -58,9 +121,9 @@ plex-tui
 ```
 
 This is the recommended cross-platform install path. It keeps Python
-dependencies isolated, but you still need to install `mpv` separately.
-If `pipx` is not installed, install it with your platform package manager first
-or follow the pipx installation guide.
+dependencies isolated, but you still need to install `mpv` separately. If
+`pipx` is not installed, install it with your platform package manager first or
+follow the pipx installation guide.
 
 ### Homebrew
 
@@ -71,14 +134,11 @@ brew install plex-tui
 plex-tui --smoke
 ```
 
-The Homebrew formula installs `mpv` automatically. Apple Silicon macOS installs
-use prebuilt bottles when available so Homebrew can pour the app virtualenv
-instead of rebuilding native Python dependencies such as `pillow` from source.
-Intel macOS installs still use Homebrew's source-build path while that platform
-continues to be supported.
-Homebrew 6 requires non-official taps to be trusted before Homebrew loads
-formulae from them. `plex-tui` only depends on formulae from Homebrew/core, so no
-additional tap trust is required for its dependencies.
+The Homebrew formula installs `mpv` automatically. Apple Silicon macOS uses
+prebuilt bottles when available, while Intel macOS still uses Homebrew's
+source-build path. Homebrew 6 requires non-official taps to be trusted before
+loading formulae from them; `plex-tui` only depends on formulae from
+Homebrew/core, so no additional tap trust is required for dependencies.
 
 ### Arch Linux
 
@@ -94,7 +154,7 @@ example.
 
 ```bash
 pipx install "git+https://github.com/so1omon563/plex-tui.git"
-pipx install "git+https://github.com/so1omon563/plex-tui.git@v0.2.1"
+pipx install "git+https://github.com/so1omon563/plex-tui.git@v0.4.4"
 ```
 
 Use this path for testing `main` before a tagged/PyPI release.
@@ -200,35 +260,12 @@ matching track.
 | `p` | Play selected item from the beginning |
 | `r` | Resume selected item from the saved Plex position |
 | `w` | Mark selected item watched / unwatched |
-| `backspace` / `delete` | Remove selected item from Continue Watching |
+| `P` | Add selected playable item to a playlist |
+| `backspace` / `delete` | Remove selected item from Continue Watching or a playlist |
 | `a` / `s` | Choose audio / subtitle preference |
 | `A` / `S` | Clear audio preference / cycle subtitle mode |
 | `x` | Stop launched `mpv` |
 
-## Features
-
-- Plex PIN login and server selection.
-- Paged library browsing with automatic loading near the end of loaded items.
-- Library submenu entrypoints for all items, Recommended, Collections,
-  Playlists, and Categories. Library rows open all items by default; Space
-  opens the browse-mode menu, and Settings can swap the primary and alternate
-  actions.
-- Current-library search and bounded global search.
-- 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.
-- Separate play-from-start and resume actions with Plex progress reporting.
-- Watched/unwatched toggling for selected playable Plex items.
-- Continue Watching episode rows show their show, season, and episode context,
-  and items can be removed from the Continue Watching view.
-- Movie editions appear as distinct variants when Plex reports multiple
-  editions for a selected movie.
-- Settings screen for stream preferences, playback mode and transcode quality,
-  artwork modes, grid density, page size, auto-load threshold, grid artwork
-  prefetching, media view, library Enter behavior, and `mpv` window size.
-- App diagnostics view for version, paths, `mpv`, Plex connection, artwork, and
-  browsing settings.
-
 ## Artwork
 
 Poster artwork renders as portable colored block art by default, so it works in
@@ -240,6 +277,12 @@ charge of layout and redraws while the terminal paints the poster inside those
 cells. Outside detected Kitty-compatible terminals, `auto` falls back to block
 art; `plex-tui --diagnostics` reports the active renderer status.
 
+Cards that represent collections, playlists, categories, hubs, or query shelves
+use geometric glyph artwork instead of pretending to be missing posters. Rows
+made entirely of those cards use roomier navigation-grid spacing. See
+`docs/collection-artwork-design.md` for the design notes behind that visual
+language.
+
 Grid view prefetches artwork for the visible page immediately and, by default,
 prepares three pages ahead in the background. `grid_prefetch_pages` can be set
 from `0` to `5`; use `0` to fetch only the visible page on slower systems.

{plex_tui-0.4.4 → plex_tui-0.4.7}/ROADMAP.md

@@ -2,8 +2,9 @@
 
 ## App UX
 
-- Continue refining grid view presentation after the initial card/detail
-  balance pass, especially against real terminal themes and wide/narrow panes.
+- Continue refining grid view presentation after the collection-card artwork
+  pass, especially against real terminal themes, wide/narrow panes, and
+  screenshot refreshes.
 - Continue tuning focus, row markers, and selection affordances based on real
   terminal themes. Status hints should keep a compact context prefix such as
   `Media:`, `Grid:`, or `Settings:` so the active pane is clear at a glance.
@@ -68,8 +69,10 @@
 - In-playback audio/subtitle switching uses mpv IPC when the active stream
   exposes matching tracks; Plex-transcoded streams may still require relaunching
   with the saved preference.
-- Design playlist management before implementation: adding/removing media from
-  playlists and creating playlists are intentionally out of PR #80 scope.
+- Playlist management can create playlists from selected media, add selected
+  media to existing playlists, and remove items while browsing a playlist.
+  Continue design passes for bulk playlist actions and richer playlist editing
+  if real-library use shows those workflows are needed.
 - Later design passes: profile switching with auto sign-in.
 
 ## Technical Follow-Up

plex_tui-0.4.7/docs/collection-artwork-design.md

@@ -0,0 +1,73 @@
+# Collection Artwork Design
+
+`plex-tui` uses real Plex artwork whenever Plex provides media posters,
+episode stills, season art, or collection art. The collection artwork system is
+for a different state: browse cards that represent organization instead of
+media.
+
+## Visual Language
+
+Collection cards should feel like wayfinding and information architecture, not
+fake posters. The first version uses terminal-native geometric glyphs on muted
+blueprint-style panels:
+
+- poster or still: actual media artwork;
+- missing poster: quiet missing-artwork block;
+- collection card: intentional glyph for a hub, playlist, category, or query.
+
+The glyph is the dominant artwork element. A faint construction layer of corner
+marks, guide dots, and center lines sits behind the glyph so the card feels like
+part of a deliberate wayfinding system instead of an empty color field. Title,
+type, and action remain in the normal grid-card text below the artwork so the
+visual stays calm at compact terminal sizes.
+
+## Glyph System
+
+Glyphs are selected from stable media metadata first, then title hints when Plex
+only reports a generic hub object.
+
+- Continue Watching: play/progress mark.
+- Recently Added: plus/cross mark.
+- Recently Released: burst mark.
+- Recommended: connected-node constellation.
+- Trending and Top shelves: upward path.
+- Unwatched shelves: hollow circles.
+- Actor shelves: simplified person.
+- Genre and category cards: one shared family with title-derived motif
+  variations, such as angled marks for action, circles for comedy, diamonds for
+  horror, and grid marks for documentary.
+- Playlist cards: layered panel.
+- Collection cards: repeated diamond mark.
+- Generic hubs: abstract geometric mark.
+
+The system is intentionally small and text-based so it remains legible in
+compact grids, plain terminals, Kitty/Ghostty image modes, and low-resolution
+remote sessions. New glyphs should use the same line weight, centered geometry,
+and blueprint layer so they read as symbols from one fictional design system,
+not unrelated icons.
+
+## Grid Behavior
+
+Rows made entirely of collection cards use a navigation-grid treatment instead
+of poster-grid treatment. They are left aligned and separated by a blank row so
+views like Recommended read as deliberate browse choices instead of a compact
+cluster of failed posters.
+
+Mixed rows or playable-media rows continue to use the centered poster-grid
+presentation.
+
+## Screenshots
+
+Current examples live in the README screenshot set:
+
+- `docs/assets/collection-recommended.png`
+- `docs/assets/collection-categories.png`
+- `docs/assets/grid-view.png`
+- `docs/assets/grid-tv-shows.png`
+- `docs/assets/list-view.png`
+
+## Expansion Notes
+
+Future iterations can reuse these glyphs in sidebar navigation, filters,
+badges, and search result indicators. New glyphs should stay geometric,
+low-detail, and readable at compact density before they are added.

{plex_tui-0.4.4 → plex_tui-0.4.7}/docs/plex-integration-research.md

@@ -56,10 +56,11 @@ Already covered:
 - 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.
+- Playlist management for creating playlists from selected media, adding media
+  to existing playlists, and removing items from playlist views.
 
 Not yet covered:
 
-- User/profile switching and auto sign-in.
 - Fuller profile switching and auto sign-in.
 
 ## Recommended Sequence

{plex_tui-0.4.4 → plex_tui-0.4.7}/packaging/aur/.SRCINFO

@@ -1,6 +1,6 @@
 pkgbase = plex-tui
 	pkgdesc = Standalone Plex terminal UI with mpv playback
-	pkgver = 0.4.3
+	pkgver = 0.4.4
 	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.4.3.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.4.3.tar.gz
-	sha256sums = 3e29f88b3a0822905c0a1940916a78d91d9e7c658231de2a6ebabe85d3897688
+	source = plex-tui-0.4.4.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.4.4.tar.gz
+	sha256sums = 77cddf1fa9117ae4f9030767968783e88f49300d9fc8bb01fbb5ded80993db7b
 
 pkgname = plex-tui

{plex_tui-0.4.4 → plex_tui-0.4.7}/packaging/aur/PKGBUILD

@@ -1,6 +1,6 @@
 # Maintainer: so1omon
 pkgname=plex-tui
-pkgver=0.4.3
+pkgver=0.4.4
 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=("3e29f88b3a0822905c0a1940916a78d91d9e7c658231de2a6ebabe85d3897688")
+sha256sums=("77cddf1fa9117ae4f9030767968783e88f49300d9fc8bb01fbb5ded80993db7b")
 
 build() {
   cd "$pkgname-$pkgver"

{plex_tui-0.4.4 → plex_tui-0.4.7}/pyproject.toml

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

{plex_tui-0.4.4 → plex_tui-0.4.7}/src/plextui/__init__.py

@@ -1,3 +1,3 @@
 """Plex TUI prototype."""
 
-__version__ = "0.4.4"
+__version__ = "0.4.7"