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

{plex_tui-0.4.2 → plex_tui-0.4.4}/.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.4}/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.4}/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 ## Unreleased
 
+## 0.4.4 - 2026-06-18
+
+- Added a keyboard action to mark the selected playable Plex item watched or
+  unwatched from the browse view.
+- Added Plex library Categories browsing, visible movie-edition variants, and
+  live mpv audio/subtitle switching when the active playback exposes matching
+  tracks.
+- Made library rows open the full Library view by default, with Space opening
+  the browse-mode menu as the alternate action, and added a Settings option to
+  swap those actions.
+- Added a Backspace/Delete Continue Watching removal action for selected items
+  in the Continue Watching view.
+- Improved episode readability by showing show, season, and episode context in
+  episode rows and directly under the episode title in details.
+
+## 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.4}/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.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plex-tui
-Version: 0.4.2
+Version: 0.4.4
 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,15 @@ 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.
+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.
 
 ## Key Bindings
 
@@ -218,6 +228,7 @@ presets.
 | `tab` / `shift+tab` | Move focus |
 | `l` | Focus libraries |
 | `m` | Focus media |
+| `space` | Run the alternate action for a selected library |
 | `v` | Toggle list/grid view |
 | `pageup` / `pagedown` | Move one page in grid view |
 | `,` | Show settings |
@@ -225,6 +236,8 @@ presets.
 | `enter` | Open selected item |
 | `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 |
 | `a` / `s` | Choose audio / subtitle preference |
 | `A` / `S` | Clear audio preference / cycle subtitle mode |
 | `x` | Stop launched `mpv` |
@@ -233,14 +246,23 @@ presets.
 
 - 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, and `mpv` window size.
+  prefetching, media view, library Enter behavior, and `mpv` window size.
 - App diagnostics view for version, paths, `mpv`, Plex connection, artwork, and
   browsing settings.
 

{plex_tui-0.4.2 → plex_tui-0.4.4}/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,15 @@ 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.
+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.
 
 ## Key Bindings
 
@@ -181,6 +191,7 @@ presets.
 | `tab` / `shift+tab` | Move focus |
 | `l` | Focus libraries |
 | `m` | Focus media |
+| `space` | Run the alternate action for a selected library |
 | `v` | Toggle list/grid view |
 | `pageup` / `pagedown` | Move one page in grid view |
 | `,` | Show settings |
@@ -188,6 +199,8 @@ presets.
 | `enter` | Open selected item |
 | `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 |
 | `a` / `s` | Choose audio / subtitle preference |
 | `A` / `S` | Clear audio preference / cycle subtitle mode |
 | `x` | Stop launched `mpv` |
@@ -196,14 +209,23 @@ presets.
 
 - 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, and `mpv` window size.
+  prefetching, media view, library Enter behavior, and `mpv` window size.
 - App diagnostics view for version, paths, `mpv`, Plex connection, artwork, and
   browsing settings.
 

{plex_tui-0.4.2 → plex_tui-0.4.4}/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.4}/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.
@@ -45,19 +47,30 @@
   [`anthonycaccese/240-MP`](https://github.com/anthonycaccese/240-MP/tree/main)
   live in `docs/plex-integration-research.md`.
 - Continue Watching now has a sidebar browse entrypoint backed by Plex on-deck
-  data; watch for real-library edge cases around ordering and pagination.
+  data; selected items can be removed from Continue Watching. Watch for
+  real-library edge cases around ordering and pagination.
 - Selective library visibility is available in Settings so noisy Plex libraries
   can be hidden from the sidebar.
-- Library submenus are available for Library, Recommended, Collections, and
-  Playlists. Revisit Categories after mapping PlexAPI support against a real
-  server response.
+- Library submenus are available for Library, Recommended, Collections,
+  Playlists, and Categories. Categories use PlexAPI category helpers when
+  present and genre filter choices as the fallback. Library rows open all items
+  by default, Space opens the browse-mode menu, and Settings can swap those
+  primary/alternate actions.
 - Alphabet navigation is available for loaded browse lists and grids with
   previous/next section jumps.
 - Explicit playback controls are available for play-from-start versus resume,
   direct/default playback versus selected transcode quality presets, and
   Plex-side resume offsets for transcoded streams.
-- Later design passes: profile switching with auto sign-in, visible movie
-  edition handling, and in-playback audio/subtitle switching through mpv IPC.
+- Watched/unwatched toggling is available for selected playable movies and
+  episodes.
+- Movie editions are visible as distinct variants when Plex reports multiple
+  editions for a selected movie.
+- In-playback audio/subtitle switching uses mpv IPC when the active stream
+  exposes matching tracks; Plex-transcoded streams may still require relaunching
+  with the saved preference.
+- Design playlist management before implementation: adding/removing media from
+  playlists and creating playlists are intentionally out of PR #80 scope.
+- Later design passes: profile switching with auto sign-in.
 
 ## Technical Follow-Up
 

{plex_tui-0.4.2 → plex_tui-0.4.4}/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.
@@ -48,6 +52,10 @@ client_identifier = "plex-tui-your-stable-client-id"
 # detail_artwork_mode = "list_only"
 # media_view can be "list" or "grid".
 # media_view = "list"
+# library_enter_action can be "library" or "browse_modes". The default
+# "library" opens all items with Enter and uses Space for browse modes.
+# "browse_modes" swaps those two actions.
+# library_enter_action = "library"
 # grid_density can be "compact", "comfortable", or "large".
 # grid_density = "comfortable"
 # Textual theme selected from the command palette.