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

{plex_tui-0.4.4 → plex_tui-0.4.9}/.github/workflows/post-release-homebrew.yml

@@ -34,12 +34,34 @@ jobs:
       - name: Check packaging PR token
         env:
           PACKAGING_PR_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+          GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
         run: |
+          set -euo pipefail
+
           if [ -z "$PACKAGING_PR_TOKEN" ]; then
             echo "PACKAGING_PR_TOKEN secret is required to publish the Homebrew tap" >&2
             exit 1
           fi
 
+          pr_query="$(cat <<'GRAPHQL'
+          query($owner: String!, $name: String!) {
+            repository(owner: $owner, name: $name) {
+              nameWithOwner
+              pullRequests(first: 1) {
+                totalCount
+              }
+            }
+          }
+          GRAPHQL
+          )"
+
+          gh api repos/so1omon563/homebrew-plex-tui --jq '.full_name' >/dev/null
+          gh api graphql \
+            -f owner=so1omon563 \
+            -f name=homebrew-plex-tui \
+            -f query="$pr_query" >/dev/null
+          gh pr list --repo so1omon563/homebrew-plex-tui --limit 1 >/dev/null
+
       - name: Determine release tag
         id: release
         env:
@@ -269,11 +291,23 @@ jobs:
           fi
 
           branch="automation/plex-tui-v${VERSION}"
-          git switch -c "$branch"
+          formula_update="$(mktemp)"
+          cp Formula/plex-tui.rb "$formula_update"
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add Formula/plex-tui.rb
-          git commit -m "Update plex-tui to ${VERSION}"
+
+          if git ls-remote --exit-code --heads origin "$branch" >/dev/null 2>&1; then
+            git fetch origin "$branch"
+            git switch -C "$branch" "origin/$branch"
+            cp "$formula_update" Formula/plex-tui.rb
+          else
+            git switch -c "$branch"
+          fi
+
+          if ! git diff --quiet -- Formula/plex-tui.rb; then
+            git add Formula/plex-tui.rb
+            git commit -m "Update plex-tui to ${VERSION}"
+          fi
           git push origin "$branch"
 
           echo "changed=true" >> "$GITHUB_OUTPUT"
@@ -292,12 +326,20 @@ jobs:
 
           pr_body="$(printf 'Automated Homebrew tap update for plex-tui %s.\n\nIncludes the generated bottle metadata for %s.\n' "$VERSION" "$BOTTLE_RELEASE")"
 
-          pr_url="$(gh pr create \
+          pr_url="$(gh pr list \
             --repo so1omon563/homebrew-plex-tui \
-            --base main \
             --head "$BRANCH" \
-            --title "Update plex-tui to ${VERSION}" \
-            --body "$pr_body")"
+            --json url \
+            --jq '.[0].url // ""')"
+
+          if [ -z "$pr_url" ]; then
+            pr_url="$(gh pr create \
+              --repo so1omon563/homebrew-plex-tui \
+              --base main \
+              --head "$BRANCH" \
+              --title "Update plex-tui to ${VERSION}" \
+              --body "$pr_body")"
+          fi
 
           gh pr merge "$pr_url" \
             --repo so1omon563/homebrew-plex-tui \

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

@@ -2,6 +2,21 @@
 
 ## Unreleased
 
+## 0.4.9 - 2026-06-19
+
+- Improved playlist-management discoverability in the details pane, Help view,
+  and README usage docs.
+- Fixed a crash when selecting playlist container cards whose PlexAPI objects
+  do not expose media stream parts.
+
+## 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.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plex-tui
-Version: 0.4.4
+Version: 0.4.9
 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.
@@ -199,22 +259,52 @@ See `config.example.toml` for optional settings.
 ## Playback
 
 Playback is launched through `mpv`; plex-tui does not embed a video player.
-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. The default `mpv` launch uses `--autofit=80%` so videos open at a
-comfortable size on modern displays; Settings can override this with values
-such as `90%`, `1280x720`, or `80%x80%`. If an older config has an exact
-`mpv_window_size = "1280x720"` override, cycle the mpv window-size setting once
-to return to the Default preset.
-Use `w` from a playable movie or episode to toggle its Plex watched state.
-When playback is active, choosing an audio or subtitle track from the picker
-also asks mpv to switch the active track when the launched stream exposes a
-matching track.
+
+Common playback actions:
+
+| Key | Action |
+| --- | --- |
+| `p` | Play the selected item from the beginning |
+| `r` | Resume from the saved Plex position when available |
+| `x` | Stop the launched `mpv` process |
+| `w` | Toggle watched / unwatched for the selected playable Plex item |
+
+Playback behavior:
+
+- Plex progress is updated in the background while playback is active.
+- Saved audio/subtitle language preferences are applied when matching streams
+  are available.
+- The details pane shows the effective playback choices for the selected item.
+- Choosing an audio or subtitle track while playback is active also asks `mpv`
+  to switch the active track when the launched stream exposes a matching track.
+
+Playback mode and window sizing:
+
+- Playback mode defaults to Plex direct/default behavior.
+- Settings can force Plex transcoding with Original, 1080p 8 Mbps, 720p
+  4 Mbps, or 480p 2 Mbps quality presets.
+- The default `mpv` launch uses `--autofit=80%` so videos open at a comfortable
+  size on modern displays.
+- Settings can override the window size with values such as `90%`,
+  `1280x720`, or `80%x80%`.
+- If an older config has an exact `mpv_window_size = "1280x720"` override,
+  cycle the mpv window-size setting once to return to the Default preset.
+
+## Playlist Management
+
+Playlist actions are available from selected playable media and from inside
+playlist views.
+
+| Key | Where | Action |
+| --- | --- | --- |
+| `P` | Playable media item | Open the Add to Playlist picker |
+| `enter` | Add to Playlist picker | Add the selected media to an existing playlist |
+| `enter` | `New playlist...` row | Prompt for a name and create a playlist containing the selected media |
+| `backspace` / `delete` | Playlist contents | Remove the selected item from that playlist |
+
+The Add to Playlist picker lists `New playlist...` first, followed by existing
+Plex playlists. Playlist browsing itself is available from a library's browse
+modes: select a library, press `space`, then open `Playlists`.
 
 ## Key Bindings
 
@@ -237,52 +327,45 @@ 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
-ordinary terminals without native image support. In Kitty and Ghostty, set
-`artwork_renderer` to `auto` to render native terminal images through Kitty
-Unicode placeholders. Set `artwork_renderer` to `kitty` to explicitly try the
-Kitty graphics protocol in other compatible terminals. This keeps Textual in
-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.
-
-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.
-Compact, comfortable, and large density modes adjust card and poster sizing. The
-artwork cache is bounded and stored in the app cache directory shown in
-Settings.
+plex-tui has two artwork paths: poster rendering for real media and glyph cards
+for Plex objects that are not posters.
+
+Poster rendering:
+
+- Default mode renders portable colored block art, so it works in ordinary
+  terminals without native image support.
+- In Kitty and Ghostty, set `artwork_renderer` to `auto` to render native
+  terminal images through Kitty Unicode placeholders.
+- Set `artwork_renderer` to `kitty` to explicitly try the Kitty graphics
+  protocol in other compatible terminals.
+- Outside detected Kitty-compatible terminals, `auto` falls back to block art.
+- `plex-tui --diagnostics` reports the active renderer status.
+
+Collection-style cards:
+
+- Collections, playlists, categories, hubs, and 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 behavior and cache:
+
+- Grid view fetches artwork for the visible page immediately.
+- By default, it 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.
+- Compact, comfortable, and large density modes adjust card and poster sizing.
+- The artwork cache is bounded and stored in the app cache directory shown in
+  Settings.
 
 ## Diagnostics