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

{plex_tui-0.2.1 → plex_tui-0.3.6}/.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: |
@@ -40,7 +43,7 @@ jobs:
       - name: Generate .SRCINFO
         working-directory: packaging/aur
         run: |
-          sudo -u builder makepkg --printsrcinfo > .SRCINFO.generated
+          sudo -u builder makepkg --printsrcinfo | sudo -u builder tee .SRCINFO.generated > /dev/null
           diff -u .SRCINFO .SRCINFO.generated
 
       - name: Run namcap

plex_tui-0.3.6/.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.6}/.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.3.6/.github/workflows/post-release-aur.yml

@@ -0,0 +1,141 @@
+name: Post-release AUR Update
+
+on:
+  workflow_run:
+    workflows: ["Version Bump and Release"]
+    types: ["completed"]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to package, such as v0.3.0. Defaults to the latest GitHub Release."
+        required: false
+        type: string
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  aur-pr:
+    if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Check packaging PR token
+        env:
+          PACKAGING_PR_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+        run: |
+          if [ -z "$PACKAGING_PR_TOKEN" ]; then
+            echo "PACKAGING_PR_TOKEN secret is required to create, approve, and auto-merge packaging PRs" >&2
+            exit 1
+          fi
+
+      - name: Determine release tag
+        id: release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REQUESTED_TAG: ${{ github.event.inputs.tag }}
+        run: |
+          set -euo pipefail
+
+          if [ -n "$REQUESTED_TAG" ]; then
+            tag="$REQUESTED_TAG"
+          else
+            tag="$(gh release list --limit 1 --json tagName --jq '.[0].tagName')"
+          fi
+
+          if ! [[ "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Release tag must look like vX.Y.Z: $tag" >&2
+            exit 1
+          fi
+
+          version="${tag#v}"
+          echo "tag=$tag" >> "$GITHUB_OUTPUT"
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
+      - name: Download source archive and checksum
+        id: archive
+        env:
+          TAG: ${{ steps.release.outputs.tag }}
+        run: |
+          set -euo pipefail
+
+          url="https://github.com/${GITHUB_REPOSITORY}/archive/refs/tags/${TAG}.tar.gz"
+          curl --fail --location --retry 5 --retry-delay 2 --output source.tar.gz "$url"
+          sha256="$(sha256sum source.tar.gz | awk '{print $1}')"
+          echo "sha256=$sha256" >> "$GITHUB_OUTPUT"
+
+      - name: Update PKGBUILD
+        run: |
+          python scripts/update_aur_package.py \
+            "${{ steps.release.outputs.version }}" \
+            "${{ steps.archive.outputs.sha256 }}"
+
+      - name: Regenerate and validate AUR package
+        run: |
+          set -euo pipefail
+
+          docker run --rm \
+            -v "$PWD:/workspace" \
+            -w /workspace/packaging/aur \
+            archlinux:base-devel \
+            bash -lc '
+              set -euo pipefail
+              pacman -Syu --noconfirm git namcap sudo
+              useradd --create-home --shell /bin/bash builder
+              echo "builder ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/builder
+              chown -R builder:builder /workspace/packaging/aur
+              sudo -u builder makepkg --printsrcinfo | sudo -u builder tee .SRCINFO > /dev/null
+              sudo -u builder makepkg --clean --syncdeps --noconfirm --check
+              namcap PKGBUILD ./*.pkg.tar.*
+            '
+
+          sudo chown -R "$(id -u):$(id -g)" packaging/aur
+
+      - name: Remove generated package artifacts
+        run: |
+          rm -f source.tar.gz
+          find packaging/aur -maxdepth 1 -type f \
+            \( -name "*.pkg.tar.*" -o -name "*.tar.gz" \) \
+            -delete
+
+      - name: Create packaging pull request
+        id: create-pr
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.PACKAGING_PR_TOKEN }}
+          branch: automation/aur-${{ steps.release.outputs.tag }}
+          delete-branch: true
+          commit-message: Update AUR package to ${{ steps.release.outputs.tag }}
+          title: Update AUR package to ${{ steps.release.outputs.tag }}
+          body: |
+            Updates Arch AUR packaging metadata for `${{ steps.release.outputs.tag }}`.
+
+            Validation performed by this workflow:
+            - downloaded the release source archive and computed the sha256
+            - regenerated `packaging/aur/.SRCINFO`
+            - ran `makepkg --clean --syncdeps --noconfirm --check`
+            - ran `namcap`
+
+            This is a packaging-only PR and intentionally has no semver bump marker.
+
+      - name: Approve packaging pull request
+        if: steps.create-pr.outputs.pull-request-number != ''
+        env:
+          GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+          PR_NUMBER: ${{ steps.create-pr.outputs.pull-request-number }}
+        run: |
+          gh pr review "$PR_NUMBER" --approve
+
+      - name: Enable packaging pull request auto-merge
+        if: steps.create-pr.outputs.pull-request-number != ''
+        env:
+          GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+          PR_NUMBER: ${{ steps.create-pr.outputs.pull-request-number }}
+        run: |
+          gh pr merge "$PR_NUMBER" --auto --squash --delete-branch

plex_tui-0.3.6/.github/workflows/post-release-homebrew.yml

@@ -0,0 +1,129 @@
+name: Post-release Homebrew Publish
+
+on:
+  workflow_run:
+    workflows: ["Version Bump and Release"]
+    types: ["completed"]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to package, such as v0.3.0. Defaults to the latest GitHub Release."
+        required: false
+        type: string
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish-tap:
+    if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
+    runs-on: macos-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Check packaging PR token
+        env:
+          PACKAGING_PR_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+        run: |
+          if [ -z "$PACKAGING_PR_TOKEN" ]; then
+            echo "PACKAGING_PR_TOKEN secret is required to publish the Homebrew tap" >&2
+            exit 1
+          fi
+
+      - name: Determine release tag
+        id: release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REQUESTED_TAG: ${{ github.event.inputs.tag }}
+        run: |
+          set -euo pipefail
+
+          if [ -n "$REQUESTED_TAG" ]; then
+            tag="$REQUESTED_TAG"
+          else
+            tag="$(gh release list --limit 1 --json tagName --jq '.[0].tagName')"
+          fi
+
+          if ! [[ "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Release tag must look like vX.Y.Z: $tag" >&2
+            exit 1
+          fi
+
+          version="${tag#v}"
+          echo "tag=$tag" >> "$GITHUB_OUTPUT"
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+
+      - name: Tap Homebrew repository
+        id: tap
+        env:
+          PACKAGING_PR_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+        run: |
+          brew tap so1omon563/plex-tui "https://x-access-token:${PACKAGING_PR_TOKEN}@github.com/so1omon563/homebrew-plex-tui.git"
+          echo "path=$(brew --repo so1omon563/plex-tui)" >> "$GITHUB_OUTPUT"
+
+      - name: Update formula source
+        run: |
+          python scripts/update_homebrew_formula.py \
+            "${{ steps.tap.outputs.path }}/Formula/plex-tui.rb" \
+            "${{ steps.release.outputs.version }}"
+
+      - name: Audit formula
+        working-directory: ${{ steps.tap.outputs.path }}
+        run: |
+          brew audit --strict --online so1omon563/plex-tui/plex-tui
+
+      - name: Commit tap update
+        id: commit
+        working-directory: ${{ steps.tap.outputs.path }}
+        env:
+          VERSION: ${{ steps.release.outputs.version }}
+        run: |
+          set -euo pipefail
+
+          if git diff --quiet -- Formula/plex-tui.rb; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+            echo "Homebrew tap is already up to date."
+            exit 0
+          fi
+
+          branch="automation/plex-tui-v${VERSION}"
+          git switch -c "$branch"
+          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}"
+          git push origin "$branch"
+
+          echo "changed=true" >> "$GITHUB_OUTPUT"
+          echo "branch=$branch" >> "$GITHUB_OUTPUT"
+
+      - name: Open and merge tap pull request
+        if: steps.commit.outputs.changed == 'true'
+        working-directory: ${{ steps.tap.outputs.path }}
+        env:
+          GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+          VERSION: ${{ steps.release.outputs.version }}
+          BRANCH: ${{ steps.commit.outputs.branch }}
+        run: |
+          set -euo pipefail
+
+          pr_url="$(gh pr create \
+            --repo so1omon563/homebrew-plex-tui \
+            --base main \
+            --head "$BRANCH" \
+            --title "Update plex-tui to ${VERSION}" \
+            --body "Automated Homebrew tap update for plex-tui ${VERSION}.")"
+
+          gh pr merge "$pr_url" \
+            --repo so1omon563/homebrew-plex-tui \
+            --squash \
+            --delete-branch

plex_tui-0.3.6/.github/workflows/publish-aur.yml

@@ -0,0 +1,102 @@
+name: Publish AUR Package
+
+on:
+  workflow_run:
+    workflows: ["AUR Package"]
+    types: ["completed"]
+  workflow_dispatch:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish:
+    if: |
+      github.event_name == 'workflow_dispatch' ||
+      (
+        github.event.workflow_run.conclusion == 'success' &&
+        github.event.workflow_run.head_branch == 'main' &&
+        github.event.workflow_run.event == 'push'
+      )
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.workflow_run.head_sha || github.sha }}
+
+      - name: Read package version
+        id: package
+        run: |
+          set -euo pipefail
+
+          version="$(sed -n 's/^pkgver=//p' packaging/aur/PKGBUILD)"
+          release="$(sed -n 's/^pkgrel=//p' packaging/aur/PKGBUILD)"
+
+          if ! [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "pkgver must look like X.Y.Z: $version" >&2
+            exit 1
+          fi
+          if ! [[ "$release" =~ ^[0-9]+$ ]]; then
+            echo "pkgrel must be numeric: $release" >&2
+            exit 1
+          fi
+
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+          echo "release=$release" >> "$GITHUB_OUTPUT"
+
+      - name: Configure AUR SSH
+        env:
+          AUR_SSH_PRIVATE_KEY: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
+        run: |
+          set -euo pipefail
+
+          if [ -z "$AUR_SSH_PRIVATE_KEY" ]; then
+            echo "AUR_SSH_PRIVATE_KEY secret is required to publish to AUR" >&2
+            exit 1
+          fi
+
+          install -m 700 -d ~/.ssh
+          printf '%s\n' "$AUR_SSH_PRIVATE_KEY" > ~/.ssh/aur
+          chmod 600 ~/.ssh/aur
+          ssh-keyscan -H aur.archlinux.org >> ~/.ssh/known_hosts
+
+          cat > ~/.ssh/config <<'EOF'
+          Host aur.archlinux.org
+            IdentityFile ~/.ssh/aur
+            IdentitiesOnly yes
+            User aur
+          EOF
+          chmod 600 ~/.ssh/config
+
+      - name: Clone AUR package repository
+        run: |
+          git clone ssh://aur@aur.archlinux.org/plex-tui.git aur-package
+
+      - name: Copy package metadata
+        run: |
+          cp packaging/aur/PKGBUILD aur-package/PKGBUILD
+          cp packaging/aur/.SRCINFO aur-package/.SRCINFO
+
+      - name: Commit and push AUR package
+        working-directory: aur-package
+        env:
+          VERSION: ${{ steps.package.outputs.version }}
+          RELEASE: ${{ steps.package.outputs.release }}
+        run: |
+          set -euo pipefail
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          if git diff --quiet -- PKGBUILD .SRCINFO; then
+            echo "AUR package repository is already up to date."
+            exit 0
+          fi
+
+          git add PKGBUILD .SRCINFO
+          git commit -m "Update to ${VERSION}-${RELEASE}"
+          git push origin master

{plex_tui-0.2.1 → plex_tui-0.3.6}/.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.6}/.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.6}/AGENTS.md

@@ -78,6 +78,36 @@ 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.
+
+By default, PR titles or bodies should include exactly one semver bump marker:
+`#patch`, `#minor`, or `#major`. Most changes should advance tags when merged,
+even when they do not publish a GitHub Release. Add `#release` only when the
+merge should create the GitHub Release and publish package channels. Exceptions
+are allowed for packaging-only follow-ups, automation repair, docs-only
+maintenance, or other changes that should not create a new version tag; call out
+the reason in the PR body when omitting a bump marker.
+
+When preparing or estimating a release version, fetch remote tags first with
+`git fetch --tags origin` and base the decision on the latest origin tag, not
+only local tags or the latest GitHub Release. Non-release PRs with `#patch`,
+`#minor`, or `#major` still create tags, so release prep files should match the
+tag that the release PR merge will create.
+
+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.6}/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 ## Unreleased
 
+## 0.3.6 - 2026-06-12
+
+- Polished grid cards so poster placeholders, cached artwork, titles,
+  subtitles, and selected status align more evenly in the media pane.
+- Improved the details pane hierarchy with clearer playback readiness,
+  explicit empty metadata/stream states, tighter preference rows, and wrapped
+  summaries.
+- Improved Settings detail feedback with consistent controls guidance, clearer
+  armed-confirmation text, and more useful saved-setting summaries.
+- Polished playback diagnostics with clearer active playback status, structured
+  playback error details, and more direct debug-log follow-up guidance.
+- Added shieldcn.dev README badges for CI, release, PyPI, AUR, Homebrew tap,
+  and license status.
+- Documented release-prep guidance for fetching origin tags before deciding the
+  next release version.
+
+## 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.6}/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