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

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

@@ -0,0 +1,52 @@
+name: AUR Package
+
+on:
+  push:
+    branches: ["main"]
+    paths:
+      - ".github/workflows/aur.yml"
+      - "packaging/aur/**"
+  pull_request:
+    branches: ["main"]
+    paths:
+      - ".github/workflows/aur.yml"
+      - "packaging/aur/**"
+  workflow_dispatch:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  makepkg:
+    runs-on: ubuntu-latest
+    container: archlinux:base-devel
+
+    steps:
+      - name: Install runner dependencies
+        run: |
+          pacman -Syu --noconfirm git namcap sudo
+
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Create build user
+        run: |
+          useradd --create-home --shell /bin/bash builder
+          echo "builder ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/builder
+          chown -R builder:builder "$GITHUB_WORKSPACE"
+
+      - name: Build and check package
+        working-directory: packaging/aur
+        run: |
+          sudo -u builder makepkg --clean --syncdeps --noconfirm --check
+
+      - name: Generate .SRCINFO
+        working-directory: packaging/aur
+        run: |
+          sudo -u builder makepkg --printsrcinfo > .SRCINFO.generated
+          diff -u .SRCINFO .SRCINFO.generated
+
+      - name: Run namcap
+        working-directory: packaging/aur
+        run: |
+          namcap PKGBUILD ./*.pkg.tar.*

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.3.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  check:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.13"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package and test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Run checks
+        run: make PYTHON=python check

plex_tui-0.3.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: "Git ref to publish, such as v0.2.0"
+        required: true
+        type: string
+  release:
+    types: ["published"]
+
+permissions:
+  contents: read
+  id-token: write
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.ref }}
+
+      - 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.3.0/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,41 @@
+name: Publish to TestPyPI
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: testpypi
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - 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 to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

{plex_tui-0.2.0 → plex_tui-0.3.0}/.gitignore

@@ -1,4 +1,5 @@
 .venv/
+.venv*/
 __pycache__/
 *.py[cod]
 .pytest_cache/

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

@@ -11,6 +11,9 @@ through `mpv`.
   - `player.py`: `mpv` launch, stream selection, and playback diagnostics.
   - `config.py`, `auth.py`, `artwork.py`, `models.py`: supporting modules.
 - `tests/`: pytest suite, split by app helpers/navigation and service modules.
+- `.github/workflows/`: CI plus PyPI/TestPyPI/AUR validation workflows.
+- `packaging/`: Homebrew and AUR maintenance notes; `packaging/aur/` contains
+  the source copy of `PKGBUILD` and `.SRCINFO`.
 - `README.md`, `PACKAGING.md`, `RELEASE.md`, `ROADMAP.md`: user and release docs.
 - `config.example.toml`: example user configuration.
 
@@ -59,6 +62,8 @@ make smoke
 ```
 
 For packaging or metadata changes, also run `make check-package` or `make check`.
+For AUR package changes, run the `AUR Package` workflow or validate with
+`makepkg` on Arch.
 
 ## Commit & Pull Request Guidelines
 
@@ -73,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.3.0/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+## 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.
+- Added a manual TestPyPI Trusted Publishing workflow.
+- Published `plex-tui` to PyPI and updated install documentation.
+- Published the Homebrew tap and updated install documentation.
+- Added Arch package validation workflow scaffolding.
+- Published the Arch AUR package and updated install documentation.
+- Added Arch AUR packaging files and Homebrew packaging notes.
+- Refreshed documentation for current install, packaging, and release workflows.
+- Added a Settings diagnostics action for recent `debug.log` output and playback error details with log context.
+- Clarified Settings rows with action-type tags and per-row detail-pane guidance.
+- Improved grid browsing smoothness by debouncing detail reloads, throttling artwork prefetch, and avoiding cached-artwork rendering during selection redraws.
+- Made grid detail reloads idle-aware so rapid selection movement no longer starts stale Plex reload workers.
+- Made grid artwork appear progressively as each card renders and added stronger focused-pane styling.
+- Added an explicit `[FOCUS]` marker to the active pane title.
+- Kept focus markers in sync when using Tab navigation and refocused the visible browser after list/grid view changes.
+- Made Tab navigation cycle explicitly through Libraries, Media, and Details panes.
+- Added a short idle debounce for list detail reloads to reduce detail-pane churn during fast row movement.
+- Increased the list detail debounce to further reduce repeated artwork loads during row navigation.
+- Split detail text refresh from detail artwork loading so artwork waits for a longer stable selection window.
+
+## 0.2.0 - 2026-06-11
+
+- Improved README structure and expanded the post-0.1.0 roadmap.
+- Grouped the Settings screen into account, stream, playback, artwork, browsing, and diagnostics sections.
+- Added direct Settings input for custom `mpv` window sizes.
+- Added direct Settings input for custom page size and auto-load threshold values.
+- Added confirmation for destructive Settings preference clears.
+- Replaced the heavy selected grid-card border with a quieter marker/footer treatment.
+- Added configurable compact, comfortable, and large grid density modes.
+- Kept Settings open after value changes and added clearer changed-value feedback.
+- Preserved Settings row highlighting after opening Settings and changing values.
+- Added README screenshots for grid and list views.
+- Clarified README install instructions for `main` versus tagged releases.
+- Improved active playback status, details-pane playback context, and abnormal `mpv` exit diagnostics.
+
+## 0.1.0 - 2026-06-11
+
+- Added Plex PIN login and server selection.
+- Added library browsing with paged loading and automatic loading near the end of the list.
+- Added current-library search with paged results and bounded global search.
+- Added playback through `mpv` with Plex resume and progress reporting.
+- Added audio and subtitle pickers with saved language preferences.
+- Added support for external subtitles and embedded PGS/VOBSUB subtitle playback.
+- Added media details for metadata, audio tracks, subtitle tracks, and saved stream preferences.
+- Added settings actions for reload, relogin, and audio/subtitle preference management.
+- Added settings actions for page size, auto-load threshold, mpv window sizing, and debug log visibility.
+- Added playback diagnostics with token-redacted `debug.log` output.
+- Added development workflow targets, smoke checks, and Linux/macOS setup documentation.
+- Added release checklist and packaging option documentation.
+- Added CLI flags for version, config/debug paths, and smoke checks.
+- Added configurable page size and auto-load threshold for browsing performance.
+- Added grid page navigation, richer grid status text, and adjacent-page artwork prefetching.

{plex_tui-0.2.0 → 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.3.0/PACKAGING.md

@@ -0,0 +1,102 @@
+# Packaging
+
+plex-tui is distributed through PyPI, a Homebrew tap, and the Arch AUR. The
+source repository remains the canonical place for versioning, release notes,
+and validation.
+
+## Supported Channels
+
+### PyPI
+
+Recommended cross-platform install:
+
+```bash
+pipx install plex-tui
+```
+
+PyPI publishing uses GitHub Actions Trusted Publishing:
+
+- Workflow: `.github/workflows/publish-pypi.yml`
+- PyPI environment: `pypi`
+- Trigger: GitHub Release publication, or manual workflow dispatch with a ref
+
+TestPyPI uses a separate manual workflow:
+
+- Workflow: `.github/workflows/publish-testpypi.yml`
+- TestPyPI environment: `testpypi`
+
+Install tests from TestPyPI need PyPI as a dependency fallback:
+
+```bash
+python -m pip install \
+  --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/ \
+  plex-tui
+```
+
+### Homebrew
+
+Tap repository:
+
+```text
+https://github.com/so1omon563/homebrew-plex-tui
+```
+
+User install:
+
+```bash
+brew tap so1omon563/plex-tui
+brew install plex-tui
+```
+
+The formula depends on `mpv` and `python@3.13`, then installs the Python app in
+a Homebrew-managed virtualenv. The first install can take several minutes
+because native Python resources such as `pillow` are built from source.
+
+Validation commands:
+
+```bash
+brew test so1omon563/plex-tui/plex-tui
+brew audit --strict --online so1omon563/plex-tui/plex-tui
+```
+
+### Arch AUR
+
+AUR package:
+
+```text
+https://aur.archlinux.org/packages/plex-tui
+```
+
+User install:
+
+```bash
+paru -S plex-tui
+```
+
+The source copy for AUR metadata lives in `packaging/aur/`. The package uses
+Arch system dependencies, including `mpv`, `python-textual`, `python-pillow`,
+`python-plexapi`, `python-platformdirs`, and `python-rich`.
+
+Validation is handled by `.github/workflows/aur.yml`, which runs inside
+`archlinux:base-devel` and checks:
+
+- `makepkg --clean --syncdeps --noconfirm --check`
+- `.SRCINFO` is in sync with `PKGBUILD`
+- `namcap PKGBUILD ./*.pkg.tar.*`
+
+## Release Maintenance
+
+For each new app release:
+
+1. Publish and validate PyPI.
+2. Update the Homebrew tap formula URL/hash and Python resources.
+3. Update `packaging/aur/PKGBUILD` and `packaging/aur/.SRCINFO`.
+4. Run packaging validation workflows.
+5. Push the AUR package repo update after the workflow passes.
+
+## Known Follow-Up
+
+- Automate Homebrew tap updates after PyPI publishing.
+- Investigate faster Homebrew installs without compromising formula quality.
+- Consider standalone artifacts only after the app behavior stabilizes.