plex-tui 0.4.2__tar.gz → 0.4.3__tar.gz

{plex_tui-0.4.2 → plex_tui-0.4.3}/.github/workflows/post-release-homebrew.yml

@@ -13,6 +13,7 @@ on:
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+  HOMEBREW_NO_REQUIRE_TAP_TRUST: "1"
 
 jobs:
   publish-tap:
@@ -133,14 +134,127 @@ jobs:
             "${{ steps.tap.outputs.path }}/Formula/plex-tui.rb" \
             "${{ steps.release.outputs.version }}"
 
-      - name: Audit formula
+      - name: Check tap update need
         if: steps.release.outputs.publish == 'true'
+        id: tap-update
+        working-directory: ${{ steps.tap.outputs.path }}
+        env:
+          VERSION: ${{ steps.release.outputs.version }}
+        run: |
+          set -euo pipefail
+
+          bottle_release="plex-tui-${VERSION}"
+          bottle_root_url="https://github.com/so1omon563/homebrew-plex-tui/releases/download/${bottle_release}"
+          needed=false
+
+          if ! git diff --quiet -- Formula/plex-tui.rb; then
+            needed=true
+          fi
+
+          if ! grep -Fq "root_url \"${bottle_root_url}\"" Formula/plex-tui.rb; then
+            needed=true
+          fi
+
+          {
+            echo "needed=${needed}"
+            echo "bottle_release=${bottle_release}"
+            echo "bottle_root_url=${bottle_root_url}"
+          } >> "$GITHUB_OUTPUT"
+
+          if [ "$needed" = "false" ]; then
+            echo "Homebrew tap is already up to date with bottle metadata."
+          fi
+
+      - name: Build Homebrew bottle
+        if: steps.release.outputs.publish == 'true' && steps.tap-update.outputs.needed == 'true'
+        id: bottle
+        timeout-minutes: 60
+        working-directory: ${{ steps.tap.outputs.path }}
+        env:
+          BOTTLE_ROOT_URL: ${{ steps.tap-update.outputs.bottle_root_url }}
+          VERSION: ${{ steps.release.outputs.version }}
+        run: |
+          set -euo pipefail
+
+          brew --version
+          brew config
+          brew info so1omon563/plex-tui/plex-tui
+
+          (
+            while true; do
+              sleep 60
+              echo "Still building Homebrew bottle for plex-tui ${VERSION} at $(date -u +%Y-%m-%dT%H:%M:%SZ)."
+            done
+          ) &
+          heartbeat_pid=$!
+          trap 'kill "$heartbeat_pid" 2>/dev/null || true' EXIT
+
+          brew uninstall --ignore-dependencies so1omon563/plex-tui/plex-tui >/dev/null 2>&1 || true
+          brew install --verbose --build-bottle so1omon563/plex-tui/plex-tui
+          kill "$heartbeat_pid" 2>/dev/null || true
+          trap - EXIT
+
+          rm -f plex-tui--*.bottle.json plex-tui--*.bottle.tar.gz
+          brew bottle \
+            --json \
+            --no-rebuild \
+            --root-url "$BOTTLE_ROOT_URL" \
+            so1omon563/plex-tui/plex-tui
+
+          bottle_json="$(find "$PWD" -maxdepth 1 -name 'plex-tui--*.bottle.json' -print -quit)"
+          if [ -z "$bottle_json" ]; then
+            echo "brew bottle did not produce bottle JSON" >&2
+            exit 1
+          fi
+
+          bottle_dir="${RUNNER_TEMP}/homebrew-bottles"
+          rm -rf "$bottle_dir"
+          mkdir -p "$bottle_dir"
+          python "${GITHUB_WORKSPACE}/scripts/prepare_homebrew_bottle_assets.py" \
+            "$bottle_json" \
+            --output-dir "$bottle_dir"
+
+          brew bottle --merge --write --no-commit "$bottle_json"
+
+          {
+            echo "json_path=${bottle_json}"
+            echo "upload_dir=${bottle_dir}"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Publish Homebrew bottle assets
+        if: steps.release.outputs.publish == 'true' && steps.tap-update.outputs.needed == 'true'
+        working-directory: ${{ steps.bottle.outputs.upload_dir }}
+        env:
+          GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
+          VERSION: ${{ steps.release.outputs.version }}
+          BOTTLE_RELEASE: ${{ steps.tap-update.outputs.bottle_release }}
+        run: |
+          set -euo pipefail
+
+          if gh release view "$BOTTLE_RELEASE" --repo so1omon563/homebrew-plex-tui >/dev/null 2>&1; then
+            gh release edit "$BOTTLE_RELEASE" \
+              --repo so1omon563/homebrew-plex-tui \
+              --title "plex-tui ${VERSION} Homebrew bottle"
+          else
+            gh release create "$BOTTLE_RELEASE" \
+              --repo so1omon563/homebrew-plex-tui \
+              --target main \
+              --title "plex-tui ${VERSION} Homebrew bottle" \
+              --notes "Homebrew bottle assets for plex-tui ${VERSION}."
+          fi
+
+          gh release upload "$BOTTLE_RELEASE" ./* \
+            --repo so1omon563/homebrew-plex-tui \
+            --clobber
+
+      - name: Audit formula
+        if: steps.release.outputs.publish == 'true' && steps.tap-update.outputs.needed == 'true'
         working-directory: ${{ steps.tap.outputs.path }}
         run: |
           brew audit --strict --online so1omon563/plex-tui/plex-tui
 
       - name: Commit tap update
-        if: steps.release.outputs.publish == 'true'
+        if: steps.release.outputs.publish == 'true' && steps.tap-update.outputs.needed == 'true'
         id: commit
         working-directory: ${{ steps.tap.outputs.path }}
         env:
@@ -172,15 +286,18 @@ jobs:
           GH_TOKEN: ${{ secrets.PACKAGING_PR_TOKEN }}
           VERSION: ${{ steps.release.outputs.version }}
           BRANCH: ${{ steps.commit.outputs.branch }}
+          BOTTLE_RELEASE: ${{ steps.tap-update.outputs.bottle_release }}
         run: |
           set -euo pipefail
 
+          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 \
             --repo so1omon563/homebrew-plex-tui \
             --base main \
             --head "$BRANCH" \
             --title "Update plex-tui to ${VERSION}" \
-            --body "Automated Homebrew tap update for plex-tui ${VERSION}.")"
+            --body "$pr_body")"
 
           gh pr merge "$pr_url" \
             --repo so1omon563/homebrew-plex-tui \

{plex_tui-0.4.2 → plex_tui-0.4.3}/AGENTS.md

@@ -184,6 +184,11 @@ Pull requests should include:
 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`.
+Create or switch to a scoped branch before doing repo work; do not keep feature
+work in the local `main` working tree.
+Repo work is not complete when a branch is merely pushed. Treat the workflow as
+open until there is a draft PR for the branch or the work is explicitly
+canceled.
 
 `main` is protected by repository rulesets. Changes must flow through PRs; force
 pushes and branch deletion are blocked. `plex-tui` requires the Python 3.11 and
@@ -198,6 +203,10 @@ 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 a change is judged release-worthy, do not only add `#release`: run the
+scripted release prep in the same branch and keep the release marker in the PR
+title. A release decision means both staged release files and a publishing
+marker are required unless the release is explicitly canceled.
 
 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

{plex_tui-0.4.2 → plex_tui-0.4.3}/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 0.4.3 - 2026-06-18
+
+- Made the default `mpv` window open with `--autofit=80%`, keeping custom
+  Settings overrides for exact pixel sizes or other percentage presets, and
+  made the old `1280x720` preset cycle back to Default.
+- Added Homebrew bottle publishing to the post-release tap automation so macOS
+  installs can pour a prebuilt `plex-tui` virtualenv instead of rebuilding
+  Python resources from source, with bounded verbose CI diagnostics for bottle
+  builds.
+- Documented that Homebrew bottles are published for Apple Silicon macOS, while
+  Intel macOS remains supported through Homebrew's source-build path.
+
 ## 0.4.2 - 2026-06-18
 
 - Prefer episode stills and season posters for TV artwork while keeping show art

{plex_tui-0.4.2 → plex_tui-0.4.3}/PACKAGING.md

@@ -51,8 +51,12 @@ 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.
+a Homebrew-managed virtualenv. Post-release automation publishes Homebrew
+bottles for Apple Silicon macOS so supported installs can pour the prebuilt app
+virtualenv instead of rebuilding Python resources such as `pillow` from source.
+Intel macOS remains supported through Homebrew's source install path while that
+platform continues to be supported. If no matching bottle is available,
+Homebrew falls back to the source install path.
 Homebrew 6 requires non-official taps to be trusted before Homebrew loads
 formulae from them. The `plex-tui` formula only uses Homebrew/core formula
 dependencies, so users do not need to trust any additional taps for `mpv`,
@@ -65,6 +69,10 @@ brew test so1omon563/plex-tui/plex-tui
 brew audit --strict --online so1omon563/plex-tui/plex-tui
 ```
 
+Install-time investigation lives in `docs/homebrew-install-time.md`. Use
+`scripts/measure_homebrew_install.py` to capture no-op upgrade, reinstall,
+fresh-install, and bottle-pour timings before changing the tap formula.
+
 ### Arch AUR
 
 AUR package:
@@ -95,8 +103,8 @@ Validation is handled by `.github/workflows/aur.yml`, which runs inside
 For each new app release:
 
 1. Publish and validate PyPI.
-2. Let the `Post-release Homebrew Publish` workflow update, validate, and merge
-   the Homebrew tap formula.
+2. Let the `Post-release Homebrew Publish` workflow update, bottle, validate,
+   and merge the Homebrew tap formula.
 3. Let the `Post-release AUR Update` workflow update AUR metadata, open the
    packaging PR, approve it, and enable auto-merge.
 4. After the packaging PR merges and the `AUR Package` workflow passes on
@@ -111,9 +119,11 @@ The AUR automation requires:
   `ssh://aur@aur.archlinux.org/plex-tui.git`.
 
 The Homebrew automation uses `PACKAGING_PR_TOKEN`; that token must also be able
-to push branches and merge pull requests in `so1omon563/homebrew-plex-tui`.
+to create or update GitHub Releases, upload bottle assets, push branches, and
+merge pull requests in `so1omon563/homebrew-plex-tui`.
 
 ## Known Follow-Up
 
-- Investigate faster Homebrew installs without compromising formula quality.
+- Continue validating Homebrew bottle publishing on release dry-runs and
+  follow-up packaging PRs.
 - Consider standalone artifacts only after the app behavior stabilizes.

{plex_tui-0.4.2 → plex_tui-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plex-tui
-Version: 0.4.2
+Version: 0.4.3
 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
@@ -108,9 +108,11 @@ brew install plex-tui
 plex-tui --smoke
 ```
 
-The Homebrew formula installs `mpv` automatically. The first install can take
-several minutes because native Python dependencies such as `pillow` are built
-from source.
+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.
@@ -204,7 +206,11 @@ 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.
+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.
 
 ## Key Bindings
 

{plex_tui-0.4.2 → plex_tui-0.4.3}/README.md

@@ -71,9 +71,11 @@ brew install plex-tui
 plex-tui --smoke
 ```
 
-The Homebrew formula installs `mpv` automatically. The first install can take
-several minutes because native Python dependencies such as `pillow` are built
-from source.
+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.
@@ -167,7 +169,11 @@ 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.
+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.
 
 ## Key Bindings
 

{plex_tui-0.4.2 → plex_tui-0.4.3}/RELEASE.md

@@ -124,9 +124,15 @@ be run manually with a release tag. It updates:
 - Formula URL and sha256.
 - Python resource blocks if dependencies changed.
 - Formula test expectations if version output changed.
+- Homebrew bottle assets and the generated formula `bottle do` block.
 
-It then runs `brew audit --strict --online`, opens a tap PR, and merges it. This
-uses `PACKAGING_PR_TOKEN`, which must have access to the tap repository.
+It builds the formula with `brew install --build-bottle`, generates bottle
+metadata with `brew bottle --json`, uploads the bottle tarball to a
+`plex-tui-X.Y.Z` GitHub Release in the tap repository, merges the generated
+`bottle do` block into the formula, runs `brew audit --strict --online`, opens a
+tap PR, and merges it. This uses `PACKAGING_PR_TOKEN`, which must have access to
+create releases, upload assets, push branches, and merge pull requests in the
+tap repository.
 
 If the automated workflow cannot run, update and validate manually:
 
@@ -186,8 +192,9 @@ To verify post-release packaging without publishing a new app release, manually
 dispatch the post-release workflows with the latest real release tag, for
 example `v0.3.6`. A healthy idempotent run should:
 
-- update and audit the Homebrew formula, then skip tap PR creation when there is
-  no diff;
+- update, bottle, and audit the Homebrew formula when bottle metadata is
+  missing; then skip tap PR creation on later reruns when the formula and bottle
+  block are already current;
 - regenerate and validate AUR metadata, then skip packaging PR auto-merge when
   there is no diff.
 

{plex_tui-0.4.2 → plex_tui-0.4.3}/ROADMAP.md

@@ -32,8 +32,10 @@
   requires the Python 3.11 and 3.13 checks before merge. Rulesets require PRs
   with zero approving reviews so automation branches can merge after checks
   without self-approval.
-- Improve Homebrew install time; the current formula works but builds native
-  Python resources such as `pillow` from source.
+- Improve Homebrew install time; baseline the current install/update paths with
+  `scripts/measure_homebrew_install.py`, then prioritize tap bottle automation.
+  The current formula works but builds Python resources from source, with
+  native compilation concentrated in `pillow`.
 - Keep post-release package publishing fully automated across PyPI, Homebrew,
   and AUR. Periodically dry-run existing release tags through the post-release
   workflows to confirm Homebrew and AUR no-op cleanly when already current.

{plex_tui-0.4.2 → plex_tui-0.4.3}/config.example.toml

@@ -14,7 +14,11 @@ client_identifier = "plex-tui-your-stable-client-id"
 # preferred_subtitle_language = "eng"
 # subtitle_mode can be "auto", "none", or "preferred".
 # subtitle_mode = "preferred"
-# Optional mpv window size passed as --autofit. Examples: "1280x720", "80%".
+# Optional mpv window size passed as --autofit. Empty uses the app default
+# "80%" for a more comfortable window on modern displays.
+# Examples: "90%", "1280x720", "80%x80%".
+# Existing exact-size overrides such as "1280x720" stay exact until reset or
+# changed in Settings.
 # mpv_window_size = "1280x720"
 # playback_mode can be "auto" for direct/default playback or "transcode" to
 # force Plex transcoding.

plex_tui-0.4.3/docs/homebrew-install-time.md

@@ -0,0 +1,171 @@
+# Homebrew Install-Time Investigation
+
+The current Homebrew formula is correct for a Python application: it uses
+`Language::Python::Virtualenv`, declares `python@3.13`, and installs explicit
+Python `resource` blocks into a Homebrew-managed virtualenv. The slow path is
+therefore expected formula work, not a known correctness bug.
+
+## Current Hypothesis
+
+Fresh installs are slow because Homebrew installs the app from source resources.
+Most dependencies are pure Python, but `pillow` is a native dependency and is
+the most likely expensive build. Even no-op updates can feel slow because
+Homebrew still evaluates the tap, dependency state, Python resources, and the
+installed virtualenv before deciding there is little to do.
+
+Baseline measurements on Apple silicon with `plex-tui 0.4.2`:
+
+| Scenario | Auto-update | Result |
+| --- | --- | ---: |
+| `brew upgrade plex-tui` no-op | disabled | 0.5s |
+| `brew upgrade plex-tui` no-op | enabled | 4.7s |
+| `brew reinstall plex-tui` from source | disabled | 49.6s |
+| `brew install plex-tui` after uninstall | disabled | 49.6s |
+| `brew install --force-bottle plex-tui` from local bottle | disabled | 3.3s |
+| `brew test plex-tui` | n/a | 3.0s |
+
+The source install output reported `/opt/homebrew/Cellar/plex-tui/0.4.2` was
+"built in 47 seconds". The local bottle prototype avoided that build and poured
+successfully in 3.3 seconds, then passed `brew test`.
+
+Separate these timing buckets before changing packaging:
+
+- Homebrew overhead: auto-update, tap loading, dependency resolution, and audit
+  checks.
+- System dependencies: `mpv` and `python@3.13` installation or upgrades.
+- App resources: Python source resources installed into `libexec`.
+- Native compilation: currently expected to be dominated by `pillow`.
+- Post-install checks: `brew test` and smoke execution.
+
+## Dependency Layers
+
+A truly first-time Homebrew install has two dependency layers:
+
+- Formula dependencies: `mpv` and `python@3.13`, plus their recursive Homebrew
+  dependencies. On the measured machine these were already installed, but
+  `brew deps --installed so1omon563/plex-tui/plex-tui` listed the full runtime
+  stack, including `ffmpeg`, `vapoursynth`, `yt-dlp`, and many media libraries
+  below `mpv`.
+- Python resources: the formula vendors every Python dependency into
+  `plex-tui`'s Homebrew-managed virtualenv. These resources are absent from a
+  fresh `plex-tui` install even if the user has similar packages elsewhere.
+
+The Python resources currently installed by the formula are:
+
+- `certifi`
+- `charset-normalizer`
+- `idna`
+- `linkify-it-py`
+- `markdown-it-py`
+- `mdit-py-plugins`
+- `mdurl`
+- `pillow`
+- `platformdirs`
+- `PlexAPI`
+- `Pygments`
+- `requests`
+- `rich`
+- `textual`
+- `typing-extensions`
+- `uc-micro-py`
+- `urllib3`
+
+Homebrew logs from a `--build-bottle` install showed each Python resource being
+built as a wheel from its source resource. Only `pillow` produced native
+extensions and a compiler log. The installed virtualenv contains Pillow
+extension modules such as `PIL/_imaging*.so`, and `brew linkage plex-tui` shows
+links to `freetype`, `jpeg-turbo`, `libtiff`, and `little-cms2`.
+
+## Measurement Script
+
+Use the local measurement helper from the repository root:
+
+```bash
+python3 scripts/measure_homebrew_install.py --help
+```
+
+Measure a no-op update path without changing the installed formula:
+
+```bash
+python3 scripts/measure_homebrew_install.py --upgrade --test --output /tmp/plex-tui-brew-noop.json
+```
+
+Measure a reinstall of the current formula:
+
+```bash
+python3 scripts/measure_homebrew_install.py --reinstall --test --output /tmp/plex-tui-brew-reinstall.json
+```
+
+Measure a fresh formula install after uninstalling only `plex-tui`:
+
+```bash
+python3 scripts/measure_homebrew_install.py --fresh-install --test --output /tmp/plex-tui-brew-fresh.json
+```
+
+Measure a bottle-pour path after adding a valid `bottle do` block to the tap
+formula:
+
+```bash
+python3 scripts/measure_homebrew_install.py --fresh-install --force-bottle --test --output /tmp/plex-tui-brew-bottle.json
+```
+
+By default, the script sets `HOMEBREW_NO_AUTO_UPDATE=1` so measurements focus on
+the formula and dependency work. Add `--allow-auto-update` when measuring the
+full user-facing command cost.
+
+## Candidate Improvements
+
+### Bottle The Tap
+
+Build and publish Homebrew bottles for `so1omon563/homebrew-plex-tui`, then add
+a `bottle do` block to the formula. Homebrew automatically downloads a matching
+bottle when one exists, which should avoid rebuilding the virtualenv and native
+resources during ordinary installs.
+
+This is the highest-impact path for first-install time in the current
+measurement. A local `arm64_tahoe` bottle for `0.4.2` was 3.1MB, relocatable
+with `cellar: :any`, and poured in 3.3 seconds. It requires a tap-side bottle
+workflow, storage for bottle artifacts, formula `bottle do` updates, and
+verification on the supported macOS runners.
+
+### Reduce Runtime Dependencies
+
+Review whether any dependency can move from required runtime to an optional
+feature. `pillow` is the main candidate because it enables rich artwork paths
+but also brings native build cost. Removing or optionalizing it would require a
+deliberate app fallback so Homebrew users do not lose expected artwork behavior
+silently.
+
+This path can improve both Homebrew and PyPI installs, but it changes app
+capability and needs product judgment.
+
+### Keep The Formula Source-Based
+
+Keep `virtualenv_install_with_resources` unchanged and improve docs only. This
+preserves the simplest, most standard formula and avoids bottle automation, but
+it does not solve the initial-install pain.
+
+### Standalone Artifacts
+
+Standalone app artifacts could bypass Python resource installation entirely, but
+they are a larger distribution project. Keep this behind bottle exploration
+unless app packaging requirements change.
+
+## Next Slice
+
+1. Capture baseline timings for no-op upgrade, reinstall, and fresh install on
+   Apple silicon. Done for `0.4.2`.
+2. Prototype bottle creation in the tap repo and compare bottle-pour timing
+   against the baseline. Done locally for `arm64_tahoe`.
+3. Add tap automation that builds bottles, uploads them to a release asset, and
+   merges the generated `bottle do` block. Implemented in the post-release
+   Homebrew workflow.
+4. Keep optional `pillow` dependency reduction as a secondary path if bottle
+   automation proves too brittle.
+5. Update `PACKAGING.md` and the tap README once bottle automation is proven.
+
+## References
+
+- Homebrew Bottles: https://docs.brew.sh/Bottles
+- Homebrew Python formula guidance:
+  https://docs.brew.sh/Python-for-Formula-Authors

{plex_tui-0.4.2 → plex_tui-0.4.3}/packaging/aur/.SRCINFO

@@ -1,6 +1,6 @@
 pkgbase = plex-tui
 	pkgdesc = Standalone Plex terminal UI with mpv playback
-	pkgver = 0.4.1
+	pkgver = 0.4.2
 	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.1.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.4.1.tar.gz
-	sha256sums = 2271c6413ec204ba1250b812e6b9e98af37afaeb44006d5c17fb0f82cf419282
+	source = plex-tui-0.4.2.tar.gz::https://github.com/so1omon563/plex-tui/archive/refs/tags/v0.4.2.tar.gz
+	sha256sums = 0d7832319a5468a89ed4eeb2dd0bad543663922f215765f40490d9e67723dac7
 
 pkgname = plex-tui

{plex_tui-0.4.2 → plex_tui-0.4.3}/packaging/aur/PKGBUILD

@@ -1,6 +1,6 @@
 # Maintainer: so1omon
 pkgname=plex-tui
-pkgver=0.4.1
+pkgver=0.4.2
 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=("2271c6413ec204ba1250b812e6b9e98af37afaeb44006d5c17fb0f82cf419282")
+sha256sums=("0d7832319a5468a89ed4eeb2dd0bad543663922f215765f40490d9e67723dac7")
 
 build() {
   cd "$pkgname-$pkgver"

{plex_tui-0.4.2 → plex_tui-0.4.3}/packaging/homebrew/README.md

@@ -22,12 +22,21 @@ For each `plex-tui` release:
 
 1. Update the formula URL and sha256 for the new PyPI sdist.
 2. Refresh Python resource blocks if dependencies changed.
-3. Run:
+3. Build and publish a Homebrew bottle, then merge the generated `bottle do`
+   block into the formula.
+4. Run:
 
    ```bash
    brew test so1omon563/plex-tui/plex-tui
    brew audit --strict --online so1omon563/plex-tui/plex-tui
    ```
 
-The current formula is correct but slow on first install because native Python
-resources such as `pillow` are built from source.
+The source formula is correct but slow on first install because native Python
+resources such as `pillow` are built from source. Release automation publishes
+Apple Silicon macOS bottles so supported installs can pour a prebuilt
+virtualenv. Intel macOS continues to use Homebrew's source-build path while that
+platform remains supported.
+
+Install-time investigation notes and the baseline measurement helper live in the
+main repo at `docs/homebrew-install-time.md` and
+`scripts/measure_homebrew_install.py`.

{plex_tui-0.4.2 → plex_tui-0.4.3}/pyproject.toml

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