plex-tui 0.2.1__tar.gz → 0.3.0__tar.gz

{plex_tui-0.2.1 → plex_tui-0.3.0}/.github/workflows/aur.yml

@@ -13,6 +13,9 @@ on:
       - "packaging/aur/**"
   workflow_dispatch:
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   makepkg:
     runs-on: ubuntu-latest
@@ -24,7 +27,7 @@ jobs:
           pacman -Syu --noconfirm git namcap sudo
 
       - name: Check out repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Create build user
         run: |

plex_tui-0.3.0/.github/workflows/bump.yml

@@ -0,0 +1,108 @@
+name: Version Bump and Release
+
+on:
+  pull_request:
+    types: ["closed"]
+    branches: ["main"]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  bump-version:
+    if: |
+      github.event.pull_request.merged == true &&
+      (
+        contains(github.event.pull_request.title, '#patch') ||
+        contains(github.event.pull_request.title, '#minor') ||
+        contains(github.event.pull_request.title, '#major') ||
+        contains(github.event.pull_request.body, '#patch') ||
+        contains(github.event.pull_request.body, '#minor') ||
+        contains(github.event.pull_request.body, '#major')
+      )
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      new_tag: ${{ steps.bump.outputs.new_version }}
+      previous_tag: ${{ steps.bump.outputs.previous_version }}
+      skipped: ${{ steps.bump.outputs.skipped }}
+      release_requested: ${{ steps.bump.outputs.should_release }}
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Bump version tag
+        id: bump
+        uses: so1omon563/custom-semver-bumper@v1
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          branch_name: ${{ github.event.pull_request.head.ref }}
+          # Floating pointer tags are owned by release-creator so they only move
+          # when a GitHub Release is intentionally published.
+
+  create-release:
+    name: Create GitHub Release
+    needs: bump-version
+    if: |
+      needs.bump-version.outputs.release_requested == 'true' &&
+      needs.bump-version.outputs.skipped != 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Create release
+        uses: so1omon563/release-creator@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          tag: ${{ needs.bump-version.outputs.new_tag }}
+          from-tag: ${{ needs.bump-version.outputs.previous_tag }}
+          tag-prefix: v
+          notes-format: grouped
+          move-major-tag: "true"
+          move-minor-tag: "true"
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs:
+      - bump-version
+      - create-release
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Check out release tag
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ needs.bump-version.outputs.new_tag }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package metadata
+        run: python -m twine check dist/*
+
+      - name: Publish package
+        uses: pypa/gh-action-pypi-publish@release/v1

{plex_tui-0.2.1 → plex_tui-0.3.0}/.github/workflows/ci.yml

@@ -6,6 +6,9 @@ on:
   pull_request:
     branches: ["main"]
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   check:
     name: Python ${{ matrix.python-version }}
@@ -17,10 +20,10 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 

{plex_tui-0.2.1 → plex_tui-0.3.0}/.github/workflows/publish-pypi.yml

@@ -14,6 +14,9 @@ permissions:
   contents: read
   id-token: write
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   publish:
     runs-on: ubuntu-latest
@@ -21,12 +24,12 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           ref: ${{ github.event.release.tag_name || inputs.ref }}
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.13"
 

{plex_tui-0.2.1 → plex_tui-0.3.0}/.github/workflows/publish-testpypi.yml

@@ -7,6 +7,9 @@ permissions:
   contents: read
   id-token: write
 
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
   publish:
     runs-on: ubuntu-latest
@@ -14,10 +17,10 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.13"
 

{plex_tui-0.2.1 → plex_tui-0.3.0}/AGENTS.md

@@ -78,6 +78,22 @@ Pull requests should include:
 - Screenshots or terminal notes for TUI changes when useful.
 - Any config, packaging, or migration impact.
 
+Use PRs for repository changes. When publishing local commits, branch from
+`main` with a scoped name such as `codex/release-prep`, push that branch, and
+open a draft PR instead of pushing directly to `main`. Treat `main` as a
+protected branch even before GitHub branch protection or rulesets are enabled.
+
+GitHub CLI notes:
+
+- `gh auth status` may fail inside the sandbox even when the user is logged in
+  via the macOS keyring. Re-run `gh` auth, PR, and push operations outside the
+  sandbox when keyring access is required.
+- Prefer the GitHub connector for PR creation when it has access. If it returns
+  `403 Resource not accessible by integration`, fall back to
+  `gh pr create --draft` using the authenticated CLI session.
+- Keep PR bodies explicit about validation, especially `make check` results and
+  release workflow checks such as `actionlint`.
+
 ## Security & Configuration Tips
 
 Never commit real Plex tokens, account tokens, debug logs, or local config files.

{plex_tui-0.2.1 → plex_tui-0.3.0}/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.3.0 - 2026-06-12
+
+- Added `plex-tui --diagnostics` for collecting environment and playback setup details.
+- Added PR-merge version tagging, GitHub Release creation, and PyPI publishing workflow automation.
+- Added a local release workflow and version metadata verification target.
+- Added targeted playback troubleshooting hints for common `mpv` and Plex stream failures.
+- Added a compact active-playback footer while media is playing.
+- Simplified Settings rows into inline controls for numeric values, toggles, and option cycling.
+- Tuned grid density geometry and stabilized unloaded poster placeholders.
+- Added explicit Kitty renderer fallback diagnostics while native images remain disabled inside Textual.
+
 ## 0.2.1 - 2026-06-11
 
 - Added GitHub Actions CI and PyPI Trusted Publishing workflow scaffolding.

{plex_tui-0.2.1 → plex_tui-0.3.0}/Makefile

@@ -1,4 +1,4 @@
-.PHONY: install-dev run test compile smoke build check-package check clean
+.PHONY: install-dev run test compile smoke build check-package check-release check clean
 
 PYTHON ?= .venv/bin/python
 
@@ -23,7 +23,10 @@ build:
 check-package: build
 	$(PYTHON) -m twine check dist/*
 
-check: smoke test compile check-package
+check-release:
+	$(PYTHON) scripts/check_release.py
+
+check: smoke test compile check-release check-package
 
 clean:
 	rm -rf build dist *.egg-info src/*.egg-info

{plex_tui-0.2.1 → plex_tui-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plex-tui
-Version: 0.2.1
+Version: 0.3.0
 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
@@ -128,6 +128,7 @@ Useful CLI checks:
 plex-tui --version
 plex-tui --config-path
 plex-tui --debug-log-path
+plex-tui --diagnostics
 plex-tui --smoke
 ```
 
@@ -222,13 +223,17 @@ available, and the details pane shows the effective playback choices.
 - Settings screen for stream preferences, artwork modes, grid density, page
   size, auto-load threshold, grid artwork prefetching, media view, 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, so it works in ordinary
-terminals without Kitty, iTerm2, or Sixel support. Native terminal image output
-is disabled for now because Kitty protocol rendering conflicts with Textual's
-screen renderer in practice.
+terminals without Kitty, iTerm2, or Sixel support. Native Kitty image output is
+disabled inside the Textual app because direct Kitty graphics protocol placement
+can destabilize the UI. If `artwork_renderer` is set to `auto` or `kitty`, the
+app falls back to block art and summarizes the fallback in
+`plex-tui --diagnostics`.
 
 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
@@ -241,6 +246,8 @@ Settings.
 
 Playback diagnostics are written to `debug.log` in the app config directory.
 Tokens are redacted from logged `mpv` arguments.
+The Settings diagnostics section can show the debug log path, recent log lines,
+and an app diagnostics summary for support reports.
 
 Useful paths:
 
@@ -255,6 +262,12 @@ Enable browsing performance timings before launch:
 PLEX_TUI_PERF_LOG=1 plex-tui
 ```
 
+To collect environment information for issue reports:
+
+```bash
+plex-tui --diagnostics
+```
+
 Verbose grid artwork internals are quieter by default. Include them only when
 debugging poster loading:
 

{plex_tui-0.2.1 → plex_tui-0.3.0}/README.md

@@ -92,6 +92,7 @@ Useful CLI checks:
 plex-tui --version
 plex-tui --config-path
 plex-tui --debug-log-path
+plex-tui --diagnostics
 plex-tui --smoke
 ```
 
@@ -186,13 +187,17 @@ available, and the details pane shows the effective playback choices.
 - Settings screen for stream preferences, artwork modes, grid density, page
   size, auto-load threshold, grid artwork prefetching, media view, 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, so it works in ordinary
-terminals without Kitty, iTerm2, or Sixel support. Native terminal image output
-is disabled for now because Kitty protocol rendering conflicts with Textual's
-screen renderer in practice.
+terminals without Kitty, iTerm2, or Sixel support. Native Kitty image output is
+disabled inside the Textual app because direct Kitty graphics protocol placement
+can destabilize the UI. If `artwork_renderer` is set to `auto` or `kitty`, the
+app falls back to block art and summarizes the fallback in
+`plex-tui --diagnostics`.
 
 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
@@ -205,6 +210,8 @@ Settings.
 
 Playback diagnostics are written to `debug.log` in the app config directory.
 Tokens are redacted from logged `mpv` arguments.
+The Settings diagnostics section can show the debug log path, recent log lines,
+and an app diagnostics summary for support reports.
 
 Useful paths:
 
@@ -219,6 +226,12 @@ Enable browsing performance timings before launch:
 PLEX_TUI_PERF_LOG=1 plex-tui
 ```
 
+To collect environment information for issue reports:
+
+```bash
+plex-tui --diagnostics
+```
+
 Verbose grid artwork internals are quieter by default. Include them only when
 debugging poster loading:
 

{plex_tui-0.2.1 → plex_tui-0.3.0}/RELEASE.md

@@ -1,6 +1,9 @@
 # Release Checklist
 
-Use this checklist for tagged app releases from `so1omon563/plex-tui`.
+Use this checklist for planned app releases from `so1omon563/plex-tui`.
+Normal releases now move through a pull request into `main`; the merge runs
+`.github/workflows/bump.yml`, creates the version tag, optionally creates the
+GitHub Release, and publishes to PyPI in the same workflow run.
 
 ## 1. Local Validation
 
@@ -13,15 +16,28 @@ make check
 
 `make check` runs smoke, tests, compile, and package metadata validation.
 
-## 2. Version Prep
+## 2. Release PR Prep
 
-Before tagging:
+Prepare a release PR:
 
 - Update `version` in `pyproject.toml`.
 - Update `src/plextui/__init__.py`.
-- Move `CHANGELOG.md` entries from `Unreleased` to the release date.
+- Move `CHANGELOG.md` entries from `Unreleased` to the release version and date.
 - Confirm `README.md`, `PACKAGING.md`, and `config.example.toml` match current behavior.
 - Confirm the Git remote points to `https://github.com/so1omon563/plex-tui`.
+- Make sure the PR title or body includes the right bump marker:
+  `#patch`, `#minor`, or `#major`.
+- Add `#release`, `#publish`, or `#ship` when the merge should create the
+  GitHub Release and publish to PyPI.
+
+The semver bumper creates tags from merge metadata, but it does not edit project
+files. Keep the version files and changelog in the PR aligned with the tag the
+merge will create.
+
+Do not update Homebrew or AUR checksums in the release PR. Those checksums depend
+on the tag or published artifact that does not exist until after merge. Handle
+packaging repository updates in a follow-up PR that does not include `#patch`,
+`#minor`, or `#major`, so it cannot create another version tag.
 
 ## 3. Build Artifacts
 
@@ -57,18 +73,20 @@ python -m venv /tmp/plex-tui-testpypi
 /tmp/plex-tui-testpypi/bin/plex-tui --smoke
 ```
 
-## 5. Tag And Publish PyPI
+## 5. Merge And Publish
 
-Create and push an annotated tag:
+Merge the release PR after CI passes. The `Version Bump and Release` workflow:
 
-```bash
-git tag -a vX.Y.Z -m "Release X.Y.Z"
-git push --follow-tags
-```
+1. Runs `so1omon563/custom-semver-bumper@v1` on the merged PR and creates the
+   next `vX.Y.Z` tag when the merged PR title or body includes `#patch`,
+   `#minor`, or `#major`.
+2. Runs `so1omon563/release-creator@v1` when the merge message includes
+   `#release`, `#publish`, or `#ship`.
+3. Publishes the tagged package to PyPI through Trusted Publishing after the
+   GitHub Release is created.
 
-Create a GitHub Release for the tag. Publishing the GitHub Release triggers
-`.github/workflows/publish-pypi.yml` through PyPI Trusted Publishing. If needed,
-the same workflow can be run manually with `ref=vX.Y.Z`.
+The older `Publish to PyPI` workflow remains available as a manual fallback with
+`ref=vX.Y.Z`, and still supports manually created GitHub Releases.
 
 After PyPI publishes, validate the real package:
 
@@ -95,6 +113,8 @@ brew test so1omon563/plex-tui/plex-tui
 brew audit --strict --online so1omon563/plex-tui/plex-tui
 ```
 
+Open this as a packaging-only PR without a semver bump marker.
+
 ## 7. Arch AUR
 
 Update `packaging/aur/PKGBUILD` and regenerate `.SRCINFO`:
@@ -116,7 +136,13 @@ git commit -m "Update to X.Y.Z-1"
 git push
 ```
 
-## Manual PyPI Fallback
+Open this as a packaging-only PR without a semver bump marker.
+
+## Manual Fallbacks
+
+If a tag exists but the release step needs to be retried, create the GitHub
+Release manually or with `so1omon563/release-creator@v1`, then run
+`Publish to PyPI` manually with `ref=vX.Y.Z`.
 
 Prefer Trusted Publishing. If it is not available and a PyPI token is
 configured, upload validated artifacts manually:

plex_tui-0.3.0/ROADMAP.md

@@ -0,0 +1,39 @@
+# Roadmap
+
+## App UX
+
+- Verify real library browsing after the prefetch/rendering and idle-detail
+  passes, especially any remaining list/grid latency on large remote libraries.
+- Tune grid artwork defaults such as `grid_prefetch_pages` only if verification
+  shows the current defaults are too aggressive or too conservative.
+- Continue tuning focus and selection affordances based on real terminal themes.
+- Continue refining Settings ergonomics as new preferences are added.
+- Consider separate poster-size controls only if density presets are not enough
+  after real-library verification.
+- Continue improving playback diagnostics as real-world `mpv` and Plex stream
+  failures show up in use.
+
+## Packaging & Distribution
+
+- Keep planned releases moving through PRs so merged release PRs drive automatic
+  tagging, GitHub Release creation, and PyPI publishing.
+- Add a GitHub ruleset or branch protection for `main` that requires branch
+  work, pull requests, and passing checks before merge.
+- Improve Homebrew install time; the current formula works but builds native
+  Python resources such as `pillow` from source.
+- Automate Homebrew tap and AUR metadata updates after PyPI releases by opening
+  packaging-only pull requests with the new artifact URLs and checksums. These
+  PRs must omit semver bump markers so they do not create another release tag.
+- Consider standalone artifacts only after the app behavior stabilizes.
+
+## Technical Follow-Up
+
+- Use `PLEX_TUI_PERF_LOG=1` for focused regression checks when changing grid,
+  artwork, pagination, or detail-loading behavior.
+- Revisit whether verbose `PLEX_TUI_ARTWORK_LOG=1` should expose more structured artwork counters.
+- Revisit native terminal image support with a Kitty Unicode-placeholder
+  prototype. Direct Kitty graphics protocol placement inside Textual caused UI
+  hangs, so any future implementation should transmit images quietly, render
+  normal placeholder text that Textual can redraw safely, and keep block art as
+  the mandatory fallback.
+- Add focused regression tests for any real-world Plex media edge cases discovered during use.

{plex_tui-0.2.1 → plex_tui-0.3.0}/config.example.toml

@@ -31,7 +31,7 @@ client_identifier = "plex-tui-your-stable-client-id"
 # artwork_mode can be "on" or "off".
 # artwork_mode = "on"
 # artwork_renderer can be "block", "auto", or "kitty". Auto/kitty currently
-# fall back to block art while native terminal image support is disabled.
+# fall back to block art because direct Kitty image placement is unsafe in Textual.
 # artwork_renderer = "block"
 # detail_artwork_mode can be "list_only", "on", or "off".
 # detail_artwork_mode = "list_only"

{plex_tui-0.2.1 → plex_tui-0.3.0}/packaging/aur/.SRCINFO

@@ -1,6 +1,6 @@
 pkgbase = plex-tui
 	pkgdesc = Standalone Plex terminal UI with mpv playback
-	pkgver = 0.2.0
+	pkgver = 0.2.1
 	pkgrel = 1
 	url = https://github.com/so1omon563/plex-tui
 	arch = any
@@ -17,7 +17,7 @@ pkgbase = plex-tui
 	depends = python-plexapi
 	depends = python-rich
 	depends = python-textual
-	source = plex-tui-0.2.0.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.2.0.tar.gz
-	sha256sums = f97a723c025d8678ca23d717e16d8cf753685e8d6bf6dd2b3e99fe1bef0e2941
+	source = plex-tui-0.2.1.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.2.1.tar.gz
+	sha256sums = f1b84354e5a0f7885fb7391d81f6d15ddece55822c8a5d5d08d01b4fadffbbeb
 
 pkgname = plex-tui

{plex_tui-0.2.1 → plex_tui-0.3.0}/packaging/aur/PKGBUILD

@@ -1,6 +1,6 @@
 # Maintainer: so1omon
 pkgname=plex-tui
-pkgver=0.2.0
+pkgver=0.2.1
 pkgrel=1
 pkgdesc="Standalone Plex terminal UI with mpv playback"
 arch=("any")
@@ -23,7 +23,7 @@ makedepends=(
 )
 checkdepends=("python-pytest")
 source=("$pkgname-$pkgver.tar.gz::$url/archive/refs/tags/v$pkgver.tar.gz")
-sha256sums=("f97a723c025d8678ca23d717e16d8cf753685e8d6bf6dd2b3e99fe1bef0e2941")
+sha256sums=("f1b84354e5a0f7885fb7391d81f6d15ddece55822c8a5d5d08d01b4fadffbbeb")
 
 build() {
   cd "$pkgname-$pkgver"

{plex_tui-0.2.1 → plex_tui-0.3.0}/pyproject.toml

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