bump VERSION to 0.3.1

Loading indicators: the braille spinner now carries a contextual label
(Refreshing…, Fetching…, Loading more…, Discovering…, Searching…) and is
shown in every loading state that previously rendered nothing — Discover
results, Search results fallback, and the empty Feed list.

Feed pagination: a focusable "[Fetch More]" row at the bottom of the flat
feed list advances every feed's loaded window by 50 episodes via the new
loadMoreAllFeeds/hasMoreAcrossAll store API. Behavior is a setting
(Fetch More: manual|auto, default manual) persisted in config.json; auto
fetches when focus reaches the bottom row. The button row is excluded
from episode focus so no episode is double-highlighted while it is active.

.github/workflows/release.yml

@@ -0,0 +1,102 @@
+name: release
+
+# Builds standalone PodTui binaries for each supported OS/arch and attaches
+# them to a GitHub Release. One runner per platform because Bun cannot
+# cross-compile — each runner runs `make dist`, which emits a
+# podtui-<platform>-<arch>.tar.gz (binary + native libs side by side).
+#
+# Trigger: push a tag like v0.1.0. Bump VERSION in src/index.tsx in the same
+# commit as the tag so the released binary reports the tagged version.
+
+on: # intentional: YAML `on` key
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: build (${{ matrix.os }} / ${{ matrix.arch }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            arch: x64
+            plat: linux
+          - os: ubuntu-24.04-arm
+            arch: arm64
+            plat: linux
+          - os: macos-15-intel
+            arch: x64
+            plat: darwin
+          - os: macos-14
+            arch: arm64
+            plat: darwin
+    steps:
+      - name: Check out repo
+        uses: actions/checkout@v4
+
+      - name: Set up Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Install fftw (cavacore build dependency)
+        run: |
+          if uname -s | grep -qi darwin; then
+            brew install fftw
+          else
+            sudo apt-get update
+            sudo apt-get install -y libfftw3-dev
+          fi
+
+      - name: Build native cavacore library
+        run: scripts/build-cavacore.sh
+
+      - name: Build standalone binary + tarball
+        run: make dist
+
+      - name: Smoke-test binary boot
+        env:
+          DIST_TAR: podtui-${{ matrix.plat }}-${{ matrix.arch }}.tar.gz
+        run: |
+          # The binary is compiled with bunfig autoload disabled
+          # (autoloadBunfig: false in build.ts), so it must boot even from a
+          # directory holding a bunfig.toml with a top-level preload the
+          # standalone can't resolve. Plant one to make this a real regression
+          # test for "preload not found".
+          SMOKE_DIR=$(mktemp -d)
+          tar -xzf "dist/$DIST_TAR" -C "$SMOKE_DIR"
+          printf 'preload = ["./definitely-missing.ts"]\n' > "$SMOKE_DIR/bunfig.toml"
+          cd "$SMOKE_DIR"
+          ./podtui-*/podtui --version
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: podtui-${{ matrix.plat }}-${{ matrix.arch }}
+          path: dist/podtui-*.tar.gz
+
+  upload:
+    name: Attach to GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download all binaries
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Publish release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            artifacts/**/*.tar.gz
+            LICENSE

CONTRIBUTING.md

@@ -0,0 +1,230 @@
+# Contributing to PodTui
+
+This file is written **for humans**. If you're an AI agent or LLM working in
+this repo, read [AGENTS.md](AGENTS.md) instead — it has the machine-oriented
+build/test/lint contract and code-style rules. Both describe the same project;
+CONTRIBUTING.md focuses on *understanding* and *navigating* the codebase.
+
+PodTui is a keyboard-first, yazi-style terminal podcast client. TypeScript +
+[OpenTUI](https://github.com/opentui/opentui) on top, [Bun](https://bun.sh)
+as the runtime and toolchain.
+
+---
+
+## Quick start
+
+```bash
+brew install bun          # or: curl -fsSL https://bun.sh/install | bash
+git clone git@github.com:mikefreno/podtui.git
+cd podtui
+
+bun install               # install JS dependencies
+make native               # build libcavacore.dylib from the vendored C source
+bun run dev               # launch with hot reload (alias: make dev)
+```
+
+The app is a TUI — it expects a real terminal (Ghostty, kitty, iTerm2,
+      WezTerm, tmux, …). It will not render in a plain captured `bash` session.
+
+## What each command does
+
+| Command            | Purpose                                                                  |
+|--------------------|--------------------------------------------------------------------------|
+| `bun install`      | Install JS dependencies                                                  |
+| `make native`      | Compile `cava/cavacore.c` → `src/native/libcavacore.<dylib\|so>`          |
+| `bun run dev`      | Run with hot reload                                                       |
+| `bun run start`    | Run once (no watch)                                                       |
+| `bun test`         | Run the test suite (see [Testing](#testing))                              |
+| `bun run lint`        | Type-check                                         |
+| `bun run build`    | Bundle JS into `dist/` + copy native libs (the `podtui` npm script path)  |
+| `make dist`        | Compile the standalone binary + make the current platform's tarball       |
+| `make dist-mac` / `make dist-linux` | Aliases for `dist` on their platform (CI runs these)          |
+| `make clean`       | Remove `dist/`                                                             |
+
+## Repository layout
+
+```
+src/
+  api/          Network + XML/RSS — client.ts, rss-parser.ts
+  components/   Reusable UI pieces: Shell, Navigation, YaziPaneRow, TabPanel…
+  config/       App config: keybinds.jsonc, shortcuts, auth
+  constants/    Static tables (sync formats, themes)
+  context/      Solid contexts: KeybindContext, NavigationContext, ThemeContext
+  hooks/        useAudio, useMultimediaKeys, useCachedData
+  native/       FFI glue + the built libcavacore.{dylib,so}
+  pages/        App screens: Feed, MyShows, Discover, Search, Player, Settings
+  stores/       Zustand stores — app, feed, audio-nav, search, auth, progress…
+  styles/       theme.css
+  themes/       catppuccin, gruvbox, nord, tokyo schemes + schema.json
+  types/        All shared interfaces (podcast, episode, feed, settings…)
+  ui/           Modal-adjacent UI: command.tsx, dialog.tsx, toast.tsx
+  utils/        Parser/persistence/audio helpers (audio-player, config-dir…)
+scripts/
+  build-cavacore.sh   C → shared lib; finds libfftw3.a on macOS & Debian
+  tui-harness.tsx     Headless harness for scripted interaction (see below)
+cava/                 Vendored cavacore C source (MIT, from karlstav/cava)
+tests/                bun test suite + cavacore smoke test
+dist/                 Build output (JS bundle + libs + tarballs)
+```
+
+## Native libraries: how the FFI layer works
+
+PodTui loads **two** native libraries at runtime:
+
+1. **libopentui** — the OpenTUI renderer (shipped inside the
+   `@opentui/core-<platform>-<arch>` npm packages, copied to `dist/` by
+   `build.ts`).
+2. **libcavacore** — the audio spectrum renderer, built from C. The source is
+   vendored under `cava/` (it must stay committed — every CI runner builds it).
+   `libfftw3` is needed to build it:
+   - macOS: `brew install fftw`
+   - Debian/Ubuntu: `apt-get install libfftw3-dev`
+   (CI installs it for you; locally run `make native`.)
+
+**Critical sibling rule**: both libraries are loaded *relative to the binary*,
+so `podtui`, `libopentui.*` and `libcavacore.*` must sit in the **same
+directory**. Never move a single binary out of the tarball. The Homebrew
+formula keeps all three in `libexec/` and exposes only a `podtui` symlink.
+
+Cavacore smoke test: `bun tests/cavacore-smoke.ts`
+(FFI-calls `cava_init` / `cava_execute` / `cava_destroy` and prints results).
+
+## Gotchas (read before touching anything)
+
+1. **The compiled binary must keep bunfig autoload disabled.**
+   `build.ts` compiles the standalone with `autoloadBunfig: false`, so its
+   embedded runtime *never* reads the launching CWD's `bunfig.toml`. Without
+   that flag, a top-level `preload` in the CWD bunfig (common in Bun project
+   dirs) resolves against the CWD rather than the binary and kills startup
+   with `preload not found`. Don't remove the flag. Preloads for dev/test
+   belong in the explicit `--preload` flags in `package.json` and the
+   `[test]` section of `bunfig.toml` — not as a top-level entry.
+
+2. **Smoke-test the binary from a dir with a poisoned bunfig.**
+   The CI smoke test unpacks the tarball into a `mktemp` dir, drops a
+   `bunfig.toml` containing an unresolvable top-level `preload` next to it,
+   and boots the binary — proving bunfig autoload stayed disabled. `./dist/
+   podtui --version` must work from any directory, including the repo root;
+   do the same check when testing a release build locally.
+
+3. **Homebrew's dylib-repair warning is benign.**
+   `brew install` may print “load commands do not fit in the header … needs
+   `-headerpad`” for a prebuilt dylib. The app dlopens the libs by path, so
+   the warning is cosmetic; installs complete and the app boots.
+
+## Testing
+
+```bash
+bun test                # full suite   (54 tests across 6 files today)
+```
+
+The suite covers the keyboard/nav model, keybind dispatch, and the yazi pane
+logic; plus `tests/cavacore-smoke.ts` asserting the native lib exports.
+
+For scripted end-to-end interaction there's a **headless harness**,
+`scripts/tui-harness.tsx`: each invocation snapshot-rebuilds the app state
+into a sandboxed `.harness/` config dir, replays the saved action log
+(`.harness/actions.json`), executes one more key/action passed on the CLI, and
+prints the resulting frame + a style summary — all without a real terminal.
+Audio is a no-op during those snapshots. The last frame lands in
+`.harness/last-frame.{json,txt}` for inspection.
+
+## Releasing
+
+Releases are built and published from **tags**
+
+### Steps
+
+1. Run `scripts/release-tag.sh` (interactive: pick major/minor/patch/custom,
+   confirms the plan, bumps `VERSION` in `src/index.tsx`, commits, tags
+   `vX.Y.Z`, and pushes branch + tag to every remote). If the version bump is
+   already committed but the tag is missing, it offers a tag-only path.
+   `--dry-run` prints the plan without doing anything.
+2. Equivalent manual commands:
+
+   ```bash
+   git tag -a v0.2.0 -m 'PodTUI v0.2.0' && git push gh v0.2.0
+   ```
+
+3. CI (`.github/workflows/release.yml`) runs four builds in parallel,
+   each producing `podtui-<platform>-<arch>.tar.gz`:
+
+   | Runner              | Platform/Arch |
+   |---------------------|---------------|
+   | `ubuntu-latest`     | linux-x64     |
+   | `ubuntu-24.04-arm`  | linux-arm64   |
+   | `macos-15-intel`    | darwin-x64    |
+   | `macos-14`          | darwin-arm64  |
+
+   Each runner: installs deps → installs fftw → `scripts/build-cavacore.sh`
+   → `make dist` → smoke-boots the binary from a temp dir → uploads the
+   tarball. (`macos-15-intel` matters: GitHub's `macos-latest` is arm64 now.)
+
+4. A release is auto-created with all 4 tarballs attached. `brew` never
+   sees the new version: the **tap self-updates**: the
+   `mikefreno/homebrew-tap` repo has a scheduled workflow (hourly) that
+   polls GitHub releases, and when a new tag appears, rewrites
+   `Formula/podtui.rb` (URLs + arm64/x64 `sha256`) and pushes it — no
+   secrets. See `scripts/sync-formula.sh` in that repo for the logic. Local
+   test: `brew install mikefreno/tap/podtui`.
+5. **AUR packaging** (`packaging/aur/PKGBUILD`): the `podtui-bin` package is
+   staged, not yet published (AUR account registrations are closed; see the
+   README's Installation section). On each release, keep the AUR sources in sync
+   with the new tag: bump `pkgver`, recompute the two tarball `sha256sums`
+   entries, keep the `LICENSE` asset source (the workflow above uploads
+   `LICENSE` to every release), and regenerate `packaging/aur/.SRCINFO` with
+   `bash packaging/aur/gen-srcinfo.sh`.
+
+### Manual fallback
+
+If you ever need to sync the tap by hand (or before the hourly job runs):
+
+```bash
+cd <clone of mikefreno/homebrew-tap>
+./scripts/sync-formula.sh 0.2.0
+git commit -am 'podtui 0.2.0' && git push
+```
+
+### Local release build
+
+```bash
+make dist          # builds the binary + tarball for THIS machine only
+```
+
+Bun cannot cross-compile — the other platforms come from CI.
+
+## Distribution & packaging
+
+A release tarball is three files sitting side by side: the `podtui` binary
+plus its two FFI libraries (`libopentui.<dylib|so>`,
+`libcavacore.<dylib|so>`). The sibling rule above is why they ship together.
+
+PodTui deliberately ships **no** `.deb`, `.rpm`, Flatpak, or Snap packages:
+for a terminal app that's overwhelmingly installed through repositories or
+archives, those formats add desktop-sandboxing overhead and a packaging tax
+with little benefit. Instead:
+
+- **GitHub Release tarballs** are the universal path — one upload per
+  OS/arch, works on any distro with `curl` + `tar`.
+- **AUR (`podtui-bin`)** covers Arch/Manjaro with the same binary through the
+  native package manager.
+- **Nix / cross-distro** users build from source (or a Nix flake can be added
+  later).
+
+This keeps maintenance to a single build per OS/arch while still reaching the
+vast majority of desktop Linux users. The AUR PKGBUILD lives in
+`packaging/aur/` and can be built locally to test before publication:
+
+```bash
+cd packaging/aur && makepkg -si
+```
+
+---
+
+## Open items / things to sort out
+
+- **Native libs in `dist/` still need committing?** No — they're built from
+  sources kept in the repo (`cava/`, `node_modules/@opentui/core-*`). Only
+  `src/native/libcavacore.dylib` is a committed binary artifact; macOS arm64
+  ships from it directly until a full rebuild replaces it. On other hosts the
+  `make native` build is required — see `scripts/build-cavacore.sh`.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Freno
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1,65 @@
+# PodTui — Makefile
+#
+# Development targets:
+#   make install     install dependencies (bun install) + build native lib
+#   make dev         run with hot reload
+#   make test        run the test suite
+#   make build       produce the JS bundle + native libs in dist/
+#   make native      build the cavacore FFI library from C source
+#   make lint        run typecheck-style checks (lsp), not eslint
+#
+# Packaging / release targets:
+#   make dist        build a standalone compiled binary + tarball for the
+#                    CURRENT platform (see dist/ for podtui + libs + tarball)
+#   make dist-mac    alias for `dist` targeting macOS (run on macOS)
+#   make dist-linux  alias for `dist` targeting Linux (run on Linux)
+#   make clean       remove dist/ output
+#
+# Cross-platform binaries are produced by CI (GitHub Actions) with one runner
+# per OS/arch — Bun cannot cross-compile, so dist:mac / dist:linux only produce
+# the binary for the OS they run on. Each runner runs `make dist` and uploads
+# its podtui-<platform>-<arch>.tar.gz artifact.
+
+SHELL := /bin/bash
+
+.PHONY: install dev build native dist dist-mac dist-linux test clean
+
+## Install dependencies and build the native runtime library.
+install:
+	bun install
+	make native
+
+## Run the dev server with hot reload.
+dev:
+	bun run dev
+
+## Type-check the whole project. (See AGENTS.md: `bun run lint` points at a
+## nonexistent lint.ts; LSP diagnostics are the maintained clean bar.)
+lint:
+	bun tsc --noEmit
+
+## Build the JS bundle + native libs into dist/ (the `podtui` npm bin target).
+build:
+	bun run build
+
+## Build the cavacore FFI library from src/native/cavacore.c.
+native:
+	scripts/build-cavacore.sh
+
+## Standalone binary + native-libs tarball for the current platform.
+## Built with bunfig autoload disabled (build.ts sets autoloadBunfig: false),
+## so the embedded runtime ignores any bunfig.toml in the launching directory.
+dist:
+	bun run build.ts --compile
+
+## macOS build (run on a macOS runner / host).
+dist-mac:
+	bun run build.ts --compile
+
+## Linux build (run on a Linux runner / host).
+dist-linux:
+	bun run build.ts --compile
+
+## Remove build artifacts.
+clean:
+	rm -rf dist

README.md

@@ -1,15 +1,221 @@
-# solid
+# PodTui
 
-To install dependencies:
+A keyboard-first, terminal podcast client built on [OpenTUI](https://github.com/opentui/opentui). Subscribe to RSS feeds,
+browse episodes in a three-pane file-manager layout, and play audio through an
+external player with full transport control — all from your terminal.
 
-```bash
-bun install
+## Features
+
+- **Vim/yazi-style navigation** — `j/k` to move, `h/l` to swipe between panes,
+  `Enter` to open, `1–6` / `[` `]` to switch tabs. The tab list is the app root:
+  at launch it fills the current pane, and drilling into a tab's contents slides
+  it into the parent pane.
+- **Three-pane view** — parent / current / preview (Up | Current | Preview).
+- **Podcast feeds** — add feeds, browse episodes, and manage your library
+  (My Shows, Discover, Feed tabs).
+- **Search** across your subscribed shows.
+- **Audio playback** through an external player with full transport control:
+  play/pause, next/previous, seek, speed, and per-episode resume progress.
+- **Themeable** and **remappable keybindings**.
+- Ships as a **standalone compiled binary** — no runtime or install step beyond
+  a system audio player.
+
+## Quick start
+
+1. Install PodTui ([Installation](#installation)) and make sure **mpv** is in
+   your `PATH`.
+2. Run `podtui` in your terminal.
+3. Press `3` to open **Discover** (or `4` to open **Search**, then `s`), drill
+   in with `Enter`, and press `Enter` on a show to subscribe.
+4. Press `1` (**Feed**) or `2` (**My Shows**), open an episode with `Enter`,
+   and use `P` to play/pause, `N`/`B` for next/previous, and `shift-.` /
+   `shift-,` to seek.
+
+Press `~` any time for in-app help. All keys are remappable — see
+[Keybindings](#keybindings).
+
+## Requirements
+
+- A terminal with UTF-8 and modern color support (kitty, iTerm2, WezTerm,
+  Ghostty, tmux etc.).
+- **mpv** on `PATH` for audio playback. PodTui drives mpv over JSON IPC, so
+  seek, speed, and position tracking all work. Without `mpv` on `PATH`,
+  playback is a silent no-op (the `none` backend) — see
+  [Troubleshooting](#troubleshooting).
+
+## Installation
+
+PodTui distributes as a **self-contained binary** for macOS (arm64/x64) and
+Linux (arm64/x64). Pick whichever fits your platform.
+
+### 1. Homebrew (macOS)
+
+```sh
+brew install mikefreno/tap/podtui
 ```
 
-To run:
+### 2. Standalone tarball (all platforms)
+
+Grab `podtui-<platform>-<arch>.tar.gz` from the latest
+[GitHub Release](https://github.com/mikefreno/podtui/releases), unpack it, and
+put `podtui` on your `PATH`:
 
 ```bash
-bun dev
+curl -sS -o /tmp/podtui.tar.gz \
+  https://github.com/mikefreno/podtui/releases/latest/download/podtui-linux-x64.tar.gz
+sudo mkdir -p /opt/podtui
+sudo tar -xzf /tmp/podtui.tar.gz -C /opt/podtui --strip-components=1
+sudo ln -sf /opt/podtui/podtui /usr/local/bin/podtui
 ```
 
-This project was created using `bun create tui`. [create-tui](https://git.new/create-tui) is the easiest way to get started with OpenTUI.
+> The tarball contains `podtui` plus `libopentui.<ext>` and
+> `libcavacore.<ext>` **beside it** — keep them together (don't move just the
+> binary alone), or the native FFI libraries won't load.
+
+### 3. Arch Linux (AUR)
+
+```bash
+yay -S podtui-bin   # once published
+```
+
+Requires an AUR helper ([paru](https://github.com/morgan/paru)); the package
+pulls in `mpv` as a dependency.
+
+> **Not yet on the AUR.** The `podtui-bin` package is staged and awaiting
+> publication (AUR account registrations are currently suspended). Until it
+> lands, use the standalone tarball above.
+
+### 4. From source
+
+PodTui is written in TypeScript and runs on [Bun](https://bun.sh). To build
+from source (development, distro packaging, unreleased versions), see
+[CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Usage
+
+Launch `podtui`. Press `~` for the in-app help.
+
+### Command-line flags
+
+| Flag | Description |
+|------|-------------|
+| `-v`, `--version` | Print the version and exit |
+| `-q`, `--query <term>` | Query feeds for a show title and print matching shows, without launching the TUI |
+| `-p`, `--play <term>` | Play the matching show, without launching the TUI |
+
+### Keybindings
+
+All keys are remappable — edit `keybinds.jsonc` in your config directory
+(see [Configuration](#configuration)).
+
+**Movement**
+
+| Keys | Action |
+|------|--------|
+| `j` / `k` (or `down` / `up`) | Move down / up |
+| `J` / `K` | Jump 5 lines down / up |
+| `ctrl-d` / `ctrl-u` | Page down / up |
+| `ctrl-f` / `ctrl-b` | Full page down / up |
+| `gg` / `G` | Go to top / bottom |
+
+**Panes**
+
+| Keys | Action |
+|------|--------|
+| `h` / `l` (or `left` / `right`) | Focus parent pane / preview pane |
+| `Enter` | Open the item under the cursor (a tab, episode, show…) |
+| `shift-enter` | Open with the interactive variant |
+
+**Selection**
+
+| Keys | Action |
+|------|--------|
+| `Space` | Toggle selection |
+| `v` | Visual mode (multi-select) |
+| `ctrl-a` | Select / deselect all |
+| `ctrl-r` | Invert selection |
+| `Esc` | Cancel / escape |
+
+**Tabs**
+
+| Keys | Action |
+|------|--------|
+| `1`–`6` | Jump to tab 1–6 (Feed, My Shows, Discover, Search, Player, Settings) |
+| `[` / `]` | Previous / next tab |
+
+**Commands, help, quit**
+
+| Keys | Action |
+|------|--------|
+| `:` or `q` | Open the command palette (type `q` + `Enter` there to quit) |
+| `Q` or `ctrl-c` | Quit |
+| `~` or `f1` | In-app help |
+
+**Lists**
+
+| Keys | Action |
+|------|--------|
+| `s` | Search |
+| `f` | Filter |
+| `,` | Sort |
+| `.` | Toggle hidden |
+| `r` | Refresh |
+| `x` | Unsubscribe the focused show (My Shows) |
+
+**Audio**
+
+| Keys | Action |
+|------|--------|
+| `P` | Play / pause |
+| `N` / `B` | Next / previous episode |
+| `shift-.` / `shift-,` | Seek forward / backward |
+
+## Configuration
+
+Configuration lives under the XDG config directory — `~/.config/podtui` by
+default (`$XDG_CONFIG_HOME/podtui` if set).
+
+| File | Purpose |
+|------|---------|
+| `config.json` | Unified settings (theme, playback speed, download path), feeds, and custom feed sources |
+| `downloads.json` | Downloaded episode metadata |
+| `keybinds.jsonc` | Keybinding remaps (see above) |
+| `themes/` | Optional custom theme files |
+
+Legacy `feeds.json`, `sources.json`, and `app-state.json` are auto-migrated
+into `config.json` on first run.
+
+Env overrides: `PODTUI_AUDIO_BACKEND`, `XDG_CONFIG_HOME`.
+
+## Troubleshooting
+
+**`preload not found` at startup** — this used to happen when the binary was
+launched from a Bun project directory whose `bunfig.toml` had a `preload`
+entry. Releases are compiled with bunfig autoload disabled
+(`autoloadBunfig: false`), so current binaries ignore the CWD's `bunfig.toml`
+entirely. If you still hit it, you're on an old release — upgrade.
+
+**No audio — playback is a silent no-op** — PodTui needs **mpv** on your
+`PATH`. Install it (`brew install mpv`, `pacman -S mpv`, …) and relaunch.
+
+**Homebrew prints a dylib warning** — “load commands do not fit in the header
+… needs `-headerpad`” is benign: the app loads its libraries by path, the
+install completes, and the app boots normally.
+
+**The app won't start / no spectrum after moving files** — `podtui` loads its
+two native libraries relative to the binary, so keep `podtui`,
+`libopentui.*`, and `libcavacore.*` together in the same directory (the
+tarball unpacks them side by side).
+
+## Building from source / contributing
+
+Development setup, the test suite, packaging, and the release process are
+documented in [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Related
+
+- [OpenTUI](https://github.com/opentui/opentui) — the TUI framework driving the interface

build.ts

@@ -1,62 +1,135 @@
-import solidPlugin from "@opentui/solid/bun-plugin"
-import { copyFileSync, existsSync, mkdirSync } from "node:fs"
-import { join, dirname } from "node:path"
+import solidPlugin from "@opentui/solid/bun-plugin";
+import { copyFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { plugin } from "bun";
+
+// Register the solid transform globally (dedup'd by name). This is what makes
+// `--compile` work: compile-mode builds only apply `onLoad` transform plugins
+// that are registered via `plugin()`, not the `plugins:` array. The transform
+// is fully embedded in the compiled binary.
+plugin(solidPlugin);
+
+const COMPILE =
+	process.argv.includes("--compile") || process.env.PODTUI_COMPILE === "1";
+
+const platform = process.platform;
+const arch = process.arch;
+
+// Platform/arch → OpenTUI package name
+const platformMap: Record<string, string> = {
+	"darwin-arm64": "darwin-arm64",
+	"darwin-x64": "darwin-x64",
+	"linux-x64": "linux-x64",
+	"linux-arm64": "linux-arm64",
+	"win32-x64": "win32-x64",
+	"win32-arm64": "win32-arm64",
+};
+
+const libExt =
+	platform === "win32" ? "dll" : platform === "darwin" ? "dylib" : "so";
 
 // Build the JavaScript bundle
 await Bun.build({
-  entrypoints: ["./src/index.tsx"],
-  outdir: "./dist",
-  target: "bun",
-  minify: true,
-  sourcemap: "external",
-  plugins: [solidPlugin],
-})
+	entrypoints: ["./src/index.tsx"],
+	outdir: "./dist",
+	target: "bun",
+	minify: true,
+	sourcemap: "external",
+	plugins: [solidPlugin],
+});
 
-// Copy the native library to dist for distribution
-const platform = process.platform
-const arch = process.arch
-
-// Map platform/arch to OpenTUI package names
-const platformMap: Record<string, string> = {
-  "darwin-arm64": "darwin-arm64",
-  "darwin-x64": "darwin-x64",
-  "linux-x64": "linux-x64",
-  "linux-arm64": "linux-arm64",
-  "win32-x64": "win32-x64",
-  "win32-arm64": "win32-arm64",
-}
-
-const platformKey = `${platform}-${arch}`
-const platformPkg = platformMap[platformKey]
+// Copy the opentui native library to dist for distribution.
+const platformKey = `${platform}-${arch}`;
+const platformPkg = platformMap[platformKey];
 
 if (platformPkg) {
-  const libName = platform === "win32"
-    ? "opentui.dll"
-    : platform === "darwin"
-      ? "libopentui.dylib"
-      : "libopentui.so"
-  const srcPath = join("node_modules", `@opentui/core-${platformPkg}`, libName)
-  
-  if (existsSync(srcPath)) {
-    const destPath = join("dist", libName)
-    copyFileSync(srcPath, destPath)
-    console.log(`Copied native library: ${libName}`)
-  }
+	const libName = `libopentui.${libExt}`;
+	const srcPath = join("node_modules", `@opentui/core-${platformPkg}`, libName);
+
+	if (existsSync(srcPath)) {
+		const destPath = join("dist", libName);
+		copyFileSync(srcPath, destPath);
+		console.log(`Copied native library: ${libName}`);
+	}
 }
 
 // Copy cavacore native library to dist
-const cavacoreLib = platform === "darwin"
-  ? "libcavacore.dylib"
-  : platform === "win32"
-    ? "cavacore.dll"
-    : "libcavacore.so"
-const cavacoreSrc = join("src", "native", cavacoreLib)
+const cavacoreLib = `libcavacore.${libExt}`;
+const cavacoreSrc = join("src", "native", cavacoreLib);
 
 if (existsSync(cavacoreSrc)) {
-  copyFileSync(cavacoreSrc, join("dist", cavacoreLib))
-  console.log(`Copied cavacore library: ${cavacoreLib}`)
+	copyFileSync(cavacoreSrc, join("dist", cavacoreLib));
+	console.log(`Copied cavacore library: ${cavacoreLib}`);
 } else {
-  console.warn(`Warning: ${cavacoreSrc} not found — run scripts/build-cavacore.sh first`)
+	console.warn(
+		`Warning: ${cavacoreSrc} not found — run scripts/build-cavacore.sh first`,
+	);
 }
 
-console.log("Build complete")
+// ── Standalone compiled binary (dist/podtui + libs beside it) ──────────────
+// `bun run build.ts --compile` (or PODTUI_COMPILE=1). Embeds the Bun runtime
+// so end users need nothing installed; the two FFI libs are shipped as
+// SIBLING FILES next to the binary (both loaders already resolve them that
+// way: cavacore checks dirname(process.execPath); opentui embeds via its
+// bun-plugin and handles the embedded-file path itself).
+if (COMPILE) {
+	const outfile = join("dist", "podtui");
+	await Bun.build({
+		entrypoints: ["./src/index.tsx"],
+		target: "bun",
+		minify: true,
+		sourcemap: "external",
+		plugins: [solidPlugin],
+		compile: {
+			outfile,
+			// Don't let the embedded runtime autoload the launching CWD's
+			// bunfig.toml. A top-level `preload` there (common in Bun project
+			// dirs) resolves against the CWD, not the binary, so startup dies
+			// with "preload not found". With autoload disabled, the binary is
+			// config-independent and boots from any directory.
+			autoloadBunfig: false,
+		},
+	});
+	console.log(`Compiled standalone binary: ${outfile}`);
+
+	// Ensure both native libs sit beside the binary.
+	const opentuiSrc = join(
+		"node_modules",
+		`@opentui/core-${platformPkg}`,
+		`libopentui.${libExt}`,
+	);
+	if (existsSync(opentuiSrc)) {
+		copyFileSync(opentuiSrc, join("dist", `libopentui.${libExt}`));
+	}
+	if (!existsSync(join("dist", cavacoreLib))) {
+		console.warn(
+			`Warning: ${cavacoreLib} missing beside the binary — run scripts/build-cavacore.sh`,
+		);
+	}
+
+	// Tarball: podtui + the two native libs (drop the JS bundle dir)
+	const tarRoot = join("dist", `podtui-${platform}-${arch}`);
+	rmSync(tarRoot, { recursive: true, force: true });
+	mkdirSync(tarRoot, { recursive: true });
+	copyFileSync(outfile, join(tarRoot, "podtui"));
+	for (const lib of [`libopentui.${libExt}`, cavacoreLib]) {
+		const s = join("dist", lib);
+		if (existsSync(s)) copyFileSync(s, join(tarRoot, lib));
+	}
+	const tar = Bun.spawnSync([
+		"tar",
+		"-czf",
+		`${tarRoot}.tar.gz`,
+		"-C",
+		"dist",
+		`podtui-${platform}-${arch}`,
+	]);
+	if (tar.exitCode !== 0) {
+		console.error(tar.stderr.toString());
+		process.exit(1);
+	}
+	console.log(`Tarball: ${tarRoot}.tar.gz`);
+	rmSync(tarRoot, { recursive: true, force: true });
+}
+
+console.log("Build complete");

bunfig.toml

@@ -1,4 +1,8 @@
-preload = ["@opentui/solid/preload"]
+# No top-level `preload` here — dev/test get the solid JSX transform via the
+# explicit `--preload` flags in package.json and the [test] section below.
+# Releases don't read this file at all: build.ts compiles the standalone with
+# `autoloadBunfig: false`, so its embedded runtime ignores any bunfig.toml in
+# the launching directory — no more "preload not found" from CWD bunfigs.
 
 [test]
 preload = "@opentui/solid/preload"

cava/LICENSE-cava.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2015 Karl Stavestrand <karl@stavestrand.no>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cava/cavacore.c

@@ -0,0 +1,588 @@
+#include "cavacore.h"
+#ifndef M_PI
+#define M_PI 3.1415926535897932385
+#endif
+#include <fftw3.h>
+#include <math.h>
+#include <stdlib.h>
+#include <string.h>
+#ifdef __ANDROID__
+#include <jni.h>
+struct cava_plan *plan;
+double *cava_in;
+double *cava_out;
+#endif
+
+static double amplitude_to_decibels(double value) {
+    // Magic number 20 comes from converting amplitude ratios to decibels.
+    return 20 * log10(value);
+}
+
+struct cava_plan *cava_init(int number_of_bars, unsigned int rate, int channels, int autosens,
+                            double noise_reduction, int low_cut_off, int high_cut_off,
+                            int scaling_mode) {
+    struct cava_plan *p = malloc(sizeof(struct cava_plan));
+    p->status = 0;
+
+    // sanity checks:
+    if (channels < 1 || channels > 2) {
+        snprintf(p->error_message, 1024,
+                 "cava_init called with illegal number of channels: %d, number of channels "
+                 "supported are "
+                 "1 and 2",
+                 channels);
+        p->status = -1;
+        return p;
+    }
+    if (rate < 1 || rate > 384000) {
+        snprintf(p->error_message, 1024, "cava_init called with illegal sample rate: %d\n", rate);
+        p->status = -1;
+        return p;
+    }
+
+    int fft_buffer_size = 512;
+
+    if (rate > 8125 && rate <= 16250)
+        fft_buffer_size *= 2;
+    else if (rate > 16250 && rate <= 32500)
+        fft_buffer_size *= 4;
+    else if (rate > 32500 && rate <= 75000)
+        fft_buffer_size *= 8;
+    else if (rate > 75000 && rate <= 150000)
+        fft_buffer_size *= 16;
+    else if (rate > 150000 && rate <= 300000)
+        fft_buffer_size *= 32;
+    else if (rate > 300000)
+        fft_buffer_size *= 64;
+
+    if (number_of_bars < 1) {
+        snprintf(p->error_message, 1024,
+                 "cava_init called with illegal number of bars: %d, number of channels must be "
+                 "positive integer\n",
+                 number_of_bars);
+        p->status = -1;
+        return p;
+    }
+
+    if (number_of_bars > fft_buffer_size / 2 + 1) {
+        snprintf(p->error_message, 1024,
+                 "cava_init called with illegal number of bars: %d, for %d sample rate number of "
+                 "bars can't be more than %d\n",
+                 number_of_bars, rate, fft_buffer_size / 2 + 1);
+        p->status = -1;
+        return p;
+    }
+    if (low_cut_off < 1 || high_cut_off < 1) {
+        snprintf(p->error_message, 1024, "low_cut_off must be a positive value\n");
+        p->status = -1;
+        return p;
+    }
+    if (low_cut_off >= high_cut_off) {
+        snprintf(p->error_message, 1024, "high_cut_off must be a higher than low_cut_off\n");
+        p->status = -1;
+        return p;
+    }
+    if ((unsigned int)high_cut_off > rate / 2) {
+        snprintf(p->error_message, 1024,
+                 "high_cut_off can't be higher than sample rate / 2. (Nyquist Sampling Theorem)\n");
+        p->status = -1;
+        return p;
+    }
+    if (scaling_mode != CAVA_SCALING_LINEAR && scaling_mode != CAVA_SCALING_DECIBEL) {
+        snprintf(p->error_message, 1024, "unknown scaling mode: %d\n", scaling_mode);
+        p->status = -1;
+        return p;
+    }
+
+    p->number_of_bars = number_of_bars;
+    p->audio_channels = channels;
+    p->rate = rate;
+    p->autosens = 1;
+    p->sens_init = 1;
+    p->sens = 1.0;
+    p->autosens = autosens;
+    p->framerate = 75;
+    p->frame_skip = 1;
+    p->noise_reduction = noise_reduction;
+    p->scaling_mode = scaling_mode;
+
+    int fftw_flag = FFTW_MEASURE;
+#ifdef __ANDROID__
+    fftw_flag = FFTW_ESTIMATE;
+#endif
+
+    p->FFTbassbufferSize = fft_buffer_size * 2;
+    p->FFTbufferSize = fft_buffer_size;
+
+    p->input_buffer_size = p->FFTbassbufferSize * channels;
+
+    p->input_buffer = (double *)malloc(p->input_buffer_size * sizeof(double));
+
+    p->FFTbuffer_lower_cut_off = (int *)malloc((number_of_bars + 1) * sizeof(int));
+    p->FFTbuffer_upper_cut_off = (int *)malloc((number_of_bars + 1) * sizeof(int));
+    p->eq = (double *)malloc((number_of_bars + 1) * sizeof(double));
+    p->cut_off_frequency = (float *)malloc((number_of_bars + 1) * sizeof(float));
+
+    p->cava_fall = (double *)malloc(number_of_bars * channels * sizeof(double));
+    p->cava_mem = (double *)malloc(number_of_bars * channels * sizeof(double));
+    p->cava_peak = (double *)malloc(number_of_bars * channels * sizeof(double));
+    p->prev_cava_out = (double *)malloc(number_of_bars * channels * sizeof(double));
+
+    // Hann Window calculate multipliers
+    p->bass_multiplier = (double *)malloc(p->FFTbassbufferSize * sizeof(double));
+    p->multiplier = (double *)malloc(p->FFTbufferSize * sizeof(double));
+    for (int i = 0; i < p->FFTbassbufferSize; i++) {
+        p->bass_multiplier[i] = 0.5 * (1 - cos(2 * M_PI * i / (p->FFTbassbufferSize - 1)));
+    }
+    for (int i = 0; i < p->FFTbufferSize; i++) {
+        p->multiplier[i] = 0.5 * (1 - cos(2 * M_PI * i / (p->FFTbufferSize - 1)));
+    }
+
+    // BASS
+    p->in_bass_l = fftw_alloc_real(p->FFTbassbufferSize);
+    p->in_bass_l_raw = fftw_alloc_real(p->FFTbassbufferSize);
+    p->out_bass_l = fftw_alloc_complex(p->FFTbassbufferSize / 2 + 1);
+    p->p_bass_l =
+        fftw_plan_dft_r2c_1d(p->FFTbassbufferSize, p->in_bass_l, p->out_bass_l, fftw_flag);
+
+    // MID + TREBLE
+    p->in_l = fftw_alloc_real(p->FFTbufferSize);
+    p->in_l_raw = fftw_alloc_real(p->FFTbufferSize);
+    p->out_l = fftw_alloc_complex(p->FFTbufferSize / 2 + 1);
+    p->p_l = fftw_plan_dft_r2c_1d(p->FFTbufferSize, p->in_l, p->out_l, fftw_flag);
+
+    memset(p->in_bass_l, 0, sizeof(double) * p->FFTbassbufferSize);
+    memset(p->in_l, 0, sizeof(double) * p->FFTbufferSize);
+    memset(p->in_bass_l_raw, 0, sizeof(double) * p->FFTbassbufferSize);
+    memset(p->in_l_raw, 0, sizeof(double) * p->FFTbufferSize);
+    memset(p->out_bass_l, 0, (p->FFTbassbufferSize / 2 + 1) * sizeof(fftw_complex));
+    memset(p->out_l, 0, (p->FFTbufferSize / 2 + 1) * sizeof(fftw_complex));
+    if (p->audio_channels == 2) {
+        // BASS
+        p->in_bass_r = fftw_alloc_real(p->FFTbassbufferSize);
+        p->in_bass_r_raw = fftw_alloc_real(p->FFTbassbufferSize);
+        p->out_bass_r = fftw_alloc_complex(p->FFTbassbufferSize / 2 + 1);
+        p->p_bass_r =
+            fftw_plan_dft_r2c_1d(p->FFTbassbufferSize, p->in_bass_r, p->out_bass_r, fftw_flag);
+
+        // MID + TREBLE
+        p->in_r = fftw_alloc_real(p->FFTbufferSize);
+        p->in_r_raw = fftw_alloc_real(p->FFTbufferSize);
+        p->out_r = fftw_alloc_complex(p->FFTbufferSize / 2 + 1);
+
+        p->p_r = fftw_plan_dft_r2c_1d(p->FFTbufferSize, p->in_r, p->out_r, fftw_flag);
+
+        memset(p->in_bass_r, 0, sizeof(double) * p->FFTbassbufferSize);
+        memset(p->in_r, 0, sizeof(double) * p->FFTbufferSize);
+        memset(p->in_bass_r_raw, 0, sizeof(double) * p->FFTbassbufferSize);
+        memset(p->in_r_raw, 0, sizeof(double) * p->FFTbufferSize);
+        memset(p->out_bass_r, 0, (p->FFTbassbufferSize / 2 + 1) * sizeof(fftw_complex));
+        memset(p->out_r, 0, (p->FFTbufferSize / 2 + 1) * sizeof(fftw_complex));
+    }
+
+    memset(p->input_buffer, 0, sizeof(double) * p->input_buffer_size);
+
+    memset(p->cava_fall, 0, sizeof(double) * number_of_bars * channels);
+    memset(p->cava_mem, 0, sizeof(double) * number_of_bars * channels);
+    memset(p->cava_peak, 0, sizeof(double) * number_of_bars * channels);
+    memset(p->prev_cava_out, 0, sizeof(double) * number_of_bars * channels);
+
+    // process: calculate cutoff frequencies and eq
+    int lower_cut_off = low_cut_off;
+    int upper_cut_off = high_cut_off;
+    int bass_cut_off = 100;
+
+    // calculate frequency constant (used to distribute bars across the frequency band)
+    double frequency_constant = log10((float)lower_cut_off / (float)upper_cut_off) /
+                                (1 / ((float)p->number_of_bars + 1) - 1);
+
+    float *relative_cut_off = (float *)malloc((p->number_of_bars + 1) * sizeof(float));
+
+    p->bass_cut_off_bar = 0;
+    int first_bar = 1;
+
+    float min_bandwidth = p->rate / p->FFTbassbufferSize;
+
+    for (int n = 0; n < p->number_of_bars + 1; n++) {
+        double bar_distribution_coefficient = frequency_constant * (-1);
+        bar_distribution_coefficient +=
+            ((float)n + 1) / ((float)p->number_of_bars + 1) * frequency_constant;
+        p->cut_off_frequency[n] = upper_cut_off * pow(10, bar_distribution_coefficient);
+
+        if (n > 0) {
+            if (p->cut_off_frequency[n - 1] >= p->cut_off_frequency[n])
+                p->cut_off_frequency[n] = p->cut_off_frequency[n - 1] + min_bandwidth;
+        }
+
+        // remember nyquist!
+        relative_cut_off[n] = p->cut_off_frequency[n] / (p->rate / 2);
+
+        if (p->cut_off_frequency[n] < bass_cut_off) {
+            // BASS
+            p->FFTbuffer_lower_cut_off[n] = relative_cut_off[n] * (p->FFTbassbufferSize / 2);
+            p->bass_cut_off_bar++;
+            if (p->bass_cut_off_bar > 1)
+                first_bar = 0;
+
+            if (p->FFTbuffer_lower_cut_off[n] > p->FFTbassbufferSize / 2) {
+                p->FFTbuffer_lower_cut_off[n] = p->FFTbassbufferSize / 2;
+            }
+        } else {
+            // MID + TREBLE
+            p->FFTbuffer_lower_cut_off[n] =
+                ceil(relative_cut_off[n] * (float)(p->FFTbufferSize / 2));
+            if (n == p->bass_cut_off_bar) {
+                first_bar = 1;
+                if (n > 0) {
+                    p->FFTbuffer_upper_cut_off[n - 1] =
+                        relative_cut_off[n] * (p->FFTbassbufferSize / 2) - 1;
+                }
+            } else {
+                first_bar = 0;
+            }
+
+            if (p->FFTbuffer_lower_cut_off[n] > p->FFTbufferSize / 2) {
+                p->FFTbuffer_lower_cut_off[n] = p->FFTbufferSize / 2;
+            }
+        }
+
+        if (n > 0) {
+            if (!first_bar) {
+                p->FFTbuffer_upper_cut_off[n - 1] = p->FFTbuffer_lower_cut_off[n] - 1;
+
+                // pushing the spectrum up if the exponential function gets "clumped" in the
+                // bass and calculating new cut off frequencies
+                if (p->FFTbuffer_lower_cut_off[n] <= p->FFTbuffer_lower_cut_off[n - 1]) {
+
+                    // check if there is room for more first
+                    int room_for_more = 0;
+
+                    if (n < p->bass_cut_off_bar) {
+                        if (p->FFTbuffer_lower_cut_off[n - 1] + 1 < p->FFTbassbufferSize / 2 + 1)
+                            room_for_more = 1;
+                    } else {
+                        if (p->FFTbuffer_lower_cut_off[n - 1] + 1 < p->FFTbufferSize / 2 + 1)
+                            room_for_more = 1;
+                    }
+
+                    if (room_for_more) {
+                        // push the spectrum up
+                        p->FFTbuffer_lower_cut_off[n] = p->FFTbuffer_lower_cut_off[n - 1] + 1;
+                        p->FFTbuffer_upper_cut_off[n - 1] = p->FFTbuffer_lower_cut_off[n] - 1;
+                    }
+                }
+            } else {
+                if (p->FFTbuffer_upper_cut_off[n - 1] < p->FFTbuffer_lower_cut_off[n - 1])
+                    p->FFTbuffer_upper_cut_off[n - 1] = p->FFTbuffer_lower_cut_off[n - 1] + 1;
+            }
+        }
+        // calculate actual cut off frequency
+        if (n < p->bass_cut_off_bar)
+            relative_cut_off[n] =
+                (float)(p->FFTbuffer_lower_cut_off[n]) / ((float)p->FFTbassbufferSize / 2);
+        else
+            relative_cut_off[n] =
+                (float)(p->FFTbuffer_lower_cut_off[n]) / ((float)p->FFTbufferSize / 2);
+
+        p->cut_off_frequency[n] = relative_cut_off[n] * ((float)p->rate / 2);
+    }
+
+    // hard coded eq
+    for (int n = 0; n < p->number_of_bars; n++) {
+
+        // the numbers that come out of the FFT are very high
+        // the EQ is used to "normalize" them by dividing with this very huge number
+        p->eq[n] = 1 / pow(2, 28);
+
+        // need to boost the EQ for higher frequencies
+        p->eq[n] *= pow(p->cut_off_frequency[n + 1], 0.85);
+
+        if (n < p->bass_cut_off_bar) {
+            p->eq[n] /= log2(p->FFTbassbufferSize);
+        } else {
+            p->eq[n] /= log2(p->FFTbufferSize);
+        }
+
+        p->eq[n] /= p->FFTbuffer_upper_cut_off[n] - p->FFTbuffer_lower_cut_off[n] + 1;
+    }
+    free(relative_cut_off);
+    return p;
+}
+
+void cava_execute(double *cava_in, int new_samples, double *cava_out, struct cava_plan *p) {
+
+    // do not overflow
+    if (new_samples > p->input_buffer_size) {
+        new_samples = p->input_buffer_size;
+    }
+
+    int silence = 1;
+    if (new_samples > 0) {
+        // process: approximate actual framerate. This will be off by +10% at 60 fps, but should be
+        // good enough for the autosens and smoothing algorithms to be adjusted accordingly if
+        // framerate is a lot more or less.
+        p->framerate -= p->framerate / 64.0;
+        p->framerate +=
+            (double)(p->rate * p->frame_skip) / (new_samples / p->audio_channels) / 64.0;
+        p->frame_skip = 1;
+
+        // shifting input buffer
+        for (int n = p->input_buffer_size - 1; n >= new_samples; n--) {
+            p->input_buffer[n] = p->input_buffer[n - new_samples];
+        }
+
+        // fill the input buffer
+        for (int n = 0; n < new_samples; n++) {
+            if (p->scaling_mode == CAVA_SCALING_DECIBEL) {
+                // Audio signals come in the range [-32768, 32768], normalize to [-1, 1].
+                p->input_buffer[new_samples - n - 1] = cava_in[n] / 32768.0;
+            } else {
+                p->input_buffer[new_samples - n - 1] = cava_in[n];
+            }
+            if (cava_in[n]) {
+                silence = 0;
+            }
+        }
+    } else {
+        p->frame_skip++;
+    }
+
+    // fill the bass, mid and treble buffers
+    for (int n = 0; n < p->FFTbassbufferSize; n++) {
+        if (p->audio_channels == 2) {
+            p->in_bass_r_raw[n] = p->input_buffer[n * 2];
+            p->in_bass_l_raw[n] = p->input_buffer[n * 2 + 1];
+        } else {
+            p->in_bass_l_raw[n] = p->input_buffer[n];
+        }
+    }
+    for (int n = 0; n < p->FFTbufferSize; n++) {
+        if (p->audio_channels == 2) {
+            p->in_r_raw[n] = p->input_buffer[n * 2];
+            p->in_l_raw[n] = p->input_buffer[n * 2 + 1];
+        } else {
+            p->in_l_raw[n] = p->input_buffer[n];
+        }
+    }
+
+    // Hann Window
+    for (int i = 0; i < p->FFTbassbufferSize; i++) {
+        p->in_bass_l[i] = p->bass_multiplier[i] * p->in_bass_l_raw[i];
+        if (p->audio_channels == 2)
+            p->in_bass_r[i] = p->bass_multiplier[i] * p->in_bass_r_raw[i];
+    }
+    for (int i = 0; i < p->FFTbufferSize; i++) {
+        p->in_l[i] = p->multiplier[i] * p->in_l_raw[i];
+        if (p->audio_channels == 2)
+            p->in_r[i] = p->multiplier[i] * p->in_r_raw[i];
+    }
+
+    // process: execute FFT and sort frequency bands
+
+    fftw_execute(p->p_bass_l);
+    fftw_execute(p->p_l);
+    if (p->audio_channels == 2) {
+        fftw_execute(p->p_bass_r);
+        fftw_execute(p->p_r);
+    }
+
+    // process: separate frequency bands
+    for (int n = 0; n < p->number_of_bars; n++) {
+
+        double temp_l = 0;
+        double temp_r = 0;
+
+        // process: add upp FFT values within bands
+        for (int i = p->FFTbuffer_lower_cut_off[n]; i <= p->FFTbuffer_upper_cut_off[n]; i++) {
+
+            if (n < p->bass_cut_off_bar) {
+                temp_l += hypot(p->out_bass_l[i][0], p->out_bass_l[i][1]);
+                if (p->audio_channels == 2)
+                    temp_r += hypot(p->out_bass_r[i][0], p->out_bass_r[i][1]);
+
+            } else {
+                temp_l += hypot(p->out_l[i][0], p->out_l[i][1]);
+                if (p->audio_channels == 2)
+                    temp_r += hypot(p->out_r[i][0], p->out_r[i][1]);
+            }
+        }
+
+        // getting average and applying configured scaling
+        if (p->scaling_mode == CAVA_SCALING_DECIBEL) {
+            const double max_db = 70;
+            temp_l = amplitude_to_decibels(temp_l) / max_db;
+            if (!isfinite(temp_l)) {
+                temp_l = 0;
+            }
+        } else {
+            temp_l *= p->eq[n];
+        }
+        cava_out[n] = temp_l;
+
+        if (p->audio_channels == 2) {
+            if (p->scaling_mode == CAVA_SCALING_DECIBEL) {
+                const double max_db = 70;
+                temp_r = amplitude_to_decibels(temp_r) / max_db;
+                if (!isfinite(temp_r)) {
+                    temp_r = 0;
+                }
+            } else {
+                temp_r *= p->eq[n];
+            }
+            cava_out[n + p->number_of_bars] = temp_r;
+        }
+    }
+
+    // applying sens or getting max value
+    if (p->autosens) {
+        for (int n = 0; n < p->number_of_bars * p->audio_channels; n++) {
+            cava_out[n] *= p->sens;
+        }
+    }
+    // process [smoothing]
+    int overshoot = 0;
+
+    double framerate_mod = 66 / p->framerate;
+    double gravity_mod = pow((framerate_mod), 2.5) * 2 / p->noise_reduction;
+    double integral_mod = pow((framerate_mod), 0.1);
+
+    for (int n = 0; n < p->number_of_bars * p->audio_channels; n++) {
+
+        // process [smoothing]: falloff
+
+        if (cava_out[n] < p->prev_cava_out[n] && p->noise_reduction > 0.1) {
+            cava_out[n] =
+                p->cava_peak[n] * (1.0 - (p->cava_fall[n] * p->cava_fall[n] * gravity_mod));
+
+            if (cava_out[n] < 0.0)
+                cava_out[n] = 0.0;
+            p->cava_fall[n] += 0.028;
+        } else {
+            p->cava_peak[n] = cava_out[n];
+            p->cava_fall[n] = 0.0;
+        }
+        p->prev_cava_out[n] = cava_out[n];
+
+        // process [smoothing]: integral
+        cava_out[n] = p->cava_mem[n] * p->noise_reduction / integral_mod + cava_out[n];
+
+        p->cava_mem[n] = cava_out[n];
+        if (p->autosens) {
+            // check if we overshoot target height
+            if (cava_out[n] > 1.0) {
+                overshoot = 1;
+                cava_out[n] = 1.0;
+            }
+        }
+    }
+
+    // calculating automatic sense adjustment
+    if (p->autosens) {
+        if (overshoot) {
+            p->sens = p->sens * (1 - (0.02 * framerate_mod));
+            p->sens_init = 0;
+        } else {
+            if (!silence) {
+                p->sens = p->sens * (1 + (0.001 * framerate_mod * p->autosens));
+                if (p->sens_init)
+                    p->sens = p->sens * (1 + (0.1 * framerate_mod));
+            }
+        }
+    }
+}
+
+void cava_destroy(struct cava_plan *p) {
+
+    free(p->input_buffer);
+    free(p->bass_multiplier);
+    free(p->multiplier);
+    free(p->eq);
+    free(p->cut_off_frequency);
+    free(p->FFTbuffer_lower_cut_off);
+    free(p->FFTbuffer_upper_cut_off);
+    free(p->cava_fall);
+    free(p->cava_mem);
+    free(p->cava_peak);
+    free(p->prev_cava_out);
+
+    fftw_free(p->in_bass_l);
+    fftw_free(p->in_bass_l_raw);
+    fftw_free(p->out_bass_l);
+    fftw_destroy_plan(p->p_bass_l);
+
+    fftw_free(p->in_l);
+    fftw_free(p->in_l_raw);
+    fftw_free(p->out_l);
+    fftw_destroy_plan(p->p_l);
+
+    if (p->audio_channels == 2) {
+        fftw_free(p->in_bass_r);
+        fftw_free(p->in_bass_r_raw);
+        fftw_free(p->out_bass_r);
+        fftw_destroy_plan(p->p_bass_r);
+
+        fftw_free(p->in_r);
+        fftw_free(p->out_r);
+        fftw_free(p->in_r_raw);
+        fftw_destroy_plan(p->p_r);
+    }
+}
+
+#ifdef __ANDROID__
+JNIEXPORT jfloatArray JNICALL Java_com_karlstav_cava_MyGLRenderer_InitCava(
+    JNIEnv *env, jobject thiz, jint number_of_bars_set, jint refresh_rate, jint lower_cut_off,
+    jint higher_cut_off) {
+    jfloatArray cuttOffFreq = (*env)->NewFloatArray(env, number_of_bars_set + 1);
+    float noise_reduction = pow((float)refresh_rate / 130, 0.75);
+
+    plan = cava_init(number_of_bars_set, 44100, 1, 1, noise_reduction, lower_cut_off,
+                     higher_cut_off, CAVA_SCALING_LINEAR);
+    cava_in = (double *)malloc(plan->FFTbassbufferSize * sizeof(double));
+    cava_out = (double *)malloc(plan->number_of_bars * sizeof(double));
+    (*env)->SetFloatArrayRegion(env, cuttOffFreq, 0, plan->number_of_bars + 1,
+                                plan->cut_off_frequency);
+    return cuttOffFreq;
+}
+
+JNIEXPORT jdoubleArray JNICALL Java_com_karlstav_cava_MyGLRenderer_ExecCava(JNIEnv *env,
+                                                                            jobject thiz,
+                                                                            jdoubleArray cava_input,
+                                                                            jint new_samples) {
+
+    jdoubleArray cavaReturn = (*env)->NewDoubleArray(env, plan->number_of_bars);
+
+    cava_in = (*env)->GetDoubleArrayElements(env, cava_input, NULL);
+
+    cava_execute(cava_in, new_samples, cava_out, plan);
+    (*env)->SetDoubleArrayRegion(env, cavaReturn, 0, plan->number_of_bars, cava_out);
+    (*env)->ReleaseDoubleArrayElements(env, cava_input, cava_in, JNI_ABORT);
+
+    return cavaReturn;
+}
+
+JNIEXPORT int JNICALL Java_com_karlstav_cava_CavaCoreTest_InitCava(JNIEnv *env, jobject thiz,
+                                                                   jint number_of_bars_set) {
+
+    plan = cava_init(number_of_bars_set, 44100, 1, 1, 0.7, 50, 10000, CAVA_SCALING_LINEAR);
+    return 1;
+}
+
+JNIEXPORT jdoubleArray JNICALL Java_com_karlstav_cava_CavaCoreTest_ExecCava(JNIEnv *env,
+                                                                            jobject thiz,
+                                                                            jdoubleArray cava_input,
+                                                                            jint new_samples) {
+
+    jdoubleArray cavaReturn = (*env)->NewDoubleArray(env, plan->number_of_bars);
+
+    cava_in = (*env)->GetDoubleArrayElements(env, cava_input, NULL);
+
+    cava_execute(cava_in, new_samples, cava_out, plan);
+    (*env)->SetDoubleArrayRegion(env, cavaReturn, 0, plan->number_of_bars, cava_out);
+    (*env)->ReleaseDoubleArrayElements(env, cava_input, cava_in, JNI_ABORT);
+
+    return cavaReturn;
+}
+JNIEXPORT void JNICALL Java_com_karlstav_cava_MyGLRenderer_DestroyCava(JNIEnv *env, jobject thiz) {
+    cava_destroy(plan);
+}
+#endif

cava/cavacore.h

@@ -0,0 +1,139 @@
+/*
+Copyright (c) 2022 Karl Stavestrand <karl@stavestrand.no>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+*/
+#ifdef __cplusplus
+extern "C" {
+#endif
+#pragma once
+#include <stdint.h>
+
+#include <fftw3.h>
+
+#define CAVA_SCALING_LINEAR 0
+#define CAVA_SCALING_DECIBEL 1
+
+// cava_plan, parameters used internally by cavacore, do not modify these directly
+// only the cut off frequencies is of any potential interest to read out,
+// the rest should most likely be hidden somehow
+struct cava_plan {
+    int FFTbassbufferSize;
+    int FFTbufferSize;
+    int number_of_bars;
+    int audio_channels;
+    int input_buffer_size;
+    int rate;
+    int bass_cut_off_bar;
+    int sens_init;
+    int autosens;
+    int frame_skip;
+    int status;
+    int scaling_mode;
+    char error_message[1024];
+
+    double sens;
+    double framerate;
+    double noise_reduction;
+
+    fftw_plan p_bass_l, p_bass_r;
+    fftw_plan p_l, p_r;
+
+    fftw_complex *out_bass_l, *out_bass_r;
+    fftw_complex *out_l, *out_r;
+
+    double *bass_multiplier;
+    double *multiplier;
+
+    double *in_bass_r_raw, *in_bass_l_raw;
+    double *in_r_raw, *in_l_raw;
+    double *in_bass_r, *in_bass_l;
+    double *in_r, *in_l;
+    double *prev_cava_out, *cava_mem;
+    double *input_buffer, *cava_peak;
+
+    double *eq;
+
+    float *cut_off_frequency;
+    int *FFTbuffer_lower_cut_off;
+    int *FFTbuffer_upper_cut_off;
+    double *cava_fall;
+};
+
+// cava_init, initialize visualization, takes the following parameters:
+
+// number_of_bars, number of wanted bars per channel
+
+// rate, sample rate of input signal
+
+// channels, number of interleaved channels in input
+
+// autosens, toggle automatic sensitivity adjustment 1 = on, 0 = off
+// on, gives a dynamically adjusted output signal from 0 to 1
+// the output is continuously adjusted to use the entire range
+// off, will pass the raw values from cava directly to the output
+// the max values will then be dependent on the input
+
+// noise_reduction, adjust noise reduction filters. 0 - 1, recommended 0.77
+// the raw visualization is very noisy, this factor adjusts the integral
+// and gravity filters inside cavacore to keep the signal smooth
+// 1 will be very slow and smooth, 0 will be fast but noisy.
+
+// low_cut_off, high_cut_off cut off frequencies for visualization in Hz
+// recommended: 50, 10000
+
+// scaling_mode, output scaling mode:
+// CAVA_SCALING_LINEAR = legacy linear scaling
+// CAVA_SCALING_DECIBEL = dB-based logarithmic scaling
+
+// returns a cava_plan to be used by cava_execute. If cava_plan.status is 0 all is OK.
+// If cava_plan.status is -1, cava_init was called with an illegal parameter, see error string in
+// cava_plan.error_message
+extern struct cava_plan *cava_init(int number_of_bars, unsigned int rate, int channels,
+                                   int autosens, double noise_reduction, int low_cut_off,
+                                   int high_cut_off, int scaling_mode);
+
+// cava_execute, executes visualization
+
+// cava_in, input buffer can be any size. internal buffers in cavacore is
+// 4096 * number of channels at 44100 samples rate, if new_samples is greater
+// then samples will be discarded. However it is recommended to use less
+// new samples per execution as this determines your framerate.
+// 512 samples at 44100 sample rate mono, gives about 86 frames per second.
+
+// new_samples, the number of samples in cava_in to be processed per execution
+// in case of async reading of data this number is allowed to vary from execution to execution
+
+// cava_out, output buffer. Size must be number of bars * number of channels. Bars will
+// be sorted from lowest to highest frequency. If stereo input channels are configured
+// then all left channel bars will be first then the right.
+
+// plan, the cava_plan struct returned from cava_init
+
+// cava_execute assumes cava_in samples to be interleaved if more than one channel
+// only up to two channels are supported.
+extern void cava_execute(double *cava_in, int new_samples, double *cava_out,
+                         struct cava_plan *plan);
+
+// cava_destroy, destroys the plan, frees up memory
+extern void cava_destroy(struct cava_plan *plan);
+
+#ifdef __cplusplus
+}
+#endif

discover/featured.json

@@ -0,0 +1,547 @@
+{
+  "version": 3,
+  "podcasts": [
+    {
+      "id": "discover-daily",
+      "title": "The Daily",
+      "description": "This is how the news should sound. Twenty minutes a day, five days a week, hosted by Michael Barbaro and Sabrina Tavernise. Powered by New York Times journalism.",
+      "feedUrl": "http://rss.art19.com/the-daily",
+      "author": "The New York Times",
+      "categories": [
+        "News & Politics"
+      ]
+    },
+    {
+      "id": "discover-up-first",
+      "title": "Up First",
+      "description": "NPR's Up First covers the three biggest stories of the day, with reporting and analysis from NPR News — in 10 minutes.",
+      "feedUrl": "https://feeds.npr.org/510318/podcast.xml",
+      "author": "NPR",
+      "categories": [
+        "News & Politics"
+      ]
+    },
+    {
+      "id": "discover-npr-politics",
+      "title": "The NPR Politics Podcast",
+      "description": "Where everyone gathers for the political conversation of the day. NPR's political reporters talk through the biggest news of the week.",
+      "feedUrl": "https://feeds.npr.org/510310/podcast.xml",
+      "author": "NPR",
+      "categories": [
+        "News & Politics"
+      ]
+    },
+    {
+      "id": "discover-ben-shapiro",
+      "title": "The Ben Shapiro Show",
+      "description": "Ben Shapiro delivers unapologetically conservative commentary on the biggest news stories of the day, blending sharp analysis with his trademark fact-based approach.",
+      "feedUrl": "https://feeds.megaphone.fm/benshow",
+      "author": "The Daily Wire",
+      "categories": [
+        "News & Politics"
+      ]
+    },
+    {
+      "id": "discover-advisory-opinions",
+      "title": "Advisory Opinions",
+      "description": "Host Sarah Isgur and permanent guest David French have twice-weekly conversations about the law, the courts, their collision with politics, and why it all matters — from The Dispatch.",
+      "feedUrl": "https://feeds.megaphone.fm/DISPME4573820108",
+      "author": "The Dispatch",
+      "categories": [
+        "News & Politics"
+      ]
+    },
+    {
+      "id": "discover-crime-junkie",
+      "title": "Crime Junkie",
+      "description": "Crime Junkie satisfies true crime cravings with host Ashley Flowers' obsessed yet accessible approach to real-life mysteries — from unsolved murders to missing persons.",
+      "feedUrl": "https://feeds.simplecast.com/qm_9xx0g",
+      "author": "audiochuck",
+      "categories": [
+        "True Crime"
+      ]
+    },
+    {
+      "id": "discover-serial",
+      "title": "Serial",
+      "description": "Serial Productions makes narrative podcasts that have transformed the medium. From the team that brought you the original Serial, one of the most influential podcasts of all time.",
+      "feedUrl": "https://feeds.simplecast.com/PpzWFGhg",
+      "author": "Serial Productions & The New York Times",
+      "categories": [
+        "True Crime",
+        "Storytelling"
+      ]
+    },
+    {
+      "id": "discover-intelligence-matters",
+      "title": "Intelligence Matters",
+      "description": "A deep dive into national security, intelligence, and foreign policy with top former officials and experts hosted by CBS News senior correspondent.",
+      "feedUrl": "https://rss.art19.com/intelligence-matters",
+      "author": "CBS News",
+      "categories": [
+        "True Crime",
+        "News & Politics"
+      ]
+    },
+    {
+      "id": "discover-smartless",
+      "title": "SmartLess",
+      "description": "Jason Bateman, Sean Hayes, and Will Arnett bring you unscripted conversations with surprise celebrity guests — each episode one host reveals the guest to the others.",
+      "feedUrl": "https://rss.art19.com/smartless",
+      "author": "Jason Bateman, Sean Hayes, Will Arnett",
+      "categories": [
+        "Comedy",
+        "Entertainment"
+      ]
+    },
+    {
+      "id": "discover-this-past-weekend",
+      "title": "This Past Weekend w/ Theo Von",
+      "description": "Comedian Theo Von's uniquely southern perspective blends heartfelt vulnerability and offbeat humor in conversations ranging from celebrity interviews to solo musings.",
+      "feedUrl": "https://feeds.megaphone.fm/thispastweekend",
+      "author": "Theo Von",
+      "categories": [
+        "Comedy"
+      ]
+    },
+    {
+      "id": "discover-joe-rogan",
+      "title": "The Joe Rogan Experience",
+      "description": "The official podcast of comedian Joe Rogan. Long-form conversations with guests from every corner of culture, science, comedy, and beyond.",
+      "feedUrl": "https://feeds.megaphone.fm/GLT1412515089",
+      "author": "Joe Rogan",
+      "categories": [
+        "Comedy",
+        "Entertainment"
+      ]
+    },
+    {
+      "id": "discover-comedy-bang-bang",
+      "title": "Comedy Bang Bang: The Podcast",
+      "description": "A weekly comedy podcast hosted by Scott Aukerman featuring improv, games, and hilarious conversations with celebrities and the world's best comedians.",
+      "feedUrl": "https://rss.art19.com/comedy-bang-bang",
+      "author": "Earwolf",
+      "categories": [
+        "Comedy"
+      ]
+    },
+    {
+      "id": "discover-office-ladies",
+      "title": "Office Ladies",
+      "description": "The Office stars Jenna Fischer and Angela Kinsey break down each episode of The Office with behind-the-scenes stories, fun facts, and fan Q&A.",
+      "feedUrl": "https://rss.art19.com/office-ladies",
+      "author": "Earwolf",
+      "categories": [
+        "Comedy",
+        "Entertainment"
+      ]
+    },
+    {
+      "id": "discover-how-did-this-get-made",
+      "title": "How Did This Get Made?",
+      "description": "Comedians Paul Scheer, June Diane Raphael, and Jason Mantzoukas break down the very best of the worst films ever made — blockbuster flops, cult classics, and Nic Cage movies.",
+      "feedUrl": "https://rss.art19.com/how-did-this-get-made",
+      "author": "Earwolf",
+      "categories": [
+        "Comedy",
+        "Film"
+      ]
+    },
+    {
+      "id": "discover-wait-wait",
+      "title": "Wait Wait... Don't Tell Me!",
+      "description": "NPR's weekly news quiz show. Test your knowledge against the week's biggest news, with panelists and celebrity guests competing in hilarious trivia.",
+      "feedUrl": "https://feeds.npr.org/344098539/podcast.xml",
+      "author": "NPR",
+      "categories": [
+        "Comedy",
+        "News & Politics"
+      ]
+    },
+    {
+      "id": "discover-new-heights",
+      "title": "New Heights with Jason & Travis Kelce",
+      "description": "Football's funniest family duo — Super Bowl champions Jason and Travis Kelce — drop weekly insights about the NFL and share inside perspectives on sports headlines.",
+      "feedUrl": "https://rss.art19.com/new-heights",
+      "author": "Jason & Travis Kelce",
+      "categories": [
+        "Sports",
+        "Comedy"
+      ]
+    },
+    {
+      "id": "discover-bill-simmons",
+      "title": "The Bill Simmons Podcast",
+      "description": "Bill Simmons and his cadre of opinionated guests discuss sports, pop culture, and everything in between on The Ringer's flagship podcast.",
+      "feedUrl": "https://rss.art19.com/the-bill-simmons-podcast",
+      "author": "The Ringer",
+      "categories": [
+        "Sports",
+        "Entertainment"
+      ]
+    },
+    {
+      "id": "discover-acquired",
+      "title": "Acquired",
+      "description": "Acquired tells the stories and strategies of the world's greatest companies. Each episode is a deep dive into a single company's history and the playbooks behind its success.",
+      "feedUrl": "https://feeds.transistor.fm/acquired",
+      "author": "Ben Gilbert & David Rosenthal",
+      "categories": [
+        "Business",
+        "Technology"
+      ]
+    },
+    {
+      "id": "discover-all-in",
+      "title": "All-In Podcast",
+      "description": "Four tech industry veterans share their unfiltered perspectives on technology, economics, politics, and culture. Insightful, opinionated, and occasionally controversial.",
+      "feedUrl": "https://allinchamathjason.libsyn.com/rss",
+      "author": "Chamath Palihapitiya, Jason Calacanis, David Sacks & David Friedberg",
+      "categories": [
+        "Business",
+        "Technology",
+        "Politics"
+      ]
+    },
+    {
+      "id": "discover-planet-money",
+      "title": "Planet Money",
+      "description": "The economy explained. NPR's Planet Money breaks down the economy with creative storytelling that makes sense of a complicated, ever-changing world.",
+      "feedUrl": "https://feeds.npr.org/510289/podcast.xml",
+      "author": "NPR",
+      "categories": [
+        "Business",
+        "Economics"
+      ]
+    },
+    {
+      "id": "discover-how-i-built-this",
+      "title": "How I Built This with Guy Raz",
+      "description": "Guy Raz interviews the world's best-known entrepreneurs to learn how they built their iconic brands. A master-class on innovation, creativity, and leadership.",
+      "feedUrl": "https://feeds.npr.org/510313/podcast.xml",
+      "author": "NPR / Wondery",
+      "categories": [
+        "Business",
+        "Technology"
+      ]
+    },
+    {
+      "id": "discover-freakonomics",
+      "title": "Freakonomics Radio",
+      "description": "Discover the hidden side of everything with Stephen Dubner. Each episode explores the riddles of everyday life using the tools of economics.",
+      "feedUrl": "https://feeds.feedburner.com/freakonomicsradio",
+      "author": "Stephen J. Dubner",
+      "categories": [
+        "Business",
+        "Economics",
+        "Society"
+      ]
+    },
+    {
+      "id": "discover-darknet-diaries",
+      "title": "Darknet Diaries",
+      "description": "True stories from the dark side of the Internet. Host Jack Rhysider investigates hacks, data breaches, cybercrime, and digital espionage with rigorous journalism and captivating storytelling.",
+      "feedUrl": "https://podcast.darknetdiaries.com/",
+      "author": "Jack Rhysider",
+      "categories": [
+        "Technology",
+        "True Crime"
+      ]
+    },
+    {
+      "id": "discover-changelog",
+      "title": "The Changelog",
+      "description": "Software's best weekly news brief, deep technical interviews, and talk show. Conversations with the hackers, leaders, and innovators of the open source and software world.",
+      "feedUrl": "https://changelog.fm/rss",
+      "author": "Changelog Media",
+      "categories": [
+        "Technology",
+        "Software Engineering"
+      ]
+    },
+    {
+      "id": "discover-twit",
+      "title": "This Week in Tech (TWiT)",
+      "description": "Your first podcast of the week, the last word in tech. Leo Laporte and a rotating panel of tech experts discuss the week's biggest tech news.",
+      "feedUrl": "https://feeds.twit.tv/twit.xml",
+      "author": "TWiT",
+      "categories": [
+        "Technology"
+      ]
+    },
+    {
+      "id": "discover-radiolab",
+      "title": "Radiolab",
+      "description": "Radiolab is on a curiosity bender. Each episode weaves together science, legal history, and deeply human stories with innovative sound design. Hosted by Lulu Miller and Latif Nasser.",
+      "feedUrl": "http://feeds.wnyc.org/radiolab",
+      "author": "WNYC Studios",
+      "categories": [
+        "Science",
+        "Storytelling"
+      ]
+    },
+    {
+      "id": "discover-huberman-lab",
+      "title": "Huberman Lab",
+      "description": "Regularly ranked as the #1 health podcast in the world. Dr. Andrew Huberman discusses science and science-based tools for everyday life: sleep, focus, fitness, and performance.",
+      "feedUrl": "https://feeds.megaphone.fm/hubermanlab",
+      "author": "Scicomm Media",
+      "categories": [
+        "Health",
+        "Science"
+      ]
+    },
+    {
+      "id": "discover-skeptics-guide",
+      "title": "The Skeptics' Guide to the Universe",
+      "description": "Your guide to reality. A weekly science and critical thinking podcast that explores myths, conspiracies, pseudoscience, and the latest scientific discoveries — with a skeptical eye.",
+      "feedUrl": "https://feeds.feedburner.com/TheSkepticsGuideToTheUniverse",
+      "author": "Steven Novella",
+      "categories": [
+        "Science",
+        "Philosophy"
+      ]
+    },
+    {
+      "id": "discover-throughline",
+      "title": "Throughline",
+      "description": "The past is never past. NPR's Throughline travels beyond the headlines to answer the question 'How did we get here?' Each episode brings history to life from ancient civilizations to forgotten figures.",
+      "feedUrl": "https://feeds.npr.org/510333/podcast.xml",
+      "author": "NPR",
+      "categories": [
+        "History",
+        "Politics"
+      ]
+    },
+    {
+      "id": "discover-hardcore-history",
+      "title": "Dan Carlin's Hardcore History",
+      "description": "In Hardcore History, journalist and broadcaster Dan Carlin applies his unorthodox, 'Martian' way of thinking to the past. Multi-hour deep dives into pivotal events that blend high drama with masterful narration.",
+      "feedUrl": "https://feeds.feedburner.com/dancarlin/history",
+      "author": "Dan Carlin",
+      "categories": [
+        "History"
+      ]
+    },
+    {
+      "id": "discover-history-of-rome",
+      "title": "The History of Rome",
+      "description": "A weekly chronological podcast tracing the entire history of Rome, from its mythical founding to the fall of the Western Empire. A masterclass in narrative history.",
+      "feedUrl": "https://feeds.feedburner.com/TheHistoryOfRome",
+      "author": "Mike Duncan",
+      "categories": [
+        "History"
+      ]
+    },
+    {
+      "id": "discover-philosophize-this",
+      "title": "Philosophize This!",
+      "description": "Stephen West walks through the entire history of philosophy chronologically, from the pre-Socratics to contemporary thinkers. Making profound ideas accessible without dumbing them down.",
+      "feedUrl": "https://philosophizethis.libsyn.com/rss",
+      "author": "Stephen West",
+      "categories": [
+        "Philosophy",
+        "Education"
+      ]
+    },
+    {
+      "id": "discover-very-bad-wizards",
+      "title": "Very Bad Wizards",
+      "description": "A philosopher (Tamler Sommers) and a psychologist (David Pizarro) discuss human nature, ethics, free will, and whatever movie they just watched. Irreverent, insightful, and intellectually honest.",
+      "feedUrl": "https://feeds.libsyn.com/474285/rss",
+      "author": "Tamler Sommers & David Pizarro",
+      "categories": [
+        "Philosophy",
+        "Science"
+      ]
+    },
+    {
+      "id": "discover-big-picture",
+      "title": "The Big Picture",
+      "description": "The Ringer's Sean Fennessey and Amanda Dobbins discuss the week in movies, TV, and streaming — from box office analysis to what's worth your time.",
+      "feedUrl": "https://rss.art19.com/the-big-picture",
+      "author": "The Ringer",
+      "categories": [
+        "Film",
+        "Entertainment"
+      ]
+    },
+    {
+      "id": "discover-all-songs-considered",
+      "title": "All Songs Considered",
+      "description": "NPR's flagship music discovery podcast, delivering the best new releases every week across indie rock, jazz, electronic, and everything in between. Discover music you wouldn't stumble across on your own.",
+      "feedUrl": "https://feeds.npr.org/510019/podcast.xml",
+      "author": "NPR Music",
+      "categories": [
+        "Music"
+      ]
+    },
+    {
+      "id": "discover-switched-on-pop",
+      "title": "Switched on Pop",
+      "description": "Musicologist Nate Sloan and songwriter Charlie Harding explain why pop music sounds the way it does — pulling apart chord progressions, production tricks, and cultural trends with zero snobbery.",
+      "feedUrl": "https://feeds.megaphone.fm/switchedonpop",
+      "author": "Vox Media / Panoply",
+      "categories": [
+        "Music"
+      ]
+    },
+    {
+      "id": "discover-hit-parade",
+      "title": "Hit Parade",
+      "description": "Slate's Chris Molanphy traces how songs and genres conquered the Billboard charts, weaving chart history, cultural context, and pure trivia into each episode.",
+      "feedUrl": "https://feeds.megaphone.fm/hitparade",
+      "author": "Slate",
+      "categories": [
+        "Music",
+        "History"
+      ]
+    },
+    {
+      "id": "discover-song-exploder",
+      "title": "Song Exploder",
+      "description": "Musicians take apart their songs, piece by piece, and tell the story of how they were made. Past guests include Billie Eilish, Fleetwood Mac, and Lin-Manuel Miranda.",
+      "feedUrl": "https://songexploder.net/rss",
+      "author": "Hrishikesh Hirway",
+      "categories": [
+        "Music",
+        "Arts"
+      ]
+    },
+    {
+      "id": "discover-blank-check",
+      "title": "Blank Check with Griffin & David",
+      "description": "Reviews of directors' complete filmographies, episode by episode. Specifically, auteurs whose early successes afforded them the rare 'blank check' from Hollywood. Painstakingly hilarious detail.",
+      "feedUrl": "https://audioboom.com/channels/4278829.rss",
+      "author": "Griffin Newman & David Sims",
+      "categories": [
+        "Film",
+        "Comedy"
+      ]
+    },
+    {
+      "id": "discover-99-invisible",
+      "title": "99% Invisible",
+      "description": "A sound-rich, narrative podcast about all the thought that goes into the things we don't think about — the unnoticed architecture and design that shape our world. Hosted by Roman Mars.",
+      "feedUrl": "https://feeds.simplecast.com/BqbsxVfO",
+      "author": "Roman Mars",
+      "categories": [
+        "Design",
+        "Arts",
+        "Culture"
+      ]
+    },
+    {
+      "id": "discover-gastropod",
+      "title": "Gastropod",
+      "description": "Food with a side of science and history. Co-hosts Cynthia Graber and Nicola Twilley explore the hidden history and surprising science behind a different food or farming topic every other week.",
+      "feedUrl": "https://gastropod.com/feed",
+      "author": "Cynthia Graber & Nicola Twilley",
+      "categories": [
+        "Food",
+        "Science",
+        "History"
+      ]
+    },
+    {
+      "id": "discover-this-american-life",
+      "title": "This American Life",
+      "description": "Hosted by Ira Glass, each episode weaves together stories around a single theme. Combining investigative reporting with intimate personal narratives, it sets the gold standard for audio storytelling.",
+      "feedUrl": "https://www.thisamericanlife.org/podcast/rss.xml",
+      "author": "This American Life",
+      "categories": [
+        "Storytelling",
+        "Culture"
+      ]
+    },
+    {
+      "id": "discover-ted-talks-daily",
+      "title": "TED Talks Daily",
+      "description": "Thought-provoking ideas on every subject imaginable from the world's leading thinkers and creators. A new TED Talk every weekday.",
+      "feedUrl": "https://feeds.feedburner.com/TEDTalks_audio",
+      "author": "TED",
+      "categories": [
+        "Education",
+        "Storytelling"
+      ]
+    },
+    {
+      "id": "discover-tim-ferriss",
+      "title": "The Tim Ferriss Show",
+      "description": "Tim Ferriss deconstructs world-class performers — from billionaires to chess prodigies to athletes — to extract the tools, tactics, and routines you can apply to your own life.",
+      "feedUrl": "https://rss.art19.com/tim-ferriss-show",
+      "author": "Tim Ferriss",
+      "categories": [
+        "Self-Improvement",
+        "Business"
+      ]
+    },
+    {
+      "id": "discover-jordan-harbinger",
+      "title": "The Jordan Harbinger Show",
+      "description": "In-depth conversations with fascinating minds — from Ray Dalio to arms traffickers. Jordan Harbinger unpacks guests' wisdom into practical nuggets for work, life, and relationships.",
+      "feedUrl": "https://rss.art19.com/the-jordan-harbinger-show",
+      "author": "Jordan Harbinger",
+      "categories": [
+        "Self-Improvement"
+      ]
+    },
+    {
+      "id": "discover-on-purpose",
+      "title": "On Purpose with Jay Shetty",
+      "description": "Jay Shetty hosts conversations and workshops designed to make you happier, healthier, and more healed. Interviews with experts, celebrities, and thought leaders on mindset and habit-building.",
+      "feedUrl": "https://rss.art19.com/on-purpose-with-jay-shetty",
+      "author": "Jay Shetty",
+      "categories": [
+        "Self-Improvement",
+        "Health"
+      ]
+    },
+    {
+      "id": "discover-10-percent-happier",
+      "title": "10% Happier with Dan Harris",
+      "description": "Self-help for the skeptical. ABC News anchor Dan Harris explores meditation and mindfulness with scientists, monks, and teachers, born from his own panic attack on live TV.",
+      "feedUrl": "https://rss.art19.com/ten-percent-happier",
+      "author": "Dan Harris",
+      "categories": [
+        "Self-Improvement",
+        "Health",
+        "Philosophy"
+      ]
+    },
+    {
+      "id": "discover-school-of-greatness",
+      "title": "The School of Greatness",
+      "description": "Former pro athlete Lewis Howes interviews successful people across business, sports, science, and literature to help you unlock your inner greatness and live your best life.",
+      "feedUrl": "https://rss.art19.com/the-school-of-greatness",
+      "author": "Lewis Howes",
+      "categories": [
+        "Self-Improvement",
+        "Business"
+      ]
+    },
+    {
+      "id": "discover-sysk",
+      "title": "Stuff You Should Know",
+      "description": "If you've ever wanted to know about champagne, satanism, the Stonewall Uprising, chaos theory, LSD, El Nino, true crime or Roswell — Josh and Chuck have got you covered.",
+      "feedUrl": "https://www.omnycontent.com/d/playlist/e73c998e-6e60-432f-8610-ae210140c5b1/A91018A4-EA4F-4130-BF55-AE270180C327/44710ECC-10BB-48D1-93C7-AE270180C33E/podcast.rss",
+      "author": "iHeartPodcasts (Josh Clark & Chuck Bryant)",
+      "categories": [
+        "Education",
+        "Comedy"
+      ]
+    },
+    {
+      "id": "discover-in-our-time",
+      "title": "In Our Time",
+      "description": "Melvyn Bragg and guests on BBC Radio 4 discuss the history of ideas — from the Peloponnesian War to the science of photography. A weekly graduate seminar in audio form since 1998.",
+      "feedUrl": "https://podcasts.files.bbci.co.uk/b006qykl.rss",
+      "author": "BBC Radio 4",
+      "categories": [
+        "History",
+        "Education",
+        "Philosophy"
+      ]
+    }
+  ]
+}

notes.md

@@ -1 +0,0 @@
-- [ ] Audio play can survive quit out

package.json

@@ -8,31 +8,25 @@
     "podtui": "./dist/index.js"
   },
   "scripts": {
-    "start": "bun src/index.tsx",
-    "dev": "bun --watch src/index.tsx",
+    "start": "bun --preload @opentui/solid/preload src/index.tsx",
+    "dev": "bun --preload @opentui/solid/preload --watch src/index.tsx",
     "build:native": "bash scripts/build-cavacore.sh",
     "build": "bun run build.ts",
     "dist": "bun dist/index.js",
     "test": "bun test",
-    "lint": "bun run lint.ts"
+    "lint": "bun tsc --noEmit"
   },
   "devDependencies": {
     "@types/bun": "latest",
-    "@types/uuid": "^11.0.0",
     "@typescript-eslint/eslint-plugin": "^8.54.0",
     "@typescript-eslint/parser": "^8.54.0",
     "eslint": "^9.39.2",
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@babel/core": "^7.28.5",
-    "@babel/preset-typescript": "^7.28.5",
     "@opentui/core": "^0.1.77",
     "@opentui/solid": "^0.1.77",
-    "babel-preset-solid": "1.9.9",
     "date-fns": "^4.1.0",
-    "solid-js": "^1.9.9",
-    "uuid": "^13.0.0",
-    "zustand": "^5.0.11"
+    "solid-js": "^1.9.9"
   }
 }

packaging/aur/.SRCINFO

@@ -0,0 +1,41 @@
+pkgbase = podtui-bin
+	pkgdesc = Terminal podcast and audio player with synchronized audio-waveform visualization
+	pkgver = 0.2.0
+	pkgrel = 1
+	url = https://github.com/mikefreno/podtui
+	arch = x86_64
+	arch = aarch64
+	license = MIT
+	depends = mpv
+	provides = podtui
+	conflicts = podtui
+	options = !strip
+	source_x86_64 = https://github.com/mikefreno/podtui/releases/download/v0.2.0/podtui-linux-x64.tar.gz
+	source_x86_64 = https://github.com/mikefreno/podtui/releases/download/v0.2.0/LICENSE
+	sha256sums_x86_64 = 5c2be309341bda9550ad7669b48d3f46341c687234ddfaa0c84a6a9177f049fc
+	sha256sums_x86_64 = 106a1290f2b9942a43785938cc8ccb1f72cf360babc58316f8d7feee829e98fc
+	source_aarch64 = https://github.com/mikefreno/podtui/releases/download/v0.2.0/podtui-linux-arm64.tar.gz
+	source_aarch64 = https://github.com/mikefreno/podtui/releases/download/v0.2.0/LICENSE
+	sha256sums_aarch64 = c9c22d3a18cd192f89fbd5ff712d3502c4de0cce7550156c6a0d48d76e56e0d5
+	sha256sums_aarch64 = 106a1290f2b9942a43785938cc8ccb1f72cf360babc58316f8d7feee829e98fc
+
+pkgname = podtui-bin
+	pkgver = 0.2.0
+	pkgrel = 1
+	url = https://github.com/mikefreno/podtui
+	pkgdesc = Terminal podcast and audio player with synchronized audio-waveform visualization
+	arch = x86_64
+	arch = aarch64
+	license = MIT
+	depends = mpv
+	provides = podtui
+	conflicts = podtui
+	options = !strip
+	source_x86_64 = https://github.com/mikefreno/podtui/releases/download/v0.2.0/podtui-linux-x64.tar.gz
+	source_x86_64 = https://github.com/mikefreno/podtui/releases/download/v0.2.0/LICENSE
+	sha256sums_x86_64 = 5c2be309341bda9550ad7669b48d3f46341c687234ddfaa0c84a6a9177f049fc
+	sha256sums_x86_64 = 106a1290f2b9942a43785938cc8ccb1f72cf360babc58316f8d7feee829e98fc
+	source_aarch64 = https://github.com/mikefreno/podtui/releases/download/v0.2.0/podtui-linux-arm64.tar.gz
+	source_aarch64 = https://github.com/mikefreno/podtui/releases/download/v0.2.0/LICENSE
+	sha256sums_aarch64 = c9c22d3a18cd192f89fbd5ff712d3502c4de0cce7550156c6a0d48d76e56e0d5
+	sha256sums_aarch64 = 106a1290f2b9942a43785938cc8ccb1f72cf360babc58316f8d7feee829e98fc

packaging/aur/PKGBUILD

@@ -0,0 +1,55 @@
+# Maintainer: Michael Freno <michael.freno@gmail.com>
+# Contributor: Michael Freno <michael.freno@gmail.com>
+# podtui-bin — TUI podcast/audiobook player with synchronized audio-waveform
+# visualization. Serves the official standalone release binary and its two FFI
+# sibling libraries (libcavacore.so + libopentui.so) from GitHub Releases.
+#
+# The embedded Bun runtime is statically linked into the binary — no Bun, no
+# fftw needed at runtime (fftw3 is linked statically into libcavacore.so).
+
+pkgname=podtui-bin
+_pkgname=podtui
+pkgver=0.2.0
+pkgrel=1
+pkgdesc="Terminal podcast and audio player with synchronized audio-waveform visualization"
+url="https://github.com/mikefreno/podtui"
+arch=('x86_64' 'aarch64')
+license=('MIT')
+depends=('mpv')                             # sole audio backend; no-op without it
+provides=("${_pkgname}")
+conflicts=("${_pkgname}")
+options=('!strip')                          # standalone binary, pre-minified
+source_x86_64=(
+	"https://github.com/mikefreno/podtui/releases/download/v${pkgver}/podtui-linux-x64.tar.gz"
+	"https://github.com/mikefreno/podtui/releases/download/v${pkgver}/LICENSE"
+)
+source_aarch64=(
+	"https://github.com/mikefreno/podtui/releases/download/v${pkgver}/podtui-linux-arm64.tar.gz"
+	"https://github.com/mikefreno/podtui/releases/download/v${pkgver}/LICENSE"
+)
+sha256sums_x86_64=(
+	'5c2be309341bda9550ad7669b48d3f46341c687234ddfaa0c84a6a9177f049fc'
+	'106a1290f2b9942a43785938cc8ccb1f72cf360babc58316f8d7feee829e98fc'
+)
+sha256sums_aarch64=(
+	'c9c22d3a18cd192f89fbd5ff712d3502c4de0cce7550156c6a0d48d76e56e0d5'
+	'106a1290f2b9942a43785938cc8ccb1f72cf360babc58316f8d7feee829e98fc'
+)
+
+package() {
+	local libdir
+
+	case "$CARCH" in
+	x86_64) libdir="podtui-linux-x64" ;;
+	aarch64) libdir="podtui-linux-arm64" ;;
+	esac
+
+	# Binary + native FFI libs must stay side by side in /usr/lib/podtui/;
+	# a /usr/bin symlink works because the embedded Bun runtime resolves
+	# process.execPath through symlinks (verified against the compiled binary).
+	install -Dm755 "${srcdir}/${libdir}/podtui" "${pkgdir}/usr/lib/podtui/podtui"
+	install -Dm644 "${srcdir}/${libdir}/libcavacore.so" "${pkgdir}/usr/lib/podtui/libcavacore.so"
+	install -Dm644 "${srcdir}/${libdir}/libopentui.so" "${pkgdir}/usr/lib/podtui/libopentui.so"
+	ln -s /usr/lib/podtui/podtui "${pkgdir}/usr/bin/podtui"
+	install -Dm644 "${srcdir}/LICENSE" "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE"
+}

packaging/aur/gen-srcinfo.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# gen-srcinfo.sh — emit .SRCINFO for the podtui-bin PKGBUILD without makepkg.
+# Emits the same field set/ordering makepkg --printsrcinfo produces for this
+# PKGBUILD shape (single package, per-arch source + sha256sums arrays).
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+# shellcheck disable=SC1091
+. ./PKGBUILD
+
+emit() { printf '\t%s = %s\n' "$1" "$2"; }
+emit_multi() { # $1 field, rest values
+	local f="$1"
+	shift
+	for v in "$@"; do emit "$f" "$v"; done
+}
+
+pkgbase_section() {
+	echo "pkgbase = ${pkgname}"
+	for f in pkgdesc pkgver pkgrel url; do
+		v="${!f}"
+		[ -n "${v:-}" ] && emit "$f" "$v"
+	done
+	[ -n "${install:-}" ] && emit install "$install"
+	[ "${#arch[@]}" -gt 0 ] && emit_multi arch "${arch[@]}"
+	[ "${#license[@]}" -gt 0 ] && emit_multi license "${license[@]}"
+	[ "${#depends[@]}" -gt 0 ] && emit_multi depends "${depends[@]}"
+	[ "${#provides[@]}" -gt 0 ] && emit_multi provides "${provides[@]}"
+	[ "${#conflicts[@]}" -gt 0 ] && emit_multi conflicts "${conflicts[@]}"
+	[ "${#options[@]}" -gt 0 ] && emit_multi options "${options[@]}"
+	emit_arch_arrays
+}
+
+emit_arch_arrays() {
+	for a in "${arch[@]}"; do
+		src_name="source_${a}"
+		sha_name="sha256sums_${a}"
+		src_val="${src_name}[@]"
+		sha_val="${sha_name}[@]"
+		[ "${#src_name}" -gt 0 ] && emit_multi "source_${a}" "${!src_val}"
+		emit_multi "sha256sums_${a}" "${!sha_val}"
+	done
+}
+
+pkgbase_section
+echo ""
+echo "pkgname = ${pkgname}"
+for v in pkgver pkgrel url; do
+	val="${!v}"
+	[ -n "${val:-}" ] && emit "$v" "$val"
+done
+emit pkgdesc "$pkgdesc"
+[ "${#arch[@]}" -gt 0 ] && emit_multi arch "${arch[@]}"
+[ "${#license[@]}" -gt 0 ] && emit_multi license "${license[@]}"
+[ "${#depends[@]}" -gt 0 ] && emit_multi depends "${depends[@]}"
+[ "${#provides[@]}" -gt 0 ] && emit_multi provides "${provides[@]}"
+[ "${#conflicts[@]}" -gt 0 ] && emit_multi conflicts "${conflicts[@]}"
+[ "${#options[@]}" -gt 0 ] && emit_multi options "${options[@]}"
+emit_arch_arrays

scripts/build-cavacore.sh

@@ -19,36 +19,58 @@ mkdir -p "$OUT_DIR"
 OS="$(uname -s)"
 ARCH="$(uname -m)"
 
-# Resolve fftw3 paths
+# Resolve fftw3 paths. The static archive lives in different places per
+# platform: Homebrew (/opt/homebrew on arm64, /usr/local on Intel) and, on
+# Debian/Ubuntu, the multiarch dir /usr/lib/<triplet> (e.g.
+# x86_64-linux-gnu, aarch64-linux-gnu).
 if [ "$OS" = "Darwin" ]; then
-  if [ "$ARCH" = "arm64" ]; then
-    FFTW_PREFIX="${FFTW_PREFIX:-/opt/homebrew}"
-  else
-    FFTW_PREFIX="${FFTW_PREFIX:-/usr/local}"
-  fi
-  LIB_EXT="dylib"
-  SHARED_FLAG="-dynamiclib"
-  INSTALL_NAME="-install_name @rpath/libcavacore.dylib"
+	LIB_EXT="dylib"
+	SHARED_FLAG="-dynamiclib"
+	INSTALL_NAME="-install_name @rpath/libcavacore.dylib"
+	if [ "$ARCH" = "arm64" ]; then
+		FFTW_HINTS="/opt/homebrew /usr/local"
+	else
+		FFTW_HINTS="/usr/local /opt/homebrew"
+	fi
 else
-  FFTW_PREFIX="${FFTW_PREFIX:-/usr}"
-  LIB_EXT="so"
-  SHARED_FLAG="-shared"
-  INSTALL_NAME=""
+	LIB_EXT="so"
+	SHARED_FLAG="-shared"
+	INSTALL_NAME=""
+	FFTW_HINTS="/usr /usr/local"
+fi
+
+FFTW_PREFIX="${FFTW_PREFIX:-}"
+FFTW_STATIC=""
+if [ -n "$FFTW_PREFIX" ]; then
+	FFTW_STATIC="$FFTW_PREFIX/lib/libfftw3.a"
+else
+	for hint in $FFTW_HINTS; do
+		for cand in "$hint/lib/libfftw3.a" "$hint/lib/${ARCH}-linux-gnu/libfftw3.a"; do
+			if [ -f "$cand" ]; then
+				FFTW_STATIC="$cand"
+				FFTW_PREFIX="$hint"
+				break 2
+			fi
+		done
+	done
+fi
+
+if [ -z "$FFTW_STATIC" ] || [ ! -f "$FFTW_STATIC" ]; then
+	echo "Error: libfftw3.a not found (searched: ${FFTW_HINTS})"
+	echo "Install fftw3: brew install fftw (macOS) or apt install libfftw3-dev (Linux)"
+	echo "or point FFTW_PREFIX at a prefix containing lib/libfftw3.a."
+	exit 1
 fi
 
 FFTW_INCLUDE="$FFTW_PREFIX/include"
-FFTW_STATIC="$FFTW_PREFIX/lib/libfftw3.a"
-
-if [ ! -f "$FFTW_STATIC" ]; then
-  echo "Error: libfftw3.a not found at $FFTW_STATIC"
-  echo "Install fftw3: brew install fftw (macOS) or apt install libfftw3-dev (Linux)"
-  exit 1
+if [ ! -d "$FFTW_INCLUDE" ]; then
+	FFTW_INCLUDE="$FFTW_PREFIX/include/$(basename "$(dirname "$FFTW_STATIC")")"
 fi
 
 if [ ! -f "$SRC" ]; then
-  echo "Error: cavacore.c not found at $SRC"
-  echo "Ensure the cava submodule is initialized: git submodule update --init"
-  exit 1
+	echo "Error: cavacore.c not found at $SRC"
+	echo "The cava source is vendored under cava/ (from github.com/karlstav/cava, MIT)."
+	exit 1
 fi
 
 OUT="$OUT_DIR/libcavacore.$LIB_EXT"
@@ -59,21 +81,21 @@ echo "  FFTW3:   $FFTW_STATIC"
 echo "  Output:  $OUT"
 
 cc -O2 \
-  $SHARED_FLAG \
-  $INSTALL_NAME \
-  -fPIC \
-  -I"$FFTW_INCLUDE" \
-  -I"$ROOT/cava" \
-  -o "$OUT" \
-  "$SRC" \
-  "$FFTW_STATIC" \
-  -lm
+	$SHARED_FLAG \
+	$INSTALL_NAME \
+	-fPIC \
+	-I"$FFTW_INCLUDE" \
+	-I"$ROOT/cava" \
+	-o "$OUT" \
+	"$SRC" \
+	"$FFTW_STATIC" \
+	-lm
 
 echo "Built: $OUT"
 
 # Verify exported symbols
 if [ "$OS" = "Darwin" ]; then
-  echo ""
-  echo "Exported symbols:"
-  nm -gU "$OUT" | grep "cava_"
+	echo ""
+	echo "Exported symbols:"
+	nm -gU "$OUT" | grep "cava_"
 fi

scripts/release-tag.sh

@@ -0,0 +1,240 @@
+#!/bin/bash
+
+# release-tag.sh — PodTui version bump, commit, tag, and push.
+#
+# Mirrors the release flow from FlexLove's scripts/make-tag.sh, adapted for
+# PodTui's single version source (src/index.tsx) and dual remotes (gh, gt).
+#
+# Usage:
+#   scripts/release-tag.sh            interactive release
+#   scripts/release-tag.sh --dry-run  plan the bump/tag/pushes without doing
+#
+# Pushing a v* tag to the `gh` remote triggers .github/workflows/release.yml
+# (4-platform tarball builds) — the release and the Homebrew tap update then
+# happen automatically and need no further local action.
+
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_ROOT"
+
+DRY_RUN=0
+for arg in "$@"; do
+	case "$arg" in
+	--dry-run | -n) DRY_RUN=1 ;;
+	--help | -h)
+		echo "Usage: scripts/release-tag.sh [--dry-run]"
+		echo "  --dry-run, -n   show the plan without committing, tagging, or pushing"
+		exit 0
+		;;
+	*)
+		echo -e "${RED}Unknown option: ${arg}${NC}" >&2
+		exit 2
+		;;
+	esac
+done
+
+if [ ! -d .git ] && [ ! -f .git ]; then
+	echo -e "${RED}Error: Not in a git repository${NC}"
+	exit 1
+fi
+
+if ! git diff-index --quiet HEAD --; then
+	echo -e "${YELLOW}You have uncommitted changes:${NC}"
+	git status --short
+	echo ""
+	read -p "Continue anyway? (y/n) " -n 1 -r
+	echo
+	if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+		echo -e "${RED}Aborted${NC}"
+		exit 1
+	fi
+	echo ""
+fi
+
+# Current version from the latest tag; fall back to src/index.tsx.
+CURRENT_VERSION=$(git describe --tags --abbrev=0 2>/dev/null | sed 's/^v//')
+if [ -z "$CURRENT_VERSION" ]; then
+	CURRENT_VERSION=$(grep -m 1 "^const VERSION" src/index.tsx | sed -E 's/.*"([0-9]+\.[0-9]+\.[0-9]+)".*/\1/')
+	if [ -z "$CURRENT_VERSION" ]; then
+		echo -e "${RED}Error: could not extract version from git tags or src/index.tsx${NC}"
+		exit 1
+	fi
+	echo -e "${YELLOW}No tags found; using VERSION from src/index.tsx (${CURRENT_VERSION})${NC}"
+fi
+
+echo -e "${CYAN}Current version:${NC} ${GREEN}v${CURRENT_VERSION}${NC}"
+echo ""
+
+IFS='.' read -r MAJOR MINOR PATCH <<<"$CURRENT_VERSION"
+MAJOR=$(echo "$MAJOR" | sed 's/[^0-9].*//')
+MINOR=$(echo "$MINOR" | sed 's/[^0-9].*//')
+PATCH=$(echo "$PATCH" | sed 's/[^0-9].*//')
+
+echo -e "${CYAN}Select version bump type:${NC}"
+echo "  1) Major (breaking changes)     ${MAJOR}.${MINOR}.${PATCH} → $((MAJOR + 1)).0.0"
+echo "  2) Minor (new features)          ${MAJOR}.${MINOR}.${PATCH} → ${MAJOR}.$((MINOR + 1)).0"
+echo "  3) Patch (bug fixes)             ${MAJOR}.${MINOR}.${PATCH} → ${MAJOR}.${MINOR}.$((PATCH + 1))"
+echo "  4) Custom version"
+echo "  5) Cancel"
+echo ""
+read -p "Enter choice (1-5): " -n 1 -r CHOICE
+echo ""
+echo ""
+
+case $CHOICE in
+1)
+	NEW_VERSION="$((MAJOR + 1)).0.0"
+	;;
+2)
+	NEW_VERSION="${MAJOR}.$((MINOR + 1)).0"
+	;;
+3)
+	NEW_VERSION="${MAJOR}.${MINOR}.$((PATCH + 1))"
+	;;
+4)
+	read -p "Enter custom version (e.g., 1.0.0-beta): " -r NEW_VERSION
+	;;
+5)
+	echo -e "${RED}Cancelled${NC}"
+	exit 0
+	;;
+*)
+	echo -e "${RED}Invalid choice${NC}"
+	exit 1
+	;;
+esac
+
+# Version sanity check (tags are vMAJOR.MINOR.PATCH).
+if ! echo "$NEW_VERSION" | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+$'; then
+	echo -e "${RED}Error: ${NEW_VERSION} is not a valid X.Y.Z version (v tags only)${NC}"
+	exit 1
+fi
+
+echo -e "${CYAN}New version:${NC} ${GREEN}v${NEW_VERSION}${NC}"
+echo ""
+echo -e "${YELLOW}This will:${NC}"
+echo "  1. Set src/index.tsx → VERSION = \"${NEW_VERSION}\""
+echo "  2. Commit the bump"
+echo "  3. Create annotated tag v${NEW_VERSION}"
+echo "  4. Push master and the tag to every remote"
+REMOTES=$(git remote)
+for r in $REMOTES; do
+	echo "       → $r"
+done
+echo ""
+echo -e "${YELLOW}Note: pushing the tag to ${BLUE}gh${YELLOW} triggers release.yml CI (4-platform"
+echo "binaries + GitHub Release) and the homebrew-tap tap update.${NC}"
+echo ""
+read -p "Proceed? (y/n) " -n 1 -r
+echo ""
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+	echo -e "${YELLOW}Aborted — no changes made${NC}"
+	exit 0
+fi
+
+if [ "$DRY_RUN" -eq 1 ]; then
+	echo ""
+	echo -e "${CYAN}[dry-run]${NC} would have:"
+	echo "  sed  src/index.tsx: VERSION \"${CURRENT_VERSION}\" → \"${NEW_VERSION}\""
+	echo "  git  commit -m \"bump VERSION to ${NEW_VERSION}\""
+	echo "  git  tag -a v${NEW_VERSION} -m \"PodTUI v${NEW_VERSION}\""
+	for r in $REMOTES; do echo "  push $r master"; done
+	for r in $REMOTES; do echo "  push $r v${NEW_VERSION}"; done
+	echo ""
+	echo -e "${GREEN}Plan only — nothing written${NC}"
+	exit 0
+fi
+
+# ── Apply the bump ───────────────────────────────────────────────────────────
+echo ""
+echo -e "${CYAN}[1/4]${NC} Updating src/index.tsx..."
+sed -i.bak "s/const VERSION = \"[^\"]*\"/const VERSION = \"${NEW_VERSION}\"/" src/index.tsx
+rm -f src/index.tsx.bak
+echo -e "${GREEN}✓ src/index.tsx updated${NC}"
+
+if git diff --quiet -- src/index.tsx; then
+	if git rev-parse -q --verify "refs/tags/v${NEW_VERSION}" >/dev/null; then
+		echo -e "${YELLOW}Already at ${NEW_VERSION} and tag v${NEW_VERSION} exists — nothing to release.${NC}"
+		exit 0
+	fi
+	echo -e "${YELLOW}VERSION is already ${NEW_VERSION} (bump already committed).${NC}"
+	echo -e "${YELLOW}Will skip the commit and just create the missing tag + push.${NC}"
+	read -p "Tag v${NEW_VERSION} on current HEAD and push? (y/n) " -n 1 -r
+	echo
+	if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+		echo -e "${YELLOW}Aborted — no changes made${NC}"
+		exit 0
+	fi
+else
+	git add src/index.tsx
+	echo -e "${GREEN}✓ staged${NC}"
+
+	echo -e "${CYAN}[2/4]${NC} Committing..."
+	DEFAULT_COMMIT_MSG="bump VERSION to ${NEW_VERSION}"
+	echo -e "Default commit message: ${CYAN}${DEFAULT_COMMIT_MSG}${NC}"
+	read -p "Use default? (y/n) " -n 1 -r
+	echo
+	if [[ $REPLY =~ ^[Nn]$ ]]; then
+		read -p "Enter commit message: " -r COMMIT_MSG
+	else
+		COMMIT_MSG="$DEFAULT_COMMIT_MSG"
+	fi
+	git commit -m "$COMMIT_MSG"
+	echo -e "${GREEN}✓ committed: ${COMMIT_MSG}${NC}"
+fi
+
+echo -e "${CYAN}[3/4]${NC} Tagging..."
+git tag -a "v${NEW_VERSION}" -m "PodTUI v${NEW_VERSION}"
+echo -e "${GREEN}✓ tagged v${NEW_VERSION}${NC}"
+echo ""
+
+echo -e "${CYAN}[4/4]${NC} Pushing..."
+FAILED=""
+for r in $REMOTES; do
+	if ! git push "$r" master; then
+		FAILED="${FAILED}${r} (branch) "
+	fi
+	if ! git push "$r" tag "v${NEW_VERSION}"; then
+		FAILED="${FAILED}${r} (tag) "
+	fi
+done
+
+echo ""
+if [ -n "$FAILED" ]; then
+	echo -e "${RED}═══════════════════════════════════════${NC}"
+	echo -e "${RED}✗ Push failed for: ${FAILED}${NC}"
+	echo -e "${RED}═══════════════════════════════════════${NC}"
+	echo ""
+	echo -e "${YELLOW}The commit and tag exist locally. To retry:${NC}"
+	for r in $REMOTES; do
+		echo "  git push ${r} master"
+		echo "  git push ${r} v${NEW_VERSION}"
+	done
+	echo ""
+	echo -e "${YELLOW}To undo:${NC}"
+	echo "  git tag -d v${NEW_VERSION}"
+	echo "  git reset --soft HEAD~1"
+	exit 1
+fi
+
+echo -e "${GREEN}═══════════════════════════════════════${NC}"
+echo -e "${GREEN}✓ PodTui v${NEW_VERSION} released${NC}"
+echo -e "${GREEN}═══════════════════════════════════════${NC}"
+echo ""
+echo -e "${CYAN}Version:${NC} ${CURRENT_VERSION} → ${GREEN}${NEW_VERSION}${NC}"
+echo -e "${CYAN}Tag:${NC} v${NEW_VERSION}"
+echo ""
+echo -e "${BLUE}Next steps (automatic, nothing to do):${NC}"
+echo "  1. GitHub Action release.yml builds 4 tarballs and attaches them:"
+echo -e "     ${CYAN}gh run watch \$(gh run list --limit 1 --json databaseId -q .[0].databaseId)${NC}"
+echo "  2. mikefreno/homebrew-tap self-updates within the hour (Formula"
+echo "     URLs + sha256s); brew upgrade podtui afterwards."

scripts/tui-harness.tsx

@@ -205,7 +205,7 @@ function parseFlags(rest: string[]): {
 			} else if (a === "--from") {
 				flags.from = rest[++i];
 			} else {
-				flags[a.slice(2)] = rest[++i] ?? true;
+				throw new Error(`unknown flag: ${a}`);
 			}
 		} else {
 			positional.push(a);
@@ -222,52 +222,68 @@ function parseMods(positional: string[]): Mod[] {
 	return mods;
 }
 
-function buildAction(cmd: string, positional: string[]): Action | null {
+// Per-command builders. Leading positional tokens that name a modifier
+// (ctrl/shift/...) are stripped as mods; the rest is the command's data.
+const modsOrUndefined = (positional: string[]): Mod[] | undefined => {
 	const mods = parseMods(positional);
-	const first = positional[0];
-	switch (cmd) {
-		case "key":
-			if (!first) throw new Error("key requires a <key> argument");
-			return { t: "key", k: first, mods: mods.length ? mods : undefined };
-		case "arrow":
-			if (!first || !["up", "down", "left", "right"].includes(first))
-				throw new Error("arrow requires up|down|left|right");
-			return {
-				t: "arrow",
-				d: first as any,
-				mods: mods.length ? mods : undefined,
-			};
-		case "enter":
-		case "escape":
-		case "tab":
-		case "space":
-		case "backspace":
-			return { t: cmd, mods: mods.length ? mods : undefined };
-		case "type":
-			if (first === undefined) throw new Error("type requires <text>");
-			// Re-join the rest in case text had spaces; positional[0] already is first token,
-			// caller should quote. We join all positional as the text.
-			return { t: "type", s: positional.join(" ") };
-		case "wait":
-			if (!first) throw new Error("wait requires <ms>");
-			return { t: "wait", ms: parseInt(first, 10) || 0 };
-		case "resize":
-			if (!first || !positional[1]) throw new Error("resize requires <w> <h>");
-			return {
-				t: "resize",
-				w: parseInt(first, 10) || 100,
-				h: parseInt(positional[1], 10) || 30,
-			};
-		case "frame":
-		case "state":
-		case "reset":
-		case "actions":
-		case "init":
-		case "seed":
-			return null;
-		default:
-			throw new Error(`unknown command: ${cmd}`);
-	}
+	return mods.length ? mods : undefined;
+};
+
+const BUILDERS: Record<string, (positional: string[]) => Action> = {
+	key: (p) => {
+		if (!p[0]) throw new Error("key requires a <key> argument");
+		return { t: "key", k: p[0], mods: modsOrUndefined(p) };
+	},
+	arrow: (p) => {
+		if (!p[0] || !["up", "down", "left", "right"].includes(p[0]))
+			throw new Error("arrow requires up|down|left|right");
+		return {
+			t: "arrow",
+			d: p[0] as "up" | "down" | "left" | "right",
+			mods: modsOrUndefined(p),
+		};
+	},
+	enter: (p) => ({ t: "enter", mods: modsOrUndefined(p) }),
+	escape: (p) => ({ t: "escape", mods: modsOrUndefined(p) }),
+	tab: (p) => ({ t: "tab", mods: modsOrUndefined(p) }),
+	space: (p) => ({ t: "space", mods: modsOrUndefined(p) }),
+	backspace: (p) => ({ t: "backspace", mods: modsOrUndefined(p) }),
+	type: (p) => {
+		if (p[0] === undefined) throw new Error("type requires <text>");
+		// Re-join the rest in case text had spaces; p[0] already is first token,
+		// caller should quote. We join all positional as the text.
+		return { t: "type", s: p.join(" ") };
+	},
+	wait: (p) => {
+		if (!p[0]) throw new Error("wait requires <ms>");
+		return { t: "wait", ms: parseInt(p[0], 10) || 0 };
+	},
+	resize: (p) => {
+		if (!p[0] || !p[1]) throw new Error("resize requires <w> <h>");
+		return {
+			t: "resize",
+			w: parseInt(p[0], 10) || 100,
+			h: parseInt(p[1], 10) || 30,
+		};
+	},
+};
+
+function buildAction(cmd: string, positional: string[]): Action | null {
+	const builder = BUILDERS[cmd];
+	if (builder) return builder(positional);
+	// Local-only commands return early in main before this is reached; keep
+	// the null contract so the public behavior is unchanged.
+	if (
+		cmd === "frame" ||
+		cmd === "state" ||
+		cmd === "reset" ||
+		cmd === "actions" ||
+		cmd === "init" ||
+		cmd === "seed"
+	)
+		return null;
+	// Single table-miss error for any unknown command.
+	throw new Error(`unknown command: ${cmd}`);
 }
 
 // ── Execute one action against a mounted setup ──────────────────────────────
@@ -317,26 +333,53 @@ async function execAction(setup: any, a: Action): Promise<void> {
 	await new Promise((r) => setTimeout(r, 40));
 }
 
-// ── Main ───────────────────────────────────────────────────────────────────
-async function main() {
-	activateSandbox();
-	captureIssues();
+// ── Mount, snapshot & output (extracted from main) ─────────────────────────
+// A line is "visually empty" if it's either fully blank OR contains only
+// box-drawing chars + whitespace (i.e. empty-pane interior padding like
+// "│   │"). Runs of these collapse to a single `…N` marker so an empty
+// 24-row pane costs 1 line, not 18.
+const BOX_CHARS = "│┌┐└─┤├┬┴┼┐┘┌└┤├┬┴┼┌┐└┘─│┤├┬┴┼";
+const isVisuallyEmpty = (l: string): boolean =>
+	l === "" || [...l].every((ch) => ch === " " || BOX_CHARS.includes(ch));
 
-	const argv = process.argv.slice(2);
-	const cmd = argv[0] ?? "frame";
-	const { flags, positional } = parseFlags(argv.slice(1));
+function trimFrame(plainFrame: string): string {
+	const lines = plainFrame
+		.replace(/\n+$/, "")
+		.split("\n")
+		.map((l) => l.replace(/\s+$/, ""));
+	while (lines.length && isVisuallyEmpty(lines[lines.length - 1]))
+		lines.pop();
+	const out: string[] = [];
+	let blank = 0;
+	const flushBlanks = () => {
+		if (blank >= 3) out.push(`  …${blank} empty`);
+		else for (let i = 0; i < blank; i++) out.push("");
+		blank = 0;
+	};
+	for (const l of lines) {
+		if (isVisuallyEmpty(l)) {
+			blank++;
+		} else {
+			flushBlanks();
+			out.push(l);
+		}
+	}
+	flushBlanks();
+	return out.join("\n");
+}
 
-	// Local-only commands that don't mount.
+// Local-only commands that don't mount. Returns true if handled (main returns).
+function runLocal(cmd: string, flags: Record<string, string | boolean>): boolean {
 	if (cmd === "reset") {
 		saveActions([]);
 		console.log("✔ actions log cleared.");
-		return;
+		return true;
 	}
 	if (cmd === "actions") {
 		const a = loadActions();
 		console.log(`Action log (${a.length}):`);
 		console.log(JSON.stringify(a, null, 2));
-		return;
+		return true;
 	}
 	if (cmd === "seed") {
 		const from = String(
@@ -349,9 +392,29 @@ async function main() {
 		const dest = join(process.env.XDG_CONFIG_HOME!, "podtui");
 		cpSync(from, dest, { recursive: true });
 		console.log(`✔ seeded sandbox config from ${from} → ${dest}`);
-		return;
+		return true;
 	}
+	return false;
+}
 
+type FrameCapture = {
+	lines: { spans: Span[] }[];
+	cols: number;
+	rows: number;
+	cursor: [number, number];
+};
+
+async function mountApp(
+	flags: Record<string, string | boolean>,
+	cmd: string,
+	positional: string[],
+): Promise<{
+	setup: any;
+	spans: FrameCapture;
+	plainFrame: string;
+	audioControls: any;
+	actions: Action[];
+}> {
 	// Size settings.
 	let width = 100;
 	let height = 30;
@@ -436,16 +499,9 @@ async function main() {
 	}
 	if (newAction) {
 		if (flags.audio && audioControls?.switchBackend) {
-			// Re-detect: clear env so detection picks the best real backend.
-			delete process.env.PODTUI_AUDIO_BACKEND;
 			// Force (re)creation of a real backend; useAudio caches, switchBackend resets.
+			delete process.env.PODTUI_AUDIO_BACKEND;
 			await audioControls.switchBackend("mpv").catch(() => {});
-			if (
-				!audioControls.backendName() ||
-				audioControls.backendName() === "none"
-			) {
-				await audioControls.switchBackend("afplay").catch(() => {});
-			}
 		}
 		actions.push(newAction);
 		saveActions(actions);
@@ -455,12 +511,7 @@ async function main() {
 	// Final settle + capture.
 	await setup.renderOnce();
 	await new Promise((r) => setTimeout(r, 60));
-	const spans = setup.captureSpans() as {
-		lines: { spans: Span[] }[];
-		cols: number;
-		rows: number;
-		cursor: [number, number];
-	};
+	const spans = setup.captureSpans() as FrameCapture;
 	const plainFrame = setup.captureCharFrame();
 
 	// Dump structured spans + plain frame.
@@ -469,6 +520,10 @@ async function main() {
 		writeFileSync(FRAME_TXT, plainFrame);
 	} catch {}
 
+	return { setup, spans, plainFrame, audioControls, actions };
+}
+
+async function snapshotState(audioControls: any): Promise<Record<string, unknown>> {
 	// Store state snapshot.
 	const state: Record<string, unknown> = {};
 	try {
@@ -521,54 +576,31 @@ async function main() {
 	try {
 		writeFileSync(STATE_JSON, JSON.stringify(state));
 	} catch {}
+	return state;
+}
 
-	// ── Output ──────────────────────────────────────────────────────────────
+function emitOutput(p: {
+	spans: FrameCapture;
+	plainFrame: string;
+	state: Record<string, unknown>;
+	actions: Action[];
+	cmd: string;
+	flags: Record<string, string | boolean>;
+	positional: string[];
+}): void {
 	// Compact by default: trimmed frame, one-line state per section, no styles
 	// block, no boilerplate footer. Use --styles / --verbose to opt back in.
-	const verbose = !!flags.verbose;
-	const scope = cmd === "state" ? String(positional[0] || "all") : "all";
-
-	// A line is "visually empty" if it's either fully blank OR contains only
-	// box-drawing chars + whitespace (i.e. empty-pane interior padding like
-	// "│   │"). Runs of these collapse to a single `…N` marker so an empty
-	// 24-row pane costs 1 line, not 18.
-	const BOX_CHARS = "│┌┐└─┤├┬┴┼┐┘┌└┤├┬┴┼┌┐└┘─│┤├┬┴┼";
-	const isVisuallyEmpty = (l: string): boolean =>
-		l === "" || [...l].every((ch) => ch === " " || BOX_CHARS.includes(ch));
-	const frameTrimmed = (() => {
-		const lines = plainFrame
-			.replace(/\n+$/, "")
-			.split("\n")
-			.map((l) => l.replace(/\s+$/, ""));
-		while (lines.length && isVisuallyEmpty(lines[lines.length - 1]))
-			lines.pop();
-		const out: string[] = [];
-		let blank = 0;
-		const flushBlanks = () => {
-			if (blank >= 3) out.push(`  …${blank} empty`);
-			else for (let i = 0; i < blank; i++) out.push("");
-			blank = 0;
-		};
-		for (const l of lines) {
-			if (isVisuallyEmpty(l)) {
-				blank++;
-			} else {
-				flushBlanks();
-				out.push(l);
-			}
-		}
-		flushBlanks();
-		return out.join("\n");
-	})();
+	const verbose = !!p.flags.verbose;
+	const scope = p.cmd === "state" ? String(p.positional[0] || "all") : "all";
 
 	console.log(
-		`FRAME ${spans.cols}x${spans.rows} cur=${spans.cursor[0]},${spans.cursor[1]} acts=${actions.length} ${cmd}`,
+		`FRAME ${p.spans.cols}x${p.spans.rows} cur=${p.spans.cursor[0]},${p.spans.cursor[1]} acts=${p.actions.length} ${p.cmd}`,
 	);
-	console.log(frameTrimmed);
+	console.log(trimFrame(p.plainFrame));
 
 	// ── distinct styles: opt-in only (--styles OR --verbose) ──
-	if (scope === "all" && (flags.styles || verbose)) {
-		const styles = distinctStyles(spans);
+	if (scope === "all" && (p.flags.styles || verbose)) {
+		const styles = distinctStyles(p.spans);
 		if (styles.length) {
 			console.log("-- styles (top 20) --");
 			for (const s of styles) console.log(`  ${s.tag} ×${s.n} “${s.sample}”`);
@@ -579,9 +611,9 @@ async function main() {
 	const want = (k: string) => scope === "all" || scope === k;
 	const compact = (obj: unknown): string =>
 		verbose ? JSON.stringify(obj, null, 2) : JSON.stringify(obj);
-	if (want("nav")) console.log("nav " + compact(state.nav));
-	if (want("audio")) console.log("audio " + compact(state.audio));
-	if (want("feed")) console.log("feed " + compact(state.feed));
+	if (want("nav")) console.log("nav " + compact(p.state.nav));
+	if (want("audio")) console.log("audio " + compact(p.state.audio));
+	if (want("feed")) console.log("feed " + compact(p.state.feed));
 	if (want("app")) console.log("app (not dumped in v1)");
 
 	// ── issues: terse ──
@@ -593,12 +625,14 @@ async function main() {
 	}
 
 	// Footer is identical every run — only print on init or --verbose.
-	if (cmd === "init" || verbose) {
+	if (p.cmd === "init" || verbose) {
 		console.log(
 			`(spans ${FRAME_JSON} | frame ${FRAME_TXT} | state ${STATE_JSON})`,
 		);
 	}
+}
 
+async function teardown(setup: any, audioControls: any): Promise<void> {
 	// Tear down child processes (audio backend) before exit to avoid orphans.
 	try {
 		if (audioControls?.stop) await audioControls.stop().catch(() => {});
@@ -613,6 +647,32 @@ async function main() {
 	process.exit(0);
 }
 
+// ── Main ───────────────────────────────────────────────────────────────────
+async function main() {
+	activateSandbox();
+	captureIssues();
+
+	const argv = process.argv.slice(2);
+	const cmd = argv[0] ?? "frame";
+	const { flags, positional } = parseFlags(argv.slice(1));
+
+	// Local-only commands that don't mount.
+	if (runLocal(cmd, flags)) return;
+
+	const m = await mountApp(flags, cmd, positional);
+	const state = await snapshotState(m.audioControls);
+	emitOutput({
+		spans: m.spans,
+		plainFrame: m.plainFrame,
+		state,
+		actions: m.actions,
+		cmd,
+		flags,
+		positional,
+	});
+	await teardown(m.setup, m.audioControls);
+}
+
 main().catch((err) => {
 	console.error("HARNESS FAILED:", err?.stack || err);
 	process.exit(1);

src/App.tsx

@@ -1,6 +1,5 @@
 import { ErrorBoundary } from "solid-js";
 import { useSelectionHandler, useRenderer } from "@opentui/solid";
-import { useAuthStore } from "@/stores/auth";
 import { useAudio } from "@/hooks/useAudio";
 import { useMultimediaKeys } from "@/hooks/useMultimediaKeys";
 import { Clipboard } from "@/utils/clipboard";
@@ -19,7 +18,6 @@ const DEBUG = import.meta.env.DEBUG;
 
 export function App() {
 	const nav = useNavigation();
-	const auth = useAuthStore();
 	const audio = useAudio();
 	const toast = useToast();
 	const renderer = useRenderer();
@@ -52,6 +50,7 @@ export function App() {
 	});
 
 	const backgroundColor = () =>
+		themeContext.transparentBackground() ||
 		themeContext.selected === "system"
 			? "transparent"
 			: themeContext.theme.surface;

src/api/client.ts

@@ -1,73 +0,0 @@
-import type { Feed } from "../types/feed"
-import type { Episode } from "../types/episode"
-import type { Podcast } from "../types/podcast"
-import type { PodcastSource } from "../types/source"
-import { parseRSSFeed } from "@/api/rss-parser"
-import { handleAPISource, handleCustomSource, handleRSSSource } from "@/api/source-handler"
-
-export const fetchEpisodes = async (feedUrl: string): Promise<Episode[]> => {
-  try {
-    const response = await fetch(feedUrl)
-    if (!response.ok) return []
-    const xml = await response.text()
-    return parseRSSFeed(xml, feedUrl).episodes
-  } catch {
-    return []
-  }
-}
-
-export const fetchFeeds = async (
-  sourceIds: string[],
-  sources: PodcastSource[]
-): Promise<Feed[]> => {
-  const active = sources.filter((source) => sourceIds.includes(source.id))
-  const feeds: Feed[] = []
-
-  await Promise.all(
-    active.map(async (source) => {
-      try {
-        if (source.type === "rss") {
-          const rssFeeds = await handleRSSSource(source)
-          feeds.push(...rssFeeds)
-        } else if (source.type === "api") {
-          const apiFeeds = await handleAPISource(source, "")
-          feeds.push(...apiFeeds)
-        } else {
-          const customFeeds = await handleCustomSource(source, "")
-          feeds.push(...customFeeds)
-        }
-      } catch {
-        // ignore individual source errors
-      }
-    })
-  )
-
-  return feeds
-}
-
-export const searchPodcasts = async (
-  query: string,
-  sources: PodcastSource[]
-): Promise<Podcast[]> => {
-  const results: Podcast[] = []
-  await Promise.all(
-    sources.map(async (source) => {
-      try {
-        if (source.type === "rss") {
-          const feeds = await handleRSSSource(source)
-          results.push(...feeds.map((feed: Feed) => feed.podcast))
-        } else if (source.type === "api") {
-          const feeds = await handleAPISource(source, query)
-          results.push(...feeds.map((feed: Feed) => feed.podcast))
-        } else {
-          const feeds = await handleCustomSource(source, query)
-          results.push(...feeds.map((feed: Feed) => feed.podcast))
-        }
-      } catch {
-        // ignore errors
-      }
-    })
-  )
-
-  return results
-}

src/api/source-handler.ts

@@ -1,94 +0,0 @@
-import { FeedVisibility } from "../types/feed"
-import type { Feed } from "../types/feed"
-import type { PodcastSource } from "../types/source"
-import type { Podcast } from "../types/podcast"
-import { parseRSSFeed } from "./rss-parser"
-
-const buildFeedFromPodcast = (podcast: Podcast, sourceId: string): Feed => {
-  return {
-    id: `${sourceId}-${podcast.id}`,
-    podcast,
-    episodes: [],
-    visibility: FeedVisibility.PUBLIC,
-    sourceId,
-    lastUpdated: new Date(),
-    isPinned: false,
-  }
-}
-
-export const handleRSSSource = async (source: PodcastSource): Promise<Feed[]> => {
-  if (!source.baseUrl) return []
-  const response = await fetch(source.baseUrl)
-  if (!response.ok) return []
-  const xml = await response.text()
-  const parsed = parseRSSFeed(xml, source.baseUrl)
-  return [
-    {
-      id: `${source.id}-${parsed.feedUrl}`,
-      podcast: {
-        id: parsed.id,
-        title: parsed.title,
-        description: parsed.description,
-        feedUrl: parsed.feedUrl,
-        author: parsed.author,
-        categories: parsed.categories,
-        lastUpdated: parsed.lastUpdated,
-        isSubscribed: true,
-      },
-      episodes: parsed.episodes,
-      visibility: FeedVisibility.PUBLIC,
-      sourceId: source.id,
-      lastUpdated: parsed.lastUpdated,
-      isPinned: false,
-    },
-  ]
-}
-
-export const handleAPISource = async (
-  source: PodcastSource,
-  query: string
-): Promise<Feed[]> => {
-  const url = new URL(source.baseUrl || "https://itunes.apple.com/search")
-  url.searchParams.set("term", query || "podcast")
-  url.searchParams.set("media", "podcast")
-  url.searchParams.set("entity", "podcast")
-  url.searchParams.set("country", source.country || "US")
-  url.searchParams.set("lang", source.language || "en_us")
-
-  const response = await fetch(url.toString())
-  if (!response.ok) return []
-  const data = (await response.json()) as { results?: Array<{ collectionId?: number; collectionName?: string; feedUrl?: string; artistName?: string }> }
-  const results = data.results ?? []
-
-  return results
-    .filter((item) => item.collectionName && item.feedUrl)
-    .map((item) => {
-      const podcast: Podcast = {
-        id: item.collectionId ? `itunes-${item.collectionId}` : `${source.id}-${item.collectionName}`,
-        title: item.collectionName || "Untitled Podcast",
-        description: item.collectionName || "",
-        feedUrl: item.feedUrl || "",
-        author: item.artistName,
-        lastUpdated: new Date(),
-        isSubscribed: false,
-      }
-      return buildFeedFromPodcast(podcast, source.id)
-    })
-}
-
-export const handleCustomSource = async (
-  source: PodcastSource,
-  query: string
-): Promise<Feed[]> => {
-  if (!query) return []
-  const podcast: Podcast = {
-    id: `${source.id}-${query.toLowerCase().replace(/\s+/g, "-")}`,
-    title: `${query} Highlights`,
-    description: `Curated results for ${query}`,
-    feedUrl: source.baseUrl || "",
-    author: source.name,
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  }
-  return [buildFeedFromPodcast(podcast, source.id)]
-}

src/components/CodeValidation.tsx

@@ -1,180 +0,0 @@
-/**
- * Code validation component for PodTUI
- * 8-character alphanumeric code input for sync authentication
- */
-
-import { createSignal } from "solid-js";
-import { useAuthStore } from "@/stores/auth";
-import { AUTH_CONFIG } from "@/config/auth";
-import { useTheme } from "@/context/ThemeContext";
-
-interface CodeValidationProps {
-  focused?: boolean;
-  onBack?: () => void;
-}
-
-type FocusField = "code" | "submit" | "back";
-
-export function CodeValidation(props: CodeValidationProps) {
-  const auth = useAuthStore();
-  const { theme } = useTheme();
-  const [code, setCode] = createSignal("");
-  const [focusField, setFocusField] = createSignal<FocusField>("code");
-  const [codeError, setCodeError] = createSignal<string | null>(null);
-
-  const fields: FocusField[] = ["code", "submit", "back"];
-
-  /** Format code as user types (uppercase, alphanumeric only) */
-  const handleCodeInput = (value: string) => {
-    const formatted = value.toUpperCase().replace(/[^A-Z0-9]/g, "");
-    // Limit to max length
-    const limited = formatted.slice(0, AUTH_CONFIG.codeValidation.codeLength);
-    setCode(limited);
-
-    // Clear error when typing
-    if (codeError()) {
-      setCodeError(null);
-    }
-  };
-
-  const validateCode = (value: string): boolean => {
-    if (!value) {
-      setCodeError("Code is required");
-      return false;
-    }
-    if (value.length !== AUTH_CONFIG.codeValidation.codeLength) {
-      setCodeError(
-        `Code must be ${AUTH_CONFIG.codeValidation.codeLength} characters`,
-      );
-      return false;
-    }
-    if (!AUTH_CONFIG.codeValidation.allowedChars.test(value)) {
-      setCodeError("Code must contain only letters and numbers");
-      return false;
-    }
-    setCodeError(null);
-    return true;
-  };
-
-  const handleSubmit = async () => {
-    if (!validateCode(code())) {
-      return;
-    }
-
-    const success = await auth.validateCode(code());
-    if (!success && auth.error) {
-      setCodeError(auth.error.message);
-    }
-  };
-
-  const handleKeyPress = (key: { name: string; shift?: boolean }) => {
-    if (key.name === "tab") {
-      const currentIndex = fields.indexOf(focusField());
-      const nextIndex = key.shift
-        ? (currentIndex - 1 + fields.length) % fields.length
-        : (currentIndex + 1) % fields.length;
-      setFocusField(fields[nextIndex]);
-    } else if (key.name === "return" || key.name === "tab") {
-      if (focusField() === "submit") {
-        handleSubmit();
-      } else if (focusField() === "back" && props.onBack) {
-        props.onBack();
-      }
-    } else if (key.name === "escape" && props.onBack) {
-      props.onBack();
-    }
-  };
-
-  const codeProgress = () => {
-    const len = code().length;
-    const max = AUTH_CONFIG.codeValidation.codeLength;
-    return `${len}/${max}`;
-  };
-
-  const codeDisplay = () => {
-    const current = code();
-    const max = AUTH_CONFIG.codeValidation.codeLength;
-    const filled = current.split("");
-    const empty = Array(max - filled.length).fill("_");
-    return [...filled, ...empty].join(" ");
-  };
-
-  return (
-    <box flexDirection="column" border padding={2} gap={1} borderColor={theme.border}>
-      <text fg={theme.text}>
-        <strong>Enter Sync Code</strong>
-      </text>
-
-      <box height={1} />
-
-      <text fg={theme.textMuted}>
-        Enter your 8-character sync code to link your account.
-      </text>
-      <text fg={theme.textMuted}>You can get this code from the web portal.</text>
-
-      <box height={1} />
-
-      {/* Code display */}
-      <box flexDirection="column" gap={0}>
-      <text fg={focusField() === "code" ? theme.primary : undefined}>
-            Code ({codeProgress()}):
-          </text>
-
-        <box border padding={1} borderColor={theme.border}>
-          <text
-            fg={
-              code().length === AUTH_CONFIG.codeValidation.codeLength
-                ? theme.success
-                : theme.warning
-            }
-          >
-            {codeDisplay()}
-          </text>
-        </box>
-
-        {/* Hidden input for actual typing */}
-        <input
-          value={code()}
-          onInput={handleCodeInput}
-          placeholder=""
-          focused={props.focused && focusField() === "code"}
-          width={30}
-        />
-
-        {codeError() && <text fg={theme.error}>{codeError()}</text>}
-      </box>
-
-      <box height={1} />
-
-      {/* Action buttons */}
-      <box flexDirection="row" gap={2}>
-        <box
-          border
-          padding={1}
-          backgroundColor={focusField() === "submit" ? theme.backgroundElement : undefined}
-        >
-          <text fg={focusField() === "submit" ? theme.primary : undefined}>
-            {auth.isLoading ? "Validating..." : "[Enter] Validate Code"}
-          </text>
-        </box>
-
-        <box
-          border
-          padding={1}
-          backgroundColor={focusField() === "back" ? theme.backgroundElement : undefined}
-        >
-          <text fg={focusField() === "back" ? theme.warning : theme.textMuted}>
-            [Esc] Back to Login
-          </text>
-        </box>
-      </box>
-
-      {/* Auth error message */}
-      {auth.error && <text fg={theme.error}>{auth.error.message}</text>}
-
-      <box height={1} />
-
-      <text fg={theme.textMuted}>Tab to navigate, Enter to select, Esc to go back</text>
-    </box>
-  );
-}

src/components/LoadingIndicator.tsx

@@ -1,24 +1,30 @@
-import { createSignal, createMemo, onCleanup } from "solid-js";
+import { createSignal, createMemo, Show, onCleanup } from "solid-js";
 import { useTheme } from "@/context/ThemeContext";
 
 const spinnerChars = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
-//TODO: Watch for actual loading state (fetching feeds)
-export function LoadingIndicator() {
-  const { theme } = useTheme();
-  const [index, setIndex] = createSignal(0);
+/**
+ * Animated braille spinner with an optional label (e.g. "Refreshing…").
+ * The spinner is rendered in the theme primary color; the label in muted.
+ */
+export function LoadingIndicator(props: { label?: string }) {
+	const { theme } = useTheme();
+	const [index, setIndex] = createSignal(0);
 
-  const interval = setInterval(() => {
-    setIndex((i) => (i + 1) % spinnerChars.length);
-  }, 65);
+	const interval = setInterval(() => {
+		setIndex((i) => (i + 1) % spinnerChars.length);
+	}, 65);
 
-  onCleanup(() => clearInterval(interval));
+	onCleanup(() => clearInterval(interval));
 
-  const currentChar = createMemo(() => spinnerChars[index()]);
+	const currentChar = createMemo(() => spinnerChars[index()]);
 
-  return (
-    <box flexDirection="row" justifyContent="flex-end" alignItems="flex-start">
-      <text fg={theme.primary} content={currentChar()} />
-    </box>
-  );
+	return (
+		<box flexDirection="row" gap={1} alignItems="flex-start">
+			<text fg={theme.primary} content={currentChar()} />
+			<Show when={props.label}>
+				<text fg={theme.muted || theme.text} content={props.label} />
+			</Show>
+		</box>
+	);
 }

src/components/Navigation.tsx

@@ -1,28 +0,0 @@
-import type { TabId } from "./Tab"
-import { useTheme } from "@/context/ThemeContext"
-
-type NavigationProps = {
-  activeTab: TabId
-  onTabSelect: (tab: TabId) => void
-}
-
-export function Navigation(props: NavigationProps) {
-  const { theme } = useTheme();
-  return (
-    <box style={{ flexDirection: "row", width: "100%", height: 1 }}>
-      <text fg={theme.text}>
-        {props.activeTab === "feed" ? "[" : " "}Feed{props.activeTab === "feed" ? "]" : " "}
-        <span> </span>
-        {props.activeTab === "shows" ? "[" : " "}My Shows{props.activeTab === "shows" ? "]" : " "}
-        <span> </span>
-        {props.activeTab === "discover" ? "[" : " "}Discover{props.activeTab === "discover" ? "]" : " "}
-        <span> </span>
-        {props.activeTab === "search" ? "[" : " "}Search{props.activeTab === "search" ? "]" : " "}
-        <span> </span>
-        {props.activeTab === "player" ? "[" : " "}Player{props.activeTab === "player" ? "]" : " "}
-        <span> </span>
-        {props.activeTab === "settings" ? "[" : " "}Settings{props.activeTab === "settings" ? "]" : " "}
-      </text>
-    </box>
-  )
-}

src/components/PaneRow.tsx

@@ -0,0 +1,215 @@
+/**
+ * PaneRow — the shared parent | current | preview 3-pane layout primitive.
+ *
+ * Implements yazi's `mgr.ratio = [1, 2, 2]` contract: three columns grow at
+ * 1/5 : 2/5 : 2/5 of the row width via Yoga `flexGrow`, so every list tab
+ * renders an identical, layout-stable shell. Columns use `flexBasis={0}` so
+ * the ratio is exact regardless of content width — a column's content can
+ * never stretch its slot.
+ *
+ * Column semantics (per the yazi depth model):
+ *   parent  — the previous-depth list. Renders a muted `—` placeholder and
+ *             KEEPS its 1/5 slot when blank (never collapses to width 0).
+ *             Borderless (no left/right/top/bottom edge). Carries the single
+ *             header row: the CURRENT column's title renders top-left in the
+ *             parent's slot (the panes above current/preview were removed).
+ *   current — the current-depth list. The only focusable content column; it
+ *             is the ONLY bordered column — left/right edges only, always
+ *             muted (no active-border highlight, focused or not).
+ *   preview — detail of the hovered item in `current`. Borderless, no header.
+ *
+ * The primitive is purely structural: callers pass their own JSX per column
+ * (static elements or accessors) plus the current-column title. Theme colors
+ * are resolved internally via `useTheme()`. Only the current column's
+ * `<scrollbox>` receives `focused`, so scroll focus follows the cursor (j/k
+ * stay in the current pane).
+ *
+ * Example:
+ *   <PaneRow
+ *     parent={parentList}
+ *     current={currentList}
+ *     preview={detail}
+ *     currentLabel="List · 42"
+ *     focused={isActive}
+ *   />
+ */
+
+import { createMemo, Show } from "solid-js";
+import type { JSX } from "solid-js";
+import type { RGBA, BorderSides } from "@opentui/core";
+import { useTheme } from "@/context/ThemeContext";
+import { PANE_RATIO } from "@/utils/navigation";
+
+// ── Types ───────────────────────────────────────────────────────────────────
+type PaneContent = JSX.Element | (() => JSX.Element);
+type PaneLabel = string | (() => string);
+
+export type PaneRowProps = {
+	/** Parent column content (previous-depth list, or null for a muted
+	 *  placeholder — the 1/5 slot is always preserved). */
+	parent?: PaneContent;
+	/** Current column content (the focused list). */
+	current?: PaneContent;
+	/** Preview column content (detail of the hovered item). Omit/undefined
+	 *  together with `panes={2}` to render a 2-pane parent|current row. */
+	preview?: PaneContent;
+	/** Title of the current column — rendered once, top-left in the parent
+	 *  pane's header slot (the per-pane Up/Detail headers are gone). */
+	currentLabel?: PaneLabel;
+	/** Whether the current column's `<scrollbox>` receives scroll focus. Defaults to
+	 *  true; pass `false` (or a signal) when the row is inactive. Does NOT change
+	 *  border colors — the current column's border is always muted. */
+	focused?: boolean | (() => boolean);
+	/** Number of visible columns. `3` (default) = parent|current|preview;
+	 *  `2` = parent|current (preview omitted, current grows to fill). */
+	panes?: 2 | 3;
+};
+
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function resolveLabel(v: PaneLabel | undefined): string {
+	if (v == null) return "";
+	return typeof v === "function" ? v() : v;
+}
+
+/** Normalize a PaneContent (static JSX or accessor) into a reactive accessor.
+ *  We deliberately avoid Solid's `children()` helper: it flattens accessor
+ *  children into a stable resolved-nodes array and won't re-resolve on a
+ *  truthy→truthy root swap (e.g. the current pane switching between a
+ *  depth-1 list fragment and a depth-2 editor), freezing the previous
+ *  subtree. Instead the raw accessor feeds a reactive `{ expr ?? <Placeholder/> }`
+ *  expression — a tracked `insert` effect that disposes the old subtree and
+ *  mounts the new whenever the accessor returns a different element identity. */
+function normalizeContent(
+	v: PaneContent | undefined,
+): () => JSX.Element | undefined {
+	if (v == null) return () => undefined;
+	return typeof v === "function" ? (v as () => JSX.Element) : () => v;
+}
+
+function Placeholder(props: { color: () => RGBA }) {
+	return (
+		<box padding={1}>
+			<text fg={props.color()}>—</text>
+		</box>
+	);
+}
+
+// ── Pane column ─────────────────────────────────────────────────────────────
+function Pane(props: {
+	grow: number;
+	label: () => string;
+	content: () => JSX.Element | undefined;
+	border: boolean | BorderSides[];
+	scrollFocused: () => boolean;
+}) {
+	const themeContext = useTheme();
+	const theme = themeContext.theme;
+	const muted = () => theme.muted ?? theme.textMuted ?? theme.text;
+
+	// Memoize the scroll-focus accessor result so the prop expression below
+	// stays reactive when the underlying signal (e.g. `focused`) changes.
+	const scrollFocused = createMemo(() => props.scrollFocused());
+
+	return (
+		<box
+			flexDirection="column"
+			flexGrow={props.grow}
+			flexBasis={0}
+			height="100%"
+		>
+			{/* ── title row: rendered only when the pane carries a label ────────── */}
+			<Show when={props.label() !== ""}>
+				<box
+					height={1}
+					paddingLeft={1}
+					backgroundColor={
+						themeContext.transparentBackground()
+							? "transparent"
+							: theme.background
+					}
+				>
+					<text fg={theme.textSecondary}>{props.label()}</text>
+				</box>
+			</Show>
+			{/* ── scrollbox; border always muted (focused or not) ──────────────── */}
+			<scrollbox
+				height="100%"
+				focused={scrollFocused()}
+				border={props.border}
+				// Only supply colors when a border is requested — opentui flips a
+				// borderless box to bordered when borderColor/focusedBorderColor
+				// are passed, which would frame the parent/preview panes too.
+				borderColor={props.border === false ? undefined : theme.border}
+				focusedBorderColor={
+					props.border === false ? undefined : theme.border
+				}
+				backgroundColor={
+					themeContext.transparentBackground()
+						? "transparent"
+						: theme.background
+				}
+			>
+			{props.content() ?? <Placeholder color={muted} />}
+			</scrollbox>
+		</box>
+	);
+}
+
+// ── Row primitive ───────────────────────────────────────────────────────────
+export function PaneRow(props: PaneRowProps) {
+	/** true → the current column's scrollbox is focused (scroll follows cursor). */
+	const focused = createMemo(() => {
+		const f = props.focused;
+		return typeof f === "function" ? f() : (f ?? true);
+	});
+
+	// Normalize static JSX and accessor children into reactive accessors
+	// (see normalizeContent for why we avoid Solid's `children()` helper).
+	const parentContent = normalizeContent(props.parent);
+	const currentContent = normalizeContent(props.current);
+	const previewContent = normalizeContent(props.preview);
+
+	// The single title: the CURRENT column's label, rendered in the parent
+	// pane's header slot (top-left). Current/preview panes have no headers.
+	const currentLabel = createMemo(() => resolveLabel(props.currentLabel));
+
+	// 2-pane mode (parent|current) grows the current column to fill the
+	// preview slot. Defaults to 3 (parent|current|preview).
+	const panes = createMemo(() => props.panes ?? 3);
+	const currentGrow = createMemo(() =>
+		panes() === 2
+			? PANE_RATIO.current + PANE_RATIO.preview
+			: PANE_RATIO.current,
+	);
+
+	return (
+		<box flexDirection="row" flexGrow={1} width="100%" height="100%">
+			{/* ── parent (1/5) — previous-depth list; title row top-left ───────── */}
+			<Pane
+				grow={PANE_RATIO.parent}
+				label={currentLabel}
+				content={parentContent}
+				border={false}
+				scrollFocused={() => false}
+			/>
+			{/* ── current — the focused list; left/right borders only ─────────── */}
+			<Pane
+				grow={currentGrow()}
+				label={() => ""}
+				content={currentContent}
+				border={["left", "right"]}
+				scrollFocused={() => focused()}
+			/>
+			{/* ── preview (2/5) — hovered-item detail; no border, no header ────── */}
+			<Show when={panes() === 3}>
+				<Pane
+					grow={PANE_RATIO.preview}
+					label={() => ""}
+					content={previewContent}
+					border={false}
+					scrollFocused={() => false}
+				/>
+			</Show>
+		</box>
+	);
+}

src/components/Selectable.tsx

@@ -20,7 +20,8 @@ export const SelectableBox: ParentComponent<
       backgroundColor={
         props.selected()
           ? theme.primary
-          : themeContext.selected === "system"
+          : themeContext.transparentBackground() ||
+              themeContext.selected === "system"
             ? "transparent"
             : themeContext.theme.surface
       }

src/components/Shell.tsx

@@ -12,30 +12,21 @@
  */
 
 import { createSignal, Show, For } from "solid-js";
-import { useKeyboard } from "@opentui/solid";
+import { useKeyboard, useRenderer } from "@opentui/solid";
 import { useTheme } from "@/context/ThemeContext";
 import { useKeybinds, type KeybindActionName } from "@/context/KeybindContext";
 import { useNavigation, NavMode } from "@/context/NavigationContext";
 import { useAudio } from "@/hooks/useAudio";
-import { useAudioNavStore, AudioSource } from "@/stores/audio-nav";
+import { useAudioNavStore } from "@/stores/audio-nav";
 import { useFeedStore } from "@/stores/feed";
-import type { Episode } from "@/types/episode";
+import { useAppStore } from "@/stores/app";
 import { useToast } from "@/ui/toast";
-import { emit } from "@/utils/event-bus";
+import { emit, on } from "@/utils/event-bus";
 import { LayerGraph } from "@/utils/layer-graph";
-import { TABS, TabPaneCount } from "@/utils/navigation";
+import { TABS } from "@/utils/navigation";
 import { createDispatcher } from "@/utils/dispatch";
 import { TabListPane } from "@/components/TabPanel";
-import { YaziPaneRow } from "@/components/YaziPaneRow";
-
-const TAB_LABEL: Record<TABS, string> = {
-	[TABS.FEED]: "Feed",
-	[TABS.MYSHOWS]: "My Shows",
-	[TABS.DISCOVER]: "Discover",
-	[TABS.SEARCH]: "Search",
-	[TABS.PLAYER]: "Player",
-	[TABS.SETTINGS]: "Settings",
-};
+import { PaneRow } from "@/components/PaneRow";
 
 export function Shell() {
 	const theme = useTheme();
@@ -43,12 +34,25 @@ export function Shell() {
 	const nav = useNavigation();
 	const k = useKeybinds();
 	const audio = useAudio();
+	const renderer = useRenderer();
 	const audioNav = useAudioNavStore();
 	const toast = useToast();
 	const feedStore = useFeedStore();
 
 	const [showHelp, setShowHelp] = createSignal(false);
 
+	// ── Auto jump to Player on podcast start ───────────────────────────────────
+	// Honor the `autoJumpToPlayer` preference: when a NEW episode starts (see
+	// "player.started" — distinct from "player.play", which also fires on
+	// resume), switch to the Player tab and drop into its content pane.
+	on("player.started", () => {
+		const app = useAppStore();
+		if (app.state().preferences.autoJumpToPlayer) {
+			nav.setActiveTab(TABS.PLAYER);
+			nav.enterTabContent(); // PLAYER is a depth-tab — enter its content.
+		}
+	});
+
 	/** Play the episode adjacent (offset ±1) to the currently-playing one,
 	 *  within its feed's episode list. Updates audio-nav context accordingly. */
 	function advanceEpisode(offset: number) {
@@ -84,74 +88,60 @@ export function Shell() {
 	}
 
 	// ── Command bar dispatch ────────────────────────────────────────────────────
+	const COMMANDS: Record<string, (arg: string) => void> = {
+		quit: () => process.exit(0),
+		exit: () => process.exit(0),
+		q: () => process.exit(0),
+		refresh: () =>
+			emit("nav.action", {
+				action: "refresh",
+				tab: nav.activeTab(),
+				pane: nav.activePane(),
+				mode: nav.mode(),
+			}),
+		r: () =>
+			emit("nav.action", {
+				action: "refresh",
+				tab: nav.activeTab(),
+				pane: nav.activePane(),
+				mode: nav.mode(),
+			}),
+		play: () => audio.togglePlayback().catch(() => {}),
+		pause: () => audio.togglePlayback().catch(() => {}),
+		p: () => audio.togglePlayback().catch(() => {}),
+		next: () => advanceEpisode(1),
+		n: () => advanceEpisode(1),
+		prev: () => advanceEpisode(-1),
+		seek: (arg) => {
+			const n = Number(arg) || 0;
+			audio.seek(n).catch(() => {});
+		},
+		feed: () => nav.setActiveTab(TABS.FEED),
+		f: () => nav.setActiveTab(TABS.FEED),
+		shows: () => nav.setActiveTab(TABS.MYSHOWS),
+		myshows: () => nav.setActiveTab(TABS.MYSHOWS),
+		discover: () => nav.setActiveTab(TABS.DISCOVER),
+		d: () => nav.setActiveTab(TABS.DISCOVER),
+		search: () => nav.setActiveTab(TABS.SEARCH),
+		player: () => nav.setActiveTab(TABS.PLAYER),
+		settings: () => nav.setActiveTab(TABS.SETTINGS),
+		set: () => nav.setActiveTab(TABS.SETTINGS),
+		help: () => setShowHelp((v) => !v),
+		h: () => setShowHelp((v) => !v),
+	};
+
 	function runCommand(raw: string) {
 		const cmd = raw.trim();
 		if (!cmd) return;
 		const name = cmd.split(/\s+/)[0].toLowerCase();
 		const arg = cmd.slice(name.length).trim();
-		switch (name) {
-			case "q":
-			case "quit":
-			case "exit":
-				return process.exit(0);
-			case "refresh":
-			case "r":
-				emit("nav.action", {
-					action: "refresh",
-					tab: nav.activeTab(),
-					pane: nav.activePane(),
-					mode: nav.mode(),
-				});
-				break;
-			case "play":
-			case "pause":
-			case "p":
-				audio.togglePlayback().catch(() => {});
-				break;
-			case "next":
-			case "n":
-				advanceEpisode(1);
-				break;
-			case "prev":
-				advanceEpisode(-1);
-				break;
-			case "seek": {
-				const n = Number(arg) || 0;
-				audio.seek(n).catch(() => {});
-				break;
-			}
-			case "feed":
-			case "f":
-				nav.setActiveTab(TABS.FEED);
-				break;
-			case "shows":
-			case "myshows":
-				nav.setActiveTab(TABS.MYSHOWS);
-				break;
-			case "discover":
-			case "d":
-				nav.setActiveTab(TABS.DISCOVER);
-				break;
-			case "search":
-				nav.setActiveTab(TABS.SEARCH);
-				break;
-			case "player":
-				nav.setActiveTab(TABS.PLAYER);
-				break;
-			case "settings":
-			case "set":
-				nav.setActiveTab(TABS.SETTINGS);
-				break;
-			case "help":
-			case "h":
-				setShowHelp((v) => !v);
-				break;
-			default:
-				nav.setCommandError(`unknown command: ${name}`);
-				// re-enter command mode so the user sees the error + can correct
-				nav.enterCommand();
-				nav.setCommandBuffer(cmd);
-		}
+		const unknownCommand = () => {
+			nav.setCommandError(`unknown command: ${name}`);
+			// re-enter command mode so the user sees the error + can correct
+			nav.enterCommand();
+			nav.setCommandBuffer(cmd);
+		};
+		(COMMANDS[name] ?? unknownCommand)(arg);
 	}
 
 	// ── Command-mode key handling ───────────────────────────────────────────────
@@ -200,8 +190,21 @@ export function Shell() {
 
 	useKeyboard(
 		(evt: any) => {
-			// Input fields (search boxes, dialogs) own their keys.
-			if (nav.inputFocused() && nav.mode() !== NavMode.COMMAND) return;
+			// Input fields (search boxes, dialogs) own their keys — except Escape,
+			// which defocuses the input so j/k/h navigation resumes (search: h back
+			// to the tab root, j/k to move the recent-searches list).
+			if (nav.inputFocused() && nav.mode() !== NavMode.COMMAND) {
+				if (evt.name === "escape") {
+					evt.preventDefault();
+					nav.setInputFocused(false);
+					// Actually blur the focused renderable too — setting the flag alone
+					// leaves the opentui input owning keys, so nav keys would still be
+					// typed into it. Blurring fires our useInputFocusNav BLURRED handler
+					// (and re-blurs the SearchPage input via its `focused` prop).
+					renderer.currentFocusedRenderable?.blur();
+				}
+				return;
+			}
 			if (nav.mode() === NavMode.COMMAND) {
 				handleCommandKey(evt);
 				return;
@@ -229,11 +232,13 @@ export function Shell() {
 
 	return (
 		<box
-			flexDirection="column"
-			width="100%"
-			height="100%"
-			backgroundColor={t.surface}
-		>
+				flexDirection="column"
+				width="100%"
+				height="100%"
+				backgroundColor={
+					theme.transparentBackground() ? "transparent" : t.surface
+				}
+			>
 			{/* ── Middle row: tab list (pane 0) + active tab content (panes 1..n) ─ */}
 			<box flexDirection="row" flexGrow={1} width="100%">
 				<Show
@@ -245,7 +250,7 @@ export function Shell() {
 					}
 				>
 					{/* app root: the tab list is the CURRENT pane, nothing in UP */}
-					<YaziPaneRow
+					<PaneRow
 						parent={
 							<box padding={1}>
 								<text fg={t.textMuted}>—</text>
@@ -257,9 +262,7 @@ export function Shell() {
 								<text fg={t.textMuted}>j/k move · l/Enter open a tab</text>
 							</box>
 						}
-						parentLabel="Up"
 						currentLabel="Tabs"
-						previewLabel=""
 						focused
 					/>
 				</Show>
@@ -269,7 +272,11 @@ export function Shell() {
 				flexDirection="row"
 				height={1}
 				width="100%"
-				backgroundColor={t.backgroundPanel ?? t.background}
+				backgroundColor={
+					theme.transparentBackground()
+						? "transparent"
+						: (t.backgroundPanel ?? t.background)
+				}
 			>
 				<Show
 					when={nav.mode() === NavMode.COMMAND}
@@ -278,15 +285,6 @@ export function Shell() {
 							<text fg={t.accent} paddingLeft={1}>
 								{modeLabel()}
 							</text>
-							<text fg={t.textMuted} paddingLeft={1}>
-								{nav.atRootTab()
-									? "Tabs · root"
-									: `${TAB_LABEL[nav.activeTab()]} · ${
-											nav.isDepthTab()
-												? `depth ${nav.currentDepth()}`
-												: `pane ${nav.activePane()}/${TabPaneCount[nav.activeTab()]}`
-										}`}
-							</text>
 							<Show when={nav.selectedIds().length > 0}>
 								<text fg={t.warning} paddingLeft={1}>
 									● {nav.selectedIds().length}
@@ -451,17 +449,5 @@ function k_match_escape(evt: any): boolean {
 	);
 }
 
-/** Exposed so App can route an externally-triggered "play episode" (e.g. from
- *  search) into the player tab. */
-export function playEpisodeAndSwitch(
-	nav: ReturnType<typeof useNavigation>,
-	audio: ReturnType<typeof useAudio>,
-	episode: import("@/types/episode").Episode,
-) {
-	audio.play(episode);
-	nav.setActiveTab(TABS.PLAYER);
-	useAudioNavStore().setSource(AudioSource.FEED);
-}
-
 // Re-export Episode type for callers building pane trees.
-export type { Episode };
+export type { Episode } from "@/types/episode";

src/components/ShortcutHelp.tsx

@@ -1,27 +0,0 @@
-import { For } from "solid-js";
-import { shortcuts } from "@/config/shortcuts";
-import { useTheme } from "@/context/ThemeContext";
-
-/** Yazi-style keybind reference. The Shell has its own overlay; this component
- *  is kept for embedding inside Settings or other surfaces. */
-export function ShortcutHelp() {
-	const { theme } = useTheme();
-	return (
-		<box
-			border
-			title="Shortcuts"
-			style={{ flexDirection: "column", padding: 1 }}
-		>
-			<box style={{ flexDirection: "column" }}>
-				<For each={shortcuts}>
-					{(s) => (
-						<box style={{ flexDirection: "row" }} gap={2}>
-							<text fg={theme.accent}>{s.keys}</text>
-							<text fg={theme.text}>{s.action}</text>
-						</box>
-					)}
-				</For>
-			</box>
-		</box>
-	);
-}

src/components/TabNavigation.tsx

@@ -1,55 +0,0 @@
-import { useTheme } from "@/context/ThemeContext";
-import { TABS, TabsCount } from "@/utils/navigation";
-import { For } from "solid-js";
-import { SelectableBox, SelectableText } from "@/components/Selectable";
-import { useNavigation } from "@/context/NavigationContext";
-
-export const tabs: TabDefinition[] = [
-  { id: TABS.FEED, label: "Feed" },
-  { id: TABS.MYSHOWS, label: "My Shows" },
-  { id: TABS.DISCOVER, label: "Discover" },
-  { id: TABS.SEARCH, label: "Search" },
-  { id: TABS.PLAYER, label: "Player" },
-  { id: TABS.SETTINGS, label: "Settings" },
-];
-
-export function TabNavigation() {
-  const { theme } = useTheme();
-  const { activeTab, setActiveTab, activeDepth } = useNavigation();
-  return (
-    <box
-      border
-      borderColor={activeDepth() !== 0 ? theme.border : theme.accent}
-      backgroundColor={"transparent"}
-      style={{
-        flexDirection: "column",
-        width: 12,
-        height: TabsCount * 3 + 2,
-      }}
-    >
-      <For each={tabs}>
-        {(tab) => (
-          <SelectableBox
-            border
-            height={3}
-            selected={() => tab.id == activeTab()}
-            onMouseDown={() => setActiveTab(tab.id)}
-          >
-            <SelectableText
-              selected={() => tab.id == activeTab()}
-              primary
-              alignSelf="center"
-            >
-              {tab.label}
-            </SelectableText>
-          </SelectableBox>
-        )}
-      </For>
-    </box>
-  );
-}
-
-export type TabDefinition = {
-  id: TABS;
-  label: string;
-};

src/components/TabPanel.tsx

@@ -2,17 +2,23 @@
  * TabListPane — the tab list as a pane you can drop into the UP | CURRENT |
  * PREVIEW flow (replaces the old fixed chrome tab column).
  *
- * Renders one row per tab (digit + label): the ACTIVE tab gets a ● marker and
- * accent fg; the CURSOR row (the one j/k hovers) gets the primary highlight.
- * `focused` only matters to the surrounding frame (the CURRENT column draws
- * its own accent ring in YaziPaneRow); when rendered as the muted UP/parent
- * column (`muted`), the cursor highlight is suppressed and only the active ●
- * shows, so it reads as the read-only parent listing.
+ * Renders one row per tab (digit + label) using the same selection UI every
+ * other yazi pane uses: the CURSOR row (the one j/k hovers) gets a `❯` marker
+ * and the focus background (`theme.primary` when this pane is the CURRENT
+ * column, `theme.border` when it is the muted UP/parent column). The ACTIVE
+ * tab (the one whose content is open) always carries a `●` marker in accent so
+ * it stays readable in both positions.
+ *
+ * `muted` marks the parent-column rendering: the highlight is dimmed (border
+ * bg, text fg) rather than suppressed, so the Up pane still shows the cursor
+ * and active tab — matching how every other pane's parent column renders its
+ * focused row.
  */
 
 import { For } from "solid-js";
 import { useTheme } from "@/context/ThemeContext";
 import { useNavigation } from "@/context/NavigationContext";
+import { useScrollIntoView } from "@/hooks/useScrollIntoView";
 import { TABS } from "@/utils/navigation";
 
 const TAB_LABEL: Record<TABS, string> = {
@@ -34,40 +40,60 @@ export function TabListPane(props: { muted?: boolean }) {
 	const nav = useNavigation();
 
 	const cursor = () => nav.tabCursor();
-	const active = () => nav.activeTab();
-	const muted = () => props.muted ?? false;
+	const activeTab = () => nav.activeTab();
+	/** `active=true` when this pane is the CURRENT column (Shell root);
+	 *  `false` when it is the muted UP/parent column (pages' parent pane). */
+	const active = () => !props.muted;
+
+	// Same focus-bg / focus-fg contract every other pane uses.
+	const focusBg = (t: TABS) =>
+		t === cursor() && active()
+			? theme.primary
+			: t === cursor()
+				? theme.border
+				: undefined;
+	const focusFg = (t: TABS) =>
+		t === cursor() && active()
+			? theme.surface
+			: t === cursor()
+				? theme.selectedListItemText ?? theme.text
+				: theme.text;
 
 	return (
 		<For each={TAB_ORDER}>
 			{(tab) => {
-				const isCursor = () => cursor() === tab && !muted();
-				const isActive = () => active() === tab;
-				const fg = () =>
+				const isCursor = () => cursor() === tab;
+				const isActive = () => activeTab() === tab;
+				// The active tab is only accented in the Up/parent position — when this
+				// pane is CURRENT, the cursor highlight is the only highlight.
+				const labelFg = () =>
 					isCursor()
-						? theme.textSelectedPrimary
-						: isActive()
+						? focusFg(tab)
+						: isActive() && !active()
 							? theme.accent
 							: theme.text;
+				const ref = useScrollIntoView(isCursor);
 				return (
 					<box
+						ref={ref}
 						width="100%"
 						height={1}
 						flexDirection="row"
-						backgroundColor={isCursor() ? theme.primary : "transparent"}
+						paddingRight={1}
+						backgroundColor={focusBg(tab)}
+						onMouseDown={() => {
+							// Click = hover + open, the yazi "open" of the row
+							// (switches to the tab and enters its content), the same
+							// as l/Enter. Restores mouse support the tab-strip
+							// refactor dropped.
+							nav.setTabCursor(tab);
+							nav.activateTabCursor();
+						}}
 					>
-						<text
-							width={2}
-							fg={isCursor() ? theme.textSelectedPrimary : "transparent"}
-						>
-							{isActive() ? "●" : " "}
-						</text>
-						<text
-							width={2}
-							fg={isCursor() ? theme.textSelectedPrimary : theme.textMuted}
-						>
-							{tab}
-						</text>
-						<text fg={fg()} paddingLeft={1}>
+						{/* ── selection marker (j/k cursor) ─────────────────────────── */}
+						<text fg={focusFg(tab)}>{isCursor() ? "❯" : " "}</text>
+						<text fg={isCursor() ? focusFg(tab) : theme.textMuted}>{tab}</text>
+						<text fg={labelFg()} paddingLeft={1}>
 							{TAB_LABEL[tab]}
 						</text>
 					</box>

src/components/YaziPaneRow.tsx

@@ -1,190 +0,0 @@
-/**
- * YaziPaneRow — the shared parent | current | preview 3-pane layout primitive.
- *
- * Implements yazi's `mgr.ratio = [1, 3, 3]` contract: three bordered columns
- * grow at 1/7 : 3/7 : 3/7 of the row width via Yoga `flexGrow`, so every list
- * tab renders an identical, layout-stable shell. Columns use `flexBasis={0}`
- * so the ratio is exact regardless of content width — a column's content can
- * never stretch its slot.
- *
- * Column semantics (per the yazi depth model):
- *   parent  — the previous-depth list. Renders a muted `—` placeholder and
- *             KEEPS its 1/7 slot when blank (never collapses to width 0).
- *   current — the current-depth list. The only focusable content column; it
- *             carries the accent focus ring when `focused` is truthy.
- *   preview — detail of the hovered item in `current`; always muted border.
- *
- * The primitive is purely structural: callers pass their own JSX per column
- * (static elements or accessors) plus header labels. Theme colors are resolved
- * internally via `useTheme()`. Only the current column's `<scrollbox>` receives
- * `focused`, so scroll focus follows the cursor (j/k stay in the current pane).
- *
- * Example:
- *   <YaziPaneRow
- *     parent={parentList}
- *     current={currentList}
- *     preview={detail}
- *     parentLabel="Up"
- *     currentLabel="List · 42"
- *     previewLabel="Detail"
- *     focused={isActive}
- *   />
- */
-
-import { createMemo } from "solid-js";
-import type { JSX } from "solid-js";
-import type { RGBA } from "@opentui/core";
-import { useTheme } from "@/context/ThemeContext";
-import { PANE_RATIO } from "@/utils/navigation";
-
-// ── Types ───────────────────────────────────────────────────────────────────
-type PaneContent = JSX.Element | (() => JSX.Element);
-type PaneLabel = string | (() => string);
-
-export type YaziPaneRowProps = {
-	/** Parent column content (previous-depth list, or null for a muted
-	 *  placeholder — the 1/7 slot is always preserved). */
-	parent?: PaneContent;
-	/** Current column content (the focused list). */
-	current?: PaneContent;
-	/** Preview column content (detail of the hovered item). */
-	preview?: PaneContent;
-	parentLabel?: PaneLabel;
-	currentLabel?: PaneLabel;
-	previewLabel?: PaneLabel;
-	/** Whether the current column carries the accent focus ring. Defaults to
-	 *  true; pass `false` (or a signal) when the row is inactive. Parent and
-	 *  preview columns always render muted borders. */
-	focused?: boolean | (() => boolean);
-};
-
-// ── Helpers ─────────────────────────────────────────────────────────────────
-function resolveLabel(v: PaneLabel | undefined): string {
-	if (v == null) return "";
-	return typeof v === "function" ? v() : v;
-}
-
-/** Normalize a PaneContent (static JSX or accessor) into a reactive accessor.
- *  We deliberately do NOT use Solid's `children()` helper here: that helper
- *  flattens accessor children into a stable resolved-nodes array and is the
- *  wrong tool for content whose ROOT swaps at runtime (e.g. the current pane
- *  switching between a depth-1 list fragment and a depth-2 editor — both
- *  truthy JSX roots). `children()` would not re-resolve on a truthy<@->truthy
- *  root swap, freezing the previous subtree in place. Instead we hand the
- *  raw accessor to a reactive `{ expr ?? <Placeholder/> }` expression below,
- *  which Solid compiles into a tracked `insert` effect that disposes the old
- *  subtree and mounts the new whenever the accessor returns a different
- *  element identity. */
-function normalizeContent(
-	v: PaneContent | undefined,
-): () => JSX.Element | undefined {
-	if (v == null) return () => undefined;
-	return typeof v === "function" ? (v as () => JSX.Element) : () => v;
-}
-
-function Placeholder(props: { color: () => RGBA }) {
-	return (
-		<box padding={1}>
-			<text fg={props.color()}>—</text>
-		</box>
-	);
-}
-
-// ── Pane column ─────────────────────────────────────────────────────────────
-function YaziPane(props: {
-	grow: number;
-	label: () => string;
-	content: () => JSX.Element | undefined;
-	borderColor: () => RGBA;
-	scrollFocused: () => boolean;
-}) {
-	const { theme } = useTheme();
-	const muted = () => theme.muted ?? theme.textMuted ?? theme.text;
-
-	// Memoize accessor results so the prop expressions below stay reactive
-	// when the underlying signals (e.g. `focused`) change.
-	const borderColor = createMemo(() => props.borderColor());
-	const scrollFocused = createMemo(() => props.scrollFocused());
-
-	return (
-		<box flexDirection="column" flexGrow={props.grow} flexBasis={0} height="100%">
-			{/* ── slim header label row ─────────────────────────────────────────── */}
-			<box height={1} paddingLeft={1} backgroundColor={theme.background}>
-				<text fg={theme.textSecondary}>{props.label()}</text>
-			</box>
-			{/* ── bordered scrollbox ────────────────────────────────────────────── */}
-			<scrollbox
-				height="100%"
-				focused={scrollFocused()}
-				border
-				borderColor={borderColor()}
-				backgroundColor={theme.background}
-			>
-				{/*
-				 * Render the content accessor directly via a reactive expression.
-				 * `{ accessor() ?? <Placeholder/> }` compiles to a Solid `insert`
-				 * effect that re-runs whenever the accessor's tracked signals
-				 * change (e.g. `depth()` swapping the root from a list fragment to
-				 * an editor). Solid disposes the previously-rendered subtree and
-				 * mounts the new element identity. `null`/`undefined` falls back
-				 * to the muted placeholder so the parent pane keeps its 1/7 slot
-				 * visibly blank at depth 0. This is the correct tool for root
-				 * swapping — unlike Solid's `children()` / `<Show>`-children,
-				 * which only react to truthiness flips, not truthy<@->truthy root
-				 * identity changes.
-				 */}
-				{props.content() ?? <Placeholder color={muted} />}
-			</scrollbox>
-		</box>
-	);
-}
-
-// ── Row primitive ───────────────────────────────────────────────────────────
-export function YaziPaneRow(props: YaziPaneRowProps) {
-	const { theme } = useTheme();
-
-	/** true → the current column gets the accent focus ring. */
-	const focused = createMemo(() => {
-		const f = props.focused;
-		return typeof f === "function" ? f() : f ?? true;
-	});
-
-	// Normalize static JSX and accessor children into reactive accessors
-	// (see normalizeContent for why we avoid Solid's `children()` helper).
-	const parentContent = normalizeContent(props.parent);
-	const currentContent = normalizeContent(props.current);
-	const previewContent = normalizeContent(props.preview);
-
-	const parentLabel = createMemo(() => resolveLabel(props.parentLabel));
-	const currentLabel = createMemo(() => resolveLabel(props.currentLabel));
-	const previewLabel = createMemo(() => resolveLabel(props.previewLabel));
-
-	return (
-		<box flexDirection="row" flexGrow={1} width="100%" height="100%">
-			{/* ── parent (1/7) — previous-depth list; always muted ─────────────── */}
-			<YaziPane
-				grow={PANE_RATIO.parent}
-				label={parentLabel}
-				content={parentContent}
-				borderColor={() => theme.border}
-				scrollFocused={() => false}
-			/>
-			{/* ── current (3/7) — the focused list; accent ring when focused ───── */}
-			<YaziPane
-				grow={PANE_RATIO.current}
-				label={currentLabel}
-				content={currentContent}
-				borderColor={() => (focused() ? theme.accent : theme.border)}
-				scrollFocused={() => focused()}
-			/>
-			{/* ── preview (3/7) — hovered-item detail; always muted ────────────── */}
-			<YaziPane
-				grow={PANE_RATIO.preview}
-				label={previewLabel}
-				content={previewContent}
-				borderColor={() => theme.border}
-				scrollFocused={() => false}
-			/>
-		</box>
-	);
-}

src/config/auth.ts

@@ -1,75 +0,0 @@
-/**
- * Authentication configuration for PodTUI
- * Authentication is DISABLED by default - users can opt-in
- */
-
-import { OAuthProvider, type OAuthProviderConfig } from "../types/auth"
-
-/** Default auth enabled state - DISABLED by default */
-export const DEFAULT_AUTH_ENABLED = false
-
-/** Authentication configuration */
-export const AUTH_CONFIG = {
-  /** Whether auth is enabled by default */
-  defaultEnabled: DEFAULT_AUTH_ENABLED,
-
-  /** Code validation settings */
-  codeValidation: {
-    /** Code length (8 characters) */
-    codeLength: 8,
-    /** Allowed characters (alphanumeric) */
-    allowedChars: /^[A-Z0-9]+$/,
-    /** Code expiration time in minutes */
-    expirationMinutes: 15,
-  },
-
-  /** Password requirements */
-  password: {
-    minLength: 8,
-    requireUppercase: false,
-    requireLowercase: false,
-    requireNumber: false,
-    requireSpecial: false,
-  },
-
-  /** Email validation */
-  email: {
-    pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
-  },
-
-  /** Local storage keys */
-  storage: {
-    authState: "podtui_auth_state",
-    user: "podtui_user",
-    lastLogin: "podtui_last_login",
-  },
-} as const
-
-/** OAuth provider configurations */
-export const OAUTH_PROVIDERS: OAuthProviderConfig[] = [
-  {
-    id: OAuthProvider.GOOGLE,
-    name: "Google",
-    enabled: false, // Not feasible in terminal
-    description: "Sign in with Google (requires browser redirect)",
-  },
-  {
-    id: OAuthProvider.APPLE,
-    name: "Apple",
-    enabled: false, // Not feasible in terminal
-    description: "Sign in with Apple (requires browser redirect)",
-  },
-]
-
-/** Terminal OAuth limitation message */
-export const OAUTH_LIMITATION_MESSAGE = `
-OAuth authentication (Google, Apple) is not directly available in terminal applications.
-
-To use OAuth:
-1. Visit the web portal in your browser
-2. Sign in with your preferred provider
-3. Generate a sync code
-4. Enter the code here to link your account
-
-Alternatively, use email/password authentication or file-based sync.
-`.trim()

src/config/keybinds.jsonc

@@ -11,7 +11,8 @@
   //
   // Yazi heritage: j/k move, h/l swipe between panes, Enter open, Space select,
   // v visual mode, gg/G top/bottom, [ ] switch tabs, 1-6 goto tab,
-  // : command bar, q quit, ~ help. Audio transport kept on shifted keys / ctrl.
+  // : / q command palette (q + Enter quits there), Q quick quit, ~ help.
+  // Audio transport kept on shifted keys / ctrl.
 
   // ── Movement (within a pane) ─────────────────────────────────────────────
   "move-down":      ["j", "down"],
@@ -50,9 +51,11 @@
   "tab-goto-5":     ["5"],
   "tab-goto-6":     ["6"],
 
-  // ── Command bar & help & quit ────────────────────────────────────────────
-  "command":        [":"],
-  "quit":           ["q", "ctrl-c"],
+  // ── Command palette & help & quit ────────────────────────────────────────
+  // q opens the command palette (neovim-style: type q + Enter to quit there).
+  // Q (shift+q) is the instant quick quit. ctrl-c also quits.
+  "command":        [":", "q"],
+  "quit":           ["Q", "ctrl-c"],
   "help":           ["~", "f1"],
 
   // ── List operations (yazi: s search, f filter, , sort, . hidden, r refresh)
@@ -61,6 +64,7 @@
   "sort":           [","],
   "toggle-hidden":  ["."],
   "refresh":        ["r"],
+  "unsubscribe":    ["x"],   // unsubscribe focused show in My Shows
 
   // ── Audio transport (preserved) ──────────────────────────────────────────
   // Kept on shifted single keys so they never collide with the yazi core

src/config/shortcuts.ts

@@ -1,26 +0,0 @@
-/**
- * Yazi-style keybind reference (mirrors src/config/keybinds.jsonc).
- * Shown in help overlays; the canonical source remains keybinds.jsonc.
- * Edit that file (or ~/.config/podtui/keybinds.jsonc) to remap.
- */
-export const shortcuts = [
-	{ keys: "j / k", action: "Move down / up (within pane)" },
-	{ keys: "h / l", action: "Swipe to prev / next pane" },
-	{ keys: "J / K", action: "Jump 5 lines down / up" },
-	{ keys: "ctrl-d / u", action: "Half page down / up" },
-	{ keys: "g g / G", action: "Go to top / bottom of list" },
-	{ keys: "1-6", action: "Go to tab 1-6" },
-	{ keys: "[ / ]", action: "Previous / next tab" },
-	{ keys: "Enter", action: "Open / activate focused item" },
-	{ keys: "Space", action: "Toggle selection on item" },
-	{ keys: "v", action: "Enter visual (range) select mode" },
-	{ keys: "ctrl-a / ctrl-r", action: "Select all / invert selection" },
-	{ keys: "Esc", action: "Clear selection / exit visual / cancel" },
-	{ keys: ":", action: "Open command bar (:quit :refresh :play …)" },
-	{ keys: "r / s / f", action: "Refresh / search / filter" },
-	{ keys: ", / .", action: "Sort / toggle hidden" },
-	{ keys: "P / N / B", action: "Play-pause / next / prev episode" },
-	{ keys: "< / >", action: "Seek backward / forward 10s" },
-	{ keys: "~ / F1", action: "Help" },
-	{ keys: "q", action: "Quit" },
-] as const;

src/constants/sync-formats.ts

@@ -1,12 +0,0 @@
-export const syncFormats = {
-  json: {
-    version: "1.0",
-    extension: ".json",
-  },
-  xml: {
-    version: "1.0",
-    extension: ".xml",
-  },
-}
-
-export const supportedSyncVersions = [syncFormats.json.version, syncFormats.xml.version]

src/context/KeybindContext.tsx

@@ -67,24 +67,12 @@ export type KeybindActionName =
 	| "sort"
 	| "toggle-hidden"
 	| "refresh"
+	| "unsubscribe"
 	| "audio-toggle"
 	| "audio-next"
 	| "audio-prev"
 	| "audio-seek-forward"
-	| "audio-seek-backward"
-	// legacy compat (kept so older callers don't crash)
-	| "select"
-	| "leader"
-	| "inverseModifier"
-	| "cycle"
-	| "dive"
-	| "out"
-	| "up"
-	| "down"
-	| "left"
-	| "right"
-	| "audio-pause"
-	| "audio-play";
+	| "audio-seek-backward";
 
 /** Resolved config: action -> list of alternative stroke-sequences. */
 export type KeybindsResolved = Partial<Record<KeybindActionName, KeybindSpec>>;
@@ -145,7 +133,7 @@ export function parseBindingSpec(spec: KeybindSpec | undefined): Stroke[][] {
 }
 
 /** Build a Stroke from a keyboard event (opentui shape: name + ctrl/shift/meta). */
-export function strokeFromEvent(evt: {
+function strokeFromEvent(evt: {
 	name: string;
 	ctrl?: boolean;
 	meta?: boolean;
@@ -153,7 +141,7 @@ export function strokeFromEvent(evt: {
 }): Stroke {
 	// Uppercase letter events from opentui arrive as name="q" + shift; normalize.
 	return {
-		key: (evt.name ?? "").toLowerCase(),
+		key: evt.name.toLowerCase(),
 		ctrl: !!evt.ctrl,
 		shift: !!evt.shift,
 		meta: !!evt.meta,
@@ -170,7 +158,7 @@ function strokeEq(a: Stroke, b: Stroke): boolean {
 }
 
 /** A human label for a stroke, for the status bar / help. */
-export function strokeLabel(s: Stroke): string {
+function strokeLabel(s: Stroke): string {
 	let out = "";
 	if (s.ctrl) out += "C-";
 	if (s.meta) out += "M-";
@@ -179,7 +167,7 @@ export function strokeLabel(s: Stroke): string {
 	return out;
 }
 
-export function sequenceLabel(seq: Stroke[]): string {
+function sequenceLabel(seq: Stroke[]): string {
 	return seq.map(strokeLabel).join(" ");
 }
 
@@ -337,17 +325,6 @@ export const { use: useKeybinds, provider: KeybindProvider } =
 				return best;
 			}
 
-			// `isInverting` kept for legacy callers; yazi model has no inverse mod,
-			// so it always reports false. Migrated callers should use tryMatch().
-			function isInverting(_evt: {
-				name: string;
-				ctrl?: boolean;
-				meta?: boolean;
-				shift?: boolean;
-			}): boolean {
-				return false;
-			}
-
 			onMount(() => {
 				load().catch(() => {});
 			});
@@ -365,7 +342,6 @@ export const { use: useKeybinds, provider: KeybindProvider } =
 				pending,
 				match,
 				tryMatch,
-				isInverting,
 				print,
 				save,
 				load,

src/context/ThemeContext.tsx

@@ -1,3 +1,4 @@
+import { execFileSync } from "node:child_process";
 import { createEffect, createMemo, onMount, onCleanup } from "solid-js";
 import { createStore, produce } from "solid-js/store";
 import { useRenderer } from "@opentui/solid";
@@ -10,6 +11,7 @@ import {
   generateSubtleSyntax,
 } from "../utils/syntax-highlighter";
 import { resolveTerminalTheme, loadThemes } from "../utils/theme";
+import { detectModeFromBackground } from "../utils/system-theme";
 import { createSimpleContext } from "./helper";
 import {
   setupThemeSignalHandler,
@@ -84,6 +86,8 @@ export type ThemeResolved = {
   muted?: RGBA;
   surface?: RGBA;
   selectedListItemText?: RGBA;
+  /** Theme declares a transparent (terminal-bg-visible) background. */
+  transparent?: boolean;
   layerBackgrounds?: {
     layer0: RGBA;
     layer1: RGBA;
@@ -94,6 +98,61 @@ export type ThemeResolved = {
   thinkingOpacity?: number;
 };
 
+/**
+ * A TerminalColors with no values — used to keep the "system" theme rendering
+ * with default ANSI colors + the detected dark/light mode when the terminal
+ * cannot answer OSC queries (e.g. inside tmux without OSC forwarding).
+ */
+const EMPTY_TERMINAL_COLORS: TerminalColors = {
+  palette: Array.from({ length: 16 }, () => null),
+  defaultForeground: null,
+  defaultBackground: null,
+  cursorColor: null,
+  mouseForeground: null,
+  mouseBackground: null,
+  tekForeground: null,
+  tekBackground: null,
+  highlightBackground: null,
+  highlightForeground: null,
+};
+
+/** Cached macOS appearance (dark/light), independent of the terminal. */
+let cachedOsMode: "dark" | "light" | null = null;
+
+/**
+ * Detect the terminal's dark/light mode.
+ *
+ * Priority:
+ *   1. The terminal's real background color (OSC 11 response) — terminal-specific.
+ *   2. The macOS appearance via `defaults read -g AppleInterfaceStyle` — works
+ *      even inside tmux, where OSC queries are usually not forwarded.
+ *      An unset value means light mode (macOS defaults to light).
+ *   3. null → keep whatever mode is currently active.
+ */
+function detectSystemMode(
+  colors: TerminalColors | null,
+): "dark" | "light" | null {
+  const fromBg = detectModeFromBackground(colors?.defaultBackground);
+  if (fromBg) return fromBg;
+
+  if (process.platform === "darwin" && cachedOsMode === null) {
+    let style: string | null = null;
+    try {
+      style = execFileSync("defaults", ["read", "-g", "AppleInterfaceStyle"], {
+        encoding: "utf8",
+        timeout: 2000,
+      })
+        .trim()
+        .toLowerCase();
+    } catch {
+      // Unset → light appearance (macOS default).
+    }
+    cachedOsMode = style?.includes("dark") ? "dark" : "light";
+  }
+
+  return cachedOsMode;
+}
+
 /**
  * Theme context using the createSimpleContext pattern.
  *
@@ -195,6 +254,16 @@ export const { use: useTheme, provider: ThemeProvider } = createSimpleContext({
         }
       }
 
+      // ── dark/light mode detection ─────────────────────────────────────────
+      // The provider starts with a hardcoded mode (e.g. "dark"); detect the
+      // real one from the terminal's background color (OSC 11) or, when that
+      // is unavailable (tmux without OSC forwarding), the OS appearance.
+      const detectedMode = detectSystemMode(colors);
+      if (detectedMode && detectedMode !== store.mode) {
+        setStore("mode", detectedMode);
+        emitThemeModeChanged(detectedMode);
+      }
+
       const hasPalette = Boolean(
         colors?.palette?.some((value) => Boolean(value)),
       );
@@ -203,13 +272,14 @@ export const { use: useTheme, provider: ThemeProvider } = createSimpleContext({
       );
 
       if (!hasPalette && !hasDefaultColors) {
-        // No system colors available, fall back to default
-        // This happens when the terminal doesn't support OSC palette queries
-        // (e.g., running inside tmux, or on unsupported terminals)
+        // No system colors available — the terminal can't answer OSC queries
+        // (e.g. inside tmux, or unsupported terminals). Keep the "system"
+        // theme anyway: the detected dark/light mode plus default ANSI colors
+        // still produce a usable, mode-correct palette.
         if (store.active === "system") {
           setStore(
             produce((draft) => {
-              draft.active = "catppuccin";
+              draft.system = colors ?? EMPTY_TERMINAL_COLORS;
               draft.ready = true;
             }),
           );
@@ -293,6 +363,15 @@ export const { use: useTheme, provider: ThemeProvider } = createSimpleContext({
       mode() {
         return store.mode;
       },
+      /** Whether the app background should be transparent (no solid fill):
+       *  either the global preference is on, or the selected theme declares
+       *  transparency (e.g. the system theme). */
+      transparentBackground() {
+        return (
+          appStore.state().settings.transparentBackground ||
+          values().transparent === true
+        );
+      },
       setMode(mode: "dark" | "light") {
         setStore("mode", mode);
         emitThemeModeChanged(mode);

src/context/navigation-store.ts

@@ -13,36 +13,33 @@
  *
  *        parent  |  current  |  preview
  *
- * Layout ratios (1/7 : 3/7 : 3/7 in the final remake) live in
+ * Layout ratios (1/5 : 2/5 : 2/5 in the final remake) live in
  * `@/utils/navigation` (PANE_RATIO). This module owns only the *focusable*
  * nav model — which column is focused and where its list cursor lives. The
  * parent/preview columns are always derived, never focused.
  *
- * Two pane models coexist under a single TAB list:
+ * The tab list is the app's ROOT and participates in the same pane flow as
+ * any other pane. View renders at most three panes, `UP | CURRENT | PREVIEW`:
  *
- *  • The tab list is the flow's leading pane (TAB_PANE = 0) — a normal,
- *    focusable pane at the left of every tab's content, just like in yazi.
- *    Starting focus lives here; tab switches made from here keep focus here.
- *    When it is focused, j/k moves the tab cursor (`tabCursor`) and
- *    `l`/Enter opens the hovered tab into its content. Swiping left past
- *    it goes out of the panes (inert — there is no pane beyond it).
+ *  • At launch the tab list is the CURRENT pane, with nothing in UP (`atRootTab`).
+ *  • Opening a tab (j/k to hover, `l`/Enter) slides it into the UP/parent pane;
+ *    that tab's content becomes CURRENT and its hovered item PREVIEW
+ *    (`enterTabContent`).
+ *  • Drilling deeper (`l`/Enter in content) pushes frames; once past the tab's
+ *    own root the UP/CURRENT/PREVIEW columns are all content, and the tab drops
+ *    OUT of the 3-pane view.
+ *  • `popDepth`/`h` walks back up: at content depth 0 `h` returns to the tab
+ *    root (`backToTabRoot`, the tab becomes CURRENT again); `h` at the root
+ *    stays (out of the panes — no-op).
  *
- *  • Depth-stack tabs (Feed, MyShows, Discover, Settings) expose exactly ONE
- *    focusable content pane — the current column (DEPTH_CENTER_PANE = 1). The
- *    parent column renders the previous depth's list (blank at depth 0); the
- *    preview column renders the hovered item. `l`/Enter drills in (push a
- *    frame); `h` pops a depth. Depth is unbounded. At depth 0 `h` moves focus
- *    to the tab list (TAB_PANE).
+ * Depth-stack tabs (Feed, MyShows, Discover, Search, Player, Settings):
+ * ONE focusable content pane — the current column (DEPTH_CENTER_PANE = 1);
+ * the parent/preview are derived. Search drills query→results; Player is a
+ * single now-playing pane under the tab list (2-pane, no preview). Every
+ * tab returns to the root via `h` at depth 0 (`backToTabRoot`).
  *
- *  • Fixed-pane tabs (Search = input/results/detail, Player = single) keep the
- *    indexed pane model — `focusedIndex(pane)` + `swipe` — moving between the
- *    parent/current/preview columns with `h`/`l`, clamped to
- *    [1, paneCount]; `h` on the first content pane (1) moves focus to the tab
- *    list; `h` on the tab list stays out-of-panear (inert).
- *
- * Tabs switch via the tab list (j/k), digit keys `1`-`6`, and `[`/`]`.
- * Focus on the tab list persists across a tab switch; from there `l`/Enter
- * drops into the active tab's content (panes 1..N).
+ * Tabs switch via the tab list (j/k + l/Enter), digit keys `1`-`6`, and
+ * `[`/`]`, each re-syncing the tab cursor (`tabCursor`).
  */
 import { createSignal, batch } from "solid-js";
 import { TABS, TabsCount, DEPTH_TABS, rootFrameFor } from "@/utils/navigation";
@@ -55,10 +52,9 @@ export enum NavMode {
 }
 
 /** The current content pane of the active tab, i.e. the focusable column
- *  (index 1) for depth-tabs, and the default landing pane for fixed-pane
- *  tabs. Content panes occupy 1..n; the tab list is pane 0. A tab switch made
- *  while focused on content resets `activePane` to this pane (unless already
- *  on the tab list). */
+ *  (index 1) for every depth-tab. Content panes occupy 1..n; the tab list is
+ *  pane 0. A tab switch made while focused on content resets `activePane` to
+ *  this pane (unless already on the tab list). */
 export const DEPTH_CENTER_PANE = 1 as PaneId;
 
 /** The tab list — the leading pane (pane 0) of the tab flow, rendered to the
@@ -67,13 +63,6 @@ export const DEPTH_CENTER_PANE = 1 as PaneId;
  *  swiping left past the first content pane returns to it. Swiping left again
  *  — beyond it — goes out of the panes (no-op). While it is focused, j/k
  *  moves the tab cursor and `l`/Enter opens the hovered tab's content. */
-/** Content pane slots for fixed-pane tabs (Search). Values are the global
- *  pane indices (content starts at 1). */
-export enum PaneSlot {
-	PARENT = 1, // Search: input
-	CURRENT = 2, // Search: results
-	PREVIEW = 3, // Search: detail
-}
 
 export type PaneId = number; // 0 = tab list; 1..n = the active tab's content panes
 
@@ -110,11 +99,11 @@ export function createNavigation() {
 	// or a direct tab switch (digits / [ ]) re-syncs it. So the panel behaves
 	// just like any other yazi list: j/k move the cursor, Enter/l open.
 	const [tabCursorSignal, setTabCursor] = createSignal<TABS>(TABS.FEED);
-	// App focus starts on the tab list (the app root). `activePane` drives the
-	// fixed-pane pages (Search/Player) and each page's content focus ring;
-	// depth-tab focus is instead described by the per-tab depth stack plus the
-	// `atRootTab` flag (the tab sits as the CURRENT pane when at the root, and
-	// slides into the UP/parent pane once content is opened).
+	// App focus starts on the tab list (the app root). `activePane` is always
+	// DEPTH_CENTER_PANE for the active depth-tab; the per-tab depth stack plus
+	// the `atRootTab` flag describe where focus sits (the tab is the CURRENT
+	// pane when at the root, and slides into the UP/parent pane once content is
+	// opened).
 	const [activePane, setActivePane] = createSignal<PaneId>(DEPTH_CENTER_PANE);
 	// Whether focus is on the tab-list root view — the tab is the CURRENT pane
 	// with nothing above it. Opening a tab moves it to UP; deeper goes back out.
@@ -128,9 +117,9 @@ export function createNavigation() {
 		{ [TABS.FEED]: [rootFrameFor(TABS.FEED)] },
 	);
 
-	// per-pane focused index (for j/k movement in fixed-pane tabs). Keyed
-	// by `${tab}:${pane}`. Depth-tabs read/write the top frame's `focus`
-	// for pane 0 (DEPTH_CENTER_PANE) instead.
+	// per-pane focused index map (unused by depth-tabs, which read/write the
+	// top frame's focus for DEPTH_CENTER_PANE; kept for any future fixed-pane
+	// pages). Keyed by `${tab}:${pane}`.
 	const [paneIndices, setPaneIndices] = createSignal<Record<string, number>>(
 		{},
 	);
@@ -143,7 +132,7 @@ export function createNavigation() {
 	const [commandBuffer, setCommandBuffer] = createSignal("");
 	const [commandError, setCommandError] = createSignal<string | null>(null);
 
-	/** Depth stack for a tab (empty for fixed-pane tabs). */
+	/** Depth stack for a tab (always non-empty — every tab is a depth-tab). */
 	const depthStackFor = (tab: TABS = activeTab()) => stacks()[tab] ?? [];
 
 	const ensureStack = (tab: TABS) => {
@@ -159,21 +148,17 @@ export function createNavigation() {
 	 *  no-op (server build). Routing every tab change through this helper
 	 *  keeps the behavior identical under both runtimes.
 	 *
-	 *  - when switching to a special (fixed-pane) tab from the tab root, leave the
-	 *    root — those tabs render only their content, never the tab-list view.
-	 *  - keep focus on the tab root if it is focused (depth-tab switch),
-	 *    otherwise recenter on the active tab's current/center pane
+	 *  - a depth-tab switch from the root keeps the root (the tab list stays
+	 *    CURRENT); switches made from inside content drop into the new tab's
+	 *    current/center pane.
 	 *  - clear mode/command/visual/count state */
 	const applyTabSwitch = (tab: TABS) => {
 		ensureStack(tab);
 		batch(() => {
-			// A depth-tab switch from the root keeps the root; switching to a
-			// special (fixed-pane) tab always leaves it. Switches made from
-			// inside content drop into the new tab's content pane.
-			if (atRootTabSignal() && !DEPTH_TABS.has(tab)) {
-				setAtTabRoot(false);
-			}
-			if (!atRootTabSignal()) {
+			if (atRootTabSignal()) {
+				// a depth-tab switch from the root keeps the root (focus stays on
+				// the tab list); only entering content (enterTabContent) leaves it.
+			} else {
 				setActivePane(DEPTH_CENTER_PANE);
 			}
 			setMode(NavMode.NORMAL);
@@ -256,23 +241,14 @@ export function createNavigation() {
 	// ── pane focus ──────────────────────────────────────────────────────────
 	const setPane = (pane: PaneId) => setActivePane(pane);
 
-	/** Move focus to the adjacent content pane (fixed-pane tabs only). `dir` =
-	 *  -1 (left, toward parent) or +1 (right, toward preview). Clamped to
-	 *  [0, paneCount-1]. The root panel transition (from content pane 0 to
-	 *  (1..TabPaneCount) is handled by the dispatcher, not here. */
-	const swipe = (dir: -1 | 1, paneCount: number) => {
-		setActivePane((p) => {
-			const n = Math.max(1, Math.min(paneCount, p + dir));
-			return n;
-		});
-	};
+	// (no fixed-pane swipe — every tab is a depth-tab; h/l drill/pop instead.)
 
 	// ── tab root (the app's outermost pane) ──────────────────────────────────
 	/** True while focus is on the tab list as the CURRENT pane — the app root,
-	 *  with nothing above it. Only depth-tabs (Feed/MyShows/Discover/Settings)
-	 *  participate; Search & Player are special and always show their content. */
-	const atRootTab = (): boolean =>
-		atRootTabSignal() && DEPTH_TABS.has(activeTab());
+	 *  with nothing above it. Applies to every tab: a depth-tab switch from
+	 *  the root keeps it; entering content (`enterTabContent`) clears it; `h`
+	 *  at content depth 0 regains it via `backToTabRoot`. */
+	const atRootTab = (): boolean => atRootTabSignal();
 
 	/** Open the active tab's content: the tab slides from CURRENT into the
 	 *  UP/parent pane and focus lands on the content's current pane. */
@@ -291,6 +267,9 @@ export function createNavigation() {
 	/** The tab the root's cursor is hovering (independent of activeTab). */
 	const tabCursor = (): TABS => tabCursorSignal();
 
+	/** Directly set the root's tab cursor (e.g. a mouse click on a tab row). */
+	const setTabCursorTo = (tab: TABS) => setTabCursor(tab);
+
 	/** Move the root's cursor to the adjacent tab (clamped, no wrap). */
 	const moveTabCursor = (dir: -1 | 1) => {
 		setTabCursor((c) => Math.max(1, Math.min(TabsCount, c + dir)) as TABS);
@@ -306,9 +285,9 @@ export function createNavigation() {
 	// ── per-pane focus index ────────────────────────────────────────────────
 	const paneKey = (pane: PaneId = activePane()) => `${activeTab()}:${pane}`;
 
-	/** For depth-tabs, pane 0 (the center/current pane) reads/writes
-	 *  the top frame's focus. Other panes and fixed-pane tabs use the
-	 *  per-pane index map. */
+	/** For depth-tabs (every tab), pane 1 (DEPTH_CENTER_PANE) reads/writes
+	 *  the top frame's focus. Other panes fall back to the per-pane index
+	 *  map (unused by current pages). */
 	const focusedIndex = (pane: PaneId = activePane()): number => {
 		if (isDepthTab() && pane === DEPTH_CENTER_PANE) {
 			return topFrame()?.focus ?? 0;
@@ -493,11 +472,11 @@ export function createNavigation() {
 		enterTabContent,
 		backToTabRoot,
 		tabCursor,
+		setTabCursor: setTabCursorTo,
 		moveTabCursor,
 		activateTabCursor,
 		// pane focus
 		setActivePane: setPane,
-		swipe,
 		// focus index
 		focusedIndex,
 		setFocusedIndex,
@@ -513,11 +492,7 @@ export function createNavigation() {
 		exitVisual,
 		// modes
 		setActiveTabSignal: setActiveTab,
-		setActiveDepth: setPane, // legacy alias
-		activeDepth: activePane, // legacy alias
 		setInputFocused,
-		nextPane: () => {}, // legacy noop; swipe() replaces this
-		prevPane: () => {},
 		setMode,
 		enterCommand,
 		enterInput,

src/hooks/useAudio.ts

@@ -12,331 +12,363 @@
  * ```
  */
 
-import { createSignal, onCleanup } from "solid-js"
+import { createSignal, onCleanup } from "solid-js";
 import {
-  createAudioBackend,
-  detectPlayers,
-  type AudioBackend,
-  type BackendName,
-  type DetectedPlayer,
-} from "../utils/audio-player"
-import { emit, on } from "../utils/event-bus"
-import { useAppStore } from "../stores/app"
-import { useProgressStore } from "../stores/progress"
-import { useMediaRegistry } from "../utils/media-registry"
-import type { Episode } from "../types/episode"
-import type { Feed } from "../types/feed"
-import { useAudioNavStore, AudioSource } from "../stores/audio-nav"
-import { useFeedStore } from "../stores/feed"
+	createAudioBackend,
+	detectPlayers,
+	type AudioBackend,
+	type BackendName,
+	type DetectedPlayer,
+} from "../utils/audio-player";
+import { emit, on } from "../utils/event-bus";
+import { useAppStore } from "../stores/app";
+import { useProgressStore } from "../stores/progress";
+import { useMediaRegistry } from "../utils/media-registry";
+import type { Episode } from "../types/episode";
+import type { Feed } from "../types/feed";
+import { useAudioNavStore, AudioSource } from "../stores/audio-nav";
+import { useFeedStore } from "../stores/feed";
 
 export interface AudioControls {
-  // Signals (reactive getters)
-  isPlaying: () => boolean
-  position: () => number
-  duration: () => number
-  volume: () => number
-  speed: () => number
-  backendName: () => BackendName
-  error: () => string | null
-  currentEpisode: () => Episode | null
-  availablePlayers: () => DetectedPlayer[]
+	// Signals (reactive getters)
+	isPlaying: () => boolean;
+	position: () => number;
+	duration: () => number;
+	volume: () => number;
+	speed: () => number;
+	backendName: () => BackendName;
+	error: () => string | null;
+	currentEpisode: () => Episode | null;
+	availablePlayers: () => DetectedPlayer[];
 
-  // Actions
-  play: (episode: Episode) => Promise<void>
-  pause: () => Promise<void>
-  resume: () => Promise<void>
-  togglePlayback: () => Promise<void>
-  stop: () => Promise<void>
-  seek: (seconds: number) => Promise<void>
-  seekRelative: (delta: number) => Promise<void>
-  setVolume: (volume: number) => Promise<void>
-  setSpeed: (speed: number) => Promise<void>
-  switchBackend: (name: BackendName) => Promise<void>
-  prev: () => Promise<void>
-  next: () => Promise<void>
+	// Actions
+	play: (episode: Episode) => Promise<void>;
+	pause: () => Promise<void>;
+	resume: () => Promise<void>;
+	togglePlayback: () => Promise<void>;
+	stop: () => Promise<void>;
+	seek: (seconds: number) => Promise<void>;
+	seekRelative: (delta: number) => Promise<void>;
+	setVolume: (volume: number) => Promise<void>;
+	setSpeed: (speed: number) => Promise<void>;
+	switchBackend: (name: BackendName) => Promise<void>;
+	prev: () => Promise<void>;
+	next: () => Promise<void>;
 }
 
 // Singleton state — shared across all components that call useAudio()
-let backend: AudioBackend | null = null
-let pollTimer: ReturnType<typeof setInterval> | null = null
-let refCount = 0
-let pollCount = 0 // Counts poll ticks for throttling progress saves
+let backend: AudioBackend | null = null;
+let pollTimer: ReturnType<typeof setInterval> | null = null;
+let refCount = 0;
+let pollCount = 0; // Counts poll ticks for throttling progress saves
 
-const [isPlaying, setIsPlaying] = createSignal(false)
-const [position, setPosition] = createSignal(0)
-const [duration, setDuration] = createSignal(0)
-const [volume, setVolume] = createSignal(0.7)
-const [speed, setSpeed] = createSignal(1)
-const [backendName, setBackendName] = createSignal<BackendName>("none")
-const [error, setError] = createSignal<string | null>(null)
-const [currentEpisode, setCurrentEpisode] = createSignal<Episode | null>(null)
-const [availablePlayers, setAvailablePlayers] = createSignal<DetectedPlayer[]>([])
+const [isPlaying, setIsPlaying] = createSignal(false);
+const [position, setPosition] = createSignal(0);
+const [duration, setDuration] = createSignal(0);
+const [volume, setVolume] = createSignal(0.7);
+const [speed, setSpeed] = createSignal(1);
+const [backendName, setBackendName] = createSignal<BackendName>("none");
+const [error, setError] = createSignal<string | null>(null);
+const [currentEpisode, setCurrentEpisode] = createSignal<Episode | null>(null);
+const [availablePlayers, setAvailablePlayers] = createSignal<DetectedPlayer[]>(
+	[],
+);
 
 function ensureBackend(): AudioBackend {
-  if (!backend) {
-    const detected = detectPlayers()
-    setAvailablePlayers(detected)
-    backend = createAudioBackend()
-    setBackendName(backend.name)
-  }
-  return backend
+	if (!backend) {
+		const detected = detectPlayers();
+		setAvailablePlayers(detected);
+		backend = createAudioBackend();
+		setBackendName(backend.name);
+		registerExitTeardown();
+	}
+	return backend;
+}
+
+// ── Process-exit teardown ─────────────────────────────────────────────
+// `q` (the quit action) calls `process.exit(0)`, which bypasses Solid's
+// onCleanup — where `backend.dispose()` would otherwise kill the spawned
+// player (mpv). Without this hook those child processes
+// survive the host and keep playing audio after the TUI has quit. The
+// `exit` event fires synchronously on `process.exit(N)`; the signal
+// handlers cover Ctrl-C / kill, which otherwise terminate without running
+// `exit` listeners.
+let exitTeardownRegistered = false;
+function registerExitTeardown(): void {
+	if (exitTeardownRegistered) return;
+	exitTeardownRegistered = true;
+	const teardown = (): void => {
+		stopPolling();
+		try {
+			backend?.dispose();
+		} catch {
+			/* best-effort at exit */
+		}
+		try {
+			useMediaRegistry().clearNowPlaying();
+		} catch {
+			/* best-effort at exit */
+		}
+	};
+	process.on("exit", teardown);
+	for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"] as const) {
+		process.on(sig, () => {
+			teardown();
+			process.exit(0);
+		});
+	}
 }
 
 function startPolling(): void {
-  stopPolling()
-  pollCount = 0
-  pollTimer = setInterval(async () => {
-    if (!backend || !isPlaying()) return
-    try {
-      const pos = await backend.getPosition()
-      const dur = await backend.getDuration()
-      setPosition(pos)
-      if (dur > 0) setDuration(dur)
+	stopPolling();
+	pollCount = 0;
+	pollTimer = setInterval(async () => {
+		if (!backend || !isPlaying()) return;
+		try {
+			const pos = await backend.getPosition();
+			const dur = await backend.getDuration();
+			setPosition(pos);
+			if (dur > 0) setDuration(dur);
 
-      // Save progress every ~5 seconds (10 ticks * 500ms)
-      pollCount++
-      if (pollCount % 10 === 0) {
-        const ep = currentEpisode()
-        if (ep) {
-          const progressStore = useProgressStore()
-          progressStore.update(ep.id, pos, dur > 0 ? dur : duration(), speed())
+			// Save progress every ~5 seconds (10 ticks * 500ms)
+			pollCount++;
+			if (pollCount % 10 === 0) {
+				const ep = currentEpisode();
+				if (ep) {
+					const progressStore = useProgressStore();
+					progressStore.update(ep.id, pos, dur > 0 ? dur : duration(), speed());
 
-          // Update platform media position
-          const media = useMediaRegistry()
-          media.setPosition(pos)
-        }
-      }
+					const media = useMediaRegistry();
+					media.setPosition(pos);
+				}
+			}
 
-      // Check if backend stopped playing (track ended)
-      if (!backend.isPlaying() && isPlaying()) {
-        setIsPlaying(false)
-        stopPolling()
-        // Save final position on track end
-        const ep = currentEpisode()
-        if (ep) {
-          const progressStore = useProgressStore()
-          progressStore.update(ep.id, pos, dur > 0 ? dur : duration(), speed())
-        }
-      }
-    } catch {
-      // Backend may have been disposed
-    }
-  }, 500)
+			// Check if backend stopped playing (track ended)
+			if (!backend.isPlaying() && isPlaying()) {
+				setIsPlaying(false);
+				stopPolling();
+				// Save final position on track end
+				const ep = currentEpisode();
+				if (ep) {
+					const progressStore = useProgressStore();
+					progressStore.update(ep.id, pos, dur > 0 ? dur : duration(), speed());
+				}
+			}
+		} catch {
+			// Backend may have been disposed
+		}
+	}, 500);
 }
 
 function stopPolling(): void {
-  if (pollTimer) {
-    clearInterval(pollTimer)
-    pollTimer = null
-  }
+	if (pollTimer) {
+		clearInterval(pollTimer);
+		pollTimer = null;
+	}
 }
 
 async function play(episode: Episode): Promise<void> {
-  const b = ensureBackend()
-  setError(null)
+	const b = ensureBackend();
+	setError(null);
 
-  if (!episode.audioUrl) {
-    setError("No audio URL for this episode")
-    return
-  }
+	if (!episode.audioUrl) {
+		setError("No audio URL for this episode");
+		return;
+	}
 
-  try {
-    const appStore = useAppStore()
-    const progressStore = useProgressStore()
-    const storeSpeed = appStore.state().settings.playbackSpeed
-    const vol = volume()
-    const spd = storeSpeed || speed()
+	try {
+		const appStore = useAppStore();
+		const progressStore = useProgressStore();
+		const storeSpeed = appStore.state().settings.playbackSpeed;
+		const vol = volume();
+		const spd = storeSpeed || speed();
 
-    // Resume from saved progress if available and not completed
-    const savedProgress = progressStore.get(episode.id)
-    let startPos = 0
-    if (savedProgress && !progressStore.isCompleted(episode.id)) {
-      startPos = savedProgress.position
-    }
+		// Resume from saved progress if available and not completed
+		const savedProgress = progressStore.get(episode.id);
+		let startPos = 0;
+		if (savedProgress && !progressStore.isCompleted(episode.id)) {
+			startPos = savedProgress.position;
+		}
 
-    await b.play(episode.audioUrl, {
-      volume: vol,
-      speed: spd,
-      startPosition: startPos > 0 ? startPos : undefined,
-    })
+		await b.play(episode.audioUrl, {
+			volume: vol,
+			speed: spd,
+			startPosition: startPos > 0 ? startPos : undefined,
+		});
 
-    setCurrentEpisode(episode)
-    setIsPlaying(true)
-    setPosition(startPos)
-    setSpeed(spd)
-    if (episode.duration) setDuration(episode.duration)
+		setCurrentEpisode(episode);
+		setIsPlaying(true);
+		setPosition(startPos);
+		setSpeed(spd);
+		if (episode.duration) setDuration(episode.duration);
 
-    // Register with platform media controls
-    const media = useMediaRegistry()
-    media.setNowPlaying({
-      title: episode.title,
-      artist: episode.podcastId,
-      duration: episode.duration,
-    })
-    media.setPlaybackState(true)
-    if (startPos > 0) media.setPosition(startPos)
+		// Register with platform media controls
+		const media = useMediaRegistry();
+		media.setNowPlaying({
+			title: episode.title,
+			artist: episode.podcastId,
+			duration: episode.duration,
+		});
+		media.setPlaybackState(true);
+		if (startPos > 0) media.setPosition(startPos);
 
-    startPolling()
-    emit("player.play", { episodeId: episode.id })
-  } catch (err) {
-    setError(err instanceof Error ? err.message : "Playback failed")
-    setIsPlaying(false)
-  }
+		startPolling();
+		emit("player.play", { episodeId: episode.id });
+		// Distinct from "player.play" (which also fires on resume): signals a
+		// fresh episode start so Shell can honor the auto-jump-to-player pref.
+		emit("player.started", { episodeId: episode.id });
+	} catch (err) {
+		setError(err instanceof Error ? err.message : "Playback failed");
+		setIsPlaying(false);
+	}
 }
 
 async function pause(): Promise<void> {
-  if (!backend) return
-  try {
-    await backend.pause()
-    setIsPlaying(false)
-    stopPolling()
-    const ep = currentEpisode()
-    if (ep) {
-      // Save progress on pause
-      const progressStore = useProgressStore()
-      progressStore.update(ep.id, position(), duration(), speed())
-      emit("player.pause", { episodeId: ep.id })
+	if (!backend) return;
+	try {
+		await backend.pause();
+		setIsPlaying(false);
+		stopPolling();
+		const ep = currentEpisode();
+		if (ep) {
+			// Save progress on pause
+			const progressStore = useProgressStore();
+			progressStore.update(ep.id, position(), duration(), speed());
+			emit("player.pause", { episodeId: ep.id });
 
-      // Update platform media controls
-      const media = useMediaRegistry()
-      media.setPlaybackState(false)
-      media.setPosition(position())
-    }
-  } catch (err) {
-    setError(err instanceof Error ? err.message : "Pause failed")
-  }
+			// Update platform media controls
+			const media = useMediaRegistry();
+			media.setPlaybackState(false);
+			media.setPosition(position());
+		}
+	} catch (err) {
+		setError(err instanceof Error ? err.message : "Pause failed");
+	}
 }
 
 async function resume(): Promise<void> {
-  if (!backend) return
-  try {
-    await backend.resume()
-    setIsPlaying(true)
-    startPolling()
-    const ep = currentEpisode()
-    if (ep) {
-      emit("player.play", { episodeId: ep.id })
-      const media = useMediaRegistry()
-      media.setPlaybackState(true)
-    }
-  } catch (err) {
-    setError(err instanceof Error ? err.message : "Resume failed")
-  }
+	if (!backend) return;
+	try {
+		await backend.resume();
+		setIsPlaying(true);
+		startPolling();
+		const ep = currentEpisode();
+		if (ep) {
+			emit("player.play", { episodeId: ep.id });
+			const media = useMediaRegistry();
+			media.setPlaybackState(true);
+		}
+	} catch (err) {
+		setError(err instanceof Error ? err.message : "Resume failed");
+	}
 }
 
 async function togglePlayback(): Promise<void> {
-  if (isPlaying()) {
-    await pause()
-  } else if (currentEpisode()) {
-    await resume()
-  }
+	if (isPlaying()) {
+		await pause();
+	} else if (currentEpisode()) {
+		await resume();
+	}
 }
 
 async function stop(): Promise<void> {
-  if (!backend) return
-  try {
-    // Save progress before stopping
-    const ep = currentEpisode()
-    if (ep) {
-      const progressStore = useProgressStore()
-      progressStore.update(ep.id, position(), duration(), speed())
-    }
-    await backend.stop()
-    setIsPlaying(false)
-    setPosition(0)
-    setCurrentEpisode(null)
-    stopPolling()
-    emit("player.stop", {})
+	if (!backend) return;
+	try {
+		// Save progress before stopping
+		const ep = currentEpisode();
+		if (ep) {
+			const progressStore = useProgressStore();
+			progressStore.update(ep.id, position(), duration(), speed());
+		}
+		await backend.stop();
+		setIsPlaying(false);
+		setPosition(0);
+		setCurrentEpisode(null);
+		stopPolling();
+		emit("player.stop", {});
 
-    // Clear platform media controls
-    const media = useMediaRegistry()
-    media.clearNowPlaying()
-  } catch (err) {
-    setError(err instanceof Error ? err.message : "Stop failed")
-  }
+		const media = useMediaRegistry();
+		media.clearNowPlaying();
+	} catch (err) {
+		setError(err instanceof Error ? err.message : "Stop failed");
+	}
 }
 
 async function seek(seconds: number): Promise<void> {
-  if (!backend) return
-  const clamped = Math.max(0, Math.min(seconds, duration()))
-  try {
-    await backend.seek(clamped)
-    setPosition(clamped)
-  } catch (err) {
-    setError(err instanceof Error ? err.message : "Seek failed")
-  }
+	if (!backend) return;
+	const clamped = Math.max(0, Math.min(seconds, duration()));
+	try {
+		await backend.seek(clamped);
+		setPosition(clamped);
+	} catch (err) {
+		setError(err instanceof Error ? err.message : "Seek failed");
+	}
 }
 
 async function seekRelative(delta: number): Promise<void> {
-  await seek(position() + delta)
+	await seek(position() + delta);
 }
 
 async function doSetVolume(vol: number): Promise<void> {
-  const clamped = Math.max(0, Math.min(1, vol))
-  if (backend) {
-    try {
-      await backend.setVolume(clamped)
-    } catch {
-      // Some backends can't change volume at runtime
-    }
-  }
-  setVolume(clamped)
+	const clamped = Math.max(0, Math.min(1, vol));
+	if (backend) {
+		try {
+			await backend.setVolume(clamped);
+		} catch {
+			// Some backends can't change volume at runtime
+		}
+	}
+	setVolume(clamped);
 }
 
 async function doSetSpeed(spd: number): Promise<void> {
-  const clamped = Math.max(0.25, Math.min(3, spd))
-  if (backend) {
-    try {
-      await backend.setSpeed(clamped)
-    } catch {
-      // Some backends can't change speed at runtime
-    }
-  }
-  setSpeed(clamped)
+	const clamped = Math.max(0.25, Math.min(3, spd));
+	if (backend) {
+		try {
+			await backend.setSpeed(clamped);
+		} catch {
+			// Some backends can't change speed at runtime
+		}
+	}
+	setSpeed(clamped);
 
-  // Sync back to app store
-  try {
-    const appStore = useAppStore()
-    appStore.updateSettings({ playbackSpeed: clamped })
-  } catch {
-    // Store may not be available
-  }
+	// Sync back to app store
+	const appStore = useAppStore();
+	appStore.updateSettings({ playbackSpeed: clamped });
 }
 
 async function switchBackend(name: BackendName): Promise<void> {
-  const wasPlaying = isPlaying()
-  const ep = currentEpisode()
-  const pos = position()
-  const vol = volume()
-  const spd = speed()
+	const wasPlaying = isPlaying();
+	const ep = currentEpisode();
+	const pos = position();
+	const vol = volume();
+	const spd = speed();
 
-  // Stop current backend
-  if (backend) {
-    stopPolling()
-    backend.dispose()
-    backend = null
-  }
+	if (backend) {
+		stopPolling();
+		backend.dispose();
+		backend = null;
+	}
 
-  // Create new backend
-  backend = createAudioBackend(name)
-  setBackendName(backend.name)
-  setAvailablePlayers(detectPlayers())
+	backend = createAudioBackend(name);
+	setBackendName(backend.name);
+	setAvailablePlayers(detectPlayers());
 
-  // Resume playback if we were playing
-  if (wasPlaying && ep && ep.audioUrl) {
-    try {
-      await backend.play(ep.audioUrl, {
-        startPosition: pos,
-        volume: vol,
-        speed: spd,
-      })
-      setIsPlaying(true)
-      startPolling()
-    } catch (err) {
-      setError(err instanceof Error ? err.message : "Backend switch failed")
-      setIsPlaying(false)
-    }
-  }
+	// Resume playback if we were playing
+	if (wasPlaying && ep && ep.audioUrl) {
+		try {
+			await backend.play(ep.audioUrl, {
+				startPosition: pos,
+				volume: vol,
+				speed: spd,
+			});
+			setIsPlaying(true);
+			startPolling();
+		} catch (err) {
+			setError(err instanceof Error ? err.message : "Backend switch failed");
+			setIsPlaying(false);
+		}
+	}
 }
 
 /**
@@ -346,183 +378,183 @@ async function switchBackend(name: BackendName): Promise<void> {
  * Registers event bus listeners and cleans them up with onCleanup.
  */
 export function useAudio(): AudioControls {
-  // Initialize backend on first use
-  ensureBackend()
+	// Initialize backend on first use
+	ensureBackend();
 
-  // Sync initial speed from app store
-  if (refCount === 0) {
-    try {
-      const appStore = useAppStore()
-      const storeSpeed = appStore.state().settings.playbackSpeed
-      if (storeSpeed && storeSpeed !== speed()) {
-        setSpeed(storeSpeed)
-      }
-    } catch {
-      // Store may not be available yet
-    }
-  }
+	// Sync initial speed from app store
+	if (refCount === 0) {
+		const appStore = useAppStore();
+		const storeSpeed = appStore.state().settings.playbackSpeed;
+		if (storeSpeed && storeSpeed !== speed()) {
+			setSpeed(storeSpeed);
+		}
+	}
 
-  refCount++
+	refCount++;
 
-  // Listen for event bus commands (e.g. from other components)
-  const unsubPlay = on("player.play", async (data) => {
-    // External play requests — currently just tracks episodeId.
-    // Episode lookup would require feed store integration.
-  })
+	// Listen for event bus commands (e.g. from other components)
+	const unsubPlay = on("player.play", async (data) => {
+		// External play requests — currently just tracks episodeId.
+		// Episode lookup would require feed store integration.
+	});
 
-  const unsubStop = on("player.stop", async () => {
-    if (backend && isPlaying()) {
-      await backend.stop()
-      setIsPlaying(false)
-      setPosition(0)
-      setCurrentEpisode(null)
-      stopPolling()
-    }
-  })
+	const unsubStop = on("player.stop", async () => {
+		if (backend && isPlaying()) {
+			await backend.stop();
+			setIsPlaying(false);
+			setPosition(0);
+			setCurrentEpisode(null);
+			stopPolling();
+		}
+	});
 
-  // Listen for global multimedia key events (from useMultimediaKeys)
-  const unsubMediaToggle = on("media.toggle", async () => {
-    await togglePlayback()
-  })
+	// Listen for global multimedia key events (from useMultimediaKeys)
+	const unsubMediaToggle = on("media.toggle", async () => {
+		await togglePlayback();
+	});
 
-  const unsubMediaVolUp = on("media.volumeUp", async () => {
-    await doSetVolume(Math.min(1, Number((volume() + 0.05).toFixed(2))))
-  })
+	const unsubMediaVolUp = on("media.volumeUp", async () => {
+		await doSetVolume(Math.min(1, Number((volume() + 0.05).toFixed(2))));
+	});
 
-  const unsubMediaVolDown = on("media.volumeDown", async () => {
-    await doSetVolume(Math.max(0, Number((volume() - 0.05).toFixed(2))))
-  })
+	const unsubMediaVolDown = on("media.volumeDown", async () => {
+		await doSetVolume(Math.max(0, Number((volume() - 0.05).toFixed(2))));
+	});
 
-  const unsubMediaSeekFwd = on("media.seekForward", async () => {
-    await seekRelative(10)
-  })
+	const unsubMediaSeekFwd = on("media.seekForward", async () => {
+		await seekRelative(10);
+	});
 
-  const unsubMediaSeekBack = on("media.seekBackward", async () => {
-    await seekRelative(-10)
-  })
+	const unsubMediaSeekBack = on("media.seekBackward", async () => {
+		await seekRelative(-10);
+	});
 
-  const unsubMediaSpeed = on("media.speedCycle", async () => {
-    const next = speed() >= 2 ? 0.5 : Number((speed() + 0.25).toFixed(2))
-    await doSetSpeed(next)
-  })
+	const unsubMediaSpeed = on("media.speedCycle", async () => {
+		const next = speed() >= 2 ? 0.5 : Number((speed() + 0.25).toFixed(2));
+		await doSetSpeed(next);
+	});
 
-  const audioNav = useAudioNavStore();
-  const feedStore = useFeedStore();
+	const audioNav = useAudioNavStore();
+	const feedStore = useFeedStore();
 
-  async function prev(): Promise<void> {
-    const current = currentEpisode();
-    if (!current) return;
+	async function prev(): Promise<void> {
+		const current = currentEpisode();
+		if (!current) return;
 
-    const currentPos = position();
-    const currentDur = duration();
+		const currentPos = position();
+		const currentDur = duration();
 
-    const NAV_START_THRESHOLD = 30;
+		const NAV_START_THRESHOLD = 30;
 
-    if (currentPos > NAV_START_THRESHOLD && currentDur > 0) {
-      await seek(NAV_START_THRESHOLD);
-    } else {
-      const source = audioNav.getSource();
-      let episodes: Array<{ episode: Episode; feed: Feed }> = [];
+		if (currentPos > NAV_START_THRESHOLD && currentDur > 0) {
+			await seek(NAV_START_THRESHOLD);
+		} else {
+			const source = audioNav.getSource();
+			let episodes: Array<{ episode: Episode; feed: Feed }> = [];
 
-      if (source === AudioSource.FEED) {
-        episodes = feedStore.getAllEpisodesChronological();
-      } else if (source === AudioSource.MY_SHOWS) {
-        const podcastId = audioNav.getPodcastId();
-        if (!podcastId) return;
+			if (source === AudioSource.FEED) {
+				episodes = feedStore.getAllEpisodesChronological();
+			} else if (source === AudioSource.MY_SHOWS) {
+				const podcastId = audioNav.getPodcastId();
+				if (!podcastId) return;
 
-        const feed = feedStore.getFilteredFeeds().find(f => f.podcast.id === podcastId);
-        if (!feed) return;
+				const feed = feedStore
+					.getFilteredFeeds()
+					.find((f) => f.podcast.id === podcastId);
+				if (!feed) return;
 
-        episodes = feed.episodes.map(ep => ({ episode: ep, feed }));
-      }
+				episodes = feed.episodes.map((ep) => ({ episode: ep, feed }));
+			}
 
-      const currentIndex = audioNav.getCurrentIndex();
-      const newIndex = Math.max(0, currentIndex - 1);
+			const currentIndex = audioNav.getCurrentIndex();
+			const newIndex = Math.max(0, currentIndex - 1);
 
-      if (newIndex < episodes.length && episodes[newIndex]) {
-        const { episode } = episodes[newIndex];
-        await play(episode);
-        audioNav.prev(newIndex);
-      }
-    }
-  }
+			if (newIndex < episodes.length && episodes[newIndex]) {
+				const { episode } = episodes[newIndex];
+				await play(episode);
+				audioNav.prev(newIndex);
+			}
+		}
+	}
 
-  async function next(): Promise<void> {
-    const current = currentEpisode();
-    if (!current) return;
+	async function next(): Promise<void> {
+		const current = currentEpisode();
+		if (!current) return;
 
-    const source = audioNav.getSource();
-    let episodes: Array<{ episode: Episode; feed: Feed }> = [];
+		const source = audioNav.getSource();
+		let episodes: Array<{ episode: Episode; feed: Feed }> = [];
 
-    if (source === AudioSource.FEED) {
-      episodes = feedStore.getAllEpisodesChronological();
-    } else if (source === AudioSource.MY_SHOWS) {
-      const podcastId = audioNav.getPodcastId();
-      if (!podcastId) return;
+		if (source === AudioSource.FEED) {
+			episodes = feedStore.getAllEpisodesChronological();
+		} else if (source === AudioSource.MY_SHOWS) {
+			const podcastId = audioNav.getPodcastId();
+			if (!podcastId) return;
 
-      const feed = feedStore.getFilteredFeeds().find(f => f.podcast.id === podcastId);
-      if (!feed) return;
+			const feed = feedStore
+				.getFilteredFeeds()
+				.find((f) => f.podcast.id === podcastId);
+			if (!feed) return;
 
-      episodes = feed.episodes.map(ep => ({ episode: ep, feed }));
-    }
+			episodes = feed.episodes.map((ep) => ({ episode: ep, feed }));
+		}
 
-    const currentIndex = audioNav.getCurrentIndex();
-    const newIndex = Math.min(episodes.length - 1, currentIndex + 1);
+		const currentIndex = audioNav.getCurrentIndex();
+		const newIndex = Math.min(episodes.length - 1, currentIndex + 1);
 
-    if (newIndex >= 0 && episodes[newIndex]) {
-      const { episode } = episodes[newIndex];
-      await play(episode);
-      audioNav.next(newIndex);
-    }
-  }
+		if (newIndex >= 0 && episodes[newIndex]) {
+			const { episode } = episodes[newIndex];
+			await play(episode);
+			audioNav.next(newIndex);
+		}
+	}
 
-  onCleanup(() => {
-    refCount--
-    unsubPlay()
-    unsubStop()
-    unsubMediaToggle()
-    unsubMediaVolUp()
-    unsubMediaVolDown()
-    unsubMediaSeekFwd()
-    unsubMediaSeekBack()
-    unsubMediaSpeed()
+	onCleanup(() => {
+		refCount--;
+		unsubPlay();
+		unsubStop();
+		unsubMediaToggle();
+		unsubMediaVolUp();
+		unsubMediaVolDown();
+		unsubMediaSeekFwd();
+		unsubMediaSeekBack();
+		unsubMediaSpeed();
 
-    if (refCount <= 0) {
-      stopPolling()
-      if (backend) {
-        backend.dispose()
-        backend = null
-      }
-      // Clear media registry on full teardown
-      const media = useMediaRegistry()
-      media.clearNowPlaying()
+		if (refCount <= 0) {
+			stopPolling();
+			if (backend) {
+				backend.dispose();
+				backend = null;
+			}
+			// Clear media registry on full teardown
+			const media = useMediaRegistry();
+			media.clearNowPlaying();
 
-      refCount = 0
-    }
-  })
+			refCount = 0;
+		}
+	});
 
-  return {
-    isPlaying,
-    position,
-    duration,
-    volume,
-    speed,
-    backendName,
-    error,
-    currentEpisode,
-    availablePlayers,
+	return {
+		isPlaying,
+		position,
+		duration,
+		volume,
+		speed,
+		backendName,
+		error,
+		currentEpisode,
+		availablePlayers,
 
-    play,
-    pause,
-    resume,
-    togglePlayback,
-    stop,
-    seek,
-    seekRelative,
-    setVolume: doSetVolume,
-    setSpeed: doSetSpeed,
-    switchBackend,
-    prev,
-    next,
-  }
+		play,
+		pause,
+		resume,
+		togglePlayback,
+		stop,
+		seek,
+		seekRelative,
+		setVolume: doSetVolume,
+		setSpeed: doSetSpeed,
+		switchBackend,
+		prev,
+		next,
+	};
 }

src/hooks/useCachedData.ts

@@ -1,34 +0,0 @@
-import { createSignal, onCleanup } from "solid-js"
-
-type CacheOptions<T> = {
-  fetcher: () => Promise<T>
-  intervalMs?: number
-}
-
-export const useCachedData = <T,>(options: CacheOptions<T>) => {
-  const [data, setData] = createSignal<T | null>(null)
-  const [loading, setLoading] = createSignal(false)
-  const [error, setError] = createSignal<string | null>(null)
-
-  const refresh = async () => {
-    setLoading(true)
-    setError(null)
-    try {
-      const value = await options.fetcher()
-      setData(() => value)
-    } catch (err) {
-      setError(err instanceof Error ? err.message : "Failed to load data")
-    } finally {
-      setLoading(false)
-    }
-  }
-
-  refresh()
-
-  if (options.intervalMs) {
-    const interval = setInterval(refresh, options.intervalMs)
-    onCleanup(() => clearInterval(interval))
-  }
-
-  return { data, loading, error, refresh }
-}

src/hooks/useInputFocusNav.ts

@@ -0,0 +1,65 @@
+/**
+ * useInputFocusNav — returns a `ref` callback for an `<input>` (or any
+ * focusable renderable) that holds the navigation store's `inputFocused`
+ * flag true while the renderable has focus.
+ *
+ * Why: the Shell keyboard router (see `components/Shell.tsx`) yields keys to
+ * whatever is focused only when `nav.inputFocused()` is true; otherwise it
+ * dispatches navigation keybinds (j/k/h/…). Forms rendered inside the
+ * depth-stack (e.g. the Settings "Add Source" RSS form) don't drive that
+ * flag, so typing into them *also* fired the navigation keybinds. Wiring the
+ * flag to each input's real focus/blur state fixes that.
+ *
+ * A module-level counter guards the blur→focus ordering gap that occurs when
+ * tabbing between two inputs in the same form (the old input blurs before the
+ * new one focuses) so the flag never flickers off mid-handoff.
+ */
+
+import { onCleanup } from "solid-js";
+import { RenderableEvents } from "@opentui/core";
+import { useNavigation } from "@/context/NavigationContext";
+
+// Inputs (managed by this hook) currently holding focus.
+let focusedCount = 0;
+
+export function useInputFocusNav() {
+	const nav = useNavigation();
+	let current: any | undefined;
+
+	const onFocused = () => {
+		focusedCount++;
+		nav.setInputFocused(true);
+	};
+	const onBlurred = () => {
+		focusedCount = Math.max(0, focusedCount - 1);
+		if (focusedCount === 0) nav.setInputFocused(false);
+	};
+
+	const detach = (el: any) => {
+		el.off(RenderableEvents.FOCUSED, onFocused);
+		el.off(RenderableEvents.BLURRED, onBlurred);
+		// Treat a focused element being torn down as a blur so the counter
+		// doesn't leak and leave inputFocused stuck on.
+		if (el.focused) onBlurred();
+	};
+
+	const ref = (el: any) => {
+		if (current && current !== el) detach(current);
+		current = el;
+		if (el) {
+			el.on(RenderableEvents.FOCUSED, onFocused);
+			el.on(RenderableEvents.BLURRED, onBlurred);
+			// If the renderable is already focused when attached, count it.
+			if (el.focused) onFocused();
+		}
+	};
+
+	onCleanup(() => {
+		if (current) {
+			detach(current);
+			current = undefined;
+		}
+	});
+
+	return ref;
+}

src/hooks/useMultimediaKeys.ts

@@ -5,43 +5,29 @@
  * regardless of which component is focused. Uses the event bus to
  * decouple key detection from audio control logic.
  *
- * Keys are only handled when an episode is loaded (or for play/pause,
- * always). This prevents accidental volume/seek changes when there's
- * nothing playing.
+ * Volume and speed are app-level settings — adjustable with or without
+ * an episode loaded (they apply to the next playback and persist). Seek
+ * is playback-dependent, so it still requires a loaded episode.
  */
 
-import { useKeyboard } from "@opentui/solid"
-import { emit } from "../utils/event-bus"
+import { useKeyboard } from "@opentui/solid";
+import { emit } from "../utils/event-bus";
 
 export type MediaKeyAction =
-  | "media.toggle"
-  | "media.volumeUp"
-  | "media.volumeDown"
-  | "media.seekForward"
-  | "media.seekBackward"
-  | "media.speedCycle"
-
-/** Key-to-action mappings for multimedia controls */
-const MEDIA_KEY_MAP: Record<string, MediaKeyAction> = {
-  // Common terminal media keys — these overlap with Player.tsx local
-  // bindings, but Player guards on `props.focused` so the global
-  // handler fires independently when the player tab is *not* active.
-  //
-  // When Player IS focused both handlers fire, but since the audio
-  // actions are idempotent (toggle = toggle, seek = additive) having
-  // them called twice for the same keypress is avoided by the event
-  // bus approach — the audio hook only processes event-bus events, and
-  // Player.tsx calls audio methods directly.  We therefore guard with
-  // a "playerFocused" flag passed via options.
-}
+	| "media.toggle"
+	| "media.volumeUp"
+	| "media.volumeDown"
+	| "media.seekForward"
+	| "media.seekBackward"
+	| "media.speedCycle";
 
 export interface MultimediaKeysOptions {
-  /** When true, skip handling (Player.tsx handles keys locally) */
-  playerFocused?: () => boolean
-  /** When true, skip handling (text input has focus) */
-  inputFocused?: () => boolean
-  /** Whether an episode is currently loaded */
-  hasEpisode?: () => boolean
+	/** When true, skip handling (Player.tsx handles keys locally) */
+	playerFocused?: () => boolean;
+	/** When true, skip handling (text input has focus) */
+	inputFocused?: () => boolean;
+	/** Whether an episode is currently loaded */
+	hasEpisode?: () => boolean;
 }
 
 /**
@@ -49,50 +35,47 @@ export interface MultimediaKeysOptions {
  * event bus. Call once at the app level (e.g. in App.tsx).
  */
 export function useMultimediaKeys(options: MultimediaKeysOptions = {}) {
-  useKeyboard((key) => {
-    // Don't intercept when a text input owns the keyboard
-    if (options.inputFocused?.()) return
+	useKeyboard((key) => {
+		// Don't intercept when a text input owns the keyboard
+		if (options.inputFocused?.()) return;
 
-    // Don't intercept when Player component handles its own keys
-    if (options.playerFocused?.()) return
+		// Don't intercept when Player component handles its own keys
+		if (options.playerFocused?.()) return;
 
-    // Ctrl/Meta combos are app-level shortcuts, not media keys
-    if (key.ctrl || key.meta) return
+		// Ctrl/Meta combos are app-level shortcuts, not media keys
+		if (key.ctrl || key.meta) return;
 
-    switch (key.name) {
-      case "space":
-        // Toggle play/pause — always valid (may start a loaded episode)
-        emit("media.toggle", {})
-        break
+		switch (key.name) {
+			case "space":
+				// Toggle play/pause — always valid (may start a loaded episode)
+				emit("media.toggle", {});
+				break;
 
-      case "up":
-        if (!options.hasEpisode?.()) return
-        emit("media.volumeUp", {})
-        break
+			case "up":
+				emit("media.volumeUp", {});
+				break;
 
-      case "down":
-        if (!options.hasEpisode?.()) return
-        emit("media.volumeDown", {})
-        break
+			case "down":
+				emit("media.volumeDown", {});
+				break;
 
-      case "left":
-        if (!options.hasEpisode?.()) return
-        emit("media.seekBackward", {})
-        break
+			case "left":
+				if (!options.hasEpisode?.()) return;
+				emit("media.seekBackward", {});
+				break;
 
-      case "right":
-        if (!options.hasEpisode?.()) return
-        emit("media.seekForward", {})
-        break
+			case "right":
+				if (!options.hasEpisode?.()) return;
+				emit("media.seekForward", {});
+				break;
 
-      case "s":
-        if (!options.hasEpisode?.()) return
-        emit("media.speedCycle", {})
-        break
+			case "s":
+				emit("media.speedCycle", {});
+				break;
 
-      default:
-        // Not a media key — do nothing
-        break
-    }
-  })
+			default:
+				// Not a media key — do nothing
+				break;
+		}
+	});
 }

src/hooks/useScrollIntoView.ts

@@ -0,0 +1,115 @@
+/**
+ * useScrollIntoView — keeps the ref'd row visible inside its enclosing
+ * `<scrollbox>` whenever the focus accessor is true.
+ *
+ * OpenTUI's `ScrollBoxRenderable` has built-in *keyboard* scrolling but does
+ * NOT auto-scroll to follow a programmatically-focused child (the app moves
+ * its own cursor via the yazi nav store, so the scrollbox never sees a key
+ * for row movement). Every scrollable panel therefore drifts out of view the
+ * moment the cursor crosses the viewport edge.
+ *
+ * Attach the returned `ref` callback to the element that represents the
+ * focused row of a scrollable list and call the hook with a `when()` that is
+ * true for exactly that row (e.g. `() => index() === focus()`). Whenever the
+ * accessor flips true, the nearest ScrollBoxRenderable is scrolled just enough
+ * to bring the element back into the viewport — a "nearest-edge" scroll:
+ *   • scroll up only if the row's top is clipped above the viewport,
+ *   • scroll down only if the row's bottom is clipped below the viewport,
+ * never snapping more than necessary (matches yazi list behaviour).
+ *
+ * Timing: for ordinary cursor movement (j/k) the list layout does not change
+ * — only background colour and the cursor glyph flip — so the focused row's
+ * Yoga-computed position is already valid when this effect fires, and the
+ * scroll is applied synchronously. On first mount / content population the
+ * layout for the new rows has not yet been computed, so the hook polls on a
+ * short timer until layout resolves (bounded so it can never loop forever).
+ */
+import { createEffect, onCleanup } from "solid-js";
+
+/** Walk up the renderable parent chain to the nearest ScrollBoxRenderable,
+ *  identified by its `viewport` + `content` + numeric `scrollTop`. */
+function findScrollBox(node: any): any | null {
+	let p: any = node?.parent;
+	while (p) {
+		if (p.viewport && p.content && typeof p.scrollTop === "number") return p;
+		p = p.parent;
+	}
+	return null;
+}
+
+/** Maximum number of retries while waiting for Yoga layout to populate the
+ *  row/viewport dimensions (handles the first-mount frame). */
+const MAX_RETRIES = 12;
+const RETRY_MS = 16;
+
+export function useScrollIntoView(when: () => boolean) {
+	let el: any = null;
+	let timer: ReturnType<typeof setTimeout> | null = null;
+	const ref = (node: any) => {
+		el = node;
+	};
+
+	const clearTimer = () => {
+		if (timer) {
+			clearTimeout(timer);
+			timer = null;
+		}
+	};
+
+	/** Compute the target scrollTop that brings `el` into the viewport of its
+	 *  enclosing scrollbox, or `null` if no scroll is possible / needed yet.
+	 *  Returns the decision so the caller knows whether to poll again. */
+	const compute = (): { scroll: number | null; ready: boolean } => {
+		const node = el;
+		if (!node) return { scroll: null, ready: false };
+		const sb = findScrollBox(node);
+		if (!sb) return { scroll: null, ready: false };
+		const vp = sb.viewport;
+		const top: number = sb.scrollTop ?? 0;
+		const vpH: number = vp?.height ?? 0;
+		// The scrollbar's onChange sets `content.translateY = -scrollTop`, so
+		// the child's cumulative `.y` already includes `-scrollTop`; subtracting
+		// the viewport's stable `.y` and re-adding `scrollTop` recovers the
+		// row's layout-space offset within the content (scroll-independent).
+		const childTop: number = node.y ?? 0;
+		const childH: number = node.height ?? 0;
+		if (!vpH || !childH) return { scroll: null, ready: false };
+
+		const offset = childTop - (vp.y ?? 0) + top;
+		let target = top;
+		if (offset < top) target = offset;
+		else if (offset + childH > top + vpH) target = offset + childH - vpH;
+		const max = Math.max(0, (sb.scrollHeight ?? 0) - vpH);
+		if (target > max) target = max;
+		if (target < 0) target = 0;
+		target = Math.round(target);
+		if (target === Math.round(top)) return { scroll: null, ready: true };
+		return { scroll: target, ready: true };
+	};
+
+	const tryScroll = (retriesLeft: number) => {
+		const { scroll, ready } = compute();
+		if (!ready) {
+			if (retriesLeft > 0)
+				timer = setTimeout(() => tryScroll(retriesLeft - 1), RETRY_MS);
+			return;
+		}
+		if (scroll != null) {
+			const sb = findScrollBox(el);
+			if (sb) sb.scrollTo(scroll);
+		}
+		clearTimer();
+	};
+
+	createEffect(() => {
+		if (!when()) return;
+		clearTimer();
+		tryScroll(MAX_RETRIES);
+	});
+
+	onCleanup(() => {
+		clearTimer();
+	});
+
+	return ref;
+}

src/index.tsx

@@ -1,225 +1,254 @@
-const VERSION = "0.1.0";
+import type { Feed } from "./types/feed"
+import type { Episode } from "./types/episode"
+
+const VERSION = "0.3.1";
 
 interface CliArgs {
-  version: boolean;
-  query: string | null;
-  play: string | null;
+	version: boolean;
+	query: string | null;
+	play: string | null;
 }
 
 function parseArgs(): CliArgs {
-  const args = process.argv.slice(2);
-  const result: CliArgs = {
-    version: false,
-    query: null,
-    play: null,
-  };
+	const args = process.argv.slice(2);
+	const result: CliArgs = {
+		version: false,
+		query: null,
+		play: null,
+	};
 
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--version" || arg === "-v") {
-      result.version = true;
-    } else if (arg === "--query" || arg === "-q") {
-      result.query = args[i + 1] || "";
-      i++;
-    } else if (arg === "--play" || arg === "-p") {
-      result.play = args[i + 1] || "";
-      i++;
-    }
-  }
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === "--version" || arg === "-v") {
+			result.version = true;
+		} else if (arg === "--query" || arg === "-q") {
+			result.query = args[i + 1] || "";
+			i++;
+		} else if (arg === "--play" || arg === "-p") {
+			result.play = args[i + 1] || "";
+			i++;
+		}
+	}
 
-  return result;
+	return result;
 }
 
 const cliArgs = parseArgs();
 
 if (cliArgs.version) {
-  console.log(`PodTUI version ${VERSION}`);
-  process.exit(0);
+	console.log(`PodTUI version ${VERSION}`);
+	process.exit(0);
+}
+
+// ── CLI handlers ──────────────────────────────────────────────────────
+
+/** Find the most recent episode across all feeds */
+function findLatestEpisode(
+	feeds: Feed[],
+): { feed: Feed; episode: Episode } | null {
+	let latest: { feed: Feed; episode: Episode } | null = null
+	let latestDate = 0
+
+	for (const feed of feeds) {
+		if (feed.episodes.length === 0) continue
+		const ep = feed.episodes[0]
+		const epDate =
+			ep.pubDate instanceof Date ? ep.pubDate.getTime() : Number(ep.pubDate)
+		if (epDate > latestDate) {
+			latestDate = epDate
+			latest = { feed, episode: ep }
+		}
+	}
+
+	return latest
+}
+
+/** Search feeds by title and print matching shows */
+function handleQuery(feeds: Feed[], query: string): void {
+	const normalizedQuery = query.toLowerCase()
+
+	const matches = feeds.filter((feed) => {
+		const title = feed.podcast.title.toLowerCase()
+		return title.includes(normalizedQuery)
+	})
+
+	if (matches.length === 0) {
+		console.log(`No shows found matching: ${query}`)
+		if (feeds.length > 0) {
+			console.log("\nAvailable shows:")
+			feeds.slice(0, 5).forEach((feed) => {
+				console.log(`  - ${feed.podcast.title}`)
+			})
+			if (feeds.length > 5) {
+				console.log(`  ... and ${feeds.length - 5} more`)
+			}
+		}
+		process.exit(0)
+	}
+
+	if (matches.length === 1) {
+		const feed = matches[0]
+		console.log(`\n${feed.podcast.title}`)
+		if (feed.podcast.description) {
+			console.log(
+				feed.podcast.description.substring(0, 200) +
+					(feed.podcast.description.length > 200 ? "..." : ""),
+			)
+		}
+		console.log(`\nRecent episodes (${Math.min(5, feed.episodes.length)}):`)
+		feed.episodes.slice(0, 5).forEach((ep, idx) => {
+			const date =
+				ep.pubDate instanceof Date
+					? ep.pubDate.toLocaleDateString()
+					: String(ep.pubDate)
+			console.log(`  ${idx + 1}. ${ep.title} (${date})`)
+		})
+		process.exit(0)
+	}
+
+	console.log(`\nClosest matches for "${query}":`)
+	matches.slice(0, 5).forEach((feed, idx) => {
+		console.log(`  ${idx + 1}. ${feed.podcast.title}`)
+	})
+	process.exit(0)
+}
+
+/** Resolve and play an episode from `arg` (title path or "latest") */
+async function handlePlay(feeds: Feed[], arg: string): Promise<void> {
+	const normalizedArg = arg.toLowerCase()
+
+	let feedResult: Feed | null = null
+	let episodeResult: Episode | null = null
+
+	if (normalizedArg === "latest") {
+		const latest = findLatestEpisode(feeds)
+		if (latest) {
+			feedResult = latest.feed
+			episodeResult = latest.episode
+		}
+	} else {
+		const parts = normalizedArg.split("/")
+		const showQuery = parts[0]
+		const episodeQuery = parts[1]
+
+		const matchingFeeds = feeds.filter((feed) =>
+			feed.podcast.title.toLowerCase().includes(showQuery),
+		)
+
+		if (matchingFeeds.length === 0) {
+			console.log(`No show found matching: ${showQuery}`)
+			process.exit(1)
+		}
+
+		const feed = matchingFeeds[0]
+
+		if (!episodeQuery) {
+			if (feed.episodes.length > 0) {
+				feedResult = feed
+				episodeResult = feed.episodes[0]
+			} else {
+				console.log(`No episodes available for: ${feed.podcast.title}`)
+				process.exit(1)
+			}
+		} else if (episodeQuery === "latest") {
+			feedResult = feed
+			episodeResult = feed.episodes[0]
+		} else {
+			const matchingEpisode = feed.episodes.find((ep) =>
+				ep.title.toLowerCase().includes(episodeQuery),
+			)
+
+			if (matchingEpisode) {
+				feedResult = feed
+				episodeResult = matchingEpisode
+			} else {
+				console.log(`Episode not found: ${episodeQuery}`)
+				console.log(`Available episodes for ${feed.podcast.title}:`)
+				feed.episodes.slice(0, 5).forEach((ep, idx) => {
+					console.log(`  ${idx + 1}. ${ep.title}`)
+				})
+				process.exit(1)
+			}
+		}
+	}
+
+	if (!feedResult || !episodeResult) {
+		console.log("Could not find episode to play")
+		process.exit(1)
+	}
+
+	console.log(`\nPlaying: ${episodeResult.title}`)
+	console.log(`Show: ${feedResult.podcast.title}`)
+
+	try {
+		const { createAudioBackend } = await import("./utils/audio-player")
+		const backend = createAudioBackend()
+		if (episodeResult.audioUrl) {
+			await backend.play(episodeResult.audioUrl)
+			console.log("Playback started (use the UI to control)")
+		} else {
+			console.log("No audio URL available for this episode")
+			process.exit(1)
+		}
+	} catch (err) {
+		console.error("Playback error:", err)
+		process.exit(1)
+	}
 }
 
 if (cliArgs.query !== null || cliArgs.play !== null) {
-  import("./utils/feeds-persistence").then(async ({ loadFeedsFromFile }) => {
-    const feeds = await loadFeedsFromFile();
+	import("./utils/feeds-persistence")
+		.then(async ({ loadFeedsFromFile }) => {
+			const feeds = await loadFeedsFromFile();
 
-    if (cliArgs.query !== null) {
-      const query = cliArgs.query;
-      const normalizedQuery = query.toLowerCase();
+			if (cliArgs.query !== null) {
+				handleQuery(feeds, cliArgs.query)
+			}
 
-      const matches = feeds.filter((feed) => {
-        const title = feed.podcast.title.toLowerCase();
-        return title.includes(normalizedQuery);
-      });
-
-      if (matches.length === 0) {
-        console.log(`No shows found matching: ${query}`);
-        if (feeds.length > 0) {
-          console.log("\nAvailable shows:");
-          feeds.slice(0, 5).forEach((feed) => {
-            console.log(`  - ${feed.podcast.title}`);
-          });
-          if (feeds.length > 5) {
-            console.log(`  ... and ${feeds.length - 5} more`);
-          }
-        }
-        process.exit(0);
-      }
-
-      if (matches.length === 1) {
-        const feed = matches[0];
-        console.log(`\n${feed.podcast.title}`);
-        if (feed.podcast.description) {
-          console.log(feed.podcast.description.substring(0, 200) + (feed.podcast.description.length > 200 ? "..." : ""));
-        }
-        console.log(`\nRecent episodes (${Math.min(5, feed.episodes.length)}):`);
-        feed.episodes.slice(0, 5).forEach((ep, idx) => {
-          const date = ep.pubDate instanceof Date ? ep.pubDate.toLocaleDateString() : String(ep.pubDate);
-          console.log(`  ${idx + 1}. ${ep.title} (${date})`);
-        });
-        process.exit(0);
-      }
-
-      console.log(`\nClosest matches for "${query}":`);
-      matches.slice(0, 5).forEach((feed, idx) => {
-        console.log(`  ${idx + 1}. ${feed.podcast.title}`);
-      });
-      process.exit(0);
-    }
-
-    if (cliArgs.play !== null) {
-      const playArg = cliArgs.play;
-      const normalizedArg = playArg.toLowerCase();
-
-      let feedResult: typeof feeds[0] | null = null;
-      let episodeResult: typeof feeds[0]["episodes"][0] | null = null;
-
-      if (normalizedArg === "latest") {
-        let latestFeed: typeof feeds[0] | null = null;
-        let latestEpisode: typeof feeds[0]["episodes"][0] | null = null;
-        let latestDate = 0;
-
-        for (const feed of feeds) {
-          if (feed.episodes.length > 0) {
-            const ep = feed.episodes[0];
-            const epDate = ep.pubDate instanceof Date ? ep.pubDate.getTime() : Number(ep.pubDate);
-            if (epDate > latestDate) {
-              latestDate = epDate;
-              latestFeed = feed;
-              latestEpisode = ep;
-            }
-          }
-        }
-
-        feedResult = latestFeed;
-        episodeResult = latestEpisode;
-      } else {
-        const parts = normalizedArg.split("/");
-        const showQuery = parts[0];
-        const episodeQuery = parts[1];
-
-        const matchingFeeds = feeds.filter((feed) =>
-          feed.podcast.title.toLowerCase().includes(showQuery)
-        );
-
-        if (matchingFeeds.length === 0) {
-          console.log(`No show found matching: ${showQuery}`);
-          process.exit(1);
-        }
-
-        const feed = matchingFeeds[0];
-
-        if (!episodeQuery) {
-          if (feed.episodes.length > 0) {
-            feedResult = feed;
-            episodeResult = feed.episodes[0];
-          } else {
-            console.log(`No episodes available for: ${feed.podcast.title}`);
-            process.exit(1);
-          }
-        } else if (episodeQuery === "latest") {
-          feedResult = feed;
-          episodeResult = feed.episodes[0];
-        } else {
-          const matchingEpisode = feed.episodes.find((ep) =>
-            ep.title.toLowerCase().includes(episodeQuery)
-          );
-
-          if (matchingEpisode) {
-            feedResult = feed;
-            episodeResult = matchingEpisode;
-          } else {
-            console.log(`Episode not found: ${episodeQuery}`);
-            console.log(`Available episodes for ${feed.podcast.title}:`);
-            feed.episodes.slice(0, 5).forEach((ep, idx) => {
-              console.log(`  ${idx + 1}. ${ep.title}`);
-            });
-            process.exit(1);
-          }
-        }
-      }
-
-      if (!feedResult || !episodeResult) {
-        console.log("Could not find episode to play");
-        process.exit(1);
-      }
-
-      console.log(`\nPlaying: ${episodeResult.title}`);
-      console.log(`Show: ${feedResult.podcast.title}`);
-
-      try {
-        const { createAudioBackend } = await import("./utils/audio-player");
-        const backend = createAudioBackend();
-        if (episodeResult.audioUrl) {
-          await backend.play(episodeResult.audioUrl);
-          console.log("Playback started (use the UI to control)");
-        } else {
-          console.log("No audio URL available for this episode");
-          process.exit(1);
-        }
-      } catch (err) {
-        console.error("Playback error:", err);
-        process.exit(1);
-      }
-    }
-  }).catch((err) => {
-    console.error("Error:", err);
-    process.exit(1);
-  });
+			if (cliArgs.play !== null) {
+				await handlePlay(feeds, cliArgs.play)
+			}
+		})
+		.catch((err) => {
+			console.error("Error:", err);
+			process.exit(1);
+		});
 } else {
-  import("@opentui/solid").then(async ({ render, useRenderer }) => {
-    const { App } = await import("./App");
-    const { ThemeProvider } = await import("./context/ThemeContext");
-    const toast = await import("./ui/toast");
-    const { KeybindProvider } = await import("./context/KeybindContext");
-    const { NavigationProvider } = await import("./context/NavigationContext");
-    const { DialogProvider } = await import("./ui/dialog");
-    const { CommandProvider } = await import("./ui/command");
+	import("@opentui/solid").then(async ({ render, useRenderer }) => {
+		const { App } = await import("./App");
+		const { ThemeProvider } = await import("./context/ThemeContext");
+		const toast = await import("./ui/toast");
+		const { KeybindProvider } = await import("./context/KeybindContext");
+		const { NavigationProvider } = await import("./context/NavigationContext");
+		const { DialogProvider } = await import("./ui/dialog");
+		const { CommandProvider } = await import("./ui/command");
 
-    function RendererSetup(props: { children: unknown }) {
-      const renderer = useRenderer();
-      renderer.disableStdoutInterception();
-      return props.children;
-    }
+		function RendererSetup(props: { children: unknown }) {
+			const renderer = useRenderer();
+			renderer.disableStdoutInterception();
+			return props.children;
+		}
 
-    render(
-      () => (
-        <RendererSetup>
-          <toast.ToastProvider>
-            <ThemeProvider mode="dark">
-              <KeybindProvider>
-                <NavigationProvider>
-                  <DialogProvider>
-                    <CommandProvider>
-                      <App />
-                      <toast.Toast />
-                    </CommandProvider>
-                  </DialogProvider>
-                </NavigationProvider>
-              </KeybindProvider>
-            </ThemeProvider>
-          </toast.ToastProvider>
-        </RendererSetup>
-      ),
-      { useThread: false },
-    );
-  });
+		render(
+			() => (
+				<RendererSetup>
+					<toast.ToastProvider>
+						<ThemeProvider mode="dark">
+							<KeybindProvider>
+								<NavigationProvider>
+									<DialogProvider>
+										<CommandProvider>
+											<App />
+											<toast.Toast />
+										</CommandProvider>
+									</DialogProvider>
+								</NavigationProvider>
+							</KeybindProvider>
+						</ThemeProvider>
+					</toast.ToastProvider>
+				</RendererSetup>
+			),
+			{ useThread: false },
+		);
+	});
 }

src/pages/Discover/DiscoverPage.tsx

@@ -2,13 +2,13 @@
  * DiscoverPage — yazi depth-stack view of discoverable podcasts.
  *
  *   depth 0 (current) — category list. Parent pane shows the muted
- *                       placeholder (1/7 slot kept).
+ *                       placeholder (1/5 slot kept).
  *   depth 1 (current) — podcast results for the drilled category. Parent
  *                       pane = the categories list.
  *   preview            — detail of the hovered item (category summary, or
  *                       podcast detail + subscribe action).
  *
- * Renders entirely through `<YaziPaneRow>`; no bespoke 3-column flexbox JSX
+ * Renders entirely through `<PaneRow>`; no bespoke 3-column flexbox JSX
  * remains. `l`/Enter drills in (category → results) or subscribes (on a
  * podcast); `h` pops a depth (noop at 0). j/k move only within the current
  * column. Moving through categories at depth 0 updates the store's selected
@@ -28,8 +28,10 @@ import {
 } from "@/context/NavigationContext";
 import { on, off } from "@/utils/event-bus";
 import type { KeybindActionName } from "@/context/KeybindContext";
-import { YaziPaneRow } from "@/components/YaziPaneRow";
+import { PaneRow } from "@/components/PaneRow";
 import { TabListPane } from "@/components/TabPanel";
+import { LoadingIndicator } from "@/components/LoadingIndicator";
+import { useScrollIntoView } from "@/hooks/useScrollIntoView";
 
 export const DiscoverPaneCount = 1;
 
@@ -39,7 +41,6 @@ function DiscoverPage() {
 	const muted = () => theme.muted || theme.text;
 	const nav = useNavigation();
 
-	const stack = nav.depthStack;
 	const depth = nav.currentDepth;
 	const focus = (d: number = depth()) => nav.depthFocus(d);
 
@@ -65,6 +66,12 @@ function DiscoverPage() {
 	};
 	onMount(ensureFocus);
 
+	// Auto-fetch the featured-shows manifest on first mount (network failure is
+	// non-fatal — the list stays empty until the user hits refresh).
+	onMount(() => {
+		discoverStore.refresh().catch(() => {});
+	});
+
 	onMount(() => {
 		nav.registerResolver(`${nav.activeTab()}:${DEPTH_CENTER_PANE}`, (i) => {
 			if (depth() === 0) return categories()[i]?.id;
@@ -140,7 +147,11 @@ function DiscoverPage() {
 	const focusBg = (i: number, lf: number, active: boolean) =>
 		i === lf && active ? theme.primary : i === lf ? theme.border : undefined;
 	const focusFg = (i: number, lf: number, active: boolean) =>
-		i === lf && active ? theme.surface : theme.text;
+		i === lf && active
+			? theme.surface
+			: i === lf
+				? theme.selectedListItemText ?? theme.text
+				: theme.text;
 
 	const currentLabel = () =>
 		depth() === 0
@@ -148,28 +159,32 @@ function DiscoverPage() {
 			: `${focusedCategory()?.name ?? "Discover"} · ${podcasts().length}`;
 
 	// ── parent pane: previous-depth list (muted/blank at depth 0) ─────────────
-	// ── parent pane: previous-depth list (muted/blank at depth 0) ──────────
 	// Stable <Show> gate (not a ternary root swap) so the parent list
 	// mounts/unmounts cleanly on depth change.
 	const parentContent = () => (
 		<Show when={depth() >= 1} fallback={<TabListPane muted />}>
 			<For each={categories()}>
-				{(cat, index) => (
-					<box
-						flexDirection="row"
-						gap={1}
-						paddingLeft={1}
-						paddingRight={1}
-						backgroundColor={focusBg(index(), nav.depthFocus(0), false)}
-					>
-						<text fg={focusFg(index(), nav.depthFocus(0), false)}>
-							{index() === nav.depthFocus(0) ? "❯" : " "}
-						</text>
-						<text fg={focusFg(index(), nav.depthFocus(0), false)}>
-							{cat.name}
-						</text>
-					</box>
-				)}
+				{(cat, index) => {
+					const lf = () => nav.depthFocus(0);
+					const ref = useScrollIntoView(() => index() === lf());
+					return (
+						<box
+							ref={ref}
+							flexDirection="row"
+							gap={1}
+							paddingLeft={1}
+							paddingRight={1}
+							backgroundColor={focusBg(index(), lf(), false)}
+						>
+							<text fg={focusFg(index(), nav.depthFocus(0), false)}>
+								{index() === nav.depthFocus(0) ? "❯" : " "}
+							</text>
+							<text fg={focusFg(index(), nav.depthFocus(0), false)}>
+								{cat.name}
+							</text>
+						</box>
+					);
+				}}
 			</For>
 		</Show>
 	);
@@ -181,30 +196,26 @@ function DiscoverPage() {
 			<Show when={depth() === 0}>
 				<For each={categories()}>
 					{(cat, index) => {
-						const lf = focusedCatIdx();
-						const selected = () => cat.id === discoverStore.selectedCategory();
+						const lf = () => focusedCatIdx();
+						const ref = useScrollIntoView(() => index() === lf());
 						return (
 							<box
+								ref={ref}
 								flexDirection="row"
 								gap={1}
 								paddingLeft={1}
 								paddingRight={1}
-								backgroundColor={focusBg(index(), lf, isActive())}
+								backgroundColor={focusBg(index(), lf(), isActive())}
 								onMouseDown={() => {
 									nav.setActivePane(DEPTH_CENTER_PANE);
 									nav.setDepthFocus(index(), 0);
 									discoverStore.setSelectedCategory(cat.id);
 								}}
 							>
-								<text fg={focusFg(index(), lf, isActive())}>
-									{index() === lf ? "❯" : " "}
+								<text fg={focusFg(index(), lf(), isActive())}>
+									{index() === lf() ? "❯" : " "}
 								</text>
-								<text fg={focusFg(index(), lf, isActive())}>{cat.name}</text>
-								<Show when={selected()}>
-									<text fg={index() === lf ? theme.surface : theme.accent}>
-										*
-									</text>
-								</Show>
+								<text fg={focusFg(index(), lf(), isActive())}>{cat.name}</text>
 							</box>
 						);
 					}}
@@ -216,41 +227,52 @@ function DiscoverPage() {
 					when={podcasts().length > 0}
 					fallback={
 						<box padding={1}>
-							<text fg={muted()}>No podcasts found. :refresh</text>
+							<Show
+								when={discoverStore.isLoading()}
+								fallback={
+									<text fg={muted()}>No podcasts found. :refresh</text>
+								}
+							>
+								<LoadingIndicator label="Discovering…" />
+							</Show>
 						</box>
 					}
 				>
 					<For each={podcasts()}>
 						{(podcast, index) => {
-							const lf = focusedPodIdx();
+							const lf = () => focusedPodIdx();
+							const ref = useScrollIntoView(() => index() === lf());
 							return (
 								<box
+									ref={ref}
 									flexDirection="column"
 									gap={0}
 									paddingLeft={1}
 									paddingRight={1}
-									backgroundColor={focusBg(index(), lf, isActive())}
+									backgroundColor={focusBg(index(), lf(), isActive())}
 									onMouseDown={() => {
 										nav.setActivePane(DEPTH_CENTER_PANE);
 										nav.setDepthFocus(index(), 1);
 									}}
 								>
 									<box flexDirection="row" gap={1}>
-										<text fg={focusFg(index(), lf, isActive())}>
-											{index() === lf ? "❯" : " "}
+										<text fg={focusFg(index(), lf(), isActive())}>
+											{index() === lf() ? "❯" : " "}
 										</text>
-										<text fg={focusFg(index(), lf, isActive())}>
+										<text fg={focusFg(index(), lf(), isActive())}>
 											{podcast.title}
 										</text>
 										<Show when={podcast.isSubscribed}>
-											<text fg={index() === lf ? theme.surface : theme.success}>
+											<text
+												fg={index() === lf() ? theme.surface : theme.success}
+											>
 												[+]
 											</text>
 										</Show>
 									</box>
 									<Show when={podcast.author}>
 										<text
-											fg={index() === lf ? theme.surface : muted()}
+											fg={index() === lf() ? theme.surface : muted()}
 											paddingLeft={2}
 										>
 											by {podcast.author}
@@ -260,6 +282,11 @@ function DiscoverPage() {
 							);
 						}}
 					</For>
+					<Show when={discoverStore.isLoading()}>
+						<box paddingLeft={2} paddingTop={1}>
+							<LoadingIndicator label="Refreshing…" />
+						</box>
+					</Show>
 				</Show>
 			</Show>
 		</>
@@ -268,7 +295,7 @@ function DiscoverPage() {
 	// ── preview pane ───────────────────────────────────────────────────────────
 	const previewContent = () =>
 		depth() === 0 ? (
-			// depth 0 preview: hovered category
+			// depth 0 preview: shows for the hovered category
 			<Show
 				when={focusedCategory()}
 				fallback={
@@ -278,16 +305,35 @@ function DiscoverPage() {
 				}
 			>
 				{(cat) => (
-					<box flexDirection="column" gap={1} padding={1}>
+					<box flexDirection="column" gap={0} padding={1}>
 						<text fg={theme.textPrimary ?? theme.text}>
 							<strong>{cat().name}</strong>
 						</text>
-						<text fg={theme.textSecondary}>
-							{(cat() as any).description ??
-								`Browse top podcasts in ${cat().name}.`}
-						</text>
+						<Show when={(cat() as any).description}>
+							<text fg={theme.textSecondary}>{(cat() as any).description}</text>
+						</Show>
 						<box height={1} />
-						<text fg={muted()}>enter/l: open · h: back</text>
+						<Show
+							when={podcasts().length > 0}
+							fallback={
+								<text fg={muted()}>
+									No shows in this category yet. :refresh
+								</text>
+							}
+						>
+							<For each={podcasts()}>
+								{(pod) => (
+									<box flexDirection="column" gap={0}>
+										<text fg={theme.text}>{pod.title}</text>
+										<Show when={pod.author}>
+											<text fg={muted()} paddingLeft={2}>
+												by {pod.author}
+											</text>
+										</Show>
+									</box>
+								)}
+							</For>
+						</Show>
 					</box>
 				)}
 			</Show>
@@ -339,13 +385,11 @@ function DiscoverPage() {
 		);
 
 	return (
-		<YaziPaneRow
+		<PaneRow
 			parent={parentContent}
 			current={currentContent}
 			preview={previewContent}
-			parentLabel={() => (depth() >= 1 ? "Categories" : "Up")}
 			currentLabel={currentLabel}
-			previewLabel="Detail"
 			focused={isActive}
 		/>
 	);

src/pages/Discover/PodcastCard.tsx

@@ -1,85 +0,0 @@
-/**
- * PodcastCard component - Reusable card for displaying podcast info
- */
-
-import { Show, For } from "solid-js";
-import type { Podcast } from "@/types/podcast";
-import { useTheme } from "@/context/ThemeContext";
-import { SelectableBox, SelectableText } from "@/components/Selectable";
-
-type PodcastCardProps = {
-  podcast: Podcast;
-  selected: boolean;
-  compact?: boolean;
-  onSelect?: () => void;
-  onSubscribe?: () => void;
-};
-
-export function PodcastCard(props: PodcastCardProps) {
-  const { theme } = useTheme();
-  const handleSubscribeClick = () => {
-    props.onSubscribe?.();
-  };
-
-  return (
-    <SelectableBox
-      selected={() => props.selected}
-      flexDirection="column"
-      padding={1}
-      onMouseDown={props.onSelect}
-    >
-      <box flexDirection="row" gap={2} alignItems="center">
-        <SelectableText selected={() => props.selected} primary>
-          <strong>{props.podcast.title}</strong>
-        </SelectableText>
-
-        <Show when={props.podcast.isSubscribed}>
-          <text fg={theme.success}>[+]</text>
-        </Show>
-      </box>
-
-      {/* Author */}
-      <Show when={props.podcast.author && !props.compact}>
-        <SelectableText
-          selected={() => props.selected}
-          tertiary
-        >
-          by {props.podcast.author}
-        </SelectableText>
-      </Show>
-
-      {/* Description */}
-      <Show when={props.podcast.description && !props.compact}>
-        <SelectableText
-          selected={() => props.selected}
-          tertiary
-        >
-          {props.podcast.description!.length > 80
-            ? props.podcast.description!.slice(0, 80) + "..."
-            : props.podcast.description}
-        </SelectableText>
-      </Show>
-
-      {/**<box
-        flexDirection="row"
-        justifyContent="space-between"
-        marginTop={props.compact ? 0 : 1}
-      />**/}
-      <box flexDirection="row" gap={1}>
-        <Show when={(props.podcast.categories ?? []).length > 0}>
-          <For each={(props.podcast.categories ?? []).slice(0, 2)}>
-            {(cat) => <text fg={theme.warning}>[{cat}]</text>}
-          </For>
-        </Show>
-      </box>
-
-      <Show when={props.selected}>
-        <box onMouseDown={handleSubscribeClick}>
-          <text fg={props.podcast.isSubscribed ? theme.error : theme.success}>
-            {props.podcast.isSubscribed ? "[Unsubscribe]" : "[Subscribe]"}
-          </text>
-        </box>
-      </Show>
-    </SelectableBox>
-  );
-}

src/pages/Feed/FeedDetail.tsx

@@ -1,194 +0,0 @@
-/**
- * Feed detail view component for PodTUI
- * Shows podcast info and episode list
- */
-
-import { createSignal, For, Show } from "solid-js";
-import { useKeyboard } from "@opentui/solid";
-import type { Feed } from "@/types/feed";
-import type { Episode } from "@/types/episode";
-import { format } from "date-fns";
-import { useTheme } from "@/context/ThemeContext";
-import { SelectableBox, SelectableText } from "@/components/Selectable";
-
-interface FeedDetailProps {
-  feed: Feed;
-  focused?: boolean;
-  onBack?: () => void;
-  onPlayEpisode?: (episode: Episode) => void;
-}
-
-export function FeedDetail(props: FeedDetailProps) {
-  const { theme } = useTheme();
-  const [selectedIndex, setSelectedIndex] = createSignal(0);
-  const [showInfo, setShowInfo] = createSignal(true);
-
-  const episodes = () => {
-    // Sort episodes by publication date (newest first)
-    return [...props.feed.episodes].sort(
-      (a, b) => b.pubDate.getTime() - a.pubDate.getTime(),
-    );
-  };
-
-  const formatDuration = (seconds: number): string => {
-    const mins = Math.floor(seconds / 60);
-    const hrs = Math.floor(mins / 60);
-    if (hrs > 0) {
-      return `${hrs}h ${mins % 60}m`;
-    }
-    return `${mins}m`;
-  };
-
-  const formatDate = (date: Date): string => {
-    return format(date, "MMM d, yyyy");
-  };
-
-  const handleKeyPress = (key: { name: string }) => {
-    const eps = episodes();
-
-    if (key.name === "escape" && props.onBack) {
-      props.onBack();
-      return;
-    }
-
-    if (key.name === "i") {
-      setShowInfo((v) => !v);
-      return;
-    }
-
-    if (key.name === "v") {
-      props.feed.podcast.onToggleVisibility?.(props.feed.id);
-      return;
-    }
-
-    if (key.name === "up" || key.name === "k") {
-      setSelectedIndex((i) => Math.max(0, i - 1));
-    } else if (key.name === "down" || key.name === "j") {
-      setSelectedIndex((i) => Math.min(eps.length - 1, i + 1));
-    } else if (key.name === "return") {
-      const episode = eps[selectedIndex()];
-      if (episode && props.onPlayEpisode) {
-        props.onPlayEpisode(episode);
-      }
-    } else if (key.name === "home" || key.name === "g") {
-      setSelectedIndex(0);
-    } else if (key.name === "end") {
-      setSelectedIndex(eps.length - 1);
-    } else if (key.name === "pageup") {
-      setSelectedIndex((i) => Math.max(0, i - 10));
-    } else if (key.name === "pagedown") {
-      setSelectedIndex((i) => Math.min(eps.length - 1, i + 10));
-    }
-  };
-
-  useKeyboard((key) => {
-    if (!props.focused) return;
-    handleKeyPress(key);
-  });
-
-  return (
-    <box flexDirection="column" gap={1}>
-      {/* Header with back button */}
-      <box flexDirection="row" justifyContent="space-between">
-        <box border padding={0} onMouseDown={props.onBack} borderColor={theme.border}>
-            <SelectableText selected={() => false} primary>[Esc] Back</SelectableText>
-        </box>
-        <box border padding={0} onMouseDown={() => setShowInfo((v) => !v)} borderColor={theme.border}>
-            <SelectableText selected={() => false} primary>[i] {showInfo() ? "Hide" : "Show"} Info</SelectableText>
-        </box>
-        <box border padding={0} onMouseDown={() => props.feed.podcast.onToggleVisibility?.(props.feed.id)} borderColor={theme.border}>
-            <SelectableText selected={() => false} primary>[v] Toggle Visibility</SelectableText>
-        </box>
-      </box>
-
-      {/* Podcast info section */}
-      <Show when={showInfo()}>
-        <box border padding={1} flexDirection="column" gap={0} borderColor={theme.border}>
-          <SelectableText selected={() => false} primary>
-            <strong>{props.feed.customName || props.feed.podcast.title}</strong>
-          </SelectableText>
-          {props.feed.podcast.author && (
-            <box flexDirection="row" gap={1}>
-                <SelectableText selected={() => false} tertiary>by</SelectableText>
-                <SelectableText selected={() => false} primary>{props.feed.podcast.author}</SelectableText>
-            </box>
-          )}
-          <box height={1} />
-          <SelectableText selected={() => false} tertiary>
-            {props.feed.podcast.description?.slice(0, 200)}
-            {(props.feed.podcast.description?.length || 0) > 200 ? "..." : ""}
-          </SelectableText>
-          <box height={1} />
-          <box flexDirection="row" gap={2}>
-            <box flexDirection="row" gap={1}>
-              <SelectableText selected={() => false} tertiary>Episodes:</SelectableText>
-              <SelectableText selected={() => false} tertiary>{props.feed.episodes.length}</SelectableText>
-            </box>
-            <box flexDirection="row" gap={1}>
-              <SelectableText selected={() => false} tertiary>Updated:</SelectableText>
-              <SelectableText selected={() => false} tertiary>{formatDate(props.feed.lastUpdated)}</SelectableText>
-            </box>
-            <SelectableText selected={() => false} tertiary>
-              {props.feed.visibility === "public" ? "[Public]" : "[Private]"}
-            </SelectableText>
-            {props.feed.isPinned && <SelectableText selected={() => false} tertiary>[Pinned]</SelectableText>}
-          </box>
-          <box flexDirection="row" gap={1}>
-            <SelectableText selected={() => false} tertiary>[v] Toggle Visibility</SelectableText>
-          </box>
-        </box>
-      </Show>
-
-      {/* Episodes header */}
-      <box flexDirection="row" justifyContent="space-between">
-        <SelectableText selected={() => false} primary>
-          <strong>Episodes</strong>
-        </SelectableText>
-        <SelectableText selected={() => false} tertiary>({episodes().length} total)</SelectableText>
-      </box>
-
-      {/* Episode list */}
-      <scrollbox height={showInfo() ? 10 : 15} focused={props.focused}>
-        <For each={episodes()}>
-          {(episode, index) => (
-            <SelectableBox
-              selected={() => index() === selectedIndex()}
-              flexDirection="column"
-              gap={0}
-              padding={1}
-              onMouseDown={() => {
-                setSelectedIndex(index());
-                if (props.onPlayEpisode) {
-                  props.onPlayEpisode(episode);
-                }
-              }}
-            >
-              <SelectableText
-                selected={() => index() === selectedIndex()}
-                primary
-              >
-                {index() === selectedIndex() ? ">" : " "}
-              </SelectableText>
-              <SelectableText
-                selected={() => index() === selectedIndex()}
-                primary
-              >
-                {episode.episodeNumber ? `#${episode.episodeNumber} - ` : ""}
-                {episode.title}
-              </SelectableText>
-              <box flexDirection="row" gap={2} paddingLeft={2}>
-                  <SelectableText selected={() => index() === selectedIndex()} tertiary>{formatDate(episode.pubDate)}</SelectableText>
-                  <SelectableText selected={() => index() === selectedIndex()} tertiary>{formatDuration(episode.duration)}</SelectableText>
-              </box>
-            </SelectableBox>
-          )}
-        </For>
-      </scrollbox>
-
-      {/* Help text */}
-      <text fg={theme.textMuted}>
-        j/k to navigate, Enter to play, i to toggle info, Esc to go back
-      </text>
-    </box>
-  );
-}

src/pages/Feed/FeedFilter.tsx

@@ -1,207 +0,0 @@
-/**
- * Feed filter component for PodTUI
- * Toggle and filter options for feed list
- */
-
-import { createSignal } from "solid-js";
-import { FeedVisibility, FeedSortField } from "@/types/feed";
-import type { FeedFilter } from "@/types/feed";
-import { useTheme } from "@/context/ThemeContext";
-
-interface FeedFilterProps {
-  filter: FeedFilter;
-  focused?: boolean;
-  onFilterChange: (filter: FeedFilter) => void;
-}
-
-type FilterField = "visibility" | "sort" | "pinned" | "private" | "search";
-
-export function FeedFilterComponent(props: FeedFilterProps) {
-  const { theme } = useTheme();
-  const [focusField, setFocusField] = createSignal<FilterField>("visibility");
-  const [searchValue, setSearchValue] = createSignal(
-    props.filter.searchQuery || "",
-  );
-
-  const fields: FilterField[] = ["visibility", "sort", "pinned", "private", "search"];
-
-  const handleKeyPress = (key: { name: string; shift?: boolean }) => {
-    if (key.name === "tab") {
-      const currentIndex = fields.indexOf(focusField());
-      const nextIndex = key.shift
-        ? (currentIndex - 1 + fields.length) % fields.length
-        : (currentIndex + 1) % fields.length;
-      setFocusField(fields[nextIndex]);
-    } else if (key.name === "return") {
-      if (focusField() === "visibility") {
-        cycleVisibility();
-      } else if (focusField() === "sort") {
-        cycleSort();
-      } else if (focusField() === "pinned") {
-        togglePinned();
-      } else if (focusField() === "private") {
-        togglePrivate();
-      }
-    } else if (key.name === "space") {
-      if (focusField() === "pinned") {
-        togglePinned();
-      } else if (focusField() === "private") {
-        togglePrivate();
-      }
-    }
-  };
-
-  const cycleVisibility = () => {
-    const current = props.filter.visibility;
-    let next: FeedVisibility | "all";
-    if (current === "all") next = FeedVisibility.PUBLIC;
-    else if (current === FeedVisibility.PUBLIC) next = FeedVisibility.PRIVATE;
-    else next = "all";
-    props.onFilterChange({ ...props.filter, visibility: next });
-  };
-
-  const cycleSort = () => {
-    const sortOptions: FeedSortField[] = [
-      FeedSortField.UPDATED,
-      FeedSortField.TITLE,
-      FeedSortField.EPISODE_COUNT,
-      FeedSortField.LATEST_EPISODE,
-    ];
-    const currentIndex = sortOptions.indexOf(
-      props.filter.sortBy as FeedSortField,
-    );
-    const nextIndex = (currentIndex + 1) % sortOptions.length;
-    props.onFilterChange({ ...props.filter, sortBy: sortOptions[nextIndex] });
-  };
-
-  const togglePinned = () => {
-    props.onFilterChange({
-      ...props.filter,
-      pinnedOnly: !props.filter.pinnedOnly,
-    });
-  };
-
-  const togglePrivate = () => {
-    props.onFilterChange({
-      ...props.filter,
-      showPrivate: !props.filter.showPrivate,
-    });
-  };
-
-  const handleSearchInput = (value: string) => {
-    setSearchValue(value);
-    props.onFilterChange({ ...props.filter, searchQuery: value });
-  };
-
-  const visibilityLabel = () => {
-    const vis = props.filter.visibility;
-    if (vis === "all") return "All";
-    if (vis === "public") return "Public";
-    return "Private";
-  };
-
-  const visibilityColor = () => {
-    const vis = props.filter.visibility;
-    if (vis === "public") return theme.success;
-    if (vis === "private") return theme.warning;
-    return theme.text;
-  };
-
-  const sortLabel = () => {
-    const sort = props.filter.sortBy;
-    switch (sort) {
-      case "title":
-        return "Title";
-      case "episodeCount":
-        return "Episodes";
-      case "latestEpisode":
-        return "Latest";
-      case "updated":
-      default:
-        return "Updated";
-    }
-  };
-
-  return (
-    <box flexDirection="column" border padding={1} gap={1} borderColor={theme.border}>
-      <text fg={theme.text}>
-        <strong>Filter Feeds</strong>
-      </text>
-
-      <box flexDirection="row" gap={2} flexWrap="wrap">
-        {/* Visibility filter */}
-        <box
-          border
-          padding={0}
-            backgroundColor={focusField() === "visibility" ? theme.backgroundElement : undefined}
-            borderColor={theme.border}
-        >
-          <box flexDirection="row" gap={1}>
-            <text fg={focusField() === "visibility" ? theme.primary : theme.textMuted}>
-              Show:
-            </text>
-            <text fg={visibilityColor()}>{visibilityLabel()}</text>
-          </box>
-        </box>
-
-        {/* Sort filter */}
-        <box
-          border
-          padding={0}
-            backgroundColor={focusField() === "sort" ? theme.backgroundElement : undefined}
-        >
-          <box flexDirection="row" gap={1}>
-            <text fg={focusField() === "sort" ? theme.primary : theme.textMuted}>Sort:</text>
-            <text fg={theme.text}>{sortLabel()}</text>
-          </box>
-        </box>
-
-        {/* Pinned filter */}
-        <box
-          border
-          padding={0}
-            backgroundColor={focusField() === "pinned" ? theme.backgroundElement : undefined}
-        >
-          <box flexDirection="row" gap={1}>
-            <text fg={focusField() === "pinned" ? theme.primary : theme.textMuted}>
-              Pinned:
-            </text>
-            <text fg={props.filter.pinnedOnly ? theme.warning : theme.textMuted}>
-              {props.filter.pinnedOnly ? "Yes" : "No"}
-            </text>
-          </box>
-        </box>
-
-        {/* Private filter */}
-        <box
-          border
-          padding={0}
-            backgroundColor={focusField() === "private" ? theme.backgroundElement : undefined}
-        >
-          <box flexDirection="row" gap={1}>
-            <text fg={focusField() === "private" ? theme.primary : theme.textMuted}>
-              Private:
-            </text>
-            <text fg={props.filter.showPrivate ? theme.warning : theme.textMuted}>
-              {props.filter.showPrivate ? "Yes" : "No"}
-            </text>
-          </box>
-        </box>
-      </box>
-
-      {/* Search box */}
-      <box flexDirection="row" gap={1}>
-            <text fg={focusField() === "search" ? theme.primary : theme.textMuted}>Search:</text>
-        <input
-          value={searchValue()}
-          onInput={handleSearchInput}
-          placeholder="Filter by name..."
-          focused={props.focused && focusField() === "search"}
-          width={25}
-        />
-      </box>
-
-      <text fg={theme.textMuted}>Tab to navigate, Enter/Space to toggle</text>
-    </box>
-  );
-}

src/pages/Feed/FeedItem.tsx

@@ -1,154 +0,0 @@
-/**
- * Feed item component for PodTUI
- * Displays a single feed/podcast in the list
- */
-
-import type { Feed, FeedVisibility } from "@/types/feed";
-import { format } from "date-fns";
-import { useTheme } from "@/context/ThemeContext";
-import { SelectableBox, SelectableText } from "@/components/Selectable";
-
-interface FeedItemProps {
-  feed: Feed;
-  isSelected: boolean;
-  showEpisodeCount?: boolean;
-  showLastUpdated?: boolean;
-  compact?: boolean;
-}
-
-export function FeedItem(props: FeedItemProps) {
-  const formatDate = (date: Date): string => {
-    return format(date, "MMM d");
-  };
-
-  const episodeCount = () => props.feed.episodes.length;
-  const unplayedCount = () => {
-    // This would be calculated based on episode status
-    return props.feed.episodes.length;
-  };
-
-  const visibilityIcon = () => {
-    return props.feed.visibility === "public" ? "[P]" : "[*]";
-  };
-
-  const visibilityColor = () => {
-    return props.feed.visibility === "public" ? theme.success : theme.warning;
-  };
-
-  const pinnedIndicator = () => {
-    return props.feed.isPinned ? "*" : " ";
-  };
-
-  const { theme } = useTheme();
-
-  if (props.compact) {
-    // Compact single-line view
-    return (
-      <SelectableBox
-        selected={() => props.isSelected}
-        flexDirection="row"
-        gap={1}
-        paddingLeft={1}
-        paddingRight={1}
-        onMouseDown={() => {}}
-      >
-        <SelectableText
-          selected={() => props.isSelected}
-          primary
-        >
-          {props.isSelected ? ">" : " "}
-        </SelectableText>
-        <SelectableText
-          selected={() => props.isSelected}
-          tertiary
-        >
-          {visibilityIcon()}
-        </SelectableText>
-        <SelectableText
-          selected={() => props.isSelected}
-          primary
-        >
-          {props.feed.customName || props.feed.podcast.title}
-        </SelectableText>
-        {props.showEpisodeCount && (
-          <SelectableText
-            selected={() => props.isSelected}
-            tertiary
-          >
-            ({episodeCount()})
-          </SelectableText>
-        )}
-      </SelectableBox>
-    );
-  }
-
-  // Full view with details
-  return (
-    <SelectableBox
-      selected={() => props.isSelected}
-      flexDirection="column"
-      gap={0}
-      padding={1}
-      onMouseDown={() => {}}
-    >
-      {/* Title row */}
-      <box flexDirection="row" gap={1}>
-        <SelectableText
-          selected={() => props.isSelected}
-          primary
-        >
-          {props.isSelected ? ">" : " "}
-        </SelectableText>
-        <SelectableText
-          selected={() => props.isSelected}
-          tertiary
-        >
-          {visibilityIcon()}
-        </SelectableText>
-        <SelectableText
-          selected={() => props.isSelected}
-          secondary
-        >
-          {pinnedIndicator()}
-        </SelectableText>
-        <SelectableText
-          selected={() => props.isSelected}
-          primary
-        >
-          <strong>{props.feed.customName || props.feed.podcast.title}</strong>
-        </SelectableText>
-      </box>
-
-      <box flexDirection="row" gap={2} paddingLeft={4}>
-        {props.showEpisodeCount && (
-          <SelectableText
-            selected={() => props.isSelected}
-            tertiary
-          >
-            {episodeCount()} episodes ({unplayedCount()} new)
-          </SelectableText>
-        )}
-        {props.showLastUpdated && (
-          <SelectableText
-            selected={() => props.isSelected}
-            tertiary
-          >
-            Updated: {formatDate(props.feed.lastUpdated)}
-          </SelectableText>
-        )}
-      </box>
-
-      {props.feed.podcast.description && (
-        <SelectableText
-          selected={() => props.isSelected}
-          paddingLeft={4}
-          paddingTop={0}
-          tertiary
-        >
-          {props.feed.podcast.description.slice(0, 60)}
-          {props.feed.podcast.description.length > 60 ? "..." : ""}
-        </SelectableText>
-      )}
-    </SelectableBox>
-  );
-}

src/pages/Feed/FeedList.tsx

@@ -1,198 +0,0 @@
-/**
- * Feed list component for PodTUI
- * Scrollable list of feeds with keyboard navigation and mouse support
- */
-
-import { createSignal, For, Show } from "solid-js";
-import { useKeyboard } from "@opentui/solid";
-import { FeedItem } from "./FeedItem";
-import { useFeedStore } from "@/stores/feed";
-import { FeedVisibility, FeedSortField } from "@/types/feed";
-import type { Feed } from "@/types/feed";
-import { useTheme } from "@/context/ThemeContext";
-
-interface FeedListProps {
-  focused?: boolean;
-  compact?: boolean;
-  showEpisodeCount?: boolean;
-  showLastUpdated?: boolean;
-  onSelectFeed?: (feed: Feed) => void;
-  onOpenFeed?: (feed: Feed) => void;
-  onFocusChange?: (focused: boolean) => void;
-}
-
-export function FeedList(props: FeedListProps) {
-  const { theme } = useTheme();
-  const feedStore = useFeedStore();
-  const [selectedIndex, setSelectedIndex] = createSignal(0);
-
-  const filteredFeeds = () => feedStore.getFilteredFeeds();
-
-  const handleKeyPress = (key: { name: string }) => {
-    if (key.name === "escape") {
-      props.onFocusChange?.(false);
-      return;
-    }
-    const feeds = filteredFeeds();
-
-    if (key.name === "up" || key.name === "k") {
-      setSelectedIndex((i) => Math.max(0, i - 1));
-    } else if (key.name === "down" || key.name === "j") {
-      setSelectedIndex((i) => Math.min(feeds.length - 1, i + 1));
-    } else if (key.name === "return") {
-      const feed = feeds[selectedIndex()];
-      if (feed && props.onOpenFeed) {
-        props.onOpenFeed(feed);
-      }
-    } else if (key.name === "home" || key.name === "g") {
-      setSelectedIndex(0);
-    } else if (key.name === "end") {
-      setSelectedIndex(feeds.length - 1);
-    } else if (key.name === "pageup") {
-      setSelectedIndex((i) => Math.max(0, i - 5));
-    } else if (key.name === "pagedown") {
-      setSelectedIndex((i) => Math.min(feeds.length - 1, i + 5));
-    } else if (key.name === "p") {
-      // Toggle pin on selected feed
-      const feed = feeds[selectedIndex()];
-      if (feed) {
-        feedStore.togglePinned(feed.id);
-      }
-    } else if (key.name === "v") {
-      // Toggle visibility on selected feed
-      const feed = feeds[selectedIndex()];
-      if (feed) {
-        const newVisibility = feed.visibility === FeedVisibility.PUBLIC ? FeedVisibility.PRIVATE : FeedVisibility.PUBLIC;
-        feedStore.updateFeed(feed.id, { visibility: newVisibility });
-      }
-    } else if (key.name === "f") {
-      // Cycle visibility filter
-      cycleVisibilityFilter();
-    } else if (key.name === "s") {
-      // Cycle sort
-      cycleSortField();
-    }
-
-    // Notify selection change
-    const selectedFeed = feeds[selectedIndex()];
-    if (selectedFeed && props.onSelectFeed) {
-      props.onSelectFeed(selectedFeed);
-    }
-  };
-
-  useKeyboard((key) => {
-    if (!props.focused) return;
-    handleKeyPress(key);
-  });
-
-  const cycleVisibilityFilter = () => {
-    const current = feedStore.filter().visibility;
-    let next: FeedVisibility | "all";
-    if (current === "all") next = FeedVisibility.PUBLIC;
-    else if (current === FeedVisibility.PUBLIC) next = FeedVisibility.PRIVATE;
-    else next = "all";
-    feedStore.setFilter({ ...feedStore.filter(), visibility: next });
-  };
-
-  const cycleSortField = () => {
-    const sortOptions: FeedSortField[] = [
-      FeedSortField.UPDATED,
-      FeedSortField.TITLE,
-      FeedSortField.EPISODE_COUNT,
-      FeedSortField.LATEST_EPISODE,
-    ];
-    const current = feedStore.filter().sortBy as FeedSortField;
-    const idx = sortOptions.indexOf(current);
-    const next = sortOptions[(idx + 1) % sortOptions.length];
-    feedStore.setFilter({ ...feedStore.filter(), sortBy: next });
-  };
-
-  const visibilityLabel = () => {
-    const vis = feedStore.filter().visibility;
-    if (vis === "all") return "All";
-    if (vis === "public") return "Public";
-    return "Private";
-  };
-
-  const sortLabel = () => {
-    const sort = feedStore.filter().sortBy;
-    switch (sort) {
-      case "title":
-        return "Title";
-      case "episodeCount":
-        return "Episodes";
-      case "latestEpisode":
-        return "Latest";
-      default:
-        return "Updated";
-    }
-  };
-
-  const handleFeedClick = (feed: Feed, index: number) => {
-    setSelectedIndex(index);
-    if (props.onSelectFeed) {
-      props.onSelectFeed(feed);
-    }
-  };
-
-  const handleFeedDoubleClick = (feed: Feed) => {
-    if (props.onOpenFeed) {
-      props.onOpenFeed(feed);
-    }
-  };
-
-  return (
-    <box flexDirection="column" gap={1}>
-      {/* Header with filter controls */}
-      <box flexDirection="row" justifyContent="space-between" paddingBottom={0}>
-        <text fg={theme.text}>
-          <strong>My Feeds</strong>
-        </text>
-            <text fg={theme.textMuted}>({filteredFeeds().length} feeds)</text>
-            <box flexDirection="row" gap={1}>
-              <box border padding={0} onMouseDown={cycleVisibilityFilter} borderColor={theme.border}>
-                <text fg={theme.primary}>[f] {visibilityLabel()}</text>
-              </box>
-              <box border padding={0} onMouseDown={cycleSortField} borderColor={theme.border}>
-                <text fg={theme.primary}>[s] {sortLabel()}</text>
-              </box>
-            </box>
-      </box>
-
-      {/* Feed list in scrollbox */}
-      <Show
-        when={filteredFeeds().length > 0}
-        fallback={
-          <box border padding={2} borderColor={theme.border}>
-            <text fg={theme.textMuted}>
-              No feeds found. Add podcasts from the Discover or Search tabs.
-            </text>
-          </box>
-        }
-      >
-        <scrollbox height={15} focused={props.focused}>
-          <For each={filteredFeeds()}>
-            {(feed, index) => (
-              <box onMouseDown={() => handleFeedClick(feed, index())}>
-                <FeedItem
-                  feed={feed}
-                  isSelected={index() === selectedIndex()}
-                  compact={props.compact}
-                  showEpisodeCount={props.showEpisodeCount ?? true}
-                  showLastUpdated={props.showLastUpdated ?? true}
-                />
-              </box>
-            )}
-          </For>
-        </scrollbox>
-      </Show>
-
-      {/* Navigation help */}
-      <box paddingTop={0}>
-          <text fg={theme.textMuted}>
-            Enter open | Esc up | j/k navigate | p pin | f filter | s sort
-          </text>
-      </box>
-    </box>
-  );
-}

src/pages/Feed/FeedPage.tsx

@@ -1,23 +1,25 @@
 /**
- * FeedPage — yazi depth-stack view of episodes across subscribed shows.
+ * FeedPage — flat chronological list of episodes across all subscribed feeds.
  *
- *   depth 0 (current) — subscribed feeds list (containers); index 0 is a
- *                       virtual "All Feeds". Parent pane shows the muted
- *                       placeholder (1/7 slot kept).
- *   depth 1 (current) — flat episodes list for the drilled feed (reverse
- *                       chronological). Parent pane = the feeds list (prev).
- *   preview            — detail of the hovered item in the current column.
+ *   depth 0 (current) — every episode from every feed, newest-first (the
+ *                       combined view the old "All Feeds" virtual row used to
+ *                       drill into). Parent pane shows the muted tab list.
+ *   preview            — detail of the hovered episode.
  *
- * Renders entirely through `<YaziPaneRow>` (the shared parent|current|preview
- * primitive); no bespoke 3-column flexbox JSX remains. `l`/Enter drills in
- * (push); `h` pops a depth (noop at 0). j/k move only within the current
- * column. The Shell router drives everything over `nav.action`; this page
- * only handles list/preview data.
+ * This page does NOT drill: the previous depth-1 "episodes of one feed" panel
+ * duplicated My Shows (shows → episodes). Per design, the Feed tab now just
+ * shows the full flat episodes list immediately.
+ *
+ * Renders entirely through `<PaneRow>` (the shared parent|current|preview
+ * primitive). `l`/Enter plays the focused episode; `h` pops back to the tab
+ * root. j/k move only within the current column. The Shell router drives
+ * everything over `nav.action`; this page only handles list/preview data.
  */
 
-import { createMemo, For, Show, onMount, onCleanup } from "solid-js";
+import { createMemo, createEffect, For, Show, onMount, onCleanup } from "solid-js";
 import { useFeedStore } from "@/stores/feed";
 import { useDownloadStore } from "@/stores/download";
+import { useAppStore } from "@/stores/app";
 import { DownloadStatus } from "@/types/episode";
 import { format } from "date-fns";
 import { useTheme } from "@/context/ThemeContext";
@@ -27,7 +29,6 @@ import {
 	NavMode,
 	DEPTH_CENTER_PANE,
 	type PaneId,
-	type DepthFrame,
 } from "@/context/NavigationContext";
 import { useAudio } from "@/hooks/useAudio";
 import { on, off } from "@/utils/event-bus";
@@ -35,12 +36,12 @@ import type { KeybindActionName } from "@/context/KeybindContext";
 import type { Episode } from "@/types/episode";
 import type { Feed } from "@/types/feed";
 import { LoadingIndicator } from "@/components/LoadingIndicator";
-import { YaziPaneRow } from "@/components/YaziPaneRow";
+import { PaneRow } from "@/components/PaneRow";
 import { TabListPane } from "@/components/TabPanel";
+import { useScrollIntoView } from "@/hooks/useScrollIntoView";
 
 export const FeedPaneCount = 1;
 
-type FeedListItem = { kind: "all" } | { kind: "feed"; feed: Feed };
 type EpItem = { episode: Episode; feed: Feed };
 
 function FeedPage() {
@@ -52,57 +53,57 @@ function FeedPage() {
 	const muted = () => theme.muted || theme.text;
 	const nav = useNavigation();
 
-	const stack = nav.depthStack;
-	const depth = nav.currentDepth;
-	const focus = (d: number = depth()) => nav.depthFocus(d);
+	// ── flat episode list (depth 0 — the only depth Feed has) ────────────────
+	const episodes = createMemo<EpItem[]>(
+		() => feedStore.getAllEpisodesChronological() as EpItem[],
+	);
 
-	// ── feeds list (depth 0) ─────────────────────────────────────────────────
-	const feedList = createMemo<FeedListItem[]>(() => {
-		const all: FeedListItem[] = [{ kind: "all" }];
-		for (const f of feedStore.getFilteredFeeds())
-			all.push({ kind: "feed", feed: f });
-		return all;
-	});
-	const focusedFeedIdx = () =>
-		feedList().length === 0 ? 0 : Math.min(focus(0), feedList().length - 1);
-	const focusedFeedItem = (): FeedListItem | undefined =>
-		feedList()[focusedFeedIdx()];
-
-	// ── episodes list (depth 1) — derived from the depth-1 frame's ctx ───────
-	const drilledFeedId = (): string => stack()[1]?.ctx ?? "all";
-	const episodes = createMemo<EpItem[]>(() => {
-		if (depth() < 1) return [];
-		const id = drilledFeedId();
-		if (id === "all")
-			return feedStore.getAllEpisodesChronological() as EpItem[];
-		const f = feedStore.getFilteredFeeds().find((x) => x.podcast.id === id);
-		if (!f) return [];
-		return [...f.episodes]
-			.sort((a, b) => b.pubDate.getTime() - a.pubDate.getTime())
-			.map((episode) => ({ episode, feed: f }));
-	});
+	// ── Fetch More ───────────────────────────────────────────────────────────
+	// A "[Fetch More]" row at the bottom of the list advances every feed's
+	// loaded window by 50 episodes. manual mode: Enter on the row. auto mode:
+	// reaching the bottom row fetches automatically (see the effect below).
+	const app = useAppStore();
+	const fetchMoreMode = () => app.state().preferences.fetchMoreMode ?? "manual";
+	const showFetchMore = () => feedStore.hasMoreAcrossAll();
+	// Total navigable rows: episodes + the optional Fetch More row.
+	const rowCount = () => episodes().length + (showFetchMore() ? 1 : 0);
+	const focus = () => nav.depthFocus(0);
+	const focusedRow = () =>
+		rowCount() === 0 ? 0 : Math.min(focus(), rowCount() - 1);
+	const focusedOnMore = () =>
+		showFetchMore() && focusedRow() === episodes().length;
+	// -1 while the Fetch More row is focused so no episode row renders the
+	// cursor/highlight (the button is the focused row, not the last episode).
 	const focusedEpIdx = () =>
-		episodes().length === 0 ? 0 : Math.min(focus(1), episodes().length - 1);
-	const focusedItem = (): EpItem | undefined => episodes()[focusedEpIdx()];
-
-	const curLen = () => (depth() === 0 ? feedList().length : episodes().length);
+		focusedOnMore()
+			? -1
+			: Math.min(focusedRow(), Math.max(episodes().length - 1, 0));
+	const focusedItem = (): EpItem | undefined =>
+		focusedOnMore() ? undefined : episodes()[focusedEpIdx()];
+	const curLen = () => rowCount();
+	const moreRef = useScrollIntoView(() => focusedOnMore());
 
 	const ensureFocus = () => {
-		if (depth() === 0 && feedList().length > 0 && focus(0) >= feedList().length)
-			nav.setDepthFocus(feedList().length - 1, 0);
-		if (depth() >= 1 && episodes().length > 0 && focus(1) >= episodes().length)
-			nav.setDepthFocus(episodes().length - 1, 1);
+		if (rowCount() > 0 && focus() >= rowCount())
+			nav.setDepthFocus(rowCount() - 1, 0);
 	};
 	onMount(ensureFocus);
 
+	// Auto mode: reaching the bottom row loads the next batch. Guarded by
+	// isLoadingMore so concurrent loads never stack.
+	createEffect(() => {
+		if (fetchMoreMode() !== "auto") return;
+		if (!showFetchMore()) return;
+		if (feedStore.isLoadingMore()) return;
+		if (focusedRow() < rowCount() - 1) return;
+		feedStore.loadMoreAllFeeds().catch(() => {});
+	});
+
 	onMount(() => {
-		nav.registerResolver(`${nav.activeTab()}:${DEPTH_CENTER_PANE}`, (i) => {
-			if (depth() === 0) {
-				const it = feedList()[i];
-				return it?.kind === "feed" ? it.feed.podcast.id : "all";
-			}
-			return episodes()[i]?.episode.id;
-		});
+		nav.registerResolver(
+			`${nav.activeTab()}:${DEPTH_CENTER_PANE}`,
+			(i) => episodes()[i]?.episode.id,
+		);
 	});
 
 	// ── helpers ────────────────────────────────────────────────────────────────
@@ -146,19 +147,13 @@ function FeedPage() {
 		audioNav.setSource(AudioSource.FEED);
 	};
 
-	// ── drill / open ───────────────────────────────────────────────────────────
+	// ── open ───────────────────────────────────────────────────────────────────
 	function open() {
-		if (depth() === 0) {
-			const item = focusedFeedItem();
-			if (!item) return;
-			const ctx = item.kind === "all" ? "all" : item.feed.podcast.id;
-			nav.pushDepth({ kind: "episodes", ctx, focus: 0 } as DepthFrame);
-			nav.setActivePane(DEPTH_CENTER_PANE);
+		if (focusedOnMore()) {
+			feedStore.loadMoreAllFeeds().catch(() => {});
 			return;
 		}
-		if (depth() >= 1) {
-			playEpisode(focusedItem());
-		}
+		playEpisode(focusedItem());
 	}
 
 	// ── nav.action handler ────────────────────────────────────────────────────
@@ -173,16 +168,11 @@ function FeedPage() {
 		"goto-bottom": () => nav.gotoIndex(curLen() - 1, curLen()),
 		open: () => open(),
 		"toggle-select": () => {
-			if (depth() >= 1) {
-				const item = focusedItem();
-				if (item) nav.toggleSelected(item.episode.id);
-			}
+			const item = focusedItem();
+			if (item) nav.toggleSelected(item.episode.id);
 		},
 		refresh: () => {
-			const item = focusedFeedItem();
-			if (item?.kind === "feed")
-				feedStore.refreshFeed(item.feed.id).catch(() => {});
-			else feedStore.refreshAllFeeds().catch(() => {});
+			feedStore.refreshAllFeeds().catch(() => {});
 		},
 	};
 	function step(delta: number) {
@@ -205,7 +195,7 @@ function FeedPage() {
 
 	// ── render ──────────────────────────────────────────────────────────────────
 	const isActive = () => nav.activePane() === DEPTH_CENTER_PANE;
-	// Row highlight within a list. `active=true` only for the current pane.
+	// Row highlight within the list. `active=true` only for the current pane.
 	const focusBg = (i: number, listFocus: number, active: boolean) =>
 		i === listFocus && active
 			? theme.primary
@@ -213,269 +203,195 @@ function FeedPage() {
 				? theme.border
 				: undefined;
 	const focusFg = (i: number, listFocus: number, active: boolean) =>
-		i === listFocus && active ? theme.surface : theme.text;
+		i === listFocus && active
+			? theme.surface
+			: i === listFocus
+				? theme.selectedListItemText ?? theme.text
+				: theme.text;
 
-	const feedLabel = (item: FeedListItem) =>
-		item.kind === "all"
-			? "All Feeds"
-			: item.feed.customName || item.feed.podcast.title;
-	const feedCount = (item: FeedListItem) =>
-		item.kind === "all"
-			? feedStore.getAllEpisodesChronological().length
-			: item.feed.episodes.length;
+	const currentLabel = () => `Feed · ${episodes().length}`;
 
-	const currentLabel = () =>
-		depth() === 0
-			? `Feeds · ${feedList().length - 1}`
-			: `${(() => {
-					const fi = focusedFeedItem();
-					return fi?.kind === "feed"
-						? fi.feed.customName || fi.feed.podcast.title
-						: "All Episodes";
-				})()} · ${episodes().length}`;
+	// ── parent pane: muted tab list (no parent list — Feed is one depth) ──────
+	const parentContent = () => <TabListPane muted />;
 
-	// ── parent pane: previous-depth list (muted/blank at depth 0) ──────────
-	// Wrap in a stable <Show> (the sibling-Show pattern) so the parent list
-	// mounts/unmounts cleanly on depth change instead of swapping roots.
-	const parentContent = () => (
-		<Show when={depth() >= 1} fallback={<TabListPane muted />}>
-			<For each={feedList()}>
+	// ── current pane: the flat episodes list (the only focusable column) ──────
+	const currentContent = () => (
+		<Show
+			when={episodes().length > 0}
+			fallback={
+				<box padding={1}>
+					<Show
+						when={feedStore.isLoadingFeeds()}
+						fallback={
+							<text fg={muted()}>
+								No feeds. Subscribe from Discover/Search.
+							</text>
+						}
+					>
+						<LoadingIndicator label="Refreshing…" />
+					</Show>
+				</box>
+			}
+		>
+			<For each={episodes()}>
 				{(item, index) => {
-					const lf = nav.depthFocus(0);
+					const fi = () => focusedEpIdx();
+					const ref = useScrollIntoView(() => index() === fi());
 					return (
 						<box
-							flexDirection="row"
-							gap={1}
+							ref={ref}
+							flexDirection="column"
+							gap={0}
 							paddingLeft={1}
 							paddingRight={1}
-							backgroundColor={focusBg(index(), lf, false)}
+							backgroundColor={focusBg(index(), fi(), isActive())}
+							onMouseDown={() => {
+								nav.setActivePane(DEPTH_CENTER_PANE);
+								nav.setDepthFocus(index(), 0);
+							}}
 						>
-							<text fg={focusFg(index(), lf, false)}>
-								{index() === lf ? "❯" : " "}
-							</text>
-							<text fg={focusFg(index(), lf, false)}>{feedLabel(item)}</text>
-							<text fg={muted()}>({feedCount(item)})</text>
+							<box flexDirection="row" gap={1}>
+								<text fg={focusFg(index(), fi(), isActive())}>
+									{index() === fi() ? "❯" : " "}
+								</text>
+								<text fg={focusFg(index(), fi(), isActive())}>
+									{item.episode.episodeNumber
+										? `#${item.episode.episodeNumber} `
+										: ""}
+									{item.episode.title}
+								</text>
+							</box>
+							<box flexDirection="row" gap={2} paddingLeft={2}>
+								<text fg={index() === fi() ? theme.surface : theme.info}>
+									{formatDate(item.episode.pubDate)}
+								</text>
+								<text fg={index() === fi() ? theme.surface : muted()}>
+									{formatDuration(item.episode.duration)}
+								</text>
+								<text fg={index() === fi() ? theme.surface : muted()}>
+									{item.feed.customName || item.feed.podcast.title}
+								</text>
+								<Show when={nav.isSelected(item.episode.id)}>
+									<text fg={theme.warning}>●</text>
+								</Show>
+								<Show when={downloadLabel(item.episode.id)}>
+									<text fg={downloadColor(item.episode.id)}>
+										{downloadLabel(item.episode.id)}
+									</text>
+								</Show>
+							</box>
 						</box>
 					);
 				}}
 			</For>
+			<Show when={showFetchMore()}>
+				<box
+					ref={moreRef}
+					flexDirection="row"
+					gap={1}
+					paddingLeft={1}
+					paddingRight={1}
+					backgroundColor={focusBg(episodes().length, focusedRow(), isActive())}
+					onMouseDown={() => {
+						nav.setActivePane(DEPTH_CENTER_PANE);
+						nav.setDepthFocus(episodes().length, 0);
+					}}
+				>
+					<text fg={focusFg(episodes().length, focusedRow(), isActive())}>
+						{focusedOnMore() ? "❯" : " "}
+					</text>
+					<Show
+						when={!feedStore.isLoadingMore()}
+						fallback={<LoadingIndicator label="Fetching…" />}
+					>
+						<text fg={focusFg(episodes().length, focusedRow(), isActive())}>
+							[Fetch More]
+						</text>
+					</Show>
+				</box>
+			</Show>
+			<Show when={feedStore.isLoadingFeeds()}>
+				<box paddingLeft={2} paddingTop={1}>
+					<LoadingIndicator label="Refreshing…" />
+				</box>
+			</Show>
 		</Show>
 	);
 
-	// ── current pane: the current-depth list (the only focusable column) ──────
-	const currentContent = () => (
+	// ── preview pane: hovered-episode detail (or the Fetch More row) ──────────
+	const previewContent = () => (
 		<>
-			{/* depth 0: feeds — stable sibling <Show> so the swap disposes cleanly */}
-			<Show when={depth() === 0}>
-				<Show
-					when={feedList().length > 1}
-					fallback={
-						<box padding={1}>
-							<text fg={muted()}>
-								No feeds. Subscribe from Discover/Search.
-							</text>
-						</box>
-					}
-				>
-					<For each={feedList()}>
-						{(item, index) => {
-							const fi = focusedFeedIdx();
-							return (
-								<box
-									flexDirection="row"
-									gap={1}
-									paddingLeft={1}
-									paddingRight={1}
-									backgroundColor={focusBg(index(), fi, isActive())}
-									onMouseDown={() => {
-										nav.setActivePane(DEPTH_CENTER_PANE);
-										nav.setDepthFocus(index(), 0);
-									}}
-								>
-									<text fg={focusFg(index(), fi, isActive())}>
-										{index() === fi ? "❯" : " "}
-									</text>
-									<text fg={focusFg(index(), fi, isActive())}>
-										{feedLabel(item)}
-									</text>
-									<text fg={index() === fi ? theme.surface : muted()}>
-										({feedCount(item)})
-									</text>
-								</box>
-							);
-						}}
-					</For>
-				</Show>
+			<Show when={focusedOnMore()}>
+				<box flexDirection="column" gap={1} padding={1}>
+					<text fg={theme.textPrimary ?? theme.text}>
+						<strong>[Fetch More]</strong>
+					</text>
+					<text fg={muted()}>
+						{feedStore.isLoadingMore()
+							? "Loading the next batch of episodes…"
+							: fetchMoreMode() === "auto"
+								? "Auto mode: the next batch loads automatically at the bottom of the list."
+								: "Load the next batch of older episodes across all feeds (Enter)."}
+					</text>
+					<box height={1} />
+					<text fg={muted()}>enter: load more · h back</text>
+				</box>
 			</Show>
-			<Show when={depth() >= 1}>
-				{/* depth ≥1: episodes */}
+			<Show when={!focusedOnMore()}>
 				<Show
-					when={episodes().length > 0}
+					when={focusedItem()}
 					fallback={
 						<box padding={1}>
-							<text fg={muted()}>No episodes. :refresh</text>
+							<text fg={muted()}>No episode focused</text>
 						</box>
 					}
 				>
-					<For each={episodes()}>
-						{(item, index) => {
-							const fi = focusedEpIdx();
-							return (
-								<box
-									flexDirection="column"
-									gap={0}
-									paddingLeft={1}
-									paddingRight={1}
-									backgroundColor={focusBg(index(), fi, isActive())}
-									onMouseDown={() => {
-										nav.setActivePane(DEPTH_CENTER_PANE);
-										nav.setDepthFocus(index(), 1);
-									}}
-								>
-									<box flexDirection="row" gap={1}>
-										<text fg={focusFg(index(), fi, isActive())}>
-											{index() === fi ? "❯" : " "}
-										</text>
-										<text fg={focusFg(index(), fi, isActive())}>
-											{item.episode.episodeNumber
-												? `#${item.episode.episodeNumber} `
-												: ""}
-											{item.episode.title}
-										</text>
-									</box>
-									<box flexDirection="row" gap={2} paddingLeft={2}>
-										<text fg={index() === fi ? theme.surface : theme.info}>
-											{formatDate(item.episode.pubDate)}
-										</text>
-										<text fg={index() === fi ? theme.surface : muted()}>
-											{formatDuration(item.episode.duration)}
-										</text>
-										<text fg={index() === fi ? theme.surface : muted()}>
-											{item.feed.customName || item.feed.podcast.title}
-										</text>
-										<Show when={nav.isSelected(item.episode.id)}>
-											<text fg={theme.warning}>●</text>
-										</Show>
-										<Show when={downloadLabel(item.episode.id)}>
-											<text fg={downloadColor(item.episode.id)}>
-												{downloadLabel(item.episode.id)}
-											</text>
-										</Show>
-									</box>
-								</box>
-							);
-						}}
-					</For>
-					<Show when={feedStore.isLoadingFeeds()}>
-						<box paddingLeft={2} paddingTop={1}>
-							<LoadingIndicator />
+					{(item) => (
+						<box flexDirection="column" gap={1} padding={1}>
+							<text fg={theme.textPrimary ?? theme.text}>
+								<strong>
+									{item().episode.episodeNumber
+										? `#${item().episode.episodeNumber} `
+										: ""}
+									{item().episode.title}
+								</strong>
+							</text>
+							<box flexDirection="row" gap={2}>
+								<text fg={theme.info}>{formatDate(item().episode.pubDate)}</text>
+								<text fg={muted()}>{formatDuration(item().episode.duration)}</text>
+								<Show when={downloadLabel(item().episode.id)}>
+									<text fg={downloadColor(item().episode.id)}>
+										{downloadLabel(item().episode.id)}
+									</text>
+								</Show>
+							</box>
+							<text fg={muted()}>
+								{item().feed.customName || item().feed.podcast.title}
+							</text>
+							<Show when={item().feed.podcast.author}>
+								<text fg={muted()}>by {item().feed.podcast.author}</text>
+							</Show>
+							<box height={1} />
+							<text fg={theme.textSecondary}>
+								{item().episode.description?.slice(0, 400) ??
+									"No description available."}
+								{(item().episode.description?.length ?? 0) > 400 ? "…" : ""}
+							</text>
+							<box height={1} />
+							<text fg={muted()}>enter: play · space: select · h back</text>
 						</box>
-					</Show>
+					)}
 				</Show>
 			</Show>
 		</>
 	);
 
-	// ── preview pane: hovered-item detail ──────────────────────────────────────
-	const previewContent = () =>
-		depth() === 0 ? (
-			// depth 0 preview: hovered feed
-			<Show
-				when={focusedFeedItem()}
-				fallback={
-					<box padding={1}>
-						<text fg={muted()}>No feed focused</text>
-					</box>
-				}
-			>
-				{(item) => {
-					const it = item();
-					return (
-						<box flexDirection="column" gap={1} padding={1}>
-							<text fg={theme.textPrimary ?? theme.text}>
-								<strong>{feedLabel(it)}</strong>
-							</text>
-							<text fg={muted()}>
-								{it.kind === "feed"
-									? `by ${it.feed.podcast.author ?? "unknown"}`
-									: ""}
-							</text>
-							<text fg={theme.textSecondary}>
-								{it.kind === "all"
-									? `${feedCount(it)} episodes across all feeds`
-									: `${feedCount(it)} episodes`}
-							</text>
-							<text fg={muted()}>
-								{it.kind === "feed"
-									? (it.feed.podcast.description?.slice(0, 400) ??
-										"No description.")
-									: "Drill in to see episodes across every feed."}
-							</text>
-							<box height={1} />
-							<text fg={muted()}>enter/l: open · h: back</text>
-						</box>
-					);
-				}}
-			</Show>
-		) : (
-			// depth ≥1 preview: hovered episode
-			<Show
-				when={focusedItem()}
-				fallback={
-					<box padding={1}>
-						<text fg={muted()}>No episode focused</text>
-					</box>
-				}
-			>
-				{(item) => {
-					const it = item();
-					return (
-						<box flexDirection="column" gap={1} padding={1}>
-							<text fg={theme.textPrimary ?? theme.text}>
-								<strong>
-									{it.episode.episodeNumber
-										? `#${it.episode.episodeNumber} `
-										: ""}
-									{it.episode.title}
-								</strong>
-							</text>
-							<box flexDirection="row" gap={2}>
-								<text fg={theme.info}>{formatDate(it.episode.pubDate)}</text>
-								<text fg={muted()}>{formatDuration(it.episode.duration)}</text>
-								<Show when={downloadLabel(it.episode.id)}>
-									<text fg={downloadColor(it.episode.id)}>
-										{downloadLabel(it.episode.id)}
-									</text>
-								</Show>
-							</box>
-							<text fg={muted()}>
-								{it.feed.customName || it.feed.podcast.title}
-							</text>
-							<Show when={it.feed.podcast.author}>
-								<text fg={muted()}>by {it.feed.podcast.author}</text>
-							</Show>
-							<box height={1} />
-							<text fg={theme.textSecondary}>
-								{it.episode.description?.slice(0, 400) ??
-									"No description available."}
-								{(it.episode.description?.length ?? 0) > 400 ? "…" : ""}
-							</text>
-							<box height={1} />
-							<text fg={muted()}>enter: play · space: select · h: back</text>
-						</box>
-					);
-				}}
-			</Show>
-		);
-
 	return (
-		<YaziPaneRow
+		<PaneRow
 			parent={parentContent}
 			current={currentContent}
 			preview={previewContent}
-			parentLabel={() => (depth() >= 1 ? "Feeds" : "Up")}
 			currentLabel={currentLabel}
-			previewLabel="Detail"
 			focused={isActive}
 		/>
 	);

src/pages/MyShows/MyShowsPage.tsx

@@ -2,11 +2,11 @@
  * MyShowsPage — yazi depth-stack view of subscribed shows.
  *
  *   depth 0 (current) — subscribed shows. Parent pane shows the muted
- *                       placeholder (1/7 slot kept).
+ *                       placeholder (1/5 slot kept).
  *   depth 1 (current) — episodes of the drilled show. Parent pane = shows.
  *   preview            — detail of the hovered item in the current column.
  *
- * Renders entirely through `<YaziPaneRow>`; no bespoke 3-column flexbox JSX
+ * Renders entirely through `<PaneRow>`; no bespoke 3-column flexbox JSX
  * remains. `l`/Enter drills in (show → episodes); `h` pops a depth (noop at
  * 0). j/k move only within the current column.
  */
@@ -31,8 +31,9 @@ import type { KeybindActionName } from "@/context/KeybindContext";
 import type { Episode } from "@/types/episode";
 import type { Feed } from "@/types/feed";
 import { LoadingIndicator } from "@/components/LoadingIndicator";
-import { YaziPaneRow } from "@/components/YaziPaneRow";
+import { PaneRow } from "@/components/PaneRow";
 import { TabListPane } from "@/components/TabPanel";
+import { useScrollIntoView } from "@/hooks/useScrollIntoView";
 
 export const MyShowsPaneCount = 1;
 
@@ -164,6 +165,16 @@ export function MyShowsPage() {
 			const show = selectedShow();
 			if (show) feedStore.refreshFeed(show.id).catch(() => {});
 		},
+		unsubscribe: () => {
+			if (depth() !== 0) return;
+			const show = selectedShow();
+			if (show) {
+				// unsubscribe = remove feed + purge its downloaded files
+				feedStore.removeFeed(show.id);
+				downloadStore.removeDownloadsForFeed(show.id).catch(() => {});
+				ensureFocus();
+			}
+		},
 	};
 	function step(delta: number) {
 		nav.move(delta, curLen());
@@ -188,7 +199,11 @@ export function MyShowsPage() {
 	const focusBg = (i: number, lf: number, active: boolean) =>
 		i === lf && active ? theme.primary : i === lf ? theme.border : undefined;
 	const focusFg = (i: number, lf: number, active: boolean) =>
-		i === lf && active ? theme.surface : theme.text;
+		i === lf && active
+			? theme.surface
+			: i === lf
+				? theme.selectedListItemText ?? theme.text
+				: theme.text;
 	const showTitle = (f: Feed) => f.customName || f.podcast.title;
 
 	const currentLabel = () =>
@@ -197,26 +212,27 @@ export function MyShowsPage() {
 			: `${selectedShow() ? showTitle(selectedShow()!) : "Episodes"} · ${episodes().length}`;
 
 	// ── parent pane: previous-depth list (muted/blank at depth 0) ─────────────
-	// ── parent pane: previous-depth list (muted/blank at depth 0) ──────────
 	// Stable <Show> gate (not a ternary root swap) so the parent list
 	// mounts/unmounts cleanly on depth change.
 	const parentContent = () => (
 		<Show when={depth() >= 1} fallback={<TabListPane muted />}>
 			<For each={shows()}>
 				{(feed, index) => {
-					const lf = nav.depthFocus(0);
+					const lf = () => nav.depthFocus(0);
+					const ref = useScrollIntoView(() => index() === lf());
 					return (
 						<box
+							ref={ref}
 							flexDirection="row"
 							gap={1}
 							paddingLeft={1}
 							paddingRight={1}
-							backgroundColor={focusBg(index(), lf, false)}
+							backgroundColor={focusBg(index(), lf(), false)}
 						>
-							<text fg={focusFg(index(), lf, false)}>
-								{index() === lf ? "❯" : " "}
+							<text fg={focusFg(index(), lf(), false)}>
+								{index() === lf() ? "❯" : " "}
 							</text>
-							<text fg={focusFg(index(), lf, false)}>{showTitle(feed)}</text>
+							<text fg={focusFg(index(), lf(), false)}>{showTitle(feed)}</text>
 							<text fg={muted()}>({feed.episodes.length})</text>
 						</box>
 					);
@@ -242,26 +258,28 @@ export function MyShowsPage() {
 				>
 					<For each={shows()}>
 						{(feed, index) => {
-							const lf = focusedShowIdx();
+							const lf = () => focusedShowIdx();
+							const ref = useScrollIntoView(() => index() === lf());
 							return (
 								<box
+									ref={ref}
 									flexDirection="row"
 									gap={1}
 									paddingLeft={1}
 									paddingRight={1}
-									backgroundColor={focusBg(index(), lf, isActive())}
+									backgroundColor={focusBg(index(), lf(), isActive())}
 									onMouseDown={() => {
 										nav.setActivePane(DEPTH_CENTER_PANE);
 										nav.setDepthFocus(index(), 0);
 									}}
 								>
-									<text fg={focusFg(index(), lf, isActive())}>
-										{index() === lf ? "❯" : " "}
+									<text fg={focusFg(index(), lf(), isActive())}>
+										{index() === lf() ? "❯" : " "}
 									</text>
-									<text fg={focusFg(index(), lf, isActive())}>
+									<text fg={focusFg(index(), lf(), isActive())}>
 										{showTitle(feed)}
 									</text>
-									<text fg={index() === lf ? theme.surface : muted()}>
+									<text fg={index() === lf() ? theme.surface : muted()}>
 										({feed.episodes.length})
 									</text>
 								</box>
@@ -282,33 +300,35 @@ export function MyShowsPage() {
 				>
 					<For each={episodes()}>
 						{(ep, index) => {
-							const lf = focusedEpIdx();
+							const lf = () => focusedEpIdx();
+							const ref = useScrollIntoView(() => index() === lf());
 							return (
 								<box
+									ref={ref}
 									flexDirection="column"
 									gap={0}
 									paddingLeft={1}
 									paddingRight={1}
-									backgroundColor={focusBg(index(), lf, isActive())}
+									backgroundColor={focusBg(index(), lf(), isActive())}
 									onMouseDown={() => {
 										nav.setActivePane(DEPTH_CENTER_PANE);
 										nav.setDepthFocus(index(), 1);
 									}}
 								>
 									<box flexDirection="row" gap={1}>
-										<text fg={focusFg(index(), lf, isActive())}>
-											{index() === lf ? "❯" : " "}
+										<text fg={focusFg(index(), lf(), isActive())}>
+											{index() === lf() ? "❯" : " "}
 										</text>
-										<text fg={focusFg(index(), lf, isActive())}>
+										<text fg={focusFg(index(), lf(), isActive())}>
 											{ep.episodeNumber ? `#${ep.episodeNumber} ` : ""}
 											{ep.title}
 										</text>
 									</box>
 									<box flexDirection="row" gap={2} paddingLeft={2}>
-										<text fg={index() === lf ? theme.surface : theme.info}>
+										<text fg={index() === lf() ? theme.surface : theme.info}>
 											{formatDate(ep.pubDate)}
 										</text>
-										<text fg={index() === lf ? theme.surface : muted()}>
+										<text fg={index() === lf() ? theme.surface : muted()}>
 											{formatDuration(ep.duration)}
 										</text>
 										<Show when={nav.isSelected(ep.id)}>
@@ -326,7 +346,7 @@ export function MyShowsPage() {
 					</For>
 					<Show when={feedStore.isLoadingMore()}>
 						<box paddingLeft={2} paddingTop={1}>
-							<LoadingIndicator />
+							<LoadingIndicator label="Loading more…" />
 						</box>
 					</Show>
 				</Show>
@@ -361,7 +381,7 @@ export function MyShowsPage() {
 							{show().podcast.description?.slice(0, 400) ?? "No description."}
 						</text>
 						<box height={1} />
-						<text fg={muted()}>enter/l: open · h: back</text>
+						<text fg={muted()}>enter/l: open · h: back · x: unsubscribe</text>
 					</box>
 				)}
 			</Show>
@@ -408,13 +428,11 @@ export function MyShowsPage() {
 		);
 
 	return (
-		<YaziPaneRow
+		<PaneRow
 			parent={parentContent}
 			current={currentContent}
 			preview={previewContent}
-			parentLabel={() => (depth() >= 1 ? "Shows" : "Up")}
 			currentLabel={currentLabel}
-			previewLabel="Detail"
 			focused={isActive}
 		/>
 	);

src/pages/Player/PlaybackControls.tsx

@@ -1,64 +1,85 @@
-import type { BackendName } from "../utils/audio-player"
-import { useTheme } from "@/context/ThemeContext"
+import type { BackendName } from "@/utils/audio-player";
+import { useTheme } from "@/context/ThemeContext";
 
 type PlaybackControlsProps = {
-  isPlaying: boolean
-  volume: number
-  speed: number
-  backendName?: BackendName
-  hasAudioUrl?: boolean
-  onToggle: () => void
-  onPrev: () => void
-  onNext: () => void
-  onVolumeChange: (value: number) => void
-  onSpeedChange: (value: number) => void
-}
+	isPlaying: boolean;
+	volume: number;
+	speed: number;
+	backendName?: BackendName;
+	hasAudioUrl?: boolean;
+	onToggle: () => void;
+	onPrev: () => void;
+	onNext: () => void;
+	onVolumeChange: (value: number) => void;
+	onSpeedChange: (value: number) => void;
+};
 
 const BACKEND_LABELS: Record<BackendName, string> = {
-  mpv: "mpv",
-  ffplay: "ffplay",
-  afplay: "afplay",
-  system: "system",
-  none: "none",
-}
+	mpv: "mpv",
+	none: "none",
+};
 
 export function PlaybackControls(props: PlaybackControlsProps) {
-  const { theme } = useTheme();
-  return (
-    <box flexDirection="row" gap={1} alignItems="center" border padding={1} borderColor={theme.border}>
-      <box border padding={0} onMouseDown={props.onPrev} borderColor={theme.border}>
-        <text fg={theme.primary}>[Prev]</text>
-      </box>
-      <box border padding={0} onMouseDown={props.onToggle} borderColor={theme.border}>
-        <text fg={theme.primary}>{props.isPlaying ? "[Pause]" : "[Play]"}</text>
-      </box>
-      <box border padding={0} onMouseDown={props.onNext} borderColor={theme.border}>
-        <text fg={theme.primary}>[Next]</text>
-      </box>
-      <box flexDirection="row" gap={1} marginLeft={2}>
-        <text fg={theme.textMuted}>Vol</text>
-        <text fg={theme.text}>{Math.round(props.volume * 100)}%</text>
-      </box>
-      <box flexDirection="row" gap={1} marginLeft={2}>
-        <text fg={theme.textMuted}>Speed</text>
-        <text fg={theme.text}>{props.speed}x</text>
-      </box>
-      {props.backendName && props.backendName !== "none" && (
-        <box flexDirection="row" gap={1} marginLeft={2}>
-          <text fg={theme.textMuted}>via</text>
-          <text fg={theme.primary}>{BACKEND_LABELS[props.backendName]}</text>
-        </box>
-      )}
-      {props.backendName === "none" && (
-        <box marginLeft={2}>
-          <text fg={theme.warning}>No audio player found</text>
-        </box>
-      )}
-      {props.hasAudioUrl === false && (
-        <box marginLeft={2}>
-          <text fg={theme.warning}>No audio URL</text>
-        </box>
-      )}
-    </box>
-  )
+	const { theme } = useTheme();
+	return (
+		<box
+			flexDirection="row"
+			gap={1}
+			alignItems="center"
+			border
+			padding={1}
+			borderColor={theme.border}
+		>
+			<box
+				border
+				padding={0}
+				onMouseDown={props.onPrev}
+				borderColor={theme.border}
+			>
+				<text fg={theme.primary}>[Prev]</text>
+			</box>
+			<box
+				border
+				padding={0}
+				onMouseDown={props.onToggle}
+				borderColor={theme.border}
+			>
+				<text fg={theme.primary}>{props.isPlaying ? "[Pause]" : "[Play]"}</text>
+			</box>
+			<box
+				border
+				padding={0}
+				onMouseDown={props.onNext}
+				borderColor={theme.border}
+			>
+				<text fg={theme.primary}>[Next]</text>
+			</box>
+			<box flexDirection="row" gap={1} marginLeft={2}>
+				<text fg={theme.textMuted}>Vol</text>
+				<text fg={theme.text}>{Math.round(props.volume * 100)}%</text>
+				<text fg={theme.textMuted}>↑↓</text>
+			</box>
+			<box flexDirection="row" gap={1} marginLeft={2}>
+				<text fg={theme.textMuted}>Speed</text>
+				<text fg={theme.text}>{props.speed}x</text>
+				<text fg={theme.textMuted}>s</text>
+			</box>
+			{props.backendName && props.backendName !== "none" && (
+				<box flexDirection="row" gap={1} marginLeft={2}>
+					<text fg={theme.textMuted}>via</text>
+					<text fg={theme.primary}>{BACKEND_LABELS[props.backendName]}</text>
+				</box>
+			)}
+			{props.backendName === "none" && (
+				<box marginLeft={2}>
+					<text fg={theme.warning}>No audio player found</text>
+				</box>
+			)}
+			{props.hasAudioUrl === false && (
+				<box marginLeft={2}>
+					<text fg={theme.warning}>No audio URL</text>
+				</box>
+			)}
+		</box>
+	);
 }

src/pages/Player/PlayerPage.tsx

@@ -1,10 +1,13 @@
 /**
- * PlayerPage — single-pane audio now-playing view.
+ * PlayerPage — 2-pane yazi depth view of the now-playing episode.
  *
- * Audio transport (play/pause, next/prev, seek) is handled globally by the
- * Shell router (P/N/B/</>). This page renders a single rich pane showing the
- * current episode, waveform, and playback controls. Panes/swipe do nothing
- * (PaneCount=1).
+ *   depth 0 (parent)  — tab list (muted, read-only).
+ *   depth 0 (current) — the single now-playing pane (rich view + controls).
+ *
+ * No preview pane (PaneRow `panes={2}`). Audio transport (play/pause,
+ * next/prev, seek) is handled globally by the Shell router (P/N/B/</>); this
+ * page only renders the now-playing surface. `h` at depth 0 returns to the
+ * tab root.
  */
 
 import { Show } from "solid-js";
@@ -13,7 +16,9 @@ import { RealtimeWaveform } from "./RealtimeWaveform";
 import { useAudio } from "@/hooks/useAudio";
 import { useAppStore } from "@/stores/app";
 import { useTheme } from "@/context/ThemeContext";
-import { useNavigation } from "@/context/NavigationContext";
+import { useNavigation, DEPTH_CENTER_PANE } from "@/context/NavigationContext";
+import { PaneRow } from "@/components/PaneRow";
+import { TabListPane } from "@/components/TabPanel";
 
 export const PlayerPaneCount = 1;
 
@@ -23,9 +28,7 @@ export function PlayerPage() {
 	const nav = useNavigation();
 	const muted = () => theme.muted || theme.text;
 
-	// Single pane — always active.
-	const isActive = () => true;
-	const border = () => theme.accent;
+	const isActive = () => nav.activePane() === DEPTH_CENTER_PANE;
 
 	const progressPercent = () => {
 		const d = audio.duration();
@@ -39,84 +42,86 @@ export function PlayerPage() {
 		return `${m}:${String(s).padStart(2, "0")}`;
 	};
 
-	return (
-		<box flexDirection="column" width="100%" height="100%">
-			{/* ── pane 0: now playing ─────────────────────────────────────────── */}
-			<box height={1} paddingLeft={1} backgroundColor={theme.background}>
-				<text fg={theme.textSecondary}>Player</text>
+	// ── parent pane: the tab list (muted) ──────────────────────────────────────
+	const parentContent = () => <TabListPane muted />;
+
+	// ── current pane: now playing ───────────────────────────────────────────────
+	const currentContent = () => (
+		<box flexDirection="column" gap={1} padding={1}>
+			<box flexDirection="row" justifyContent="space-between">
+				<text fg={theme.text}>
+					<strong>Now Playing</strong>
+				</text>
+				<text fg={muted()}>
+					{formatTime(audio.position())} / {formatTime(audio.duration())} (
+					{progressPercent()}%)
+				</text>
 			</box>
-			<scrollbox
-				height="100%"
-				focused={isActive()}
-				border
-				borderColor={border()}
-				backgroundColor={theme.background}
+
+			<Show when={audio.error()}>
+				{(err) => <text fg={theme.error}>{err()}</text>}
+			</Show>
+
+			<Show
+				when={audio.currentEpisode()}
+				fallback={
+					<box padding={1}>
+						<text fg={muted()}>No episode loaded.</text>
+					</box>
+				}
 			>
-				<box flexDirection="column" gap={1} padding={1}>
-					<box flexDirection="row" justifyContent="space-between">
+				{(ep) => (
+					<box flexDirection="column" gap={1}>
 						<text fg={theme.text}>
-							<strong>Now Playing</strong>
+							<strong>{ep().title}</strong>
 						</text>
 						<text fg={muted()}>
-							{formatTime(audio.position())} / {formatTime(audio.duration())} (
-							{progressPercent()}%)
+							{ep().description?.slice(0, 500) ?? "No description available."}
 						</text>
+
+						<RealtimeWaveform
+							visualizerConfig={(() => {
+								const viz = useAppStore().state().settings.visualizer;
+								// bars is width-derived in RealtimeWaveform; pass only the
+								// audio-processing params here.
+								return {
+									noiseReduction: viz.noiseReduction,
+									lowCutOff: viz.lowCutOff,
+									highCutOff: viz.highCutOff,
+								};
+							})()}
+						/>
 					</box>
+				)}
+			</Show>
 
-					<Show when={audio.error()}>
-						{(err) => <text fg={theme.error}>{err()}</text>}
-					</Show>
+			<PlaybackControls
+				isPlaying={audio.isPlaying()}
+				volume={audio.volume()}
+				speed={audio.speed()}
+				backendName={audio.backendName()}
+				hasAudioUrl={!!audio.currentEpisode()?.audioUrl}
+				onToggle={audio.togglePlayback}
+				onPrev={() => audio.seek(0)}
+				onNext={() => audio.seek(audio.currentEpisode()?.duration ?? 0)}
+				onSpeedChange={(s: number) => audio.setSpeed(s)}
+				onVolumeChange={(v: number) => audio.setVolume(v)}
+			/>
 
-					<Show
-						when={audio.currentEpisode()}
-						fallback={
-							<box padding={1}>
-								<text fg={muted()}>No episode loaded.</text>
-							</box>
-						}
-					>
-						{(ep) => (
-							<box flexDirection="column" gap={1}>
-								<text fg={theme.text}>
-									<strong>{ep().title}</strong>
-								</text>
-								<text fg={muted()}>
-									{ep().description?.slice(0, 500) ??
-										"No description available."}
-								</text>
-
-								<RealtimeWaveform
-									visualizerConfig={(() => {
-										const viz = useAppStore().state().settings.visualizer;
-										return {
-											bars: viz.bars,
-											noiseReduction: viz.noiseReduction,
-											lowCutOff: viz.lowCutOff,
-											highCutOff: viz.highCutOff,
-										};
-									})()}
-								/>
-							</box>
-						)}
-					</Show>
-
-					<PlaybackControls
-						isPlaying={audio.isPlaying()}
-						volume={audio.volume()}
-						speed={audio.speed()}
-						backendName={audio.backendName()}
-						hasAudioUrl={!!audio.currentEpisode()?.audioUrl}
-						onToggle={audio.togglePlayback}
-						onPrev={() => audio.seek(0)}
-						onNext={() => audio.seek(audio.currentEpisode()?.duration ?? 0)}
-						onSpeedChange={(s: number) => audio.setSpeed(s)}
-						onVolumeChange={(v: number) => audio.setVolume(v)}
-					/>
-
-					<box height={1} />
-					<text fg={muted()}>{"P play/pause  N next  B prev  </ seek"}</text>
-				</box>
-			</scrollbox>
+			<box height={1} />
+			<text fg={muted()}>
+				{"P play/pause  N next  B prev  ◀▶ seek  h back"}
+			</text>
 		</box>
 	);
+
+	return (
+		<PaneRow
+			parent={parentContent}
+			current={currentContent}
+			currentLabel="Player"
+			panes={2}
+			focused={isActive}
+		/>
+	);
 }

src/pages/Player/RealtimeWaveform.tsx

@@ -8,32 +8,34 @@
  */
 
 import { createSignal, createEffect, onCleanup, on, untrack } from "solid-js";
+import { useTerminalDimensions } from "@opentui/solid";
 import {
-  loadCavaCore,
-  type CavaCore,
-  type CavaCoreConfig,
+	loadCavaCore,
+	type CavaCore,
+	type CavaCoreConfig,
 } from "@/utils/cavacore";
 import { AudioStreamReader } from "@/utils/audio-stream-reader";
 import { useAudio } from "@/hooks/useAudio";
 import { useTheme } from "@/context/ThemeContext";
+import { PANE_RATIO } from "@/utils/navigation";
 
 // ── Types ────────────────────────────────────────────────────────────
 
 export type RealtimeWaveformProps = {
-  visualizerConfig?: Partial<CavaCoreConfig>;
+	visualizerConfig?: Partial<CavaCoreConfig>;
 };
 
 /** Unicode lower block elements: space (silence) through full block (max) */
 const BARS = [
-  " ",
-  "\u2581",
-  "\u2582",
-  "\u2583",
-  "\u2584",
-  "\u2585",
-  "\u2586",
-  "\u2587",
-  "\u2588",
+	" ",
+	"\u2581",
+	"\u2582",
+	"\u2583",
+	"\u2584",
+	"\u2585",
+	"\u2586",
+	"\u2587",
+	"\u2588",
 ];
 
 /** Target frame interval in ms (~30 fps) */
@@ -45,212 +47,226 @@ const SAMPLES_PER_FRAME = 512;
 // ── Component ────────────────────────────────────────────────────────
 
 export function RealtimeWaveform(props: RealtimeWaveformProps) {
-  const { theme } = useTheme();
-  const audio = useAudio();
+	const { theme } = useTheme();
+	const audio = useAudio();
 
-  // Frequency bar values (0.0–1.0 per bar)
-  const [barData, setBarData] = createSignal<number[]>([]);
+	// Frequency bar values (0.0–1.0 per bar)
+	const [barData, setBarData] = createSignal<number[]>([]);
 
-  // Track whether cavacore is available
-  const [available, setAvailable] = createSignal(false);
+	let cava: CavaCore | null = null;
+	let reader: AudioStreamReader | null = null;
+	let frameTimer: ReturnType<typeof setInterval> | null = null;
+	let sampleBuffer: Float64Array | null = null;
 
-  let cava: CavaCore | null = null;
-  let reader: AudioStreamReader | null = null;
-  let frameTimer: ReturnType<typeof setInterval> | null = null;
-  let sampleBuffer: Float64Array | null = null;
+	// Bar count scales with terminal width so the waveform fills its pane.
+	// The player is a 2-pane row: current column = (current+preview) of
+	// (parent+current+preview) of the terminal width. Subtract ~8 chars of
+	// chrome (scrollbox border + box padding + waveform border + padding).
+	// Falls back to 64 before the renderer reports a real size.
+	const dimensions = useTerminalDimensions();
+	const numBars = () => {
+		const total = PANE_RATIO.parent + PANE_RATIO.current + PANE_RATIO.preview;
+		const current = PANE_RATIO.current + PANE_RATIO.preview; // 2-pane grows current
+		const width = dimensions().width;
+		if (!width) return 64;
+		return Math.max(
+			8,
+			Math.min(256, Math.floor((width * current) / total) - 8),
+		);
+	};
 
-  // ── Lifecycle: init cavacore once ──────────────────────────────────
+	// ── Lifecycle: init cavacore once ──────────────────────────────────
 
-  const initCava = () => {
-    if (cava) return true;
+	const initCava = () => {
+		if (cava) return true;
 
-    cava = loadCavaCore();
-    if (!cava) {
-      setAvailable(false);
-      return false;
-    }
+		cava = loadCavaCore();
+		if (!cava) {
+			return false;
+		}
 
-    setAvailable(true);
-    return true;
-  };
+		return true;
+	};
 
-  // ── Start/stop the visualization pipeline ──────────────────────────
+	// ── Start/stop the visualization pipeline ──────────────────────────
 
-  const startVisualization = (url: string, position: number, speed: number) => {
-    stopVisualization();
+	const startVisualization = (url: string, position: number, speed: number) => {
+		stopVisualization();
 
-    if (!url || !initCava() || !cava) return;
+		if (!url || !initCava() || !cava) return;
 
-    // Initialize cavacore with current resolution + any overrides
-    const config: CavaCoreConfig = {
-      bars: 32,
-      sampleRate: 44100,
-      channels: 1,
-      ...props.visualizerConfig,
-    };
-    cava.init(config);
+		// Initialize cavacore with current resolution + any overrides.
+		// bars is width-derived (see numBars); visualizerConfig supplies the
+		// audio-processing params (noise reduction, cutoffs, etc.).
+		const config: CavaCoreConfig = {
+			bars: numBars(),
+			sampleRate: 44100,
+			channels: 1,
+			...props.visualizerConfig,
+		};
+		cava.init(config);
 
-    // Pre-allocate sample read buffer
-    sampleBuffer = new Float64Array(SAMPLES_PER_FRAME);
+		// Pre-allocate sample read buffer
+		sampleBuffer = new Float64Array(SAMPLES_PER_FRAME);
 
-    // Start ffmpeg decode stream (reuse reader if same URL, else create new)
-    if (!reader || reader.url !== url) {
-      if (reader) reader.stop();
-      reader = new AudioStreamReader({ url });
-    }
-    reader.start(position, speed);
+		// Start ffmpeg decode stream (reuse reader if same URL, else create new)
+		if (!reader || reader.url !== url) {
+			if (reader) reader.stop();
+			reader = new AudioStreamReader({ url });
+		}
+		reader.start(position, speed);
 
-    // Start render loop
-    frameTimer = setInterval(renderFrame, FRAME_INTERVAL);
-  };
+		frameTimer = setInterval(renderFrame, FRAME_INTERVAL);
+	};
 
-  const stopVisualization = () => {
-    if (frameTimer) {
-      clearInterval(frameTimer);
-      frameTimer = null;
-    }
-    if (reader) {
-      reader.stop();
-      // Don't null reader — we reuse it across start/stop cycles
-    }
-    if (cava?.isReady) {
-      cava.destroy();
-    }
-    sampleBuffer = null;
-  };
+	const stopVisualization = () => {
+		if (frameTimer) {
+			clearInterval(frameTimer);
+			frameTimer = null;
+		}
+		if (reader) {
+			reader.stop();
+			// Don't null reader — we reuse it across start/stop cycles
+		}
+		if (cava?.isReady) {
+			cava.destroy();
+		}
+		sampleBuffer = null;
+	};
 
-  // ── Render loop (called at ~30fps) ─────────────────────────────────
+	// ── Render loop (called at ~30fps) ─────────────────────────────────
 
-  const renderFrame = () => {
-    if (!cava?.isReady || !reader?.running || !sampleBuffer) return;
+	const renderFrame = () => {
+		if (!cava?.isReady || !reader?.running || !sampleBuffer) return;
 
-    // Read available PCM samples from the stream
-    const count = reader.read(sampleBuffer);
-    if (count === 0) return;
+		const count = reader.read(sampleBuffer);
+		if (count === 0) return;
 
-    // Feed samples to cavacore → get frequency bars
-    const input =
-      count < sampleBuffer.length
-        ? sampleBuffer.subarray(0, count)
-        : sampleBuffer;
-    const output = cava.execute(input);
+		const input =
+			count < sampleBuffer.length
+				? sampleBuffer.subarray(0, count)
+				: sampleBuffer;
+		const output = cava.execute(input);
 
-    // Copy bar values to a new array for the signal
-    setBarData(Array.from(output));
-  };
+		// Copy bar values to a new array for the signal
+		setBarData(Array.from(output as Float64Array));
+	};
 
-  createEffect(
-    on(
-      [
-        audio.isPlaying,
-        () => audio.currentEpisode()?.audioUrl ?? "", // may need to fire an error here
-        audio.speed,
-        () => 32,
-      ],
-      ([playing, url, speed]) => {
-        if (playing && url) {
-          const pos = untrack(audio.position);
-          startVisualization(url, pos, speed);
-        } else {
-          stopVisualization();
-        }
-      },
-    ),
-  );
+	createEffect(
+		on(
+			[
+				audio.isPlaying,
+				() => audio.currentEpisode()?.audioUrl ?? "",
+				audio.speed,
+				numBars,
+			],
+			([playing, url, speed]) => {
+				if (playing && url) {
+					const pos = untrack(audio.position);
+					startVisualization(url, pos, speed);
+				} else {
+					stopVisualization();
+				}
+			},
+		),
+	);
 
-  // ── Seek detection: lightweight effect for position jumps ──────────
-  //
-  // Watches position and restarts the reader (not the whole pipeline)
-  // only on significant jumps (>2s), which indicate a user seek.
-  // This is intentionally a separate effect — it should NOT trigger a
-  // full pipeline restart, just restart the ffmpeg stream at the new pos.
+	// ── Seek detection: lightweight effect for position jumps ──────────
+	//
+	// Watches position and restarts the reader (not the whole pipeline)
+	// only on significant jumps (>2s), which indicate a user seek.
+	// This is intentionally a separate effect — it should NOT trigger a
+	// full pipeline restart, just restart the ffmpeg stream at the new pos.
 
-  let lastSyncPosition = 0;
-  createEffect(
-    on(audio.position, (pos) => {
-      if (!audio.isPlaying || !reader?.running) {
-        lastSyncPosition = pos;
-        return;
-      }
+	let lastSyncPosition = 0;
+	createEffect(
+		on(audio.position, (pos) => {
+			if (!audio.isPlaying || !reader?.running) {
+				lastSyncPosition = pos;
+				return;
+			}
 
-      const delta = Math.abs(pos - lastSyncPosition);
-      lastSyncPosition = pos;
+			const delta = Math.abs(pos - lastSyncPosition);
+			lastSyncPosition = pos;
 
-      if (delta > 2) {
-        reader.restart(pos, audio.speed() ?? 1);
-      }
-    }),
-  );
+			if (delta > 2) {
+				reader.restart(pos, audio.speed() ?? 1);
+			}
+		}),
+	);
 
-  // Cleanup on unmount
-  onCleanup(() => {
-    stopVisualization();
-    if (reader) {
-      reader.stop();
-      reader = null;
-    }
-    // Don't null cava itself — it can be reused. But do destroy its plan.
-    if (cava?.isReady) {
-      cava.destroy();
-    }
-  });
+	onCleanup(() => {
+		stopVisualization();
+		if (reader) {
+			reader.stop();
+			reader = null;
+		}
+		// Don't null cava itself — it can be reused. But do destroy its plan.
+		if (cava?.isReady) {
+			cava.destroy();
+		}
+	});
 
-  // ── Rendering ──────────────────────────────────────────────────────
+	// ── Rendering ──────────────────────────────────────────────────────
 
-  const playedRatio = () =>
-    audio.duration() <= 0
-      ? 0
-      : Math.min(1, audio.position() / audio.duration());
+	const playedRatio = () =>
+		audio.duration() <= 0
+			? 0
+			: Math.min(1, audio.position() / audio.duration());
 
-  const renderLine = () => {
-    const bars = barData();
-    const numBars = 32;
+	const renderLine = () => {
+		const bars = barData();
+		const count = numBars();
 
-    // If no data yet, show empty placeholder
-    if (bars.length === 0) {
-      const placeholder = ".".repeat(numBars);
-      return (
-        <box flexDirection="row" gap={0}>
-          <text fg="#3b4252">{placeholder}</text>
-        </box>
-      );
-    }
+		if (bars.length === 0) {
+			const placeholder = ".".repeat(count);
+			return (
+				<box flexDirection="row" gap={0}>
+					<text fg="#3b4252">{placeholder}</text>
+				</box>
+			);
+		}
 
-    const played = Math.floor(numBars * playedRatio());
-    const playedColor = audio.isPlaying() ? "#6fa8ff" : "#7d8590";
-    const futureColor = "#3b4252";
+		const played = Math.floor(count * playedRatio());
+		const playedColor = audio.isPlaying() ? "#6fa8ff" : "#7d8590";
+		const futureColor = "#3b4252";
 
-    const playedChars = bars
-      .slice(0, played)
-      .map((v) => BARS[Math.min(BARS.length - 1, Math.floor(v * BARS.length))])
-      .join("");
+		const playedChars = bars
+			.slice(0, played)
+			.map((v) => BARS[Math.min(BARS.length - 1, Math.floor(v * BARS.length))])
+			.join("");
 
-    const futureChars = bars
-      .slice(played)
-      .map((v) => BARS[Math.min(BARS.length - 1, Math.floor(v * BARS.length))])
-      .join("");
+		const futureChars = bars
+			.slice(played)
+			.map((v) => BARS[Math.min(BARS.length - 1, Math.floor(v * BARS.length))])
+			.join("");
 
-    return (
-      <box flexDirection="row" gap={0}>
-        <text fg={playedColor}>{playedChars || " "}</text>
-        <text fg={futureColor}>{futureChars || " "}</text>
-      </box>
-    );
-  };
+		return (
+			<box flexDirection="row" gap={0}>
+				<text fg={playedColor}>{playedChars || " "}</text>
+				<text fg={futureColor}>{futureChars || " "}</text>
+			</box>
+		);
+	};
 
-  const handleClick = (event: { x: number }) => {
-    const numBars = 32;
-    const ratio = event.x / numBars;
-    const next = Math.max(
-      0,
-      Math.min(audio.duration(), Math.round(audio.duration() * ratio)),
-    );
-    audio.seek(next);
-  };
+	const handleClick = (event: { x: number }) => {
+		const count = numBars();
+		const ratio = event.x / count;
+		const next = Math.max(
+			0,
+			Math.min(audio.duration(), Math.round(audio.duration() * ratio)),
+		);
+		audio.seek(next);
+	};
 
-  return (
-    <box border borderColor={theme.border} padding={1} onMouseDown={handleClick}>
-      {renderLine()}
-    </box>
-  );
-}
+	return (
+		<box
+			border
+			borderColor={theme.border}
+			padding={1}
+			onMouseDown={handleClick}
+		>
+			{renderLine()}
+		</box>
+	);
+}

src/pages/Search/ResultCard.tsx

@@ -1,95 +0,0 @@
-import { Show } from "solid-js";
-import type { SearchResult } from "@/types/source";
-import { SourceBadge } from "./SourceBadge";
-import { useTheme } from "@/context/ThemeContext";
-import { SelectableBox, SelectableText } from "@/components/Selectable";
-
-type ResultCardProps = {
-  result: SearchResult;
-  selected: boolean;
-  onSelect: () => void;
-  onSubscribe?: () => void;
-};
-
-export function ResultCard(props: ResultCardProps) {
-  const { theme } = useTheme();
-  const podcast = () => props.result.podcast;
-
-  return (
-    <SelectableBox
-      selected={() => props.selected}
-      flexDirection="column"
-      padding={1}
-      onMouseDown={props.onSelect}
-    >
-      <box
-        flexDirection="row"
-        justifyContent="space-between"
-        alignItems="center"
-      >
-         <box flexDirection="row" gap={2} alignItems="center">
-             <SelectableText
-               selected={() => props.selected}
-               primary
-             >
-               <strong>{podcast().title}</strong>
-             </SelectableText>
-           <SourceBadge
-             sourceId={props.result.sourceId}
-             sourceName={props.result.sourceName}
-             sourceType={props.result.sourceType}
-           />
-         </box>
-        <Show when={podcast().isSubscribed}>
-            <text fg={theme.success}>[Subscribed]</text>
-        </Show>
-      </box>
-
-       <Show when={podcast().author}>
-             <SelectableText
-               selected={() => props.selected}
-               tertiary
-             >
-               by {podcast().author}
-             </SelectableText>
-       </Show>
-
-       <Show when={podcast().description}>
-         {(description) => (
-             <SelectableText
-               selected={() => props.selected}
-               tertiary
-             >
-             {description().length > 120
-               ? description().slice(0, 120) + "..."
-               : description()}
-           </SelectableText>
-         )}
-       </Show>
-
-      <Show when={(podcast().categories ?? []).length > 0}>
-        <box flexDirection="row" gap={1}>
-          {(podcast().categories ?? []).slice(0, 3).map((category) => (
-            <text fg={theme.warning}>[{category}]</text>
-          ))}
-        </box>
-      </Show>
-
-      <Show when={!podcast().isSubscribed}>
-        <box
-          border
-          padding={0}
-          paddingLeft={1}
-          paddingRight={1}
-          width={18}
-          onMouseDown={(event) => {
-            event.stopPropagation?.();
-            props.onSubscribe?.();
-          }}
-        >
-            <text fg={theme.primary}>[+] Add to Feeds</text>
-        </box>
-      </Show>
-    </SelectableBox>
-  );
-}

src/pages/Search/ResultDetail.tsx

@@ -1,75 +0,0 @@
-import { Show } from "solid-js";
-import { format } from "date-fns";
-import type { SearchResult } from "@/types/source";
-import { SourceBadge } from "./SourceBadge";
-import { useTheme } from "@/context/ThemeContext";
-
-type ResultDetailProps = {
-  result?: SearchResult;
-  onSubscribe?: (result: SearchResult) => void;
-};
-
-export function ResultDetail(props: ResultDetailProps) {
-  const { theme } = useTheme();
-  return (
-    <box flexDirection="column" border padding={1} gap={1} height="100%" borderColor={theme.border}>
-      <Show
-        when={props.result}
-        fallback={          <text fg={theme.textMuted}>Select a result to see details.</text>}
-      >
-        {(result) => (
-          <>
-            <text fg={theme.text}>
-              <strong>{result().podcast.title}</strong>
-            </text>
-
-            <SourceBadge
-              sourceId={result().sourceId}
-              sourceName={result().sourceName}
-              sourceType={result().sourceType}
-            />
-
-            <Show when={result().podcast.author}>
-              <text fg={theme.textMuted}>by {result().podcast.author}</text>
-            </Show>
-
-            <Show when={result().podcast.description}>
-              <text fg={theme.textMuted}>{result().podcast.description}</text>
-            </Show>
-
-            <Show when={(result().podcast.categories ?? []).length > 0}>
-              <box flexDirection="row" gap={1}>
-                {(result().podcast.categories ?? []).map((category) => (
-                  <text fg={theme.warning}>[{category}]</text>
-                ))}
-              </box>
-            </Show>
-
-            <text fg={theme.textMuted}>Feed: {result().podcast.feedUrl}</text>
-
-            <text fg={theme.textMuted}>
-              Updated: {format(result().podcast.lastUpdated, "MMM d, yyyy")}
-            </text>
-
-            <Show when={!result().podcast.isSubscribed}>
-              <box
-                border
-                padding={0}
-                paddingLeft={1}
-                paddingRight={1}
-                width={18}
-                onMouseDown={() => props.onSubscribe?.(result())}
-              >
-                  <text fg={theme.primary}>[+] Add to Feeds</text>
-              </box>
-            </Show>
-
-            <Show when={result().podcast.isSubscribed}>
-              <text fg={theme.success}>Already subscribed</text>
-            </Show>
-          </>
-        )}
-      </Show>
-    </box>
-  );
-}

src/pages/Search/SearchHistory.tsx

@@ -1,89 +0,0 @@
-/**
- * SearchHistory component for displaying and managing search history
- */
-
-import { For, Show } from "solid-js"
-import { useTheme } from "@/context/ThemeContext"
-import { SelectableBox, SelectableText } from "@/components/Selectable"
-
-type SearchHistoryProps = {
-  history: string[]
-  focused: boolean
-  selectedIndex: number
-  onSelect?: (query: string) => void
-  onRemove?: (query: string) => void
-  onClear?: () => void
-  onChange?: (index: number) => void
-}
-
-export function SearchHistory(props: SearchHistoryProps) {
-  const { theme } = useTheme();
-  const handleSearchClick = (index: number, query: string) => {
-    props.onChange?.(index)
-    props.onSelect?.(query)
-  }
-
-  const handleRemoveClick = (query: string) => {
-    props.onRemove?.(query)
-  }
-
-  return (
-    <box flexDirection="column" gap={1}>
-      <box flexDirection="row" justifyContent="space-between">
-            <text fg={theme.textMuted}>Recent Searches</text>
-            <Show when={props.history.length > 0}>
-              <box onMouseDown={() => props.onClear?.()} padding={0}>
-                <text fg={theme.error}>[Clear All]</text>
-              </box>
-            </Show>
-      </box>
-
-      <Show
-        when={props.history.length > 0}
-        fallback={
-          <box padding={1}>
-            <text fg={theme.textMuted}>No recent searches</text>
-          </box>
-        }
-      >
-        <scrollbox height={10}>
-          <box flexDirection="column">
-            <For each={props.history}>
-              {(query, index) => {
-                const isSelected = () => index() === props.selectedIndex && props.focused
-
-                return (
-                  <SelectableBox
-                    selected={isSelected}
-                    flexDirection="row"
-                    justifyContent="space-between"
-                    padding={0}
-                    paddingLeft={1}
-                    paddingRight={1}
-                    onMouseDown={() => handleSearchClick(index(), query)}
-                  >
-                     <SelectableText
-                       selected={isSelected}
-                       tertiary
-                     >
-                       {">"}
-                     </SelectableText>
-                     <SelectableText
-                       selected={isSelected}
-                       primary
-                     >
-                       {query}
-                     </SelectableText>
-                    <box onMouseDown={() => handleRemoveClick(query)} padding={0}>
-                      <text fg={theme.error}>[x]</text>
-                    </box>
-                  </SelectableBox>
-                )
-              }}
-            </For>
-          </box>
-        </scrollbox>
-      </Show>
-    </box>
-  )
-}

src/pages/Search/SearchPage.tsx

@@ -1,16 +1,18 @@
 /**
- * SearchPage — yazi-style 3-pane view.
+ * SearchPage — yazi depth-stack view of podcast search.
  *
- *   pane 1 (parent)  — query input with recent-search history (clickable)
- *   pane 2 (current) — search results list (navigate j/k)
- *   pane 3 (preview)  — detail of the focused search result
+ *   depth 0 (current) — query input row + recent-searches list (navigable
+ *                       with j/k when the input is defocused). Parent pane
+ *                       shows the tab list (muted); preview shows a hint.
+ *   depth 1 (current) — search results list. Parent pane shows the submitted
+ *                       query (muted, read-only); preview shows the detail of
+ *                       the focused result.
  *
- * (pane 0 is the app's tab list.) The Shell resets activePane to CURRENT(2)
- * on tab enter so the user lands on the results pane. Swipe left (h) to pane
- * 1 to type a query — the Shell
- * router skips keys while `nav.inputFocused()` is true so the `<input>`
- * element captures typing natively. Press Enter (onSubmit) to search and
- * auto-swipe to the results pane.
+ * Typed input owns its keys while `nav.inputFocused()` is true (the Shell
+ * router yields). Escape defocuses the input (handled in Shell) so j/k/h
+ * navigation resumes; `s` (the `search` action) refocuses it. Enter on the
+ * input (or on a focused recent at depth 0) submits the query and pushes to
+ * depth 1 (results). `h` pops: results→query, query→tab root.
  */
 
 import {
@@ -23,137 +25,160 @@ import {
 	onCleanup,
 } from "solid-js";
 import { useSearchStore } from "@/stores/search";
+import { useFeedStore } from "@/stores/feed";
 import { format } from "date-fns";
 import { useTheme } from "@/context/ThemeContext";
 import {
 	useNavigation,
 	NavMode,
-	PaneSlot,
+	DEPTH_CENTER_PANE,
 	type PaneId,
+	type DepthFrame,
 } from "@/context/NavigationContext";
 import { on, off } from "@/utils/event-bus";
 import type { KeybindActionName } from "@/context/KeybindContext";
 import type { SearchResult } from "@/types/source";
-import { PANE_RATIO } from "@/utils/navigation";
+import { PaneRow } from "@/components/PaneRow";
+import { TabListPane } from "@/components/TabPanel";
+import { LoadingIndicator } from "@/components/LoadingIndicator";
+import { useScrollIntoView } from "@/hooks/useScrollIntoView";
 
-export const SearchPaneCount = 3;
+export const SearchPaneCount = 1;
 
 function SearchPage() {
 	const searchStore = useSearchStore();
+	const feedStore = useFeedStore();
 	const [inputValue, setInputValue] = createSignal("");
 	const { theme } = useTheme();
 	const muted = () => theme.muted || theme.text;
 	const nav = useNavigation();
 
-	const INPUT = PaneSlot.PARENT; // 1 (input row)
-	const RESULTS = PaneSlot.CURRENT; // 2 (results list)
-	const DETAIL = PaneSlot.PREVIEW; // 3 (detail preview)
+	const stack = nav.depthStack;
+	const depth = nav.currentDepth;
+	const focus = (d: number = depth()) => nav.depthFocus(d);
 
+	// depth 1's ctx carries the submitted query string.
+	const submittedQuery = (): string => stack()[1]?.ctx ?? searchStore.query();
+
+	// ── input focusing ────────────────────────────────────────────────────────
+	// `inputFocused` is true while the query input is being typed in. The Shell
+	// router yields keys to the <input> while this is true; Escape (in Shell)
+	// sets it false so navigation resumes; `s` (search action) sets it true.
+	//
+	// Typing is the default only on the query depth (0); the results depth
+	// (1) is always list-navigation. Drive `inputFocused` straight off
+	// `depth()` rather than seeding it `true` on mount and patching on change:
+	// the depth stack persists across tab switches, so re-mounting this page
+	// at depth 1 (e.g. after searching, leaving, and returning to the tab)
+	// must NOT leave `inputFocused` stuck on — otherwise the Shell swallows
+	// j/k (yielding to a non-existent input) and only the scrollbox's native
+	// scroll responds.
+	//
+	// The effect only re-runs on a depth transition, so Escape (defocus) and
+	// `s` (refocus) at the same depth are not clobbered.
+	onMount(() => nav.setInputFocused(depth() === 0));
+	onCleanup(() => nav.setInputFocused(false));
+	createEffect(() => {
+		nav.setInputFocused(depth() === 0);
+	});
+
+	// ── results (depth 1) ─────────────────────────────────────────────────────
 	const results = () => searchStore.results();
-
-	// The focused result tracks pane 1's focused row.
+	const focusedResultIdx = () =>
+		results().length === 0 ? 0 : Math.min(focus(1), results().length - 1);
 	const focusedResult = createMemo(() => {
 		const list = results();
 		if (list.length === 0) return undefined;
-		const idx = Math.min(nav.focusedIndex(RESULTS), list.length - 1);
-		return list[idx];
+		return list[focusedResultIdx()];
 	});
 
-	// Register a resolver so visual-mode range selection grows by result id.
-	onMount(() => {
-		nav.registerResolver(
-			`${nav.activeTab()}:${RESULTS}`,
-			(i) => results()[i]?.podcast.id,
-		);
-		const unsub = on("nav.action", () => {
-			nav.registerResolver(
-				`${nav.activeTab()}:${RESULTS}`,
-				(i) => results()[i]?.podcast.id,
-			);
-		});
-		onCleanup(() => unsub());
-	});
+	// ── recents (depth 0) ────────────────────────────────────────────────────
+	const recents = () => searchStore.history();
+	const curLen = () => (depth() === 0 ? recents().length : results().length);
 
-	// Keep results focus in range after searches complete.
 	const ensureFocus = () => {
-		const list = results();
-		if (list.length === 0) return;
-		const cur = nav.focusedIndex(RESULTS);
-		if (cur >= list.length) nav.setFocusedIndex(RESULTS, list.length - 1);
+		if (depth() === 1 && results().length > 0 && focus(1) >= results().length)
+			nav.setDepthFocus(results().length - 1, 1);
 	};
 	onMount(ensureFocus);
 
-	// ── input pane: set inputFocused so Shell router yields keys to <input> ─────
-	createEffect(() => {
-		const isInputPane = nav.activePane() === INPUT;
-		nav.setInputFocused(isInputPane);
-	});
+	// Register a visual-mode resolver for the results list (depth 1).
 	onMount(() => {
-		onCleanup(() => nav.setInputFocused(false));
+		const key = `${nav.activeTab()}:${DEPTH_CENTER_PANE}`;
+		nav.registerResolver(key, (i) => results()[i]?.podcast.id);
 	});
 
 	// ── helpers ─────────────────────────────────────────────────────────────────
 	const formatDate = (d: Date) => format(d, "MMM d, yyyy");
 
-	const handleSubmit = () => {
-		const query = inputValue().trim();
-		if (!query) return;
-		searchStore.search(query).catch(() => {});
-		nav.setFocusedIndex(RESULTS, 0);
-		nav.setActivePane(RESULTS);
+	const runSearch = (query: string) => {
+		const q = query.trim();
+		if (!q) return;
+		searchStore.search(q).catch(() => {});
+		nav.pushDepth({
+			kind: "search:results",
+			ctx: q,
+			focus: 0,
+		} as DepthFrame);
+		nav.setActivePane(DEPTH_CENTER_PANE);
 	};
 
-	const handleHistorySelect = (query: string) => {
+	const handleSubmit = () => runSearch(inputValue());
+
+	const selectRecent = (query: string) => {
 		setInputValue(query);
-		searchStore.search(query).catch(() => {});
-		nav.setFocusedIndex(RESULTS, 0);
-		nav.setActivePane(RESULTS);
+		runSearch(query);
 	};
 
 	const handleSubscribe = (result: SearchResult) => {
+		// Actually add the feed to the feed store, then mark the result subscribed
+		feedStore.addFeed(result.podcast, result.sourceId).catch(() => {});
 		searchStore.markSubscribed(result.podcast.id);
 	};
 
 	// ── nav.action handler ──────────────────────────────────────────────────────
-	const PAGE_ACTIONS: Partial<
-		Record<KeybindActionName, (pane: PaneId) => void>
-	> = {
-		"move-down": (p) => step(p, 1),
-		"move-up": (p) => step(p, -1),
-		"jump-down": (p) => step(p, 5),
-		"jump-up": (p) => step(p, -5),
-		"page-down": (p) => step(p, 10),
-		"page-up": (p) => step(p, -10),
-		"goto-top": (p) => nav.gotoIndex(0, len(p)),
-		"goto-bottom": (p) => nav.gotoIndex(len(p) - 1, len(p)),
-		open: (p) => {
-			if (p === RESULTS || p === DETAIL) {
-				const result = focusedResult();
-				if (result) handleSubscribe(result);
-			}
-		},
-		"toggle-select": (p) => {
-			if (p === RESULTS) {
-				const result = focusedResult();
-				if (result) nav.toggleSelected(result.podcast.id);
+	const PAGE_ACTIONS: Partial<Record<KeybindActionName, () => void>> = {
+		"move-down": () => step(1),
+		"move-up": () => step(-1),
+		"jump-down": () => step(5),
+		"jump-up": () => step(-5),
+		"page-down": () => step(10),
+		"page-up": () => step(-10),
+		"goto-top": () => nav.gotoIndex(0, curLen()),
+		"goto-bottom": () => nav.gotoIndex(curLen() - 1, curLen()),
+		open: () => open(),
+		"toggle-select": () => {
+			if (depth() === 1) {
+				const r = focusedResult();
+				if (r) nav.toggleSelected(r.podcast.id);
 			}
 		},
 		search: () => {
-			nav.setActivePane(INPUT);
+			// `s` refocuses the query input (typing mode) when on the query depth.
+			if (depth() === 0) nav.setInputFocused(true);
 		},
 		refresh: () => {
-			if (inputValue().trim()) {
-				searchStore.search(inputValue().trim()).catch(() => {});
-			}
+			const q = submittedQuery() || inputValue().trim();
+			if (q) searchStore.search(q).catch(() => {});
 		},
 	};
 
-	function len(pane: PaneId): number {
-		if (pane === RESULTS) return results().length;
-		return 0;
+	function step(delta: number) {
+		nav.move(delta, curLen());
 	}
-	function step(pane: PaneId, delta: number) {
-		nav.move(delta, len(pane));
+	function open() {
+		if (depth() === 0) {
+			// Enter/l on a focused recent search → submit it and drill to results.
+			const list = recents();
+			const idx = Math.min(focus(0), list.length - 1);
+			const q = list[idx];
+			if (q) selectRecent(q);
+			return;
+		}
+		if (depth() === 1) {
+			const r = focusedResult();
+			if (r) handleSubscribe(r);
+		}
 	}
 
 	const onAction = (data: {
@@ -161,139 +186,161 @@ function SearchPage() {
 		pane: PaneId;
 		mode: NavMode;
 	}) => {
+		if (data.pane !== DEPTH_CENTER_PANE) return;
+		if (nav.activePane() !== DEPTH_CENTER_PANE) return;
 		ensureFocus();
-		const handler = PAGE_ACTIONS[data.action];
-		if (handler) handler(data.pane);
+		PAGE_ACTIONS[data.action]?.();
 	};
-
 	onMount(() => {
 		on("nav.action", onAction);
 		onCleanup(() => off("nav.action", onAction));
 	});
 
 	// ── render ──────────────────────────────────────────────────────────────────
-	const isActive = (p: PaneId) => nav.activePane() === p;
-	const border = (p: PaneId) => (isActive(p) ? theme.accent : theme.border);
-
-	const focusBg = (i: number, pane: PaneId) =>
-		i === nav.focusedIndex(pane) && isActive(pane)
+	const isActive = () => nav.activePane() === DEPTH_CENTER_PANE;
+	const inputActive = () => nav.inputFocused() && depth() === 0;
+	const focusBg = (i: number, listFocus: number, active: boolean) =>
+		i === listFocus && active
 			? theme.primary
-			: i === nav.focusedIndex(pane)
+			: i === listFocus
 				? theme.border
 				: undefined;
-	const focusFg = (i: number, pane: PaneId) =>
-		i === nav.focusedIndex(pane) && isActive(pane) ? theme.surface : theme.text;
+	const focusFg = (i: number, listFocus: number, active: boolean) =>
+		i === listFocus && active
+			? theme.surface
+			: i === listFocus
+				? theme.selectedListItemText ?? theme.text
+				: theme.text;
 
-	return (
-		<box flexDirection="row" flexGrow={1} width="100%" height="100%">
-			{/* ── pane 0: query input ──────────────────────────────────────────────── */}
-			<box flexDirection="column" flexGrow={PANE_RATIO.parent} height="100%">
-				<box height={1} paddingLeft={1} backgroundColor={theme.background}>
-					<text fg={theme.textSecondary}>Search</text>
-				</box>
-				<scrollbox
-					height="100%"
-					focused={false}
-					border
-					borderColor={border(INPUT)}
-					backgroundColor={theme.background}
-				>
-					<box flexDirection="column" gap={1} padding={1}>
-						<box flexDirection="row" gap={1} alignItems="center">
-							<text fg={muted()}>Query:</text>
-							<input
-								value={inputValue()}
-								onInput={setInputValue}
-								onSubmit={() => handleSubmit()}
-								placeholder="Enter podcast name..."
-								focused={isActive(INPUT)}
-								width={28}
-							/>
-						</box>
-						<text fg={muted()}>Enter to search · h/l: panes</text>
-
-						<Show when={searchStore.isSearching()}>
-							<text fg={theme.warning}>Searching...</text>
-						</Show>
-						<Show when={searchStore.error()}>
-							<text fg={theme.error}>{searchStore.error()}</text>
-						</Show>
-
-						<box height={1} />
-						<text fg={theme.textSecondary}>Recent</text>
-						<Show
-							when={searchStore.history().length > 0}
-							fallback={<text fg={muted()}>No recent searches</text>}
-						>
-							<For each={searchStore.history().slice(0, 12)}>
-								{(query) => (
-									<box
-										flexDirection="row"
-										paddingLeft={1}
-										onMouseDown={() => handleHistorySelect(query)}
-									>
-										<text fg={muted()}>
-											{">"} {query}
-										</text>
-									</box>
-								)}
-							</For>
-						</Show>
-					</box>
-				</scrollbox>
+	// ── parent pane: previous-depth content (tab list at depth 0) ──────────────
+	const parentContent = () => (
+		<Show when={depth() >= 1} fallback={<TabListPane muted />}>
+			<box flexDirection="column" gap={1} padding={1}>
+				<text fg={theme.textSecondary}>Query</text>
+				<text fg={muted()}>{submittedQuery() || "(empty)"}</text>
+				<box height={1} />
+				<text fg={muted()}>h: back to query</text>
 			</box>
+		</Show>
+	);
 
-			{/* ── pane 1: results ──────────────────────────────────────────────────── */}
-			<box flexDirection="column" flexGrow={PANE_RATIO.current} height="100%">
-				<box height={1} paddingLeft={1} backgroundColor={theme.background}>
-					<text fg={theme.textSecondary}>Results · {results().length}</text>
-				</box>
-				<scrollbox
-					height="100%"
-					focused={isActive(RESULTS)}
-					border
-					borderColor={border(RESULTS)}
-					backgroundColor={theme.background}
-				>
+	// ── current pane ────────────────────────────────────────────────────────────
+	const currentContent = () => (
+		<>
+			<Show when={depth() === 0}>
+				{/* query input row + recent searches */}
+				<box flexDirection="column" gap={1} padding={1}>
+					<box flexDirection="row" gap={1} alignItems="center">
+						<text fg={muted()}>Query:</text>
+						<input
+							value={inputValue()}
+							onInput={setInputValue}
+							onSubmit={() => handleSubmit()}
+							placeholder="Enter podcast name..."
+							focused={inputActive()}
+							width={28}
+						/>
+					</box>
+					<Show when={searchStore.isSearching()}>
+						<LoadingIndicator label="Searching…" />
+					</Show>
+					<Show when={searchStore.error()}>
+						<text fg={theme.error}>{searchStore.error()}</text>
+					</Show>
+					<box height={1} />
+					<text fg={theme.textSecondary}>Recent</text>
 					<Show
-						when={results().length > 0}
+						when={recents().length > 0}
 						fallback={
-							<box padding={1}>
-								<text fg={muted()}>
-									{searchStore.query()
-										? "No results found"
-										: "Enter a search term to find podcasts"}
-								</text>
-							</box>
+							<text fg={muted()}>
+								{inputActive()
+									? "Enter to search"
+									: "s to type · Enter to search"}
+							</text>
 						}
 					>
-						<For each={results()}>
-							{(result, index) => (
+						<For each={recents()}>
+							{(query, index) => {
+								const lf = () => focus(0);
+								const ref = useScrollIntoView(() => index() === lf());
+								return (
+									<box
+										ref={ref}
+										flexDirection="row"
+										gap={1}
+										paddingLeft={1}
+										paddingRight={1}
+										backgroundColor={focusBg(index(), lf(), isActive())}
+										onMouseDown={() => {
+											nav.setActivePane(DEPTH_CENTER_PANE);
+											nav.setDepthFocus(index(), 0);
+										}}
+									>
+										<text fg={focusFg(index(), lf(), isActive())}>
+											{index() === lf() ? "❯" : " "}
+										</text>
+										<text fg={focusFg(index(), lf(), isActive())}>{query}</text>
+									</box>
+								);
+							}}
+						</For>
+					</Show>
+					<box height={1} />
+					<text fg={muted()}>
+						{inputActive()
+							? "Enter to search · Esc to defocus"
+							: "j/k recents · s to type · h back"}
+					</text>
+				</box>
+			</Show>
+			<Show when={depth() >= 1}>
+				{/* results list */}
+				<Show
+					when={results().length > 0}
+					fallback={
+						<box padding={1}>
+							<Show
+								when={searchStore.isSearching()}
+								fallback={
+									<text fg={muted()}>
+										{searchStore.query()
+											? "No results found"
+											: "Enter a search term to find podcasts"}
+									</text>
+								}
+							>
+								<LoadingIndicator label="Searching…" />
+							</Show>
+						</box>
+					}
+				>
+					<For each={results()}>
+						{(result, index) => {
+							const fi = () => focusedResultIdx();
+							const ref = useScrollIntoView(() => index() === fi());
+							return (
 								<box
+									ref={ref}
 									flexDirection="column"
 									gap={0}
 									paddingLeft={1}
 									paddingRight={1}
-									backgroundColor={focusBg(index(), RESULTS)}
+									backgroundColor={focusBg(index(), fi(), isActive())}
 									onMouseDown={() => {
-										nav.setActivePane(RESULTS);
-										nav.setFocusedIndex(RESULTS, index());
+										nav.setActivePane(DEPTH_CENTER_PANE);
+										nav.setDepthFocus(index(), 1);
 									}}
 								>
 									<box flexDirection="row" gap={1}>
-										<text fg={focusFg(index(), RESULTS)}>
-											{index() === nav.focusedIndex(RESULTS) ? "❯" : " "}
+										<text fg={focusFg(index(), fi(), isActive())}>
+											{index() === fi() ? "❯" : " "}
 										</text>
-										<text fg={focusFg(index(), RESULTS)}>
+										<text fg={focusFg(index(), fi(), isActive())}>
 											{result.podcast.title}
 										</text>
 										<Show when={result.podcast.isSubscribed}>
 											<text
-												fg={
-													index() === nav.focusedIndex(RESULTS)
-														? theme.surface
-														: theme.success
-												}
+												fg={index() === fi() ? theme.surface : theme.success}
 											>
 												[+]
 											</text>
@@ -301,95 +348,100 @@ function SearchPage() {
 									</box>
 									<Show when={result.podcast.author}>
 										<text
-											fg={
-												index() === nav.focusedIndex(RESULTS)
-													? theme.surface
-													: muted()
-											}
+											fg={index() === fi() ? theme.surface : muted()}
 											paddingLeft={2}
 										>
 											by {result.podcast.author}
 										</text>
 									</Show>
 								</box>
-							)}
-						</For>
-					</Show>
-				</scrollbox>
+							);
+						}}
+					</For>
+				</Show>
+			</Show>
+		</>
+	);
+
+	// ── preview pane ────────────────────────────────────────────────────────────
+	const previewContent = () =>
+		depth() === 0 ? (
+			<box flexDirection="column" gap={1} padding={1}>
+				<text fg={theme.textPrimary ?? theme.text}>
+					<strong>Search</strong>
+				</text>
+				<text fg={muted()}>Type a query, press Enter to search.</text>
+				<text fg={muted()}>Esc defocuses the input; h goes back.</text>
+				<box height={1} />
+				<text fg={theme.textSecondary}>Recent · {recents().length}</text>
+				<For each={recents().slice(0, 6)}>
+					{(q) => <text fg={muted()}>‣ {q}</text>}
+				</For>
 			</box>
-
-			{/* ── pane 2: detail ───────────────────────────────────────────────────── */}
-			<box flexDirection="column" flexGrow={PANE_RATIO.preview} height="100%">
-				<box height={1} paddingLeft={1} backgroundColor={theme.background}>
-					<text fg={theme.textSecondary}>Detail</text>
-				</box>
-				<scrollbox
-					height="100%"
-					focused={isActive(DETAIL)}
-					border
-					borderColor={border(DETAIL)}
-					backgroundColor={theme.background}
-				>
-					<Show
-						when={focusedResult()}
-						fallback={
-							<box padding={1}>
-								<text fg={muted()}>No result focused</text>
+		) : (
+			<Show
+				when={focusedResult()}
+				fallback={
+					<box padding={1}>
+						<text fg={muted()}>No result focused</text>
+					</box>
+				}
+			>
+				{(result) => (
+					<box flexDirection="column" gap={1} padding={1}>
+						<text fg={theme.text}>
+							<strong>{result().podcast.title}</strong>
+						</text>
+						<Show when={result().podcast.author}>
+							<text fg={muted()}>by {result().podcast.author}</text>
+						</Show>
+						<Show when={result().podcast.description}>
+							<text fg={theme.textSecondary}>
+								{result().podcast.description!.slice(0, 400)}
+								{(result().podcast.description?.length ?? 0) > 400 ? "…" : ""}
+							</text>
+						</Show>
+						<Show when={(result().podcast.categories ?? []).length > 0}>
+							<box flexDirection="row" gap={1}>
+								<For each={(result().podcast.categories ?? []).slice(0, 4)}>
+									{(cat) => <text fg={theme.warning}>[{cat}]</text>}
+								</For>
 							</box>
-						}
-					>
-						{(result) => (
-							<box flexDirection="column" gap={1} padding={1}>
-								<text fg={theme.text}>
-									<strong>{result().podcast.title}</strong>
-								</text>
+						</Show>
+						<text fg={muted()}>Feed: {result().podcast.feedUrl}</text>
+						<text fg={muted()}>
+							Updated: {formatDate(result().podcast.lastUpdated)}
+						</text>
+						<Show when={result().sourceName}>
+							<text fg={muted()}>Source: {result().sourceName}</text>
+						</Show>
+						<box height={1} />
+						<Show when={!result().podcast.isSubscribed}>
+							<text fg={theme.primary}>[+] Subscribe (enter)</text>
+						</Show>
+						<Show when={result().podcast.isSubscribed}>
+							<text fg={theme.success}>Already subscribed</text>
+						</Show>
+						<box height={1} />
+						<text fg={muted()}>enter: subscribe · h: back to query</text>
+					</box>
+				)}
+			</Show>
+		);
 
-								<Show when={result().podcast.author}>
-									<text fg={muted()}>by {result().podcast.author}</text>
-								</Show>
+	const currentLabel = () =>
+		depth() === 0
+			? `Search · ${recents().length} recent`
+			: `Results · ${results().length}`;
 
-								<Show when={result().podcast.description}>
-									<text fg={theme.textSecondary}>
-										{result().podcast.description!.slice(0, 400) ??
-											"No description available."}
-										{(result().podcast.description?.length ?? 0) > 400
-											? "…"
-											: ""}
-									</text>
-								</Show>
-
-								<Show when={(result().podcast.categories ?? []).length > 0}>
-									<box flexDirection="row" gap={1}>
-										<For each={(result().podcast.categories ?? []).slice(0, 4)}>
-											{(cat) => <text fg={theme.warning}>[{cat}]</text>}
-										</For>
-									</box>
-								</Show>
-
-								<text fg={muted()}>Feed: {result().podcast.feedUrl}</text>
-								<text fg={muted()}>
-									Updated: {formatDate(result().podcast.lastUpdated)}
-								</text>
-
-								<Show when={result().sourceName}>
-									<text fg={muted()}>Source: {result().sourceName}</text>
-								</Show>
-
-								<box height={1} />
-								<Show when={!result().podcast.isSubscribed}>
-									<text fg={theme.primary}>[+] Subscribe (enter)</text>
-								</Show>
-								<Show when={result().podcast.isSubscribed}>
-									<text fg={theme.success}>Already subscribed</text>
-								</Show>
-								<box height={1} />
-								<text fg={muted()}>enter: subscribe h/l: panes</text>
-							</box>
-						)}
-					</Show>
-				</scrollbox>
-			</box>
-		</box>
+	return (
+		<PaneRow
+			parent={parentContent}
+			current={currentContent}
+			preview={previewContent}
+			currentLabel={currentLabel}
+			focused={isActive}
+		/>
 	);
 }
 

src/pages/Search/SearchResults.tsx

@@ -1,80 +0,0 @@
-/**
- * SearchResults component for displaying podcast search results
- */
-
-import { For, Show } from "solid-js";
-import type { SearchResult } from "@/types/source";
-import { ResultCard } from "./ResultCard";
-import { ResultDetail } from "./ResultDetail";
-
-type SearchResultsProps = {
-  results: SearchResult[];
-  selectedIndex: number;
-  focused: boolean;
-  onSelect?: (result: SearchResult) => void;
-  onChange?: (index: number) => void;
-  isSearching?: boolean;
-  error?: string | null;
-};
-
-export function SearchResults(props: SearchResultsProps) {
-  const handleSelect = (index: number) => {
-    props.onChange?.(index);
-  };
-
-  return (
-    <Show
-      when={!props.isSearching}
-      fallback={
-        <box padding={1}>
-          <text fg="yellow">Searching...</text>
-        </box>
-      }
-    >
-      <Show
-        when={!props.error}
-        fallback={
-          <box padding={1}>
-            <text fg="red">{props.error}</text>
-          </box>
-        }
-      >
-        <Show
-          when={props.results.length > 0}
-          fallback={
-            <box padding={1}>
-              <text fg="gray">
-                No results found. Try a different search term.
-              </text>
-            </box>
-          }
-        >
-          <box flexDirection="row" gap={1} height="100%">
-            <box flexDirection="column" flexGrow={1}>
-              <scrollbox height="100%">
-                <box flexDirection="column" gap={1}>
-                  <For each={props.results}>
-                    {(result, index) => (
-                      <ResultCard
-                        result={result}
-                        selected={index() === props.selectedIndex}
-                        onSelect={() => handleSelect(index())}
-                        onSubscribe={() => props.onSelect?.(result)}
-                      />
-                    )}
-                  </For>
-                </box>
-              </scrollbox>
-            </box>
-            <box width={36}>
-              <ResultDetail
-                result={props.results[props.selectedIndex]}
-                onSubscribe={(result) => props.onSelect?.(result)}
-              />
-            </box>
-          </box>
-        </Show>
-      </Show>
-    </Show>
-  );
-}

src/pages/Search/SourceBadge.tsx

@@ -1,43 +0,0 @@
-import { SourceType } from "@/types/source";
-import { useTheme } from "@/context/ThemeContext";
-
-type SourceBadgeProps = {
-  sourceId: string;
-  sourceName?: string;
-  sourceType?: SourceType;
-};
-
-const typeLabel = (sourceType?: SourceType) => {
-  if (sourceType === SourceType.API) return "API";
-  if (sourceType === SourceType.RSS) return "RSS";
-  if (sourceType === SourceType.CUSTOM) return "Custom";
-  return "Source";
-};
-
-const typeColor = (sourceType?: SourceType) => {
-  if (sourceType === SourceType.API) return theme.primary;
-  if (sourceType === SourceType.RSS) return theme.success;
-  if (sourceType === SourceType.CUSTOM) return theme.warning;
-  return theme.textMuted;
-};
-
-export function SourceBadge(props: SourceBadgeProps) {
-  const { theme } = useTheme();
-  const label = () => props.sourceName || props.sourceId;
-
-  const typeColor = (sourceType?: SourceType) => {
-    if (sourceType === SourceType.API) return theme.primary;
-    if (sourceType === SourceType.RSS) return theme.success;
-    if (sourceType === SourceType.CUSTOM) return theme.warning;
-    return theme.textMuted;
-  };
-
-  return (
-    <box flexDirection="row" gap={1} padding={0}>
-      <text fg={typeColor(props.sourceType)}>
-        [{typeLabel(props.sourceType)}]
-      </text>
-      <text fg={theme.textMuted}>{label()}</text>
-    </box>
-  );
-}

src/pages/Settings/DownloadManager.tsx

@@ -0,0 +1,124 @@
+/**
+ * DownloadManager — exposes downloads as SettingItems for the depth-stack.
+ *
+ *   • "Delete All Downloads"   — action item; Enter wipes every download.
+ *   • one item per show        — action item; Enter deletes all that show's
+ *                               downloads (file + metadata, aborts in-flight).
+ *   • one item per episode     — action item; Enter deletes a single download.
+ *
+ * Titles resolve from the feed store at render time (reactive), falling back
+ * to the episode id when the feed is no longer loaded. Movement flows through
+ * nav.action — no own useKeyboard (matches the other panels).
+ */
+
+import { useFeedStore } from "@/stores/feed";
+import { useDownloadStore } from "@/stores/download";
+import { DownloadStatus } from "@/types/episode";
+import type { DownloadedEpisode } from "@/types/episode";
+import type { SettingItem } from "./types";
+
+/** Format a byte count as a compact human string. */
+function fmtBytes(n: number): string {
+	if (n >= 1 << 20) return `${(n / (1 << 20)).toFixed(1)} MB`;
+	if (n >= 1 << 10) return `${(n / (1 << 10)).toFixed(0)} KB`;
+	return `${n} B`;
+}
+
+/** Short status badge for an episode download. */
+function statusLabel(s: DownloadStatus): string {
+	switch (s) {
+		case DownloadStatus.QUEUED:
+			return "queued";
+		case DownloadStatus.DOWNLOADING:
+			return "downloading";
+		case DownloadStatus.COMPLETED:
+			return "done";
+		case DownloadStatus.FAILED:
+			return "failed";
+		default:
+			return "";
+	}
+}
+
+/** Episode title for a download, resolved from the feed store (reactive). */
+function episodeTitle(
+	feedStore: ReturnType<typeof useFeedStore>,
+	d: DownloadedEpisode,
+): string {
+	const feed = feedStore.getFeed(d.feedId);
+	const ep = feed?.episodes.find((e) => e.id === d.episodeId);
+	return ep?.title ?? d.episodeId;
+}
+
+/** Show title for a download's feed id. */
+function feedTitle(
+	feedStore: ReturnType<typeof useFeedStore>,
+	feedId: string,
+): string {
+	const feed = feedStore.getFeed(feedId);
+	return feed ? feed.customName || feed.podcast.title : feedId;
+}
+
+export function useDownloadItems(): SettingItem[] {
+	const downloadStore = useDownloadStore();
+	const feedStore = useFeedStore();
+
+	const downloads = () => downloadStore.getAllDownloads();
+
+	const items: SettingItem[] = [
+		{
+			id: "clear-all",
+			label: "Delete All Downloads",
+			kind: "action",
+			display: () => `${downloads().length} files`,
+			help: () =>
+				`Delete every downloaded episode (files + metadata) and clear the\nqueue. Enter to run.`,
+			run: () => {
+				for (const d of downloads()) {
+					downloadStore.cancelDownload(d.episodeId);
+					downloadStore.removeDownload(d.episodeId).catch(() => {});
+				}
+			},
+		},
+	];
+
+	// Group downloads by feed so each show gets a delete-by-show item.
+	const byFeed = new Map<string, DownloadedEpisode[]>();
+	for (const d of downloads()) {
+		const arr = byFeed.get(d.feedId) ?? [];
+		arr.push(d);
+		byFeed.set(d.feedId, arr);
+	}
+	for (const [feedId, eps] of byFeed) {
+		const size = eps.reduce((s, e) => s + e.fileSize, 0);
+		items.push({
+			id: `feed:${feedId}`,
+			label: `Show: ${feedTitle(feedStore, feedId)}`,
+			kind: "action",
+			display: () => `${eps.length} · ${fmtBytes(size)}`,
+			help: () =>
+				`Delete all ${eps.length} downloads for this show (files + metadata,\naborts any in-flight transfers). Enter to run.`,
+			run: () => {
+				downloadStore.removeDownloadsForFeed(feedId).catch(() => {});
+			},
+		});
+	}
+
+	// One item per individual episode download.
+	for (const d of downloads()) {
+		items.push({
+			id: `ep:${d.episodeId}`,
+			label: episodeTitle(feedStore, d),
+			kind: "action",
+			display: () =>
+				`${feedTitle(feedStore, d.feedId)} · ${statusLabel(d.status)} · ${fmtBytes(d.fileSize)}`,
+			help: () =>
+				`Delete this single download (file + metadata). Enter to run.`,
+			run: () => {
+				downloadStore.removeDownload(d.episodeId).catch(() => {});
+			},
+		});
+	}
+
+	return items;
+}

src/pages/Settings/ExportDialog.tsx

@@ -1,38 +1,55 @@
 const createSignal = <T,>(value: T): [() => T, (next: T) => void] => {
-  let current = value
-  return [() => current, (next) => {
-    current = next
-  }]
-}
+	let current = value;
+	return [
+		() => current,
+		(next) => {
+			current = next;
+		},
+	];
+};
 
-import { SyncStatus } from "./SyncStatus"
-import { useTheme } from "@/context/ThemeContext"
+import { SyncStatus } from "./SyncStatus";
+import { useTheme } from "@/context/ThemeContext";
+import { useInputFocusNav } from "@/hooks/useInputFocusNav";
 
 export function ExportDialog() {
-  const { theme } = useTheme();
-  const filename = createSignal("podcast-sync.json")
-  const format = createSignal<"json" | "xml">("json")
+	const { theme } = useTheme();
+	const filename = createSignal("podcast-sync.json");
+	const format = createSignal<"json" | "xml">("json");
+	// Yield navigation keybinds to the Shell router while the input is focused.
+	const filenameRef = useInputFocusNav();
 
-  return (
-    <box border title="Export" style={{ padding: 1, flexDirection: "column", gap: 1 }}>
-      <box style={{ flexDirection: "row", gap: 1 }}>
-        <text fg={theme.text}>File:</text>
-        <input value={filename[0]()} onInput={filename[1]} style={{ width: 30 }} />
-      </box>
-      <box style={{ flexDirection: "row", gap: 1 }}>
-        <text fg={theme.text}>Format:</text>
-        <tab_select
-          options={[
-            { name: "JSON", description: "Portable" },
-            { name: "XML", description: "Structured" },
-          ]}
-          onSelect={(index) => format[1](index === 0 ? "json" : "xml")}
-        />
-      </box>
-      <box border borderColor={theme.border}>
-        <text fg={theme.text}>Export {format[0]()} to {filename[0]()}</text>
-      </box>
-      <SyncStatus />
-    </box>
-  )
+	return (
+		<box
+			border
+			title="Export"
+			style={{ padding: 1, flexDirection: "column", gap: 1 }}
+		>
+			<box style={{ flexDirection: "row", gap: 1 }}>
+				<text fg={theme.text}>File:</text>
+				<input
+					ref={filenameRef}
+					value={filename[0]()}
+					onInput={filename[1]}
+					style={{ width: 30 }}
+				/>
+			</box>
+			<box style={{ flexDirection: "row", gap: 1 }}>
+				<text fg={theme.text}>Format:</text>
+				<tab_select
+					options={[
+						{ name: "JSON", description: "Portable" },
+						{ name: "XML", description: "Structured" },
+					]}
+					onSelect={(index) => format[1](index === 0 ? "json" : "xml")}
+				/>
+			</box>
+			<box border borderColor={theme.border}>
+				<text fg={theme.text}>
+					Export {format[0]()} to {filename[0]()}
+				</text>
+			</box>
+			<SyncStatus />
+		</box>
+	);
 }

src/pages/Settings/FilePicker.tsx

@@ -1,24 +1,28 @@
 import { detectFormat } from "@/utils/file-detector";
 import { useTheme } from "@/context/ThemeContext";
+import { useInputFocusNav } from "@/hooks/useInputFocusNav";
 
 type FilePickerProps = {
-  value: string;
-  onChange: (value: string) => void;
+	value: string;
+	onChange: (value: string) => void;
 };
 
 export function FilePicker(props: FilePickerProps) {
-  const { theme } = useTheme();
-  const format = detectFormat(props.value);
+	const { theme } = useTheme();
+	// Yield navigation keybinds to the Shell router while the input is focused.
+	const inputRef = useInputFocusNav();
+	const format = detectFormat(props.value);
 
-  return (
-    <box style={{ flexDirection: "column", gap: 1 }}>
-      <input
-        value={props.value}
-        onInput={props.onChange}
-        placeholder="/path/to/sync-file.json"
-        style={{ width: 40 }}
-      />
-      <text fg={theme.text}>Format: {format}</text>
-    </box>
-  );
+	return (
+		<box style={{ flexDirection: "column", gap: 1 }}>
+			<input
+				ref={inputRef}
+				value={props.value}
+				onInput={props.onChange}
+				placeholder="/path/to/sync-file.json"
+				style={{ width: 40 }}
+			/>
+			<text fg={theme.text}>Format: {format}</text>
+		</box>
+	);
 }

src/pages/Settings/LoginScreen.tsx

@@ -1,178 +0,0 @@
-/**
- * Login screen component for PodTUI
- * Email/password login with links to code validation and OAuth
- */
-
-import { createSignal } from "solid-js";
-import { useAuthStore } from "@/stores/auth";
-import { useTheme } from "@/context/ThemeContext";
-import { AUTH_CONFIG } from "@/config/auth";
-
-interface LoginScreenProps {
-  focused?: boolean;
-  onNavigateToCode?: () => void;
-  onNavigateToOAuth?: () => void;
-}
-
-type FocusField = "email" | "password" | "submit" | "code" | "oauth";
-
-export function LoginScreen(props: LoginScreenProps) {
-  const auth = useAuthStore();
-  const { theme } = useTheme();
-  const [email, setEmail] = createSignal("");
-  const [password, setPassword] = createSignal("");
-  const [focusField, setFocusField] = createSignal<FocusField>("email");
-  const [emailError, setEmailError] = createSignal<string | null>(null);
-  const [passwordError, setPasswordError] = createSignal<string | null>(null);
-
-  const fields: FocusField[] = ["email", "password", "submit", "code", "oauth"];
-
-  const validateEmail = (value: string): boolean => {
-    if (!value) {
-      setEmailError("Email is required");
-      return false;
-    }
-    if (!AUTH_CONFIG.email.pattern.test(value)) {
-      setEmailError("Invalid email format");
-      return false;
-    }
-    setEmailError(null);
-    return true;
-  };
-
-  const validatePassword = (value: string): boolean => {
-    if (!value) {
-      setPasswordError("Password is required");
-      return false;
-    }
-    if (value.length < AUTH_CONFIG.password.minLength) {
-      setPasswordError(`Minimum ${AUTH_CONFIG.password.minLength} characters`);
-      return false;
-    }
-    setPasswordError(null);
-    return true;
-  };
-
-  const handleSubmit = async () => {
-    const isEmailValid = validateEmail(email());
-    const isPasswordValid = validatePassword(password());
-
-    if (!isEmailValid || !isPasswordValid) {
-      return;
-    }
-
-    await auth.login({ email: email(), password: password() });
-  };
-
-  const handleKeyPress = (key: { name: string; shift?: boolean }) => {
-    if (key.name === "tab") {
-      const currentIndex = fields.indexOf(focusField());
-      const nextIndex = key.shift
-        ? (currentIndex - 1 + fields.length) % fields.length
-        : (currentIndex + 1) % fields.length;
-      setFocusField(fields[nextIndex]);
-    } else if (key.name === "return") {
-      if (focusField() === "submit") {
-        handleSubmit();
-      } else if (focusField() === "code" && props.onNavigateToCode) {
-        props.onNavigateToCode();
-      } else if (focusField() === "oauth" && props.onNavigateToOAuth) {
-        props.onNavigateToOAuth();
-      }
-    }
-  };
-
-  return (
-    <box flexDirection="column" border borderColor={theme.border} padding={2} gap={1}>
-      <text fg={theme.text}>
-        <strong>Sign In</strong>
-      </text>
-
-      <box height={1} />
-
-      {/* Email field */}
-      <box flexDirection="column" gap={0}>
-        <text fg={focusField() === "email" ? theme.primary : theme.textMuted}>
-          Email:
-        </text>
-        <input
-          value={email()}
-          onInput={setEmail}
-          placeholder="your@email.com"
-          focused={props.focused && focusField() === "email"}
-          width={30}
-        />
-        {emailError() && <text fg={theme.error}>{emailError()}</text>}
-      </box>
-
-      {/* Password field */}
-      <box flexDirection="column" gap={0}>
-        <text fg={focusField() === "password" ? theme.primary : theme.textMuted}>
-          Password:
-        </text>
-        <input
-          value={password()}
-          onInput={setPassword}
-          placeholder="********"
-          focused={props.focused && focusField() === "password"}
-          width={30}
-        />
-        {passwordError() && <text fg={theme.error}>{passwordError()}</text>}
-      </box>
-
-      <box height={1} />
-
-      {/* Submit button */}
-      <box flexDirection="row" gap={2}>
-        <box
-          border
-          borderColor={theme.border}
-          padding={1}
-          backgroundColor={
-            focusField() === "submit" ? theme.primary : undefined
-          }
-        >
-          <text fg={focusField() === "submit" ? theme.text : undefined}>
-            {auth.isLoading ? "Signing in..." : "[Enter] Sign In"}
-          </text>
-        </box>
-      </box>
-
-      {/* Auth error message */}
-      {auth.error && <text fg={theme.error}>{auth.error.message}</text>}
-
-      <box height={1} />
-
-      {/* Alternative auth options */}
-      <text fg={theme.textMuted}>Or authenticate with:</text>
-
-      <box flexDirection="row" gap={2}>
-        <box
-          border
-          borderColor={theme.border}
-          padding={1}
-          backgroundColor={focusField() === "code" ? theme.primary : undefined}
-        >
-          <text fg={focusField() === "code" ? theme.accent : theme.textMuted}>
-            [C] Sync Code
-          </text>
-        </box>
-
-        <box
-          border
-          borderColor={theme.border}
-          padding={1}
-          backgroundColor={focusField() === "oauth" ? theme.primary : undefined}
-        >
-          <text fg={focusField() === "oauth" ? theme.accent : theme.textMuted}>
-            [O] OAuth Info
-          </text>
-        </box>
-      </box>
-
-      <box height={1} />
-
-      <text fg={theme.textMuted}>Tab to navigate, Enter to select</text>
-    </box>
-  );
-}

src/pages/Settings/OAuthPlaceholder.tsx

@@ -1,123 +0,0 @@
-/**
- * OAuth placeholder component for PodTUI
- * Displays OAuth limitations and alternative authentication methods
- */
-
-import { createSignal } from "solid-js";
-import { OAUTH_PROVIDERS, OAUTH_LIMITATION_MESSAGE } from "@/config/auth";
-import { useTheme } from "@/context/ThemeContext";
-
-interface OAuthPlaceholderProps {
-  focused?: boolean;
-  onBack?: () => void;
-  onNavigateToCode?: () => void;
-}
-
-type FocusField = "code" | "back";
-
-export function OAuthPlaceholder(props: OAuthPlaceholderProps) {
-  const { theme } = useTheme();
-  const [focusField, setFocusField] = createSignal<FocusField>("code");
-
-  const fields: FocusField[] = ["code", "back"];
-
-  const handleKeyPress = (key: { name: string; shift?: boolean }) => {
-    if (key.name === "tab") {
-      const currentIndex = fields.indexOf(focusField());
-      const nextIndex = key.shift
-        ? (currentIndex - 1 + fields.length) % fields.length
-        : (currentIndex + 1) % fields.length;
-      setFocusField(fields[nextIndex]);
-    } else if (key.name === "return") {
-      if (focusField() === "code" && props.onNavigateToCode) {
-        props.onNavigateToCode();
-      } else if (focusField() === "back" && props.onBack) {
-        props.onBack();
-      }
-    } else if (key.name === "escape" && props.onBack) {
-      props.onBack();
-    }
-  };
-
-  return (
-    <box flexDirection="column" border padding={2} gap={1} borderColor={theme.border}>
-      <text fg={theme.text}>
-        <strong>OAuth Authentication</strong>
-      </text>
-
-      <box height={1} />
-
-      {/* OAuth providers list */}
-      <text fg={theme.primary}>Available OAuth Providers:</text>
-
-      <box flexDirection="column" gap={0} paddingLeft={2}>
-        {OAUTH_PROVIDERS.map((provider) => (
-          <box flexDirection="row" gap={1}>
-            <text fg={provider.enabled ? theme.success : theme.textMuted}>
-              {provider.enabled ? "[+]" : "[-]"} {provider.name}
-            </text>
-            <text fg={theme.textMuted}>- {provider.description}</text>
-          </box>
-        ))}
-      </box>
-
-      <box height={1} />
-
-      {/* Limitation message */}
-      <box border padding={1} borderColor={theme.warning}>
-        <text fg={theme.warning}>Terminal Limitations</text>
-      </box>
-
-      <box paddingLeft={1}>
-        {OAUTH_LIMITATION_MESSAGE.split("\n").map((line) => (
-          <text fg={theme.textMuted}>{line}</text>
-        ))}
-      </box>
-
-      <box height={1} />
-
-      {/* Alternative options */}
-      <text fg={theme.primary}>Recommended Alternatives:</text>
-
-      <box flexDirection="column" gap={0} paddingLeft={2}>
-        <box flexDirection="row" gap={1}>
-            <text fg={theme.success}>[1]</text>
-            <text fg={theme.text}>Use a sync code from the web portal</text>
-            <text fg={theme.success}>[2]</text>
-            <text fg={theme.text}>Use email/password authentication</text>
-            <text fg={theme.success}>[3]</text>
-            <text fg={theme.text}>Use file-based sync (no account needed)</text>
-        </box>
-      </box>
-
-      <box height={1} />
-
-      {/* Action buttons */}
-      <box flexDirection="row" gap={2}>
-        <box
-          border
-          padding={1}
-            backgroundColor={focusField() === "code" ? theme.backgroundElement : undefined}
-        >
-            <text fg={focusField() === "code" ? theme.primary : undefined}>
-            [C] Enter Sync Code
-          </text>
-        </box>
-
-        <box
-          border
-          padding={1}
-            backgroundColor={focusField() === "back" ? theme.backgroundElement : undefined}
-        >
-            <text fg={focusField() === "back" ? theme.warning : theme.textMuted}>
-            [Esc] Back to Login
-          </text>
-        </box>
-      </box>
-
-      <box height={1} />
-
-      <text fg={theme.textMuted}>Tab to navigate, Enter to select, Esc to go back</text>
-    </box>
-  );
-}

src/pages/Settings/PreferencesPanel.tsx

@@ -39,6 +39,19 @@ export function usePreferencesItems(): SettingItem[] {
 				app.setTheme(THEME_LABELS[next].value);
 			},
 		},
+		{
+			id: "transparentBackground",
+			label: "Transparent Background",
+			kind: "toggle",
+			display: () =>
+				settings().transparentBackground ? "On" : "Off",
+			help: () =>
+				`Let the terminal's own background show through (no app background fill).\nType: toggle\nDefault: false\nCurrent: ${settings().transparentBackground ? "On" : "Off"}\nSpace/Enter to toggle.`,
+			toggle: () =>
+				app.updateSettings({
+					transparentBackground: !settings().transparentBackground,
+				}),
+		},
 		{
 			id: "fontSize",
 			label: "Font Size",
@@ -90,5 +103,31 @@ export function usePreferencesItems(): SettingItem[] {
 					autoDownload: !prefs().autoDownload,
 				}),
 		},
+		{
+			id: "autoJumpToPlayer",
+			label: "Auto Jump to Player",
+			kind: "toggle",
+			display: () => (prefs().autoJumpToPlayer ? "On" : "Off"),
+			help: () =>
+				`Jump to the Player view automatically when a podcast starts.\nType: toggle\nDefault: true\nCurrent: ${prefs().autoJumpToPlayer ? "On" : "Off"}\nSpace/Enter to toggle.`,
+			toggle: () =>
+				app.updatePreferences({
+					autoJumpToPlayer: !prefs().autoJumpToPlayer,
+				}),
+		},
+		{
+			id: "fetchMore",
+			label: "Fetch More",
+			kind: "select",
+			display: () => (prefs().fetchMoreMode === "auto" ? "Auto" : "Manual"),
+			help: () =>
+				`How the Feed list loads older episodes.\nManual: a "[Fetch More]" button at the bottom of the list.\nAuto: fetches automatically when reaching the bottom.\nType: select\nDefault: manual\nCurrent: ${prefs().fetchMoreMode === "auto" ? "Auto" : "Manual"}\nCycle with j/k; Enter to apply.`,
+			cycle: (dir) => {
+				const modes: Array<"manual" | "auto"> = ["manual", "auto"];
+				const idx = modes.indexOf(prefs().fetchMoreMode ?? "manual");
+				const next = modes[(idx + dir + modes.length) % modes.length];
+				app.updatePreferences({ fetchMoreMode: next });
+			},
+		},
 	];
 }

src/pages/Settings/SettingsPage.tsx

@@ -5,9 +5,9 @@
  *   depth 1 — the focused section's items as a navigable list
  *   depth 2 — per-item editor (for editor-kind items) or value adjuster
  *
- * Renders entirely through `<YaziPaneRow>` (parent | current | preview):
+ * Renders entirely through `<PaneRow>` (parent | current | preview):
  *   parent  = previous depth's list (sections at depth 1, items at depth 2);
- *             blank placeholder at depth 0 (1/7 slot kept).
+ *             blank placeholder at depth 0 (1/5 slot kept).
  *   current = the current-depth list (or editor at depth 2); the only
  *             focusable column.
  *   preview = help/preview text for the hovered item in current.
@@ -18,7 +18,8 @@
  */
 
 import { For, Show, onMount, onCleanup, createMemo } from "solid-js";
-import { useTheme } from "@/context/ThemeContext";
+import { rgbToHex, type RGBA } from "@opentui/core";
+import { useTheme, type ThemeResolved } from "@/context/ThemeContext";
 import {
 	useNavigation,
 	NavMode,
@@ -32,8 +33,10 @@ import { usePreferencesItems } from "./PreferencesPanel";
 import { useVisualizerItems } from "./VisualizerSettings";
 import { useSyncItems, closeSyncEditor } from "./SyncPanel";
 import { useSourceItems } from "./SourceManager";
-import { YaziPaneRow } from "@/components/YaziPaneRow";
+import { useDownloadItems } from "./DownloadManager";
+import { PaneRow } from "@/components/PaneRow";
 import { TabListPane } from "@/components/TabPanel";
+import { useScrollIntoView } from "@/hooks/useScrollIntoView";
 
 export const SettingsPaneCount = 1;
 
@@ -60,13 +63,12 @@ const SECTIONS: SettingsSectionDef[] = [
 	},
 	{
 		id: 4,
-		label: "Account",
-		description: "Account login & OAuth (not yet implemented).",
+		label: "Downloads",
+		description: "Manage downloaded episodes — delete by show or individually.",
 	},
 ];
 
-/** Resolve the items for a section id at render time. Section 4 (Account) has
- *  no items yet. */
+/** Resolve the items for a section id at render time. */
 function sectionItems(sectionId: number): SettingItem[] {
 	switch (sectionId) {
 		case 0:
@@ -77,6 +79,8 @@ function sectionItems(sectionId: number): SettingItem[] {
 			return usePreferencesItems();
 		case 3:
 			return useVisualizerItems();
+		case 4:
+			return useDownloadItems();
 		default:
 			return [];
 	}
@@ -230,6 +234,15 @@ export function SettingsPage() {
 	// ── render helpers ───────────────────────────────────────────────────────
 	const isActive = () => nav.activePane() === DEPTH_CENTER_PANE;
 
+	// Whether the currently-focused settings row is the Theme select — the
+	// only item whose Detail pane carries a color breakdown below the help text.
+	const isThemeItem = () => {
+		const d = depth();
+		if (d === 1) return focusedItem()?.id === "theme";
+		if (d === 2) return editorItem()?.id === "theme";
+		return false;
+	};
+
 	// preview text for the right column
 	const previewText = createMemo<string>(() => {
 		const d = depth();
@@ -254,12 +267,6 @@ export function SettingsPage() {
 		if (d === 1) return sectionForDepth1()?.label ?? "Items";
 		return editorItem()?.label ?? "Editor";
 	};
-	const parentLabel = () => {
-		const d = depth();
-		if (d === 1) return "Sections";
-		if (d === 2) return sectionForDepth1()?.label ?? "";
-		return "Up";
-	};
 
 	// ── parent pane: previous-depth list (blank at depth 0) ────────────────
 	// Sibling <Show> blocks per depth (mirrors the preview pane) so Solid
@@ -278,7 +285,7 @@ export function SettingsPage() {
 				<For each={SECTIONS}>
 					{(section, index) => (
 						<Row
-							label={`${section.id + 1}. ${section.label}`}
+							label={section.label}
 							focused={index() === focusedSectionIdx()}
 							active={false}
 						/>
@@ -307,7 +314,7 @@ export function SettingsPage() {
 				<For each={SECTIONS}>
 					{(section, index) => (
 						<Row
-							label={`${section.id + 1}. ${section.label}`}
+							label={section.label}
 							focused={index() === focusedSectionIdx()}
 							active={isActive()}
 							onMouseDown={() => {
@@ -356,19 +363,22 @@ export function SettingsPage() {
 
 	// ── preview pane ──────────────────────────────────────────────────────────
 	const previewContent = () => (
-		<box padding={1}>
-			<MultiLine text={previewText()} />
+		<box padding={1} flexDirection="column">
+			{/* Keep everything on a stable root so Solid re-resolves the swap
+			    between plain help text and the theme breakdown on focus move. */}
+			<Show when={isThemeItem()} fallback={<MultiLine text={previewText()} />}>
+				<MultiLine text={previewText()} />
+				<ThemeBreakdown />
+			</Show>
 		</box>
 	);
 
 	return (
-		<YaziPaneRow
+		<PaneRow
 			parent={parentContent}
 			current={currentContent}
 			preview={previewContent}
-			parentLabel={parentLabel}
 			currentLabel={currentLabel}
-			previewLabel="Detail"
 			focused={isActive}
 		/>
 	);
@@ -406,9 +416,16 @@ function Row(props: {
 			: props.focused
 				? theme.border
 				: undefined;
-	const fg = () => (props.focused && props.active ? theme.surface : theme.text);
+	const fg = () =>
+		props.focused && props.active
+			? theme.surface
+			: props.focused
+				? theme.selectedListItemText ?? theme.text
+				: theme.text;
+	const ref = useScrollIntoView(() => props.focused);
 	return (
 		<box
+			ref={ref}
 			flexDirection="row"
 			gap={1}
 			paddingLeft={1}
@@ -458,6 +475,49 @@ function GenericEditor(props: { item: SettingItem }) {
 	);
 }
 
+/** Curated theme color roles shown in the Theme breakdown. */
+const THEME_ROLES: Array<{ key: keyof ThemeResolved; label: string }> = [
+	{ key: "primary", label: "Primary" },
+	{ key: "secondary", label: "Secondary" },
+	{ key: "accent", label: "Accent" },
+	{ key: "text", label: "Text" },
+	{ key: "textMuted", label: "Muted" },
+	{ key: "background", label: "Background" },
+	{ key: "surface", label: "Surface" },
+	{ key: "border", label: "Border" },
+	{ key: "error", label: "Error" },
+	{ key: "warning", label: "Warning" },
+	{ key: "success", label: "Success" },
+	{ key: "info", label: "Info" },
+];
+
+/** Color swatch breakdown (‹block› <Label> (<HEX>)) of the resolved theme. */
+function ThemeBreakdown() {
+	const { theme, selected } = useTheme();
+	return (
+		<box flexDirection="column" paddingTop={1} gap={1}>
+			<text fg={theme.accent}>Theme · {selected}</text>
+			<For each={THEME_ROLES}>
+				{(role) => {
+					const color = theme[role.key] as RGBA | undefined;
+					return (
+						<box flexDirection="row" gap={1} alignItems="center">
+							<box backgroundColor={color}>
+								<text>{"  "}</text>
+							</box>
+							<text fg={theme.text}>{role.label}</text>
+							<box flexGrow={1} />
+							<text fg={theme.textMuted}>
+								{color ? rgbToHex(color).toUpperCase() : "n/a"}
+							</text>
+						</box>
+					);
+				}}
+			</For>
+		</box>
+	);
+}
+
 /** Renders a string with `\n` newlines as stacked <text> lines. */
 function MultiLine(props: { text: string }) {
 	const lines = () => props.text.split("\n");

src/pages/Settings/SourceManager.tsx

@@ -14,6 +14,7 @@
 import { createSignal, For, Show } from "solid-js";
 import { useFeedStore } from "@/stores/feed";
 import { useTheme } from "@/context/ThemeContext";
+import { useInputFocusNav } from "@/hooks/useInputFocusNav";
 import { SourceType } from "@/types/source";
 import type { PodcastSource } from "@/types/source";
 import type { SettingItem } from "./types";
@@ -61,6 +62,9 @@ function AddSourceForm() {
 	const [name, setName] = createSignal("");
 	const [url, setUrl] = createSignal("");
 	const [error, setError] = createSignal<string | null>(null);
+	// Yield navigation keybinds to the Shell router while either input is focused.
+	const nameRef = useInputFocusNav();
+	const urlRef = useInputFocusNav();
 
 	const submit = () => {
 		const u = url().trim();
@@ -94,6 +98,7 @@ function AddSourceForm() {
 			<box flexDirection="row" gap={1}>
 				<text fg={theme.textMuted}>Name:</text>
 				<input
+					ref={nameRef}
 					value={name()}
 					onInput={setName}
 					placeholder="My Custom Feed"
@@ -103,6 +108,7 @@ function AddSourceForm() {
 			<box flexDirection="row" gap={1}>
 				<text fg={theme.textMuted}>URL:</text>
 				<input
+					ref={urlRef}
 					value={url()}
 					onInput={(v) => {
 						setUrl(v);

src/pages/Settings/SyncPanel.tsx

@@ -3,21 +3,13 @@
  * Export dialogs render as depth-2 editors. No own useKeyboard.
  */
 
-import { createSignal } from "solid-js";
 import { ImportDialog } from "./ImportDialog";
 import { ExportDialog } from "./ExportDialog";
-import { SyncStatus } from "./SyncStatus";
 import type { SettingItem } from "./types";
 
-// Module-level state so the action items can open their dialogs as depth-2
-// editors. The SettingsPage reads `syncEditor()` to decide which dialog to show.
-const [syncEditor, setSyncEditor] = createSignal<"import" | "export" | null>(
-	null,
-);
-export { syncEditor };
-export function closeSyncEditor() {
-	setSyncEditor(null);
-}
+// closeSyncEditor kept for SettingsPage's cleanup hook; its backing state
+// (the syncEditor signal) was removed as dead — nothing ever read it.
+export function closeSyncEditor() {}
 
 export function useSyncItems(): SettingItem[] {
 	return [
@@ -49,9 +41,3 @@ export function useSyncItems(): SettingItem[] {
 		},
 	];
 }
-
-/** Renders the live sync status block (used by the Settings page header for the
- *  Sync section, when relevant). */
-export function SyncStatusBlock() {
-	return <SyncStatus />;
-}

src/pages/Settings/SyncProfile.tsx

@@ -1,157 +0,0 @@
-/**
- * Sync profile component for PodTUI
- * Displays user profile information and sync status
- */
-
-import { createSignal } from "solid-js";
-import { useAuthStore } from "@/stores/auth";
-import { format } from "date-fns";
-import { useTheme } from "@/context/ThemeContext";
-
-interface SyncProfileProps {
-  focused?: boolean;
-  onLogout?: () => void;
-  onManageSync?: () => void;
-}
-
-type FocusField = "sync" | "export" | "logout";
-
-export function SyncProfile(props: SyncProfileProps) {
-  const auth = useAuthStore();
-  const { theme } = useTheme();
-  const [focusField, setFocusField] = createSignal<FocusField>("sync");
-  const [lastSyncTime] = createSignal<Date | null>(new Date());
-
-  const fields: FocusField[] = ["sync", "export", "logout"];
-
-  const handleKeyPress = (key: { name: string; shift?: boolean }) => {
-    if (key.name === "tab") {
-      const currentIndex = fields.indexOf(focusField());
-      const nextIndex = key.shift
-        ? (currentIndex - 1 + fields.length) % fields.length
-        : (currentIndex + 1) % fields.length;
-      setFocusField(fields[nextIndex]);
-    } else if (key.name === "return") {
-      if (focusField() === "sync" && props.onManageSync) {
-        props.onManageSync();
-      } else if (focusField() === "logout" && props.onLogout) {
-        handleLogout();
-      }
-    }
-  };
-
-  const handleLogout = () => {
-    auth.logout();
-    if (props.onLogout) {
-      props.onLogout();
-    }
-  };
-
-  const formatDate = (date: Date | null | undefined): string => {
-    if (!date) return "Never";
-    return format(date, "MMM d, yyyy HH:mm");
-  };
-
-  const user = () => auth.state().user;
-
-  // Get user initials for avatar
-  const userInitials = () => {
-    const name = user()?.name || "?";
-    return name.slice(0, 2).toUpperCase();
-  };
-
-  return (
-    <box flexDirection="column" border padding={2} gap={1} borderColor={theme.border}>
-      <text fg={theme.text}>
-        <strong>User Profile</strong>
-      </text>
-
-      <box height={1} />
-
-      {/* User avatar and info */}
-      <box flexDirection="row" gap={2}>
-        {/* ASCII avatar */}
-        <box
-          border
-          padding={1}
-          width={8}
-          height={4}
-          justifyContent="center"
-          alignItems="center"
-        >
-          <text fg={theme.primary}>{userInitials()}</text>
-        </box>
-
-        {/* User details */}
-        <box flexDirection="column" gap={0}>
-            <text fg={theme.text}>{user()?.name || "Guest User"}</text>
-            <text fg={theme.textMuted}>{user()?.email || "No email"}</text>
-            <text fg={theme.textMuted}>Joined: {formatDate(user()?.createdAt)}</text>
-        </box>
-      </box>
-
-      <box height={1} />
-
-      {/* Sync status section */}
-      <box border padding={1} flexDirection="column" gap={0} borderColor={theme.border}>
-        <text fg={theme.primary}>Sync Status</text>
-
-        <box flexDirection="row" gap={1}>
-            <text fg={theme.textMuted}>Status:</text>
-            <text fg={user()?.syncEnabled ? theme.success : theme.warning}>
-              {user()?.syncEnabled ? "Enabled" : "Disabled"}
-            </text>
-        </box>
-
-        <box flexDirection="row" gap={1}>
-            <text fg={theme.textMuted}>Last Sync:</text>
-            <text fg={theme.text}>{formatDate(lastSyncTime())}</text>
-        </box>
-
-        <box flexDirection="row" gap={1}>
-            <text fg={theme.textMuted}>Method:</text>
-            <text fg={theme.text}>File-based (JSON/XML)</text>
-        </box>
-      </box>
-
-      <box height={1} />
-
-      {/* Action buttons */}
-      <box flexDirection="row" gap={2}>
-        <box
-          border
-          padding={1}
-            backgroundColor={focusField() === "sync" ? theme.backgroundElement : undefined}
-        >
-            <text fg={focusField() === "sync" ? theme.primary : undefined}>
-            [S] Manage Sync
-          </text>
-        </box>
-
-        <box
-          border
-          padding={1}
-            backgroundColor={focusField() === "export" ? theme.backgroundElement : undefined}
-        >
-            <text fg={focusField() === "export" ? theme.primary : undefined}>
-            [E] Export Data
-          </text>
-        </box>
-
-        <box
-          border
-          padding={1}
-            backgroundColor={focusField() === "logout" ? theme.backgroundElement : undefined}
-        >
-            <text fg={focusField() === "logout" ? theme.error : theme.textMuted}>
-            [L] Logout
-          </text>
-        </box>
-      </box>
-
-      <box height={1} />
-
-      <text fg={theme.textMuted}>Tab to navigate, Enter to select</text>
-    </box>
-  );
-}

src/stores/app.ts

@@ -1,130 +1,133 @@
 import { createSignal } from "solid-js";
 import { DEFAULT_THEME, THEME_JSON } from "../constants/themes";
 import type {
-  AppSettings,
-  AppState,
-  ThemeColors,
-  ThemeName,
-  ThemeMode,
-  UserPreferences,
-  VisualizerSettings,
+	AppSettings,
+	AppState,
+	ThemeColors,
+	ThemeName,
+	ThemeMode,
+	UserPreferences,
+	VisualizerSettings,
 } from "../types/settings";
 import { resolveTheme } from "../utils/theme-resolver";
 import type { ThemeJson } from "../types/theme-schema";
 import {
-  loadAppStateFromFile,
-  saveAppStateToFile,
+	loadAppStateFromFile,
+	saveAppStateToFile,
 } from "../utils/app-persistence";
 
 const defaultVisualizerSettings: VisualizerSettings = {
-  bars: 32,
-  sensitivity: 1,
-  noiseReduction: 0.77,
-  lowCutOff: 50,
-  highCutOff: 10000,
+	bars: 64,
+	sensitivity: 1,
+	noiseReduction: 0.77,
+	lowCutOff: 50,
+	highCutOff: 10000,
 };
 
 const defaultSettings: AppSettings = {
-  theme: "system",
-  fontSize: 14,
-  playbackSpeed: 1,
-  downloadPath: "",
-  visualizer: defaultVisualizerSettings,
+	theme: "system",
+	fontSize: 14,
+	playbackSpeed: 1,
+	downloadPath: "",
+	transparentBackground: false,
+	visualizer: defaultVisualizerSettings,
 };
 
 const defaultPreferences: UserPreferences = {
-  showExplicit: false,
-  autoDownload: false,
+	showExplicit: false,
+	autoDownload: false,
+	autoJumpToPlayer: true,
+	fetchMoreMode: "manual",
 };
 
 const defaultState: AppState = {
-  settings: defaultSettings,
-  preferences: defaultPreferences,
-  customTheme: DEFAULT_THEME,
+	settings: defaultSettings,
+	preferences: defaultPreferences,
+	customTheme: DEFAULT_THEME,
 };
 
-export function createAppStore() {
-  // Start with defaults; async load will update once ready
-  const [state, setState] = createSignal<AppState>(defaultState);
+function createAppStore() {
+	// Start with defaults; async load will update once ready
+	const [state, setState] = createSignal<AppState>(defaultState);
 
-  // Fire-and-forget async initialisation
-  const init = async () => {
-    const loaded = await loadAppStateFromFile();
-    setState(loaded);
-  };
-  init();
+	// Fire-and-forget async initialisation
+	const init = async () => {
+		const loaded = await loadAppStateFromFile();
+		setState(loaded);
+	};
+	init();
 
-  const saveState = (next: AppState) => {
-    saveAppStateToFile(next).catch(() => {});
-  };
+	const saveState = (next: AppState) => {
+		saveAppStateToFile(next);
+	};
 
-  const updateState = (next: AppState) => {
-    setState(next);
-    saveState(next);
-  };
+	const updateState = (next: AppState) => {
+		setState(next);
+		saveState(next);
+	};
 
-  const updateSettings = (updates: Partial<AppSettings>) => {
-    const next = {
-      ...state(),
-      settings: { ...state().settings, ...updates },
-    };
-    updateState(next);
-  };
+	const updateSettings = (updates: Partial<AppSettings>) => {
+		const next = {
+			...state(),
+			settings: { ...state().settings, ...updates },
+		};
+		updateState(next);
+	};
 
-  const updatePreferences = (updates: Partial<UserPreferences>) => {
-    const next = {
-      ...state(),
-      preferences: { ...state().preferences, ...updates },
-    };
-    updateState(next);
-  };
+	const updatePreferences = (updates: Partial<UserPreferences>) => {
+		const next = {
+			...state(),
+			preferences: { ...state().preferences, ...updates },
+		};
+		updateState(next);
+	};
 
-  const updateCustomTheme = (updates: Partial<ThemeColors>) => {
-    const next = {
-      ...state(),
-      customTheme: { ...state().customTheme, ...updates },
-    };
-    updateState(next);
-  };
+	const updateCustomTheme = (updates: Partial<ThemeColors>) => {
+		const next = {
+			...state(),
+			customTheme: { ...state().customTheme, ...updates },
+		};
+		updateState(next);
+	};
 
-  const updateVisualizer = (updates: Partial<VisualizerSettings>) => {
-    updateSettings({
-      visualizer: { ...state().settings.visualizer, ...updates },
-    });
-  };
+	const updateVisualizer = (updates: Partial<VisualizerSettings>) => {
+		updateSettings({
+			visualizer: { ...state().settings.visualizer, ...updates },
+		});
+	};
 
-  const setTheme = (theme: ThemeName) => {
-    updateSettings({ theme });
-  };
+	const setTheme = (theme: ThemeName) => {
+		updateSettings({ theme });
+	};
 
-  const resolveThemeColors = (): ThemeColors => {
-    const theme = state().settings.theme;
-    if (theme === "custom") return state().customTheme;
-    if (theme === "system") return DEFAULT_THEME;
-    const json = THEME_JSON[theme];
-    if (!json) return DEFAULT_THEME;
-    return resolveTheme(
-      json as ThemeJson,
-      "dark" as ThemeMode,
-    ) as unknown as ThemeColors;
-  };
+	const resolveThemeColors = (): ThemeColors => {
+		const theme = state().settings.theme;
+		if (theme === "custom") return state().customTheme;
+		if (theme === "system") return DEFAULT_THEME;
+		const json = THEME_JSON[theme];
+		if (!json) return DEFAULT_THEME;
+		return resolveTheme(
+			json as ThemeJson,
+			"dark" as ThemeMode,
+		) as unknown as ThemeColors;
+	};
 
-  return {
-    state,
-    updateSettings,
-    updatePreferences,
-    updateCustomTheme,
-    updateVisualizer,
-    setTheme,
-    resolveTheme: resolveThemeColors,
-  };
+	return {
+		state,
+		updateSettings,
+		updatePreferences,
+		updateCustomTheme,
+		updateVisualizer,
+		setTheme,
+		resolveTheme: resolveThemeColors,
+	};
 }
 
 let appStoreInstance: ReturnType<typeof createAppStore> | null = null;
 
 export function useAppStore() {
-  if (!appStoreInstance) {
-    appStoreInstance = createAppStore();
-  }
-  return appStoreInstance;
+	if (!appStoreInstance) {
+		appStoreInstance = createAppStore();
+	}
+	return appStoreInstance;
 }

src/stores/audio-nav.ts

@@ -5,122 +5,122 @@
 
 import { createSignal } from "solid-js";
 import {
-  loadAudioNavFromFile,
-  saveAudioNavToFile,
+	loadAudioNavFromFile,
+	saveAudioNavToFile,
 } from "../utils/app-persistence";
 
 /** Source type for audio navigation */
 export enum AudioSource {
-  FEED = "feed",
-  MY_SHOWS = "my_shows",
-  SEARCH = "search",
+	FEED = "feed",
+	MY_SHOWS = "my_shows",
+	SEARCH = "search",
 }
 
 /** Audio navigation state */
 export interface AudioNavState {
-  /** Current source type */
-  source: AudioSource;
-  /** Index of current episode in the ordered list */
-  currentIndex: number;
-  /** Podcast ID for My Shows source */
-  podcastId?: string;
-  /** Timestamp when navigation state was last saved */
-  lastUpdated: Date;
+	/** Current source type */
+	source: AudioSource;
+	/** Index of current episode in the ordered list */
+	currentIndex: number;
+	/** Podcast ID for My Shows source */
+	podcastId?: string;
+	/** Timestamp when navigation state was last saved */
+	lastUpdated: Date;
 }
 
 /** Default navigation state */
 const defaultNavState: AudioNavState = {
-  source: AudioSource.FEED,
-  currentIndex: 0,
-  lastUpdated: new Date(),
+	source: AudioSource.FEED,
+	currentIndex: 0,
+	lastUpdated: new Date(),
 };
 
 /** Create audio navigation store */
-export function createAudioNavStore() {
-  const [navState, setNavState] = createSignal<AudioNavState>(defaultNavState);
+function createAudioNavStore() {
+	const [navState, setNavState] = createSignal<AudioNavState>(defaultNavState);
 
-  /** Persist current navigation state to file (fire-and-forget) */
-  function persist(): void {
-    saveAudioNavToFile(navState()).catch(() => {});
-  }
+	/** Persist current navigation state to file (fire-and-forget) */
+	function persist(): void {
+		saveAudioNavToFile(navState());
+	}
 
-  /** Load navigation state from file */
-  async function init(): Promise<void> {
-    const loaded = await loadAudioNavFromFile<AudioNavState>();
-    if (loaded) {
-      setNavState(loaded);
-    }
-  }
+	/** Load navigation state from file */
+	async function init(): Promise<void> {
+		const loaded = await loadAudioNavFromFile<AudioNavState>();
+		if (loaded) {
+			setNavState(loaded);
+		}
+	}
 
-  /** Fire-and-forget initialization */
-  init();
+	/** Fire-and-forget initialization */
+	init();
 
-  return {
-    /** Get current navigation state */
-    get state(): AudioNavState {
-      return navState();
-    },
+	return {
+		/** Get current navigation state */
+		get state(): AudioNavState {
+			return navState();
+		},
 
-    /** Update source type */
-    setSource: (source: AudioSource, podcastId?: string) => {
-      setNavState((prev) => ({
-        ...prev,
-        source,
-        podcastId,
-        lastUpdated: new Date(),
-      }));
-      persist();
-    },
+		/** Update source type */
+		setSource: (source: AudioSource, podcastId?: string) => {
+			setNavState((prev) => ({
+				...prev,
+				source,
+				podcastId,
+				lastUpdated: new Date(),
+			}));
+			persist();
+		},
 
-    /** Move to next episode */
-    next: (currentIndex: number) => {
-      setNavState((prev) => ({
-        ...prev,
-        currentIndex,
-        lastUpdated: new Date(),
-      }));
-      persist();
-    },
+		/** Move to next episode */
+		next: (currentIndex: number) => {
+			setNavState((prev) => ({
+				...prev,
+				currentIndex,
+				lastUpdated: new Date(),
+			}));
+			persist();
+		},
 
-    /** Move to previous episode */
-    prev: (currentIndex: number) => {
-      setNavState((prev) => ({
-        ...prev,
-        currentIndex,
-        lastUpdated: new Date(),
-      }));
-      persist();
-    },
+		/** Move to previous episode */
+		prev: (currentIndex: number) => {
+			setNavState((prev) => ({
+				...prev,
+				currentIndex,
+				lastUpdated: new Date(),
+			}));
+			persist();
+		},
 
-    /** Reset to default state */
-    reset: () => {
-      setNavState(defaultNavState);
-      persist();
-    },
+		/** Reset to default state */
+		reset: () => {
+			setNavState(defaultNavState);
+			persist();
+		},
 
-    /** Get current index */
-    getCurrentIndex: (): number => {
-      return navState().currentIndex;
-    },
+		/** Get current index */
+		getCurrentIndex: (): number => {
+			return navState().currentIndex;
+		},
 
-    /** Get current source */
-    getSource: (): AudioSource => {
-      return navState().source;
-    },
+		/** Get current source */
+		getSource: (): AudioSource => {
+			return navState().source;
+		},
 
-    /** Get current podcast ID */
-    getPodcastId: (): string | undefined => {
-      return navState().podcastId;
-    },
-  };
+		/** Get current podcast ID */
+		getPodcastId: (): string | undefined => {
+			return navState().podcastId;
+		},
+	};
 }
 
 /** Singleton instance */
 let audioNavInstance: ReturnType<typeof createAudioNavStore> | null = null;
 
 export function useAudioNavStore() {
-  if (!audioNavInstance) {
-    audioNavInstance = createAudioNavStore();
-  }
-  return audioNavInstance;
+	if (!audioNavInstance) {
+		audioNavInstance = createAudioNavStore();
+	}
+	return audioNavInstance;
 }

src/stores/auth.ts

@@ -1,244 +0,0 @@
-/**
- * Authentication store for PodTUI
- * Uses Zustand for state management with localStorage persistence
- * Authentication is DISABLED by default
- */
-
-import { createSignal } from "solid-js"
-import type {
-  User,
-  AuthState,
-  AuthError,
-  AuthErrorCode,
-  LoginCredentials,
-  AuthScreen,
-} from "../types/auth"
-import { AUTH_CONFIG, DEFAULT_AUTH_ENABLED } from "../config/auth"
-
-/** Initial auth state */
-const initialState: AuthState = {
-  user: null,
-  isAuthenticated: false,
-  isLoading: false,
-  error: null,
-}
-
-/** Load auth state from localStorage */
-function loadAuthState(): AuthState {
-  if (typeof localStorage === "undefined") {
-    return initialState
-  }
-
-  try {
-    const stored = localStorage.getItem(AUTH_CONFIG.storage.authState)
-    if (stored) {
-      const parsed = JSON.parse(stored)
-      // Convert date strings back to Date objects
-      if (parsed.user?.createdAt) {
-        parsed.user.createdAt = new Date(parsed.user.createdAt)
-      }
-      if (parsed.user?.lastLoginAt) {
-        parsed.user.lastLoginAt = new Date(parsed.user.lastLoginAt)
-      }
-      return parsed
-    }
-  } catch {
-    // Ignore parse errors, use initial state
-  }
-
-  return initialState
-}
-
-/** Save auth state to localStorage */
-function saveAuthState(state: AuthState): void {
-  if (typeof localStorage === "undefined") {
-    return
-  }
-
-  try {
-    localStorage.setItem(AUTH_CONFIG.storage.authState, JSON.stringify(state))
-  } catch {
-    // Ignore storage errors
-  }
-}
-
-/** Create auth store using Solid signals */
-export function createAuthStore() {
-  const [state, setState] = createSignal<AuthState>(loadAuthState())
-  const [authEnabled, setAuthEnabled] = createSignal(DEFAULT_AUTH_ENABLED)
-  const [currentScreen, setCurrentScreen] = createSignal<AuthScreen>("login")
-
-  /** Update state and persist */
-  const updateState = (updates: Partial<AuthState>) => {
-    setState((prev) => {
-      const next = { ...prev, ...updates }
-      saveAuthState(next)
-      return next
-    })
-  }
-
-  /** Login with email/password (placeholder - no real backend) */
-  const login = async (credentials: LoginCredentials): Promise<boolean> => {
-    updateState({ isLoading: true, error: null })
-
-    // Simulate network delay
-    await new Promise((r) => setTimeout(r, 500))
-
-    // Validate email format
-    if (!AUTH_CONFIG.email.pattern.test(credentials.email)) {
-      updateState({
-        isLoading: false,
-        error: {
-          code: "INVALID_CREDENTIALS" as AuthErrorCode,
-          message: "Invalid email format",
-        },
-      })
-      return false
-    }
-
-    // Validate password length
-    if (credentials.password.length < AUTH_CONFIG.password.minLength) {
-      updateState({
-        isLoading: false,
-        error: {
-          code: "INVALID_CREDENTIALS" as AuthErrorCode,
-          message: `Password must be at least ${AUTH_CONFIG.password.minLength} characters`,
-        },
-      })
-      return false
-    }
-
-    // Create mock user (in real app, this would validate against backend)
-    const user: User = {
-      id: crypto.randomUUID(),
-      email: credentials.email,
-      name: credentials.email.split("@")[0],
-      createdAt: new Date(),
-      lastLoginAt: new Date(),
-      syncEnabled: true,
-    }
-
-    updateState({
-      user,
-      isAuthenticated: true,
-      isLoading: false,
-      error: null,
-    })
-
-    return true
-  }
-
-  /** Logout and clear state */
-  const logout = () => {
-    updateState({
-      user: null,
-      isAuthenticated: false,
-      isLoading: false,
-      error: null,
-    })
-    setCurrentScreen("login")
-  }
-
-  /** Validate 8-character code */
-  const validateCode = async (code: string): Promise<boolean> => {
-    updateState({ isLoading: true, error: null })
-
-    // Simulate network delay
-    await new Promise((r) => setTimeout(r, 500))
-
-    const normalizedCode = code.toUpperCase().replace(/[^A-Z0-9]/g, "")
-
-    // Check code length
-    if (normalizedCode.length !== AUTH_CONFIG.codeValidation.codeLength) {
-      updateState({
-        isLoading: false,
-        error: {
-          code: "INVALID_CODE" as AuthErrorCode,
-          message: `Code must be ${AUTH_CONFIG.codeValidation.codeLength} characters`,
-        },
-      })
-      return false
-    }
-
-    // Check code format
-    if (!AUTH_CONFIG.codeValidation.allowedChars.test(normalizedCode)) {
-      updateState({
-        isLoading: false,
-        error: {
-          code: "INVALID_CODE" as AuthErrorCode,
-          message: "Code must contain only letters and numbers",
-        },
-      })
-      return false
-    }
-
-    // Mock successful code validation
-    const user: User = {
-      id: crypto.randomUUID(),
-      email: `sync-${normalizedCode.toLowerCase()}@podtui.local`,
-      name: `Sync User (${normalizedCode.slice(0, 4)})`,
-      createdAt: new Date(),
-      lastLoginAt: new Date(),
-      syncEnabled: true,
-    }
-
-    updateState({
-      user,
-      isAuthenticated: true,
-      isLoading: false,
-      error: null,
-    })
-
-    return true
-  }
-
-  /** Clear error */
-  const clearError = () => {
-    updateState({ error: null })
-  }
-
-  /** Enable/disable auth */
-  const toggleAuthEnabled = () => {
-    setAuthEnabled((prev) => !prev)
-  }
-
-  return {
-    // State accessors (signals)
-    state,
-    authEnabled,
-    currentScreen,
-
-    // Actions
-    login,
-    logout,
-    validateCode,
-    clearError,
-    setCurrentScreen,
-    toggleAuthEnabled,
-
-    // Computed
-    get user() {
-      return state().user
-    },
-    get isAuthenticated() {
-      return state().isAuthenticated
-    },
-    get isLoading() {
-      return state().isLoading
-    },
-    get error() {
-      return state().error
-    },
-  }
-}
-
-/** Singleton auth store instance */
-let authStoreInstance: ReturnType<typeof createAuthStore> | null = null
-
-/** Get or create auth store */
-export function useAuthStore() {
-  if (!authStoreInstance) {
-    authStoreInstance = createAuthStore()
-  }
-  return authStoreInstance
-}

src/stores/discover.ts

@@ -1,215 +1,218 @@
 /**
  * Discover store for PodTUI
- * Manages trending/popular podcasts and category filtering
+ * Manages trending/popular podcasts and category filtering.
+ *
+ * The featured-shows list is fetched at runtime from a JSON file hosted in the
+ * GitHub repo (discover/featured.json on the `master` branch), so the list
+ * can be updated without shipping a new release. The feed URL, de-duped set,
+ * and version field act as the cache key — a fresh fetch only happens when the
+ * version bumps or the cache window (24h) expires.
  */
 
-import { createSignal } from "solid-js"
-import type { Podcast } from "../types/podcast"
+import { createSignal } from "solid-js";
+import type { Podcast } from "../types/podcast";
+import { useFeedStore } from "./feed";
 
 export interface DiscoverCategory {
-  id: string
-  name: string
-  icon: string
+	id: string;
+	name: string;
+	icon: string;
 }
 
 export const DISCOVER_CATEGORIES: DiscoverCategory[] = [
-  { id: "all", name: "All", icon: "*" },
-  { id: "technology", name: "Technology", icon: ">" },
-  { id: "science", name: "Science", icon: "~" },
-  { id: "comedy", name: "Comedy", icon: ")" },
-  { id: "news", name: "News", icon: "!" },
-  { id: "business", name: "Business", icon: "$" },
-  { id: "health", name: "Health", icon: "+" },
-  { id: "education", name: "Education", icon: "?" },
-  { id: "sports", name: "Sports", icon: "#" },
-  { id: "true-crime", name: "True Crime", icon: "%" },
-  { id: "arts", name: "Arts", icon: "@" },
-]
+	{ id: "all", name: "All", icon: "*" },
+	{ id: "technology", name: "Technology", icon: ">" },
+	{ id: "science", name: "Science", icon: "~" },
+	{ id: "comedy", name: "Comedy", icon: ")" },
+	{ id: "news", name: "News", icon: "!" },
+	{ id: "business", name: "Business", icon: "$" },
+	{ id: "health", name: "Health", icon: "+" },
+	{ id: "education", name: "Education", icon: "?" },
+	{ id: "sports", name: "Sports", icon: "#" },
+	{ id: "true-crime", name: "True Crime", icon: "%" },
+	{ id: "arts", name: "Arts", icon: "@" },
+];
 
-/** Mock trending podcasts */
-const TRENDING_PODCASTS: Podcast[] = [
-  {
-    id: "trend-1",
-    title: "AI Today",
-    description: "The latest developments in artificial intelligence, machine learning, and their impact on society.",
-    feedUrl: "https://example.com/aitoday.rss",
-    author: "Tech Futures",
-    categories: ["Technology", "Science"],
-    coverUrl: undefined,
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  },
-  {
-    id: "trend-2",
-    title: "The History Hour",
-    description: "Fascinating stories from history that shaped our world today.",
-    feedUrl: "https://example.com/historyhour.rss",
-    author: "History Channel",
-    categories: ["Education", "History"],
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  },
-  {
-    id: "trend-3",
-    title: "Comedy Gold",
-    description: "Weekly stand-up comedy, sketches, and hilarious conversations.",
-    feedUrl: "https://example.com/comedygold.rss",
-    author: "Laugh Factory",
-    categories: ["Comedy", "Entertainment"],
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  },
-  {
-    id: "trend-4",
-    title: "Market Watch",
-    description: "Daily financial news, stock analysis, and investing tips.",
-    feedUrl: "https://example.com/marketwatch.rss",
-    author: "Finance Daily",
-    categories: ["Business", "News"],
-    lastUpdated: new Date(),
-    isSubscribed: true,
-  },
-  {
-    id: "trend-5",
-    title: "Science Weekly",
-    description: "Breaking science news and in-depth analysis of the latest research.",
-    feedUrl: "https://example.com/scienceweekly.rss",
-    author: "Science Network",
-    categories: ["Science", "Education"],
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  },
-  {
-    id: "trend-6",
-    title: "True Crime Files",
-    description: "Investigative journalism into real criminal cases and unsolved mysteries.",
-    feedUrl: "https://example.com/truecrime.rss",
-    author: "Crime Network",
-    categories: ["True Crime", "Documentary"],
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  },
-  {
-    id: "trend-7",
-    title: "Wellness Journey",
-    description: "Tips for mental and physical health, meditation, and mindful living.",
-    feedUrl: "https://example.com/wellness.rss",
-    author: "Health Media",
-    categories: ["Health", "Self-Help"],
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  },
-  {
-    id: "trend-8",
-    title: "Sports Talk Live",
-    description: "Live commentary, analysis, and interviews from the world of sports.",
-    feedUrl: "https://example.com/sportstalk.rss",
-    author: "Sports Network",
-    categories: ["Sports", "News"],
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  },
-  {
-    id: "trend-9",
-    title: "Creative Minds",
-    description: "Interviews with artists, designers, and creative professionals.",
-    feedUrl: "https://example.com/creativeminds.rss",
-    author: "Arts Weekly",
-    categories: ["Arts", "Culture"],
-    lastUpdated: new Date(),
-    isSubscribed: false,
-  },
-  {
-    id: "trend-10",
-    title: "Dev Talk",
-    description: "Software development, programming tutorials, and tech career advice.",
-    feedUrl: "https://example.com/devtalk.rss",
-    author: "Code Academy",
-    categories: ["Technology", "Education"],
-    lastUpdated: new Date(),
-    isSubscribed: true,
-  },
-]
+// ── Remote featured-shows manifest ───────────────────────────────────────────
+// The raw GitHub URL serving discover/featured.json from the master branch.
+// Update this file in the repo (no release needed) to refresh the list.
+const FEATURED_JSON_URL =
+	"https://raw.githubusercontent.com/mikefreno/PodTui/master/discover/featured.json";
+
+/** Cache window for the remote featured list (24 hours) */
+const FEATURED_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+
+/** Shape of a single entry in the remote JSON */
+interface FeaturedEntry {
+	id: string;
+	title: string;
+	description: string;
+	feedUrl: string;
+	author?: string;
+	categories?: string[];
+}
+
+/** Shape of the remote JSON manifest */
+interface FeaturedManifest {
+	version: number;
+	podcasts: FeaturedEntry[];
+}
+
+/** Convert a JSON entry to a runtime Podcast (adding derived fields) */
+function entryToPodcast(entry: FeaturedEntry): Podcast {
+	return {
+		id: entry.id,
+		title: entry.title,
+		description: entry.description,
+		feedUrl: entry.feedUrl,
+		author: entry.author,
+		categories: entry.categories ?? [],
+		coverUrl: undefined,
+		lastUpdated: new Date(),
+		isSubscribed: false,
+	};
+}
+
+/** Reconcile isSubscribed state across the discover list against the feed store */
+function syncSubscriptionState(
+	podcasts: Podcast[],
+	subscribedUrls: Set<string>,
+	subscribedIds: Set<string>,
+): Podcast[] {
+	return podcasts.map((p) => ({
+		...p,
+		isSubscribed: subscribedUrls.has(p.feedUrl) || subscribedIds.has(p.id),
+	}));
+}
 
 /** Create discover store */
 export function createDiscoverStore() {
-  const [selectedCategory, setSelectedCategory] = createSignal<string>("all")
-  const [isLoading, setIsLoading] = createSignal(false)
-  const [podcasts, setPodcasts] = createSignal<Podcast[]>(TRENDING_PODCASTS)
+	const [selectedCategory, setSelectedCategory] = createSignal<string>("all");
+	const [isLoading, setIsLoading] = createSignal(false);
+	const [podcasts, setPodcasts] = createSignal<Podcast[]>([]);
 
-  /** Get filtered podcasts by category */
-  const filteredPodcasts = () => {
-    const category = selectedCategory()
-    if (category === "all") {
-      return podcasts()
-    }
+	// In-memory cache timestamp for the remote manifest (within 24h, skip refetch)
+	let cachedAt = 0;
 
-    return podcasts().filter((p) => {
-      const cats = p.categories?.map((c) => c.toLowerCase()) ?? []
-      return cats.some((c) => c.includes(category.toLowerCase().replace("-", " ")))
-    })
-  }
+	/** Reconcile local isSubscribed flags with the feed store */
+	const syncSubscriptions = () => {
+		const feedStore = useFeedStore();
+		const feeds = feedStore.feeds();
+		const urls = new Set(feeds.map((f) => f.podcast.feedUrl));
+		const ids = new Set(feeds.map((f) => f.podcast.id));
+		setPodcasts((prev) => syncSubscriptionState(prev, urls, ids));
+	};
 
-  /** Subscribe to a podcast */
-  const subscribe = (podcastId: string) => {
-    setPodcasts((prev) =>
-      prev.map((p) =>
-        p.id === podcastId ? { ...p, isSubscribed: true } : p
-      )
-    )
-  }
+	/** Fetch the featured-shows manifest from GitHub if stale */
+	const refresh = async () => {
+		setIsLoading(true);
+		try {
+			// Skip if cache is still fresh
+			const now = Date.now();
+			if (now - cachedAt < FEATURED_CACHE_TTL_MS) {
+				syncSubscriptions();
+				return;
+			}
 
-  /** Unsubscribe from a podcast */
-  const unsubscribe = (podcastId: string) => {
-    setPodcasts((prev) =>
-      prev.map((p) =>
-        p.id === podcastId ? { ...p, isSubscribed: false } : p
-      )
-    )
-  }
+			const resp = await fetch(FEATURED_JSON_URL, {
+				headers: { "User-Agent": "PodTUI/1.0" },
+			});
+			if (!resp.ok) {
+				syncSubscriptions();
+				return;
+			}
+			const manifest = (await resp.json()) as FeaturedManifest;
+			if (!manifest?.podcasts?.length) {
+				syncSubscriptions();
+				return;
+			}
 
-  /** Toggle subscription */
-  const toggleSubscription = (podcastId: string) => {
-    const podcast = podcasts().find((p) => p.id === podcastId)
-    if (podcast?.isSubscribed) {
-      unsubscribe(podcastId)
-    } else {
-      subscribe(podcastId)
-    }
-  }
+			const fetched = manifest.podcasts.map(entryToPodcast);
+			cachedAt = now;
+			setPodcasts(fetched);
 
-  /** Refresh trending podcasts (mock) */
-  const refresh = async () => {
-    setIsLoading(true)
-    // Simulate network delay
-    await new Promise((r) => setTimeout(r, 500))
-    // In real app, would fetch from API
-    setIsLoading(false)
-  }
+			// Reflect current feed-store subscriptions
+			syncSubscriptions();
+		} catch {
+			// Network failure — keep whatever we have (stale or empty)
+		} finally {
+			setIsLoading(false);
+		}
+	};
 
-  return {
-    // State
-    selectedCategory,
-    isLoading,
-    podcasts,
-    filteredPodcasts,
-    categories: DISCOVER_CATEGORIES,
+	/** Get filtered podcasts by category */
+	const filteredPodcasts = () => {
+		const category = selectedCategory();
+		if (category === "all") {
+			return podcasts();
+		}
 
-    // Actions
-    setSelectedCategory,
-    subscribe,
-    unsubscribe,
-    toggleSubscription,
-    refresh,
-  }
+		return podcasts().filter((p) => {
+			const cats = p.categories?.map((c) => c.toLowerCase()) ?? [];
+			return cats.some((c) =>
+				c.includes(category.toLowerCase().replace("-", " ")),
+			);
+		});
+	};
+
+	/** Subscribe to a podcast */
+	const subscribe = (podcastId: string) => {
+		const podcast = podcasts().find((p) => p.id === podcastId);
+		if (podcast) {
+			// Actually add the feed to the feed store
+			const feedStore = useFeedStore();
+			feedStore.addFeed(podcast, "discover").catch(() => {});
+		}
+		setPodcasts((prev) =>
+			prev.map((p) => (p.id === podcastId ? { ...p, isSubscribed: true } : p)),
+		);
+	};
+
+	/** Unsubscribe from a podcast */
+	const unsubscribe = (podcastId: string) => {
+		const podcast = podcasts().find((p) => p.id === podcastId);
+		if (podcast) {
+			const feedStore = useFeedStore();
+			feedStore.removeFeedByUrl(podcast.feedUrl);
+		}
+		setPodcasts((prev) =>
+			prev.map((p) => (p.id === podcastId ? { ...p, isSubscribed: false } : p)),
+		);
+	};
+
+	/** Toggle subscription */
+	const toggleSubscription = (podcastId: string) => {
+		const podcast = podcasts().find((p) => p.id === podcastId);
+		if (podcast?.isSubscribed) {
+			unsubscribe(podcastId);
+		} else {
+			subscribe(podcastId);
+		}
+	};
+
+	return {
+		// State
+		selectedCategory,
+		isLoading,
+		podcasts,
+		filteredPodcasts,
+		categories: DISCOVER_CATEGORIES,
+
+		// Actions
+		setSelectedCategory,
+		subscribe,
+		unsubscribe,
+		toggleSubscription,
+		refresh,
+	};
 }
 
 /** Singleton discover store */
-let discoverStoreInstance: ReturnType<typeof createDiscoverStore> | null = null
+let discoverStoreInstance: ReturnType<typeof createDiscoverStore> | null = null;
 
 export function useDiscoverStore() {
-  if (!discoverStoreInstance) {
-    discoverStoreInstance = createDiscoverStore()
-  }
-  return discoverStoreInstance
+	if (!discoverStoreInstance) {
+		discoverStoreInstance = createDiscoverStore();
+	}
+	return discoverStoreInstance;
 }

src/stores/download.ts

@@ -6,355 +6,371 @@
  * download queue (max 2 concurrent).
  */
 
-import { createSignal } from "solid-js"
-import { DownloadStatus } from "../types/episode"
-import type { DownloadedEpisode } from "../types/episode"
-import type { Episode } from "../types/episode"
-import { downloadEpisode } from "../utils/episode-downloader"
-import { ensureConfigDir, getConfigFilePath } from "../utils/config-dir"
-import { backupConfigFile } from "../utils/config-backup"
+import { createSignal } from "solid-js";
+import { DownloadStatus } from "../types/episode";
+import type { DownloadedEpisode } from "../types/episode";
+import type { Episode } from "../types/episode";
+import { downloadEpisode } from "../utils/episode-downloader";
+import { ensureConfigDir, getConfigFilePath } from "../utils/config-dir";
 
-const DOWNLOADS_FILE = "downloads.json"
-const MAX_CONCURRENT = 2
+const DOWNLOADS_FILE = "downloads.json";
+const MAX_CONCURRENT = 2;
 
 /** Serializable download record for persistence */
 interface DownloadRecord {
-  episodeId: string
-  feedId: string
-  status: DownloadStatus
-  filePath: string | null
-  downloadedAt: string | null
-  fileSize: number
-  error: string | null
-  audioUrl: string
-  episodeTitle: string
+	episodeId: string;
+	feedId: string;
+	status: DownloadStatus;
+	filePath: string | null;
+	downloadedAt: string | null;
+	fileSize: number;
+	error: string | null;
+	audioUrl: string;
+	episodeTitle: string;
 }
 
 /** Queue item for pending downloads */
 interface QueueItem {
-  episodeId: string
-  feedId: string
-  audioUrl: string
-  episodeTitle: string
+	episodeId: string;
+	feedId: string;
+	audioUrl: string;
+	episodeTitle: string;
 }
 
 /** Create download store */
-export function createDownloadStore() {
-  const [downloads, setDownloads] = createSignal<Map<string, DownloadedEpisode>>(new Map())
-  const [queue, setQueue] = createSignal<QueueItem[]>([])
-  const [activeCount, setActiveCount] = createSignal(0)
+function createDownloadStore() {
+	const [downloads, setDownloads] = createSignal<
+		Map<string, DownloadedEpisode>
+	>(new Map());
+	const [queue, setQueue] = createSignal<QueueItem[]>([]);
+	const [activeCount, setActiveCount] = createSignal(0);
 
-  /** Active AbortControllers keyed by episodeId */
-  const abortControllers = new Map<string, AbortController>()
+	/** Active AbortControllers keyed by episodeId */
+	const abortControllers = new Map<string, AbortController>();
 
-  // Load persisted downloads on init
-  ;(async () => {
-    const loaded = await loadDownloads()
-    if (loaded.size > 0) setDownloads(loaded)
-    // Resume any queued downloads from previous session
-    resumeIncomplete()
-  })()
+	(async () => {
+		const loaded = await loadDownloads();
+		if (loaded.size > 0) setDownloads(loaded);
+		// Resume any queued downloads from previous session
+		resumeIncomplete();
+	})();
 
-  /** Load downloads from JSON file */
-  async function loadDownloads(): Promise<Map<string, DownloadedEpisode>> {
-    try {
-      const filePath = getConfigFilePath(DOWNLOADS_FILE)
-      const file = Bun.file(filePath)
-      if (!(await file.exists())) return new Map()
+	/** Load downloads from JSON file */
+	async function loadDownloads(): Promise<Map<string, DownloadedEpisode>> {
+		try {
+			const filePath = getConfigFilePath(DOWNLOADS_FILE);
+			const file = Bun.file(filePath);
+			if (!(await file.exists())) return new Map();
 
-      const raw: DownloadRecord[] = await file.json()
-      if (!Array.isArray(raw)) return new Map()
+			const raw: DownloadRecord[] = await file.json();
+			if (!Array.isArray(raw)) return new Map();
 
-      const map = new Map<string, DownloadedEpisode>()
-      for (const rec of raw) {
-        map.set(rec.episodeId, {
-          episodeId: rec.episodeId,
-          feedId: rec.feedId,
-          status: rec.status === DownloadStatus.DOWNLOADING ? DownloadStatus.QUEUED : rec.status,
-          progress: rec.status === DownloadStatus.COMPLETED ? 100 : 0,
-          filePath: rec.filePath,
-          downloadedAt: rec.downloadedAt ? new Date(rec.downloadedAt) : null,
-          speed: 0,
-          fileSize: rec.fileSize,
-          error: rec.error,
-        })
-      }
-      return map
-    } catch {
-      return new Map()
-    }
-  }
+			const map = new Map<string, DownloadedEpisode>();
+			for (const rec of raw) {
+				map.set(rec.episodeId, {
+					episodeId: rec.episodeId,
+					feedId: rec.feedId,
+					status:
+						rec.status === DownloadStatus.DOWNLOADING
+							? DownloadStatus.QUEUED
+							: rec.status,
+					progress: rec.status === DownloadStatus.COMPLETED ? 100 : 0,
+					filePath: rec.filePath,
+					downloadedAt: rec.downloadedAt ? new Date(rec.downloadedAt) : null,
+					speed: 0,
+					fileSize: rec.fileSize,
+					error: rec.error,
+				});
+			}
+			return map;
+		} catch {
+			return new Map();
+		}
+	}
 
-  /** Persist downloads to JSON file */
-  async function saveDownloads(): Promise<void> {
-    try {
-      await ensureConfigDir()
-      await backupConfigFile(DOWNLOADS_FILE)
-      const map = downloads()
-      const records: DownloadRecord[] = []
-      for (const [, dl] of map) {
-        // Find the audioUrl from queue or use empty string
-        const qItem = queue().find((q) => q.episodeId === dl.episodeId)
-        records.push({
-          episodeId: dl.episodeId,
-          feedId: dl.feedId,
-          status: dl.status,
-          filePath: dl.filePath,
-          downloadedAt: dl.downloadedAt?.toISOString() ?? null,
-          fileSize: dl.fileSize,
-          error: dl.error,
-          audioUrl: qItem?.audioUrl ?? "",
-          episodeTitle: qItem?.episodeTitle ?? "",
-        })
-      }
-      const filePath = getConfigFilePath(DOWNLOADS_FILE)
-      await Bun.write(filePath, JSON.stringify(records, null, 2))
-    } catch {
-      // Silently ignore write errors
-    }
-  }
+	/** Persist downloads to JSON file */
+	async function saveDownloads(): Promise<void> {
+		try {
+			await ensureConfigDir();
+			const map = downloads();
+			const records: DownloadRecord[] = [];
+			for (const [, dl] of map) {
+				// Find the audioUrl from queue or use empty string
+				const qItem = queue().find((q) => q.episodeId === dl.episodeId);
+				records.push({
+					episodeId: dl.episodeId,
+					feedId: dl.feedId,
+					status: dl.status,
+					filePath: dl.filePath,
+					downloadedAt: dl.downloadedAt?.toISOString() ?? null,
+					fileSize: dl.fileSize,
+					error: dl.error,
+					audioUrl: qItem?.audioUrl ?? "",
+					episodeTitle: qItem?.episodeTitle ?? "",
+				});
+			}
+			const filePath = getConfigFilePath(DOWNLOADS_FILE);
+			await Bun.write(filePath, JSON.stringify(records, null, 2));
+		} catch {
+			// Silently ignore write errors
+		}
+	}
 
-  /** Resume incomplete downloads from a previous session */
-  function resumeIncomplete(): void {
-    const map = downloads()
-    for (const [, dl] of map) {
-      if (dl.status === DownloadStatus.QUEUED) {
-        // Re-queue — but we lack audioUrl from persistence alone.
-        // These will sit as QUEUED until the user re-triggers them.
-      }
-    }
-  }
+	/** Resume incomplete downloads from a previous session */
+	function resumeIncomplete(): void {
+		const map = downloads();
+		for (const [, dl] of map) {
+			if (dl.status === DownloadStatus.QUEUED) {
+				// Re-queue — but we lack audioUrl from persistence alone.
+				// These will sit as QUEUED until the user re-triggers them.
+			}
+		}
+	}
 
-  /** Update a single download entry and trigger reactivity */
-  function updateDownload(episodeId: string, updates: Partial<DownloadedEpisode>): void {
-    setDownloads((prev) => {
-      const next = new Map(prev)
-      const existing = next.get(episodeId)
-      if (existing) {
-        next.set(episodeId, { ...existing, ...updates })
-      }
-      return next
-    })
-  }
+	/** Update a single download entry and trigger reactivity */
+	function updateDownload(
+		episodeId: string,
+		updates: Partial<DownloadedEpisode>,
+	): void {
+		setDownloads((prev) => {
+			const next = new Map(prev);
+			const existing = next.get(episodeId);
+			if (existing) {
+				next.set(episodeId, { ...existing, ...updates });
+			}
+			return next;
+		});
+	}
 
-  /** Process the download queue — starts downloads up to MAX_CONCURRENT */
-  function processQueue(): void {
-    const current = activeCount()
-    const q = queue()
+	/** Process the download queue — starts downloads up to MAX_CONCURRENT */
+	function processQueue(): void {
+		const current = activeCount();
+		const q = queue();
 
-    if (current >= MAX_CONCURRENT || q.length === 0) return
+		if (current >= MAX_CONCURRENT || q.length === 0) return;
 
-    const slotsAvailable = MAX_CONCURRENT - current
-    const toStart = q.slice(0, slotsAvailable)
+		const slotsAvailable = MAX_CONCURRENT - current;
+		const toStart = q.slice(0, slotsAvailable);
 
-    // Remove started items from queue
-    if (toStart.length > 0) {
-      setQueue((prev) => prev.slice(toStart.length))
-    }
+		if (toStart.length > 0) {
+			setQueue((prev) => prev.slice(toStart.length));
+		}
 
-    for (const item of toStart) {
-      executeDownload(item)
-    }
-  }
+		for (const item of toStart) {
+			executeDownload(item);
+		}
+	}
 
-  /** Execute a single download */
-  async function executeDownload(item: QueueItem): Promise<void> {
-    const controller = new AbortController()
-    abortControllers.set(item.episodeId, controller)
-    setActiveCount((c) => c + 1)
+	/** Execute a single download */
+	async function executeDownload(item: QueueItem): Promise<void> {
+		const controller = new AbortController();
+		abortControllers.set(item.episodeId, controller);
+		setActiveCount((c) => c + 1);
 
-    updateDownload(item.episodeId, {
-      status: DownloadStatus.DOWNLOADING,
-      progress: 0,
-      speed: 0,
-      error: null,
-    })
+		updateDownload(item.episodeId, {
+			status: DownloadStatus.DOWNLOADING,
+			progress: 0,
+			speed: 0,
+			error: null,
+		});
 
-    const result = await downloadEpisode(
-      item.audioUrl,
-      item.episodeTitle,
-      item.feedId,
-      (progress) => {
-        updateDownload(item.episodeId, {
-          progress: progress.percent >= 0 ? progress.percent : 0,
-          speed: progress.speed,
-          fileSize: progress.totalBytes,
-        })
-      },
-      controller.signal,
-    )
+		const result = await downloadEpisode(
+			item.audioUrl,
+			item.episodeTitle,
+			item.feedId,
+			(progress) => {
+				updateDownload(item.episodeId, {
+					progress: progress.percent >= 0 ? progress.percent : 0,
+					speed: progress.speed,
+					fileSize: progress.totalBytes,
+				});
+			},
+			controller.signal,
+		);
 
-    abortControllers.delete(item.episodeId)
-    setActiveCount((c) => Math.max(0, c - 1))
+		abortControllers.delete(item.episodeId);
+		setActiveCount((c) => Math.max(0, c - 1));
 
-    if (result.success) {
-      updateDownload(item.episodeId, {
-        status: DownloadStatus.COMPLETED,
-        progress: 100,
-        filePath: result.filePath,
-        fileSize: result.fileSize,
-        downloadedAt: new Date(),
-        speed: 0,
-        error: null,
-      })
-    } else {
-      updateDownload(item.episodeId, {
-        status: DownloadStatus.FAILED,
-        speed: 0,
-        error: result.error ?? "Unknown error",
-      })
-    }
+		if (result.success) {
+			updateDownload(item.episodeId, {
+				status: DownloadStatus.COMPLETED,
+				progress: 100,
+				filePath: result.filePath,
+				fileSize: result.fileSize,
+				downloadedAt: new Date(),
+				speed: 0,
+				error: null,
+			});
+		} else {
+			updateDownload(item.episodeId, {
+				status: DownloadStatus.FAILED,
+				speed: 0,
+				error: result.error ?? "Unknown error",
+			});
+		}
 
-    saveDownloads().catch(() => {})
-    // Process next items in queue
-    processQueue()
-  }
+		saveDownloads().catch(() => {});
+		// Process next items in queue
+		processQueue();
+	}
 
-  /** Get download status for an episode */
-  const getDownloadStatus = (episodeId: string): DownloadStatus => {
-    return downloads().get(episodeId)?.status ?? DownloadStatus.NONE
-  }
+	/** Get download status for an episode */
+	const getDownloadStatus = (episodeId: string): DownloadStatus => {
+		return downloads().get(episodeId)?.status ?? DownloadStatus.NONE;
+	};
 
-  /** Get download progress for an episode (0-100) */
-  const getDownloadProgress = (episodeId: string): number => {
-    return downloads().get(episodeId)?.progress ?? 0
-  }
+	/** Get download progress for an episode (0-100) */
+	const getDownloadProgress = (episodeId: string): number => {
+		return downloads().get(episodeId)?.progress ?? 0;
+	};
 
-  /** Get full download info for an episode */
-  const getDownload = (episodeId: string): DownloadedEpisode | undefined => {
-    return downloads().get(episodeId)
-  }
+	/** Get full download info for an episode */
+	const getDownload = (episodeId: string): DownloadedEpisode | undefined => {
+		return downloads().get(episodeId);
+	};
 
-  /** Get the local file path for a completed download */
-  const getDownloadedFilePath = (episodeId: string): string | null => {
-    const dl = downloads().get(episodeId)
-    if (dl?.status === DownloadStatus.COMPLETED && dl.filePath) {
-      return dl.filePath
-    }
-    return null
-  }
+	/** Get the local file path for a completed download */
+	const getDownloadedFilePath = (episodeId: string): string | null => {
+		const dl = downloads().get(episodeId);
+		if (dl?.status === DownloadStatus.COMPLETED && dl.filePath) {
+			return dl.filePath;
+		}
+		return null;
+	};
 
-  /** Start downloading an episode */
-  const startDownload = (episode: Episode, feedId: string): void => {
-    const existing = downloads().get(episode.id)
-    if (existing?.status === DownloadStatus.DOWNLOADING || existing?.status === DownloadStatus.QUEUED) {
-      return // Already downloading or queued
-    }
+	/** Start downloading an episode */
+	const startDownload = (episode: Episode, feedId: string): void => {
+		const existing = downloads().get(episode.id);
+		if (
+			existing?.status === DownloadStatus.DOWNLOADING ||
+			existing?.status === DownloadStatus.QUEUED
+		) {
+			return; // Already downloading or queued
+		}
 
-    // Create download entry
-    const entry: DownloadedEpisode = {
-      episodeId: episode.id,
-      feedId,
-      status: DownloadStatus.QUEUED,
-      progress: 0,
-      filePath: null,
-      downloadedAt: null,
-      speed: 0,
-      fileSize: episode.fileSize ?? 0,
-      error: null,
-    }
+		const entry: DownloadedEpisode = {
+			episodeId: episode.id,
+			feedId,
+			status: DownloadStatus.QUEUED,
+			progress: 0,
+			filePath: null,
+			downloadedAt: null,
+			speed: 0,
+			fileSize: episode.fileSize ?? 0,
+			error: null,
+		};
 
-    setDownloads((prev) => {
-      const next = new Map(prev)
-      next.set(episode.id, entry)
-      return next
-    })
+		setDownloads((prev) => {
+			const next = new Map(prev);
+			next.set(episode.id, entry);
+			return next;
+		});
 
-    // Add to queue
-    const queueItem: QueueItem = {
-      episodeId: episode.id,
-      feedId,
-      audioUrl: episode.audioUrl,
-      episodeTitle: episode.title,
-    }
-    setQueue((prev) => [...prev, queueItem])
+		const queueItem: QueueItem = {
+			episodeId: episode.id,
+			feedId,
+			audioUrl: episode.audioUrl,
+			episodeTitle: episode.title,
+		};
+		setQueue((prev) => [...prev, queueItem]);
 
-    saveDownloads().catch(() => {})
-    processQueue()
-  }
+		saveDownloads().catch(() => {});
+		processQueue();
+	};
 
-  /** Cancel a download */
-  const cancelDownload = (episodeId: string): void => {
-    // Abort active download
-    const controller = abortControllers.get(episodeId)
-    if (controller) {
-      controller.abort()
-      abortControllers.delete(episodeId)
-    }
+	/** Cancel a download */
+	const cancelDownload = (episodeId: string): void => {
+		// Abort active download
+		const controller = abortControllers.get(episodeId);
+		if (controller) {
+			controller.abort();
+			abortControllers.delete(episodeId);
+		}
 
-    // Remove from queue
-    setQueue((prev) => prev.filter((q) => q.episodeId !== episodeId))
+		setQueue((prev) => prev.filter((q) => q.episodeId !== episodeId));
 
-    // Update status
-    updateDownload(episodeId, {
-      status: DownloadStatus.NONE,
-      progress: 0,
-      speed: 0,
-      error: null,
-    })
+		updateDownload(episodeId, {
+			status: DownloadStatus.NONE,
+			progress: 0,
+			speed: 0,
+			error: null,
+		});
 
-    saveDownloads().catch(() => {})
-  }
+		saveDownloads().catch(() => {});
+	};
 
-  /** Remove a completed download (delete file and metadata) */
-  const removeDownload = async (episodeId: string): Promise<void> => {
-    const dl = downloads().get(episodeId)
-    if (dl?.filePath) {
-      try {
-        const { unlink } = await import("fs/promises")
-        await unlink(dl.filePath)
-      } catch {
-        // File may already be gone
-      }
-    }
+	/** Remove a completed download (delete file and metadata) */
+	const removeDownload = async (episodeId: string): Promise<void> => {
+		const dl = downloads().get(episodeId);
+		if (dl?.filePath) {
+			try {
+				const { unlink } = await import("fs/promises");
+				await unlink(dl.filePath);
+			} catch {
+				// File may already be gone
+			}
+		}
 
-    setDownloads((prev) => {
-      const next = new Map(prev)
-      next.delete(episodeId)
-      return next
-    })
+		setDownloads((prev) => {
+			const next = new Map(prev);
+			next.delete(episodeId);
+			return next;
+		});
 
-    saveDownloads().catch(() => {})
-  }
+		saveDownloads().catch(() => {});
+	};
 
-  /** Get all downloads as an array */
-  const getAllDownloads = (): DownloadedEpisode[] => {
-    return Array.from(downloads().values())
-  }
+	/** Remove every download (active/queued/completed) belonging to a feed —
+	 *  abort in-flight transfers, drop queued items, delete files + metadata. */
+	const removeDownloadsForFeed = async (feedId: string): Promise<void> => {
+		const eps = Array.from(downloads().values()).filter(
+			(d) => d.feedId === feedId,
+		);
+		for (const d of eps) {
+			cancelDownload(d.episodeId);
+			await removeDownload(d.episodeId);
+		}
+	};
 
-  /** Get the current queue */
-  const getQueue = (): QueueItem[] => {
-    return queue()
-  }
+	/** Get all downloads as an array */
+	const getAllDownloads = (): DownloadedEpisode[] => {
+		return Array.from(downloads().values());
+	};
 
-  /** Get count of active downloads */
-  const getActiveCount = (): number => {
-    return activeCount()
-  }
+	/** Get the current queue */
+	const getQueue = (): QueueItem[] => {
+		return queue();
+	};
 
-  return {
-    // Getters
-    getDownloadStatus,
-    getDownloadProgress,
-    getDownload,
-    getDownloadedFilePath,
-    getAllDownloads,
-    getQueue,
-    getActiveCount,
+	/** Get count of active downloads */
+	const getActiveCount = (): number => {
+		return activeCount();
+	};
 
-    // Actions
-    startDownload,
-    cancelDownload,
-    removeDownload,
-  }
+	return {
+		// Getters
+		getDownloadStatus,
+		getDownloadProgress,
+		getDownload,
+		getDownloadedFilePath,
+		getAllDownloads,
+		getQueue,
+		getActiveCount,
+
+		// Actions
+		startDownload,
+		cancelDownload,
+		removeDownload,
+		removeDownloadsForFeed,
+	};
 }
 
 /** Singleton download store */
-let downloadStoreInstance: ReturnType<typeof createDownloadStore> | null = null
+let downloadStoreInstance: ReturnType<typeof createDownloadStore> | null = null;
 
 export function useDownloadStore() {
-  if (!downloadStoreInstance) {
-    downloadStoreInstance = createDownloadStore()
-  }
-  return downloadStoreInstance
+	if (!downloadStoreInstance) {
+		downloadStoreInstance = createDownloadStore();
+	}
+	return downloadStoreInstance;
 }

src/stores/feed.ts

@@ -7,19 +7,18 @@ import { createSignal } from "solid-js";
 import { FeedVisibility } from "../types/feed";
 import type { Feed, FeedFilter, FeedSortField } from "../types/feed";
 import type { Podcast } from "../types/podcast";
-import type { Episode, EpisodeStatus } from "../types/episode";
-import type { PodcastSource, SourceType } from "../types/source";
+import type { Episode } from "../types/episode";
+import type { PodcastSource } from "../types/source";
 import { DEFAULT_SOURCES } from "../types/source";
 import { parseRSSFeed } from "../api/rss-parser";
 import {
-  loadFeedsFromFile,
-  saveFeedsToFile,
-  loadSourcesFromFile,
-  saveSourcesToFile,
+	loadFeedsFromFile,
+	saveFeedsToFile,
+	loadSourcesFromFile,
+	saveSourcesToFile,
 } from "../utils/feeds-persistence";
 import { useDownloadStore } from "./download";
 import { DownloadStatus } from "../types/episode";
-import { useAuthStore } from "./auth";
 
 /** Max episodes to load per page/chunk */
 const MAX_EPISODES_REFRESH = 50;
@@ -35,461 +34,502 @@ const episodeLoadCount = new Map<string, number>();
 
 /** Save feeds to file (async, fire-and-forget) */
 function saveFeeds(feeds: Feed[]): void {
-  saveFeedsToFile(feeds).catch(() => {});
+	saveFeedsToFile(feeds);
 }
 
 /** Save sources to file (async, fire-and-forget) */
 function saveSources(sources: PodcastSource[]): void {
-  saveSourcesToFile(sources).catch(() => {});
+	saveSourcesToFile(sources);
 }
 
 /** Create feed store */
-export function createFeedStore() {
-  const [feeds, setFeeds] = createSignal<Feed[]>([]);
-  const [sources, setSources] = createSignal<PodcastSource[]>([
-    ...DEFAULT_SOURCES,
-  ]);
-  const [filter, setFilter] = createSignal<FeedFilter>({
-    visibility: "all",
-    sortBy: "updated" as FeedSortField,
-    sortDirection: "desc",
-  });
-  const [selectedFeedId, setSelectedFeedId] = createSignal<string | null>(null);
-  const [isLoadingMore, setIsLoadingMore] = createSignal(false);
-  const [isLoadingFeeds, setIsLoadingFeeds] = createSignal(false);
+function createFeedStore() {
+	const [feeds, setFeeds] = createSignal<Feed[]>([]);
+	const [sources, setSources] = createSignal<PodcastSource[]>([
+		...DEFAULT_SOURCES,
+	]);
+	const [filter, setFilter] = createSignal<FeedFilter>({
+		visibility: "all",
+		sortBy: "updated" as FeedSortField,
+		sortDirection: "desc",
+	});
+	const [selectedFeedId, setSelectedFeedId] = createSignal<string | null>(null);
+	const [isLoadingMore, setIsLoadingMore] = createSignal(false);
+	const [isLoadingFeeds, setIsLoadingFeeds] = createSignal(false);
 
-  /** Get filtered and sorted feeds */
-  const getFilteredFeeds = (): Feed[] => {
-    let result = [...feeds()];
-    const f = filter();
-    const authStore = useAuthStore();
+	/** Get filtered and sorted feeds */
+	const getFilteredFeeds = (): Feed[] => {
+		let result = [...feeds()];
+		const f = filter();
 
-    // Filter by visibility
-    if (f.visibility && f.visibility !== "all") {
-      result = result.filter((feed) => feed.visibility === f.visibility);
-    } else if (f.visibility === "all") {
-      // Only show private feeds if authenticated
-      result = result.filter((feed) => feed.visibility === FeedVisibility.PUBLIC || authStore.isAuthenticated);
-    }
+		if (f.visibility && f.visibility !== "all") {
+			result = result.filter((feed) => feed.visibility === f.visibility);
+		}
 
-    // Filter by source
-    if (f.sourceId) {
-      result = result.filter((feed) => feed.sourceId === f.sourceId);
-    }
+		if (f.sourceId) {
+			result = result.filter((feed) => feed.sourceId === f.sourceId);
+		}
 
-    // Filter by pinned
-    if (f.pinnedOnly) {
-      result = result.filter((feed) => feed.isPinned);
-    }
+		if (f.pinnedOnly) {
+			result = result.filter((feed) => feed.isPinned);
+		}
 
-    // Filter by search query
-    if (f.searchQuery) {
-      const query = f.searchQuery.toLowerCase();
-      result = result.filter(
-        (feed) =>
-          feed.podcast.title.toLowerCase().includes(query) ||
-          feed.customName?.toLowerCase().includes(query) ||
-          feed.podcast.description?.toLowerCase().includes(query),
-      );
-    }
+		if (f.searchQuery) {
+			const query = f.searchQuery.toLowerCase();
+			result = result.filter(
+				(feed) =>
+					feed.podcast.title.toLowerCase().includes(query) ||
+					feed.customName?.toLowerCase().includes(query) ||
+					feed.podcast.description?.toLowerCase().includes(query),
+			);
+		}
 
-    // Sort by selected field
-    const sortDir = f.sortDirection === "asc" ? 1 : -1;
-    result.sort((a, b) => {
-      switch (f.sortBy) {
-        case "title":
-          return (
-            sortDir *
-            (a.customName || a.podcast.title).localeCompare(
-              b.customName || b.podcast.title,
-            )
-          );
-        case "episodeCount":
-          return sortDir * (a.episodes.length - b.episodes.length);
-        case "latestEpisode":
-          const aLatest = a.episodes[0]?.pubDate?.getTime() || 0;
-          const bLatest = b.episodes[0]?.pubDate?.getTime() || 0;
-          return sortDir * (aLatest - bLatest);
-        case "updated":
-        default:
-          return sortDir * (a.lastUpdated.getTime() - b.lastUpdated.getTime());
-      }
-    });
+		const sortDir = f.sortDirection === "asc" ? 1 : -1;
+		result.sort((a, b) => {
+			switch (f.sortBy) {
+				case "title":
+					return (
+						sortDir *
+						(a.customName || a.podcast.title).localeCompare(
+							b.customName || b.podcast.title,
+						)
+					);
+				case "episodeCount":
+					return sortDir * (a.episodes.length - b.episodes.length);
+				case "latestEpisode":
+					const aLatest = a.episodes[0]?.pubDate?.getTime() || 0;
+					const bLatest = b.episodes[0]?.pubDate?.getTime() || 0;
+					return sortDir * (aLatest - bLatest);
+				case "updated":
+				default:
+					return sortDir * (a.lastUpdated.getTime() - b.lastUpdated.getTime());
+			}
+		});
 
-    // Pinned feeds always first
-    result.sort((a, b) => {
-      if (a.isPinned && !b.isPinned) return -1;
-      if (!a.isPinned && b.isPinned) return 1;
-      return 0;
-    });
+		result.sort((a, b) => {
+			if (a.isPinned && !b.isPinned) return -1;
+			if (!a.isPinned && b.isPinned) return 1;
+			return 0;
+		});
 
-    return result;
-  };
+		return result;
+	};
 
-  /** Get episodes in reverse chronological order across all feeds */
-  const getAllEpisodesChronological = (): Array<{
-    episode: Episode;
-    feed: Feed;
-  }> => {
-    const allEpisodes: Array<{ episode: Episode; feed: Feed }> = [];
+	/** Get episodes in reverse chronological order across all feeds */
+	const getAllEpisodesChronological = (): Array<{
+		episode: Episode;
+		feed: Feed;
+	}> => {
+		const allEpisodes: Array<{ episode: Episode; feed: Feed }> = [];
 
-    for (const feed of feeds()) {
-      for (const episode of feed.episodes) {
-        allEpisodes.push({ episode, feed });
-      }
-    }
+		for (const feed of feeds()) {
+			for (const episode of feed.episodes) {
+				allEpisodes.push({ episode, feed });
+			}
+		}
 
-    // Sort by publication date (newest first)
-    allEpisodes.sort(
-      (a, b) => b.episode.pubDate.getTime() - a.episode.pubDate.getTime(),
-    );
+		// Sort by publication date (newest first)
+		allEpisodes.sort(
+			(a, b) => b.episode.pubDate.getTime() - a.episode.pubDate.getTime(),
+		);
 
-    return allEpisodes;
-  };
+		return allEpisodes;
+	};
 
-  /** Sort episodes in reverse chronological order (newest first) */
-  const sortEpisodesReverseChronological = (episodes: Episode[]): Episode[] => {
-    return [...episodes].sort(
-      (a, b) => b.pubDate.getTime() - a.pubDate.getTime(),
-    );
-  };
+	/** Sort episodes in reverse chronological order (newest first) */
+	const sortEpisodesReverseChronological = (episodes: Episode[]): Episode[] => {
+		return [...episodes].sort(
+			(a, b) => b.pubDate.getTime() - a.pubDate.getTime(),
+		);
+	};
 
-  /** Fetch latest episodes from an RSS feed URL, caching all parsed episodes */
-  const fetchEpisodes = async (
-    feedUrl: string,
-    limit: number,
-    feedId?: string,
-  ): Promise<Episode[]> => {
-    try {
-      const response = await fetch(feedUrl, {
-        headers: {
-          "Accept-Encoding": "identity",
-          Accept: "application/rss+xml, application/xml, text/xml, */*",
-        },
-      });
-      if (!response.ok) return [];
-      const xml = await response.text();
-      const parsed = parseRSSFeed(xml, feedUrl);
-      const allEpisodes = sortEpisodesReverseChronological(parsed.episodes);
+	/** Fetch latest episodes from an RSS feed URL, caching all parsed episodes */
+	const fetchEpisodes = async (
+		feedUrl: string,
+		limit: number,
+		feedId?: string,
+	): Promise<Episode[]> => {
+		try {
+			const response = await fetch(feedUrl, {
+				headers: {
+					"Accept-Encoding": "identity",
+					Accept: "application/rss+xml, application/xml, text/xml, */*",
+				},
+			});
+			if (!response.ok) return [];
+			const xml = await response.text();
+			const parsed = parseRSSFeed(xml, feedUrl);
+			const allEpisodes = sortEpisodesReverseChronological(parsed.episodes);
 
-      // Cache all parsed episodes for pagination
-      if (feedId) {
-        fullEpisodeCache.set(feedId, allEpisodes);
-        episodeLoadCount.set(feedId, Math.min(limit, allEpisodes.length));
-      }
+			// Cache all parsed episodes for pagination
+			if (feedId) {
+				fullEpisodeCache.set(feedId, allEpisodes);
+				episodeLoadCount.set(feedId, Math.min(limit, allEpisodes.length));
+			}
 
-      return allEpisodes.slice(0, limit);
-    } catch {
-      return [];
-    }
-  };
+			return allEpisodes.slice(0, limit);
+		} catch {
+			return [];
+		}
+	};
 
-  /** Add a new feed and auto-fetch latest 20 episodes */
-  const addFeed = async (
-    podcast: Podcast,
-    sourceId: string,
-    visibility: FeedVisibility = FeedVisibility.PUBLIC,
-  ) => {
-    const feedId = crypto.randomUUID();
-    const episodes = await fetchEpisodes(
-      podcast.feedUrl,
-      MAX_EPISODES_SUBSCRIBE,
-      feedId,
-    );
-    const newFeed: Feed = {
-      id: feedId,
-      podcast,
-      episodes,
-      visibility,
-      sourceId,
-      lastUpdated: new Date(),
-      isPinned: false,
-    };
-    setFeeds((prev) => {
-      const updated = [...prev, newFeed];
-      saveFeeds(updated);
-      return updated;
-    });
-    return newFeed;
-  };
+	/** Check if a feed with this URL already exists */
+	const hasFeedByUrl = (feedUrl: string): boolean => {
+		return feeds().some((f) => f.podcast.feedUrl === feedUrl);
+	};
 
-  /** Auto-download newest episodes for a feed */
-  const autoDownloadEpisodes = (
-    feedId: string,
-    newEpisodes: Episode[],
-    count: number,
-  ) => {
-    try {
-      const dlStore = useDownloadStore();
-      // Sort by pubDate descending (newest first)
-      const sorted = [...newEpisodes].sort(
-        (a, b) => b.pubDate.getTime() - a.pubDate.getTime(),
-      );
-      // count = 0 means download all new episodes
-      const toDownload = count > 0 ? sorted.slice(0, count) : sorted;
-      for (const ep of toDownload) {
-        const status = dlStore.getDownloadStatus(ep.id);
-        if (
-          status === DownloadStatus.NONE ||
-          status === DownloadStatus.FAILED
-        ) {
-          dlStore.startDownload(ep, feedId);
-        }
-      }
-    } catch {
-      // Download store may not be available yet
-    }
-  };
+	/** Add a new feed and auto-fetch latest 20 episodes */
+	const addFeed = async (
+		podcast: Podcast,
+		sourceId: string,
+		visibility: FeedVisibility = FeedVisibility.PUBLIC,
+	): Promise<Feed | null> => {
+		// Guard: don't add a feed we already have (matched by feedUrl)
+		if (hasFeedByUrl(podcast.feedUrl)) {
+			return feeds().find((f) => f.podcast.feedUrl === podcast.feedUrl) ?? null;
+		}
 
-  /** Refresh a single feed - re-fetch latest 50 episodes */
-  const refreshFeed = async (feedId: string) => {
-    const feed = getFeed(feedId);
-    if (!feed) return;
-    const oldEpisodeIds = new Set(feed.episodes.map((e) => e.id));
-    const episodes = await fetchEpisodes(
-      feed.podcast.feedUrl,
-      MAX_EPISODES_REFRESH,
-      feedId,
-    );
-    setFeeds((prev) => {
-      const updated = prev.map((f) =>
-        f.id === feedId ? { ...f, episodes, lastUpdated: new Date() } : f,
-      );
-      saveFeeds(updated);
-      return updated;
-    });
+		const feedId = crypto.randomUUID();
+		const episodes = await fetchEpisodes(
+			podcast.feedUrl,
+			MAX_EPISODES_SUBSCRIBE,
+			feedId,
+		);
+		const newFeed: Feed = {
+			id: feedId,
+			podcast,
+			episodes,
+			visibility,
+			sourceId,
+			lastUpdated: new Date(),
+			isPinned: false,
+		};
+		setFeeds((prev) => {
+			const updated = [...prev, newFeed];
+			saveFeeds(updated);
+			return updated;
+		});
+		return newFeed;
+	};
 
-    // Auto-download new episodes if enabled for this feed
-    if (feed.autoDownload) {
-      const newEpisodes = episodes.filter((e) => !oldEpisodeIds.has(e.id));
-      if (newEpisodes.length > 0) {
-        autoDownloadEpisodes(feedId, newEpisodes, feed.autoDownloadCount ?? 0);
-      }
-    }
-  };
+	/** Auto-download newest episodes for a feed */
+	const autoDownloadEpisodes = (
+		feedId: string,
+		newEpisodes: Episode[],
+		count: number,
+	) => {
+		const dlStore = useDownloadStore();
+		// Sort by pubDate descending (newest first)
+		const sorted = [...newEpisodes].sort(
+			(a, b) => b.pubDate.getTime() - a.pubDate.getTime(),
+		);
+		// count = 0 means download all new episodes
+		const toDownload = count > 0 ? sorted.slice(0, count) : sorted;
+		for (const ep of toDownload) {
+			const status = dlStore.getDownloadStatus(ep.id);
+			if (
+				status === DownloadStatus.NONE ||
+				status === DownloadStatus.FAILED
+			) {
+				dlStore.startDownload(ep, feedId);
+			}
+		}
+	};
 
-  /** Refresh all feeds */
-  const refreshAllFeeds = async () => {
-    setIsLoadingFeeds(true);
-    try {
-      const currentFeeds = feeds();
-      for (const feed of currentFeeds) {
-        await refreshFeed(feed.id);
-      }
-    } finally {
-      setIsLoadingFeeds(false);
-    }
-  };
+	/** Refresh a single feed - re-fetch latest 50 episodes */
+	const refreshFeed = async (feedId: string) => {
+		const feed = getFeed(feedId);
+		if (!feed) return;
+		const oldEpisodeIds = new Set(feed.episodes.map((e) => e.id));
+		const episodes = await fetchEpisodes(
+			feed.podcast.feedUrl,
+			MAX_EPISODES_REFRESH,
+			feedId,
+		);
+		setFeeds((prev) => {
+			const updated = prev.map((f) =>
+				f.id === feedId ? { ...f, episodes, lastUpdated: new Date() } : f,
+			);
+			saveFeeds(updated);
+			return updated;
+		});
 
-  (async () => {
-    const loadedFeeds = await loadFeedsFromFile();
-    if (loadedFeeds.length > 0) setFeeds(loadedFeeds);
-    const loadedSources = await loadSourcesFromFile<PodcastSource>();
-    if (loadedSources && loadedSources.length > 0) setSources(loadedSources);
-    await refreshAllFeeds();
-  })();
+		// Auto-download new episodes if enabled for this feed
+		if (feed.autoDownload) {
+			const newEpisodes = episodes.filter((e) => !oldEpisodeIds.has(e.id));
+			if (newEpisodes.length > 0) {
+				autoDownloadEpisodes(feedId, newEpisodes, feed.autoDownloadCount ?? 0);
+			}
+		}
+	};
 
-  /** Remove a feed */
-  const removeFeed = (feedId: string) => {
-    fullEpisodeCache.delete(feedId);
-    episodeLoadCount.delete(feedId);
-    setFeeds((prev) => {
-      const updated = prev.filter((f) => f.id !== feedId);
-      saveFeeds(updated);
-      return updated;
-    });
-  };
+	/** Refresh all feeds */
+	const refreshAllFeeds = async () => {
+		setIsLoadingFeeds(true);
+		try {
+			const currentFeeds = feeds();
+			for (const feed of currentFeeds) {
+				await refreshFeed(feed.id);
+			}
+		} finally {
+			setIsLoadingFeeds(false);
+		}
+	};
 
-  /** Update a feed */
-  const updateFeed = (feedId: string, updates: Partial<Feed>) => {
-    setFeeds((prev) => {
-      const updated = prev.map((f) =>
-        f.id === feedId ? { ...f, ...updates, lastUpdated: new Date() } : f,
-      );
-      saveFeeds(updated);
-      return updated;
-    });
-  };
+	(async () => {
+		const loadedFeeds = await loadFeedsFromFile();
+		if (loadedFeeds.length > 0) setFeeds(loadedFeeds);
+		const loadedSources = await loadSourcesFromFile<PodcastSource>();
+		if (loadedSources && loadedSources.length > 0) setSources(loadedSources);
+		await refreshAllFeeds();
+	})();
 
-  /** Toggle feed pinned status */
-  const togglePinned = (feedId: string) => {
-    setFeeds((prev) => {
-      const updated = prev.map((f) =>
-        f.id === feedId ? { ...f, isPinned: !f.isPinned } : f,
-      );
-      saveFeeds(updated);
-      return updated;
-    });
-  };
+	/** Remove a feed */
+	const removeFeed = (feedId: string) => {
+		fullEpisodeCache.delete(feedId);
+		episodeLoadCount.delete(feedId);
+		setFeeds((prev) => {
+			const updated = prev.filter((f) => f.id !== feedId);
+			saveFeeds(updated);
+			return updated;
+		});
+	};
 
-  /** Add a source */
-  const addSource = (source: Omit<PodcastSource, "id">) => {
-    const newSource: PodcastSource = {
-      ...source,
-      id: crypto.randomUUID(),
-    };
-    setSources((prev) => {
-      const updated = [...prev, newSource];
-      saveSources(updated);
-      return updated;
-    });
-    return newSource;
-  };
+	/** Remove a feed by its RSS URL (for sources that match by URL, not ID) */
+	const removeFeedByUrl = (feedUrl: string) => {
+		const feed = feeds().find((f) => f.podcast.feedUrl === feedUrl);
+		if (feed) {
+			fullEpisodeCache.delete(feed.id);
+			episodeLoadCount.delete(feed.id);
+			setFeeds((prev) => {
+				const updated = prev.filter((f) => f.podcast.feedUrl !== feedUrl);
+				saveFeeds(updated);
+				return updated;
+			});
+		}
+	};
 
-  /** Update a source */
-  const updateSource = (sourceId: string, updates: Partial<PodcastSource>) => {
-    setSources((prev) => {
-      const updated = prev.map((source) =>
-        source.id === sourceId ? { ...source, ...updates } : source,
-      );
-      saveSources(updated);
-      return updated;
-    });
-  };
+	/** Update a feed */
+	const updateFeed = (feedId: string, updates: Partial<Feed>) => {
+		setFeeds((prev) => {
+			const updated = prev.map((f) =>
+				f.id === feedId ? { ...f, ...updates, lastUpdated: new Date() } : f,
+			);
+			saveFeeds(updated);
+			return updated;
+		});
+	};
 
-  /** Remove a source */
-  const removeSource = (sourceId: string) => {
-    // Don't remove default sources
-    if (sourceId === "itunes" || sourceId === "rss") return false;
+	/** Toggle feed pinned status */
+	const togglePinned = (feedId: string) => {
+		setFeeds((prev) => {
+			const updated = prev.map((f) =>
+				f.id === feedId ? { ...f, isPinned: !f.isPinned } : f,
+			);
+			saveFeeds(updated);
+			return updated;
+		});
+	};
 
-    setSources((prev) => {
-      const updated = prev.filter((s) => s.id !== sourceId);
-      saveSources(updated);
-      return updated;
-    });
-    return true;
-  };
+	/** Add a source */
+	const addSource = (source: Omit<PodcastSource, "id">) => {
+		const newSource: PodcastSource = {
+			...source,
+			id: crypto.randomUUID(),
+		};
+		setSources((prev) => {
+			const updated = [...prev, newSource];
+			saveSources(updated);
+			return updated;
+		});
+		return newSource;
+	};
 
-  /** Toggle source enabled status */
-  const toggleSource = (sourceId: string) => {
-    setSources((prev) => {
-      const updated = prev.map((s) =>
-        s.id === sourceId ? { ...s, enabled: !s.enabled } : s,
-      );
-      saveSources(updated);
-      return updated;
-    });
-  };
+	/** Update a source */
+	const updateSource = (sourceId: string, updates: Partial<PodcastSource>) => {
+		setSources((prev) => {
+			const updated = prev.map((source) =>
+				source.id === sourceId ? { ...source, ...updates } : source,
+			);
+			saveSources(updated);
+			return updated;
+		});
+	};
 
-  /** Get feed by ID */
-  const getFeed = (feedId: string): Feed | undefined => {
-    return feeds().find((f) => f.id === feedId);
-  };
+	/** Remove a source */
+	const removeSource = (sourceId: string) => {
+		// Don't remove default sources
+		if (sourceId === "itunes" || sourceId === "rss") return false;
 
-  /** Get selected feed */
-  const getSelectedFeed = (): Feed | undefined => {
-    const id = selectedFeedId();
-    return id ? getFeed(id) : undefined;
-  };
+		setSources((prev) => {
+			const updated = prev.filter((s) => s.id !== sourceId);
+			saveSources(updated);
+			return updated;
+		});
+		return true;
+	};
 
-  /** Check if a feed has more episodes available beyond what's currently loaded */
-  const hasMoreEpisodes = (feedId: string): boolean => {
-    const cached = fullEpisodeCache.get(feedId);
-    if (!cached) return false;
-    const loaded = episodeLoadCount.get(feedId) ?? 0;
-    return loaded < cached.length;
-  };
+	/** Toggle source enabled status */
+	const toggleSource = (sourceId: string) => {
+		setSources((prev) => {
+			const updated = prev.map((s) =>
+				s.id === sourceId ? { ...s, enabled: !s.enabled } : s,
+			);
+			saveSources(updated);
+			return updated;
+		});
+	};
 
-  /** Load the next chunk of episodes for a feed from the cache.
-   *  If no cache exists (e.g. app restart), re-fetches from the RSS feed. */
-  const loadMoreEpisodes = async (feedId: string) => {
-    if (isLoadingMore()) return;
-    const feed = getFeed(feedId);
-    if (!feed) return;
+	/** Get feed by ID */
+	const getFeed = (feedId: string): Feed | undefined => {
+		return feeds().find((f) => f.id === feedId);
+	};
 
-    setIsLoadingMore(true);
-    try {
-      let cached = fullEpisodeCache.get(feedId);
+	/** Get selected feed */
+	const getSelectedFeed = (): Feed | undefined => {
+		const id = selectedFeedId();
+		return id ? getFeed(id) : undefined;
+	};
 
-      // If no cache, re-fetch and parse the full feed
-      if (!cached) {
-        const response = await fetch(feed.podcast.feedUrl, {
-          headers: {
-            "Accept-Encoding": "identity",
-            Accept: "application/rss+xml, application/xml, text/xml, */*",
-          },
-        });
-        if (!response.ok) return;
-        const xml = await response.text();
-        const parsed = parseRSSFeed(xml, feed.podcast.feedUrl);
-        cached = parsed.episodes;
-        fullEpisodeCache.set(feedId, cached);
-        // Set current load count to match what's already displayed
-        episodeLoadCount.set(feedId, feed.episodes.length);
-      }
+	/** Check if a feed has more episodes available beyond what's currently loaded */
+	const hasMoreEpisodes = (feedId: string): boolean => {
+		const cached = fullEpisodeCache.get(feedId);
+		if (!cached) return false;
+		const loaded = episodeLoadCount.get(feedId) ?? 0;
+		return loaded < cached.length;
+	};
 
-      const currentCount = episodeLoadCount.get(feedId) ?? feed.episodes.length;
-      const newCount = Math.min(
-        currentCount + MAX_EPISODES_REFRESH,
-        cached.length,
-      );
+	/** Load the next chunk of episodes for one feed from the cache.
+	 *  No global guard — callers own the `isLoadingMore` flag so batches
+	 *  (loadMoreAllFeeds) can loop over multiple feeds in one go. */
+	const loadMoreEpisodesForFeed = async (feedId: string) => {
+		const feed = getFeed(feedId);
+		if (!feed) return;
 
-      if (newCount <= currentCount) return; // nothing more to load
+		let cached = fullEpisodeCache.get(feedId);
 
-      episodeLoadCount.set(feedId, newCount);
-      const episodes = cached.slice(0, newCount);
+		// If no cache, re-fetch and parse the full feed
+		if (!cached) {
+			const response = await fetch(feed.podcast.feedUrl, {
+				headers: {
+					"Accept-Encoding": "identity",
+					Accept: "application/rss+xml, application/xml, text/xml, */*",
+				},
+			});
+			if (!response.ok) return;
+			const xml = await response.text();
+			const parsed = parseRSSFeed(xml, feed.podcast.feedUrl);
+			cached = parsed.episodes;
+			fullEpisodeCache.set(feedId, cached);
+			// Set current load count to match what's already displayed
+			episodeLoadCount.set(feedId, feed.episodes.length);
+		}
 
-      setFeeds((prev) => {
-        const updated = prev.map((f) =>
-          f.id === feedId ? { ...f, episodes } : f,
-        );
-        saveFeeds(updated);
-        return updated;
-      });
-    } finally {
-      setIsLoadingMore(false);
-    }
-  };
+		const currentCount = episodeLoadCount.get(feedId) ?? feed.episodes.length;
+		const newCount = Math.min(
+			currentCount + MAX_EPISODES_REFRESH,
+			cached.length,
+		);
 
-  /** Set auto-download settings for a feed */
-  const setAutoDownload = (
-    feedId: string,
-    enabled: boolean,
-    count: number = 0,
-  ) => {
-    updateFeed(feedId, { autoDownload: enabled, autoDownloadCount: count });
-  };
+		if (newCount <= currentCount) return; // nothing more to load
 
-  return {
-    // State
-    feeds,
-    sources,
-    filter,
-    selectedFeedId,
-    isLoadingMore,
+		episodeLoadCount.set(feedId, newCount);
+		const episodes = cached.slice(0, newCount);
 
-    // Computed
-    getFilteredFeeds,
-    getAllEpisodesChronological,
-    getFeed,
-    getSelectedFeed,
-    hasMoreEpisodes,
-    isLoadingFeeds,
+		setFeeds((prev) => {
+			const updated = prev.map((f) =>
+				f.id === feedId ? { ...f, episodes } : f,
+			);
+			saveFeeds(updated);
+			return updated;
+		});
+	};
 
-    // Actions
-    setFilter,
-    setSelectedFeedId,
-    addFeed,
-    removeFeed,
-    updateFeed,
-    togglePinned,
-    refreshFeed,
-    refreshAllFeeds,
-    loadMoreEpisodes,
-    addSource,
-    removeSource,
-    toggleSource,
-    updateSource,
-    setAutoDownload,
-  };
+	/** Load the next chunk of episodes for a feed from the cache.
+	 *  If no cache exists (e.g. app restart), re-fetches from the RSS feed. */
+	const loadMoreEpisodes = async (feedId: string) => {
+		if (isLoadingMore()) return;
+		setIsLoadingMore(true);
+		try {
+			await loadMoreEpisodesForFeed(feedId);
+		} finally {
+			setIsLoadingMore(false);
+		}
+	};
+
+	/** True if any feed still has cached episodes beyond its loaded window. */
+	const hasMoreAcrossAll = (): boolean => {
+		return feeds().some((f) => hasMoreEpisodes(f.id));
+	};
+
+	/** Advance the loaded window by MAX_EPISODES_REFRESH for every feed that
+	 *  still has cached episodes — powers the Feed page's "[Fetch More]". */
+	const loadMoreAllFeeds = async () => {
+		if (isLoadingMore()) return;
+		setIsLoadingMore(true);
+		try {
+			const pending = feeds().filter((f) => hasMoreEpisodes(f.id));
+			for (const feed of pending) {
+				await loadMoreEpisodesForFeed(feed.id);
+			}
+		} finally {
+			setIsLoadingMore(false);
+		}
+	};
+
+	/** Set auto-download settings for a feed */
+	const setAutoDownload = (
+		feedId: string,
+		enabled: boolean,
+		count: number = 0,
+	) => {
+		updateFeed(feedId, { autoDownload: enabled, autoDownloadCount: count });
+	};
+
+	return {
+		// State
+		feeds,
+		sources,
+		filter,
+		selectedFeedId,
+		isLoadingMore,
+
+		// Computed
+		getFilteredFeeds,
+		getAllEpisodesChronological,
+		getFeed,
+		getSelectedFeed,
+		hasMoreEpisodes,
+		isLoadingFeeds,
+
+		// Actions
+		setFilter,
+		setSelectedFeedId,
+		addFeed,
+		hasFeedByUrl,
+		removeFeed,
+		removeFeedByUrl,
+		updateFeed,
+		togglePinned,
+		refreshFeed,
+		refreshAllFeeds,
+		loadMoreEpisodes,
+		loadMoreAllFeeds,
+		hasMoreAcrossAll,
+		addSource,
+		removeSource,
+		toggleSource,
+		updateSource,
+		setAutoDownload,
+	};
 }
 
 /** Singleton feed store */
 let feedStoreInstance: ReturnType<typeof createFeedStore> | null = null;
 
 export function useFeedStore() {
-  if (!feedStoreInstance) {
-    feedStoreInstance = createFeedStore();
-  }
-  return feedStoreInstance;
+	if (!feedStoreInstance) {
+		feedStoreInstance = createFeedStore();
+	}
+	return feedStoreInstance;
 }

src/stores/progress.ts

@@ -8,8 +8,8 @@
 import { createSignal } from "solid-js";
 import type { Progress } from "../types/episode";
 import {
-  loadProgressFromFile,
-  saveProgressToFile,
+	loadProgressFromFile,
+	saveProgressToFile,
 } from "../utils/app-persistence";
 
 /** Threshold (fraction 0-1) at which an episode is considered completed */
@@ -21,146 +21,146 @@ const MIN_POSITION_TO_SAVE = 5;
 // --- Singleton store ---
 
 const [progressMap, setProgressMap] = createSignal<Record<string, Progress>>(
-  {},
+	{},
 );
 
 /** Persist current progress map to file (fire-and-forget) */
 function persist(): void {
-  saveProgressToFile(progressMap()).catch(() => {});
+	saveProgressToFile(progressMap());
 }
 
 /** Parse raw progress entries from file, reviving Date objects */
 function parseProgressEntries(
-  raw: Record<string, unknown>,
+	raw: Record<string, unknown>,
 ): Record<string, Progress> {
-  const result: Record<string, Progress> = {};
-  for (const [key, value] of Object.entries(raw)) {
-    const p = value as Record<string, unknown>;
-    result[key] = {
-      episodeId: p.episodeId as string,
-      position: p.position as number,
-      duration: p.duration as number,
-      timestamp: new Date(p.timestamp as string),
-      playbackSpeed: p.playbackSpeed as number | undefined,
-    };
-  }
-  return result;
+	const result: Record<string, Progress> = {};
+	for (const [key, value] of Object.entries(raw)) {
+		const p = value as Record<string, unknown>;
+		result[key] = {
+			episodeId: p.episodeId as string,
+			position: p.position as number,
+			duration: p.duration as number,
+			timestamp: new Date(p.timestamp as string),
+			playbackSpeed: p.playbackSpeed as number | undefined,
+		};
+	}
+	return result;
 }
 
 async function initProgress(): Promise<void> {
-  const raw = await loadProgressFromFile();
-  const parsed = parseProgressEntries(raw as Record<string, unknown>);
-  setProgressMap(parsed);
+	const raw = await loadProgressFromFile();
+	const parsed = parseProgressEntries(raw as Record<string, unknown>);
+	setProgressMap(parsed);
 }
 
 // Fire-and-forget init
 initProgress();
 
 function createProgressStore() {
-  return {
-    /**
-     * Get progress for a specific episode.
-     */
-    get(episodeId: string): Progress | undefined {
-      return progressMap()[episodeId];
-    },
+	return {
+		/**
+		 * Get progress for a specific episode.
+		 */
+		get(episodeId: string): Progress | undefined {
+			return progressMap()[episodeId];
+		},
 
-    /**
-     * Get all progress entries.
-     */
-    all(): Record<string, Progress> {
-      return progressMap();
-    },
+		/**
+		 * Get all progress entries.
+		 */
+		all(): Record<string, Progress> {
+			return progressMap();
+		},
 
-    /**
-     * Update progress for an episode. Only persists if position is meaningful.
-     */
-    update(
-      episodeId: string,
-      position: number,
-      duration: number,
-      playbackSpeed?: number,
-    ): void {
-      if (position < MIN_POSITION_TO_SAVE && duration > 0) return;
+		/**
+		 * Update progress for an episode. Only persists if position is meaningful.
+		 */
+		update(
+			episodeId: string,
+			position: number,
+			duration: number,
+			playbackSpeed?: number,
+		): void {
+			if (position < MIN_POSITION_TO_SAVE && duration > 0) return;
 
-      setProgressMap((prev) => ({
-        ...prev,
-        [episodeId]: {
-          episodeId,
-          position,
-          duration,
-          timestamp: new Date(),
-          playbackSpeed,
-        },
-      }));
-      persist();
-    },
+			setProgressMap((prev) => ({
+				...prev,
+				[episodeId]: {
+					episodeId,
+					position,
+					duration,
+					timestamp: new Date(),
+					playbackSpeed,
+				},
+			}));
+			persist();
+		},
 
-    /**
-     * Check if an episode is completed.
-     */
-    isCompleted(episodeId: string): boolean {
-      const p = progressMap()[episodeId];
-      if (!p || p.duration <= 0) return false;
-      return p.position / p.duration >= COMPLETION_THRESHOLD;
-    },
+		/**
+		 * Check if an episode is completed.
+		 */
+		isCompleted(episodeId: string): boolean {
+			const p = progressMap()[episodeId];
+			if (!p || p.duration <= 0) return false;
+			return p.position / p.duration >= COMPLETION_THRESHOLD;
+		},
 
-    /**
-     * Get progress percentage (0-100) for an episode.
-     */
-    getPercent(episodeId: string): number {
-      const p = progressMap()[episodeId];
-      if (!p || p.duration <= 0) return 0;
-      return Math.min(100, Math.round((p.position / p.duration) * 100));
-    },
+		/**
+		 * Get progress percentage (0-100) for an episode.
+		 */
+		getPercent(episodeId: string): number {
+			const p = progressMap()[episodeId];
+			if (!p || p.duration <= 0) return 0;
+			return Math.min(100, Math.round((p.position / p.duration) * 100));
+		},
 
-    /**
-     * Mark an episode as completed (set position to duration).
-     */
-    markCompleted(episodeId: string): void {
-      const p = progressMap()[episodeId];
-      const duration = p?.duration ?? 0;
-      setProgressMap((prev) => ({
-        ...prev,
-        [episodeId]: {
-          episodeId,
-          position: duration,
-          duration,
-          timestamp: new Date(),
-          playbackSpeed: p?.playbackSpeed,
-        },
-      }));
-      persist();
-    },
+		/**
+		 * Mark an episode as completed (set position to duration).
+		 */
+		markCompleted(episodeId: string): void {
+			const p = progressMap()[episodeId];
+			const duration = p?.duration ?? 0;
+			setProgressMap((prev) => ({
+				...prev,
+				[episodeId]: {
+					episodeId,
+					position: duration,
+					duration,
+					timestamp: new Date(),
+					playbackSpeed: p?.playbackSpeed,
+				},
+			}));
+			persist();
+		},
 
-    /**
-     * Remove progress for an episode (e.g. "mark as new").
-     */
-    remove(episodeId: string): void {
-      setProgressMap((prev) => {
-        const next = { ...prev };
-        delete next[episodeId];
-        return next;
-      });
-      persist();
-    },
+		/**
+		 * Remove progress for an episode (e.g. "mark as new").
+		 */
+		remove(episodeId: string): void {
+			setProgressMap((prev) => {
+				const next = { ...prev };
+				delete next[episodeId];
+				return next;
+			});
+			persist();
+		},
 
-    /**
-     * Clear all progress data.
-     */
-    clear(): void {
-      setProgressMap({});
-      persist();
-    },
-  };
+		/**
+		 * Clear all progress data.
+		 */
+		clear(): void {
+			setProgressMap({});
+			persist();
+		},
+	};
 }
 
 // Singleton instance
 let instance: ReturnType<typeof createProgressStore> | null = null;
 
 export function useProgressStore() {
-  if (!instance) {
-    instance = createProgressStore();
-  }
-  return instance;
+	if (!instance) {
+		instance = createProgressStore();
+	}
+	return instance;
 }

src/stores/search.ts

@@ -4,7 +4,7 @@
  */
 
 import { createSignal } from "solid-js";
-import { searchPodcasts } from "../utils/search";
+import { searchPodcasts, searchByFeedUrl } from "../utils/search";
 import { useFeedStore } from "./feed";
 import type { SearchResult } from "../types/source";
 
@@ -80,10 +80,18 @@ export function createSearchStore() {
 		setIsSearching(true);
 		setError(null);
 
-		// Add to history
 		addToHistory(q);
 
 		try {
+			// A query that is a direct RSS feed URL (e.g. a private feed that
+			// isn't in any public directory) resolves to that feed directly,
+			// independent of enabled search sources.
+			const urlResults = await searchByFeedUrl(q);
+			if (urlResults.length > 0) {
+				setResults(applySubscribedStatus(urlResults));
+				return;
+			}
+
 			const sources = feedStore.sources();
 			const enabledSourceIds = sources
 				.filter((s) => s.enabled)
@@ -122,7 +130,6 @@ export function createSearchStore() {
 	/** Add query to history */
 	const addToHistory = (q: string) => {
 		setHistory((prev) => {
-			// Remove duplicates and add to front
 			const filtered = prev.filter((h) => h.toLowerCase() !== q.toLowerCase());
 			const updated = [q, ...filtered].slice(0, MAX_HISTORY);
 			saveHistory(updated);

src/types/auth.ts

@@ -1,65 +0,0 @@
-/**
- * Authentication types for PodTUI
- * Authentication is optional and disabled by default
- */
-
-/** User profile information */
-export interface User {
-  id: string
-  email: string
-  name: string
-  createdAt: Date
-  lastLoginAt?: Date
-  syncEnabled: boolean
-}
-
-/** Authentication state */
-export interface AuthState {
-  user: User | null
-  isAuthenticated: boolean
-  isLoading: boolean
-  error: AuthError | null
-}
-
-/** Authentication error */
-export interface AuthError {
-  code: AuthErrorCode
-  message: string
-}
-
-/** Error codes for authentication */
-export enum AuthErrorCode {
-  INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
-  INVALID_CODE = "INVALID_CODE",
-  CODE_EXPIRED = "CODE_EXPIRED",
-  NETWORK_ERROR = "NETWORK_ERROR",
-  UNKNOWN_ERROR = "UNKNOWN_ERROR",
-}
-
-/** Login credentials */
-export interface LoginCredentials {
-  email: string
-  password: string
-}
-
-/** Code validation request */
-export interface CodeValidationRequest {
-  code: string
-}
-
-/** OAuth provider types */
-export enum OAuthProvider {
-  GOOGLE = "google",
-  APPLE = "apple",
-}
-
-/** OAuth provider configuration */
-export interface OAuthProviderConfig {
-  id: OAuthProvider
-  name: string
-  enabled: boolean
-  description: string
-}
-
-/** Auth screen types for navigation */
-export type AuthScreen = "login" | "code" | "oauth" | "profile"

src/types/desktop-theme.ts

@@ -1,12 +1,4 @@
-import type {
-  DesktopTheme,
-  ThemeColors,
-  ThemeDefinition,
-  ThemeName,
-  ThemeToken,
-  ThemeVariant,
-} from "../types/settings"
-import type { ColorValue } from "./theme-schema"
+import type { ThemeColors } from "../types/settings"
 
 // Base theme colors
 export const BASE_THEME_COLORS: ThemeColors = {
@@ -37,156 +29,3 @@ export const BASE_LAYER_BACKGROUND: ThemeColors["layerBackgrounds"] = {
   layer2: "#161b22",
   layer3: "#0d1117",
 }
-
-// Theme tokens
-export const BASE_THEME_TOKENS: ThemeToken = {
-  "background": "transparent",
-  "surface": "#1b1f27",
-  "primary": "#6fa8ff",
-  "secondary": "#a9b1d6",
-  "accent": "#f6c177",
-  "text": "#e6edf3",
-  "muted": "#7d8590",
-  "warning": "#f0b429",
-  "error": "#f47067",
-  "success": "#3fb950",
-  "layer0": "transparent",
-  "layer1": "#1e222e",
-  "layer2": "#161b22",
-  "layer3": "#0d1117",
-}
-
-// Desktop theme structure
-export const THEMES_DESKTOP: DesktopTheme = {
-  name: "PodTUI",
-  variants: [
-    {
-      name: "catppuccin",
-      colors: {
-        background: "transparent",
-        surface: "#1e1e2e",
-        primary: "#89b4fa",
-        secondary: "#cba6f7",
-        accent: "#f9e2af",
-        text: "#cdd6f4",
-        textPrimary: "#cdd6f4",
-        textSecondary: "#cba6f7",
-        textTertiary: "#7f849c",
-        textSelectedPrimary: "#1e1e2e",
-        textSelectedSecondary: "#cdd6f4",
-        textSelectedTertiary: "#cba6f7",
-        muted: "#7f849c",
-        warning: "#fab387",
-        error: "#f38ba8",
-        success: "#a6e3a1",
-    layerBackgrounds: {
-      layer0: "transparent",
-      layer1: "#181825",
-      layer2: "#11111b",
-      layer3: "#0a0a0f",
-    },
-      },
-    },
-    {
-      name: "gruvbox",
-      colors: {
-        background: "transparent",
-        surface: "#282828",
-        primary: "#fabd2f",
-        secondary: "#83a598",
-        accent: "#fe8019",
-        text: "#ebdbb2",
-        textPrimary: "#ebdbb2",
-        textSecondary: "#83a598",
-        textTertiary: "#928374",
-        textSelectedPrimary: "#282828",
-        textSelectedSecondary: "#ebdbb2",
-        textSelectedTertiary: "#83a598",
-        muted: "#928374",
-        warning: "#fabd2f",
-        error: "#fb4934",
-        success: "#b8bb26",
-        layerBackgrounds: {
-          layer0: "transparent",
-          layer1: "#32302a",
-          layer2: "#1d2021",
-          layer3: "#0d0c0c",
-        },
-      },
-    },
-    {
-      name: "tokyo",
-      colors: {
-        background: "transparent",
-        surface: "#1a1b26",
-        primary: "#7aa2f7",
-        secondary: "#bb9af7",
-        accent: "#e0af68",
-        text: "#c0caf5",
-        textPrimary: "#c0caf5",
-        textSecondary: "#bb9af7",
-        textTertiary: "#565f89",
-        textSelectedPrimary: "#1a1b26",
-        textSelectedSecondary: "#c0caf5",
-        textSelectedTertiary: "#bb9af7",
-        muted: "#565f89",
-        warning: "#e0af68",
-        error: "#f7768e",
-        success: "#9ece6a",
-        layerBackgrounds: {
-          layer0: "transparent",
-          layer1: "#16161e",
-          layer2: "#0f0f15",
-          layer3: "#08080b",
-        },
-      },
-    },
-    {
-      name: "nord",
-      colors: {
-        background: "transparent",
-        surface: "#2e3440",
-        primary: "#88c0d0",
-        secondary: "#81a1c1",
-        accent: "#ebcb8b",
-        text: "#eceff4",
-        textPrimary: "#eceff4",
-        textSecondary: "#81a1c1",
-        textTertiary: "#4c566a",
-        textSelectedPrimary: "#2e3440",
-        textSelectedSecondary: "#eceff4",
-        textSelectedTertiary: "#81a1c1",
-        muted: "#4c566a",
-        warning: "#ebcb8b",
-        error: "#bf616a",
-        success: "#a3be8c",
-        layerBackgrounds: {
-          layer0: "transparent",
-          layer1: "#3b4252",
-          layer2: "#242933",
-          layer3: "#1a1c23",
-        },
-      },
-    },
-  ],
-  defaultVariant: "catppuccin",
-  tokens: BASE_THEME_TOKENS,
-}
-
-// Helper function to get theme by name
-export function getThemeByName(name: ThemeName): ThemeVariant | undefined {
-  return THEMES_DESKTOP.variants.find((variant) => variant.name === name)
-}
-
-// Helper function to get default theme
-export function getDefaultTheme(): ThemeVariant {
-  return THEMES_DESKTOP.variants.find(
-    (variant) => variant.name === THEMES_DESKTOP.defaultVariant
-  )!
-}
-
-export type ThemeJsonFile = ThemeDefinition
-
-export function isColorReference(value: ColorValue): value is string {
-  return typeof value === "string" && !value.startsWith("#")
-}

src/types/feed.ts

@@ -97,14 +97,6 @@ export interface FeedListOptions {
   compact: boolean
 }
 
-/** Default feed list options */
-export const DEFAULT_FEED_LIST_OPTIONS: FeedListOptions = {
-  showEpisodeCount: true,
-  showLastUpdated: true,
-  showSource: false,
-  compact: false,
-}
-
 /** Feed statistics */
 export interface FeedStats {
   /** Total feed count */

src/types/settings.ts

@@ -2,95 +2,104 @@ import type { RGBA } from "@opentui/core";
 import type { ColorValue, ThemeJson, Variant } from "./theme-schema";
 
 export type ThemeName =
-  | "system"
-  | "catppuccin"
-  | "gruvbox"
-  | "tokyo"
-  | "nord"
-  | "custom";
+	| "system"
+	| "catppuccin"
+	| "gruvbox"
+	| "tokyo"
+	| "nord"
+	| "custom";
 
 export type LayerBackgrounds = {
-  layer0: ColorValue;
-  layer1: ColorValue;
-  layer2: ColorValue;
-  layer3: ColorValue;
+	layer0: ColorValue;
+	layer1: ColorValue;
+	layer2: ColorValue;
+	layer3: ColorValue;
 };
 
 export type ThemeColors = {
-  background: ColorValue;
-  surface: ColorValue;
-  primary: ColorValue;
-  secondary: ColorValue;
-  accent: ColorValue;
-  text: ColorValue;
-  textPrimary?: ColorValue;
-  textSecondary?: ColorValue;
-  textTertiary?: ColorValue;
-  textSelectedPrimary?: ColorValue;
-  textSelectedSecondary?: ColorValue;
-  textSelectedTertiary?: ColorValue;
-  muted: ColorValue;
-  warning: ColorValue;
-  error: ColorValue;
-  success: ColorValue;
-  layerBackgrounds?: LayerBackgrounds;
-  _hasSelectedListItemText?: boolean;
-  thinkingOpacity?: number;
-  selectedListItemText?: ColorValue;
+	background: ColorValue;
+	surface: ColorValue;
+	primary: ColorValue;
+	secondary: ColorValue;
+	accent: ColorValue;
+	text: ColorValue;
+	textPrimary?: ColorValue;
+	textSecondary?: ColorValue;
+	textTertiary?: ColorValue;
+	textSelectedPrimary?: ColorValue;
+	textSelectedSecondary?: ColorValue;
+	textSelectedTertiary?: ColorValue;
+	muted: ColorValue;
+	warning: ColorValue;
+	error: ColorValue;
+	success: ColorValue;
+	layerBackgrounds?: LayerBackgrounds;
+	_hasSelectedListItemText?: boolean;
+	thinkingOpacity?: number;
+	selectedListItemText?: ColorValue;
 };
 
 export type ThemeVariant = {
-  name: string;
-  colors: ThemeColors;
+	name: string;
+	colors: ThemeColors;
 };
 
 export type ThemeToken = {
-  [key: string]: string;
+	[key: string]: string;
 };
 
 export type ResolvedTheme = Record<string, RGBA> & {
-  layerBackgrounds: Record<string, RGBA>;
-  _hasSelectedListItemText: boolean;
-  thinkingOpacity: number;
+	layerBackgrounds: Record<string, RGBA>;
+	_hasSelectedListItemText: boolean;
+	thinkingOpacity: number;
 };
 
 export type DesktopTheme = {
-  name: string;
-  variants: ThemeVariant[];
-  defaultVariant: string;
-  tokens: ThemeToken;
+	name: string;
+	variants: ThemeVariant[];
+	defaultVariant: string;
+	tokens: ThemeToken;
 };
 
 export type VisualizerSettings = {
-  /** Number of frequency bars (8–128, default: 32) */
-  bars: number;
-  /** Automatic sensitivity: 1 = enabled, 0 = disabled (default: 1) */
-  sensitivity: number;
-  /** Noise reduction factor 0.0–1.0 (default: 0.77) */
-  noiseReduction: number;
-  /** Low frequency cutoff in Hz (default: 50) */
-  lowCutOff: number;
-  /** High frequency cutoff in Hz (default: 10000) */
-  highCutOff: number;
+	/** Number of frequency bars (8–128, default: 64) */
+	bars: number;
+	/** Automatic sensitivity: 1 = enabled, 0 = disabled (default: 1) */
+	sensitivity: number;
+	/** Noise reduction factor 0.0–1.0 (default: 0.77) */
+	noiseReduction: number;
+	/** Low frequency cutoff in Hz (default: 50) */
+	lowCutOff: number;
+	/** High frequency cutoff in Hz (default: 10000) */
+	highCutOff: number;
 };
 
 export type AppSettings = {
-  theme: ThemeName;
-  fontSize: number;
-  playbackSpeed: number;
-  downloadPath: string;
-  visualizer: VisualizerSettings;
+	theme: ThemeName;
+	fontSize: number;
+	playbackSpeed: number;
+	downloadPath: string;
+	/** Render the app background transparent (let the terminal's own bg show). */
+	transparentBackground: boolean;
+	visualizer: VisualizerSettings;
 };
 
+/** How the Feed list loads older episodes (default: manual "[Fetch More]"). */
+export type FetchMoreMode = "manual" | "auto";
+
 export type UserPreferences = {
-  showExplicit: boolean;
-  autoDownload: boolean;
+	showExplicit: boolean;
+	autoDownload: boolean;
+	/** Jump to the Player view automatically when playback starts (default: true) */
+	autoJumpToPlayer: boolean;
+	/** Load older episodes from the Feed list: manual button or automatic at the bottom (default: manual). */
+	fetchMoreMode: FetchMoreMode;
 };
 
 export type AppState = {
-  settings: AppSettings;
-  preferences: UserPreferences;
-  customTheme: ThemeColors;
+	settings: AppSettings;
+	preferences: UserPreferences;
+	customTheme: ThemeColors;
 };
 
 export type ThemeMode = "dark" | "light";

src/types/sync-json.ts

@@ -1,24 +0,0 @@
-export type SyncData = {
-  version: string
-  lastSyncedAt: string
-  feeds: {
-    id: string
-    title: string
-    url: string
-    isPrivate: boolean
-  }[]
-  sources: {
-    id: string
-    name: string
-    url: string
-  }[]
-  settings: {
-    theme: string
-    playbackSpeed: number
-    downloadPath: string
-  }
-  preferences: {
-    showExplicit: boolean
-    autoDownload: boolean
-  }
-}

src/types/sync-xml.ts

@@ -1,28 +0,0 @@
-export type SyncDataXML = {
-  version: string
-  lastSyncedAt: string
-  feeds: {
-    feed: {
-      id: string
-      title: string
-      url: string
-      isPrivate: boolean
-    }[]
-  }
-  sources: {
-    source: {
-      id: string
-      name: string
-      url: string
-    }[]
-  }
-  settings: {
-    theme: string
-    playbackSpeed: number
-    downloadPath: string
-  }
-  preferences: {
-    showExplicit: boolean
-    autoDownload: boolean
-  }
-}

src/types/theme-schema.ts

@@ -13,10 +13,12 @@ export type ColorValue = HexColor | RefName | Variant | RGBA | number
 export type ThemeJson = {
   $schema?: string
   defs?: Record<string, HexColor | RefName>
-  theme: Record<string, ColorValue> & {
+  theme: Record<string, ColorValue | boolean> & {
     selectedListItemText?: ColorValue
     backgroundMenu?: ColorValue
     thinkingOpacity?: number
+    /** Render the app background transparent (let the terminal's own bg show). */
+    transparent?: boolean
   }
 }
 

src/ui/command.tsx

@@ -1,13 +1,13 @@
 import {
-  createContext,
-  createMemo,
-  createSignal,
-  onCleanup,
-  useContext,
-  type Accessor,
-  type ParentProps,
-  For,
-  Show,
+	createContext,
+	createMemo,
+	createSignal,
+	onCleanup,
+	useContext,
+	type Accessor,
+	type ParentProps,
+	For,
+	Show,
 } from "solid-js";
 import { useKeyboard, useTerminalDimensions } from "@opentui/solid";
 import { KeybindsResolved, useKeybinds } from "../context/KeybindContext";
@@ -21,313 +21,316 @@ import { SelectableBox, SelectableText } from "@/components/Selectable";
  * Command option for the command palette.
  */
 export type CommandOption = {
-  /** Display title */
-  title: string;
-  /** Unique identifier */
-  value: string;
-  /** Description shown below title */
-  description?: string;
-  /** Category for grouping */
-  category?: string;
-  /** Keybind reference */
-  keybind?: keyof KeybindsResolved;
-  /** Whether this command is suggested */
-  suggested?: boolean;
-  /** Slash command configuration */
-  slash?: {
-    name: string;
-    aliases?: string[];
-  };
-  /** Whether to hide from command list */
-  hidden?: boolean;
-  /** Whether command is enabled */
-  enabled?: boolean;
-  /** Footer text (usually keybind display) */
-  footer?: string;
-  /** Handler when command is selected */
-  onSelect?: (dialog: ReturnType<typeof useDialog>) => void;
+	/** Display title */
+	title: string;
+	/** Unique identifier */
+	value: string;
+	/** Description shown below title */
+	description?: string;
+	/** Category for grouping */
+	category?: string;
+	/** Keybind reference */
+	keybind?: keyof KeybindsResolved;
+	/** Whether this command is suggested */
+	suggested?: boolean;
+	/** Slash command configuration */
+	slash?: {
+		name: string;
+		aliases?: string[];
+	};
+	/** Whether to hide from command list */
+	hidden?: boolean;
+	/** Whether command is enabled */
+	enabled?: boolean;
+	/** Footer text (usually keybind display) */
+	footer?: string;
+	/** Handler when command is selected */
+	onSelect?: (dialog: ReturnType<typeof useDialog>) => void;
 };
 
 type CommandContext = ReturnType<typeof init>;
 const ctx = createContext<CommandContext>();
 
 function init() {
-  const [registrations, setRegistrations] = createSignal<
-    Accessor<CommandOption[]>[]
-  >([]);
-  const [suspendCount, setSuspendCount] = createSignal(0);
-  const dialog = useDialog();
-  const keybind = useKeybinds();
+	const [registrations, setRegistrations] = createSignal<
+		Accessor<CommandOption[]>[]
+	>([]);
+	const [suspendCount, setSuspendCount] = createSignal(0);
+	const dialog = useDialog();
+	const keybind = useKeybinds();
 
-  const entries = createMemo(() => {
-    const all = registrations().flatMap((x) => x());
-    return all.map((x) => ({
-      ...x,
-      footer: x.keybind ? keybind.print(x.keybind) : undefined,
-    }));
-  });
+	const entries = createMemo(() => {
+		const all = registrations().flatMap((x) => x());
+		return all.map((x) => ({
+			...x,
+			footer: x.keybind ? keybind.print(x.keybind) : undefined,
+		}));
+	});
 
-  const isEnabled = (option: CommandOption) => option.enabled !== false;
-  const isVisible = (option: CommandOption) =>
-    isEnabled(option) && !option.hidden;
+	const isEnabled = (option: CommandOption) => option.enabled !== false;
+	const isVisible = (option: CommandOption) =>
+		isEnabled(option) && !option.hidden;
 
-  const visibleOptions = createMemo(() =>
-    entries().filter((option) => isVisible(option)),
-  );
-  const suggestedOptions = createMemo(() =>
-    visibleOptions()
-      .filter((option) => option.suggested)
-      .map((option) => ({
-        ...option,
-        value: `suggested:${option.value}`,
-        category: "Suggested",
-      })),
-  );
-  const suspended = () => suspendCount() > 0;
+	const visibleOptions = createMemo(() =>
+		entries().filter((option) => isVisible(option)),
+	);
+	const suggestedOptions = createMemo(() =>
+		visibleOptions()
+			.filter((option) => option.suggested)
+			.map((option) => ({
+				...option,
+				value: `suggested:${option.value}`,
+				category: "Suggested",
+			})),
+	);
+	const suspended = () => suspendCount() > 0;
 
-  // Handle keybind shortcuts
-  useKeyboard((evt) => {
-    if (suspended()) return;
-    if (dialog.isOpen) return;
-    for (const option of entries()) {
-      if (!isEnabled(option)) continue;
-      if (option.keybind && keybind.match(option.keybind, evt)) {
-        evt.preventDefault();
-        option.onSelect?.(dialog);
-        emit("command.execute", { command: option.value });
-        return;
-      }
-    }
-  });
+	useKeyboard((evt) => {
+		if (suspended()) return;
+		if (dialog.isOpen) return;
+		for (const option of entries()) {
+			if (!isEnabled(option)) continue;
+			if (option.keybind && keybind.match(option.keybind, evt)) {
+				evt.preventDefault();
+				option.onSelect?.(dialog);
+				emit("command.execute", { command: option.value });
+				return;
+			}
+		}
+	});
 
-  const result = {
-    /**
-     * Trigger a command by its value.
-     */
-    trigger(name: string) {
-      for (const option of entries()) {
-        if (option.value === name) {
-          if (!isEnabled(option)) return;
-          option.onSelect?.(dialog);
-          emit("command.execute", { command: name });
-          return;
-        }
-      }
-    },
-    /**
-     * Get all slash commands.
-     */
-    slashes() {
-      return visibleOptions().flatMap((option) => {
-        const slash = option.slash;
-        if (!slash) return [];
-        return {
-          display: "/" + slash.name,
-          description: option.description ?? option.title,
-          aliases: slash.aliases?.map((alias) => "/" + alias),
-          onSelect: () => result.trigger(option.value),
-        };
-      });
-    },
-    /**
-     * Enable/disable keybinds temporarily.
-     */
-    keybinds(enabled: boolean) {
-      setSuspendCount((count) => count + (enabled ? -1 : 1));
-    },
-    suspended,
-    /**
-     * Show the command palette dialog.
-     */
-    show() {
-      dialog.replace(() => (
-        <CommandDialog
-          options={visibleOptions()}
-          suggestedOptions={suggestedOptions()}
-        />
-      ));
-    },
-    /**
-     * Register commands. Returns cleanup function.
-     */
-    register(cb: () => CommandOption[]) {
-      const results = createMemo(cb);
-      setRegistrations((arr) => [results, ...arr]);
-      onCleanup(() => {
-        setRegistrations((arr) => arr.filter((x) => x !== results));
-      });
-    },
-    /**
-     * Get all visible options.
-     */
-    get options() {
-      return visibleOptions();
-    },
-  };
-  return result;
+	const result = {
+		/**
+		 * Trigger a command by its value.
+		 */
+		trigger(name: string) {
+			for (const option of entries()) {
+				if (option.value === name) {
+					if (!isEnabled(option)) return;
+					option.onSelect?.(dialog);
+					emit("command.execute", { command: name });
+					return;
+				}
+			}
+		},
+		/**
+		 * Get all slash commands.
+		 */
+		slashes() {
+			return visibleOptions().flatMap((option) => {
+				const slash = option.slash;
+				if (!slash) return [];
+				return {
+					display: "/" + slash.name,
+					description: option.description ?? option.title,
+					aliases: slash.aliases?.map((alias) => "/" + alias),
+					onSelect: () => result.trigger(option.value),
+				};
+			});
+		},
+		/**
+		 * Enable/disable keybinds temporarily.
+		 */
+		keybinds(enabled: boolean) {
+			setSuspendCount((count) => count + (enabled ? -1 : 1));
+		},
+		suspended,
+		/**
+		 * Show the command palette dialog.
+		 */
+		show() {
+			dialog.replace(() => (
+				<CommandDialog
+					options={visibleOptions()}
+					suggestedOptions={suggestedOptions()}
+				/>
+			));
+		},
+		/**
+		 * Register commands. Returns cleanup function.
+		 */
+		register(cb: () => CommandOption[]) {
+			const results = createMemo(cb);
+			setRegistrations((arr) => [results, ...arr]);
+			onCleanup(() => {
+				setRegistrations((arr) => arr.filter((x) => x !== results));
+			});
+		},
+		/**
+		 * Get all visible options.
+		 */
+		get options() {
+			return visibleOptions();
+		},
+	};
+	return result;
 }
 
 export function useCommandDialog() {
-  const value = useContext(ctx);
-  if (!value) {
-    throw new Error("useCommandDialog must be used within a CommandProvider");
-  }
-  return value;
+	const value = useContext(ctx);
+	if (!value) {
+		throw new Error("useCommandDialog must be used within a CommandProvider");
+	}
+	return value;
 }
 
 export function CommandProvider(props: ParentProps) {
-  const value = init();
-  const dialog = useDialog();
-  const keybind = useKeybinds();
+	const value = init();
+	const dialog = useDialog();
+	const keybind = useKeybinds();
 
-  // Open command palette on ctrl+p or command_list keybind
-  useKeyboard((evt) => {
-    if (value.suspended()) return;
-    if (dialog.isOpen) return;
-    if (evt.defaultPrevented) return;
-    if (keybind.match("command_list", evt)) {
-      evt.preventDefault();
-      value.show();
-      return;
-    }
-  });
+	// Open the command palette via the `command` keybind (bound to `:` or `q`
+	// in keybinds.jsonc; the Shell router owns the action and runs it first).
+	useKeyboard((evt) => {
+		if (value.suspended()) return;
+		if (dialog.isOpen) return;
+		if (evt.defaultPrevented) return;
+		if (keybind.match("command", evt)) {
+			evt.preventDefault();
+			value.show();
+			return;
+		}
+	});
 
-  return <ctx.Provider value={value}>{props.children}</ctx.Provider>;
+	return <ctx.Provider value={value}>{props.children}</ctx.Provider>;
 }
 
 /**
  * Command palette dialog component.
  */
 function CommandDialog(props: {
-  options: CommandOption[];
-  suggestedOptions: CommandOption[];
+	options: CommandOption[];
+	suggestedOptions: CommandOption[];
 }) {
-  const { theme } = useTheme();
-  const dialog = useDialog();
-  const dimensions = useTerminalDimensions();
-  const [filter, setFilter] = createSignal("");
-  const [selectedIndex, setSelectedIndex] = createSignal(0);
+	const { theme } = useTheme();
+	const dialog = useDialog();
+	const dimensions = useTerminalDimensions();
+	const [filter, setFilter] = createSignal("");
+	const [selectedIndex, setSelectedIndex] = createSignal(0);
 
-  const filteredOptions = createMemo(() => {
-    const query = filter().toLowerCase();
-    if (!query) {
-      return [...props.suggestedOptions, ...props.options];
-    }
-    return props.options.filter(
-      (option) =>
-        option.title.toLowerCase().includes(query) ||
-        option.description?.toLowerCase().includes(query) ||
-        option.category?.toLowerCase().includes(query),
-    );
-  });
+	const filteredOptions = createMemo(() => {
+		const query = filter().toLowerCase();
+		if (!query) {
+			return [...props.suggestedOptions, ...props.options];
+		}
+		return props.options.filter(
+			(option) =>
+				option.title.toLowerCase().includes(query) ||
+				option.description?.toLowerCase().includes(query) ||
+				option.category?.toLowerCase().includes(query),
+		);
+	});
 
-  // Reset selection when filter changes
-  createMemo(() => {
-    filter();
-    setSelectedIndex(0);
-  });
+	// Reset selection when filter changes
+	createMemo(() => {
+		filter();
+		setSelectedIndex(0);
+	});
 
-  useKeyboard((evt) => {
-    if (evt.name === "escape") {
-      dialog.clear();
-      evt.preventDefault();
-      return;
-    }
+	useKeyboard((evt) => {
+		if (evt.name === "escape") {
+			dialog.clear();
+			evt.preventDefault();
+			return;
+		}
 
-    if (evt.name === "return" || evt.name === "enter") {
-      const option = filteredOptions()[selectedIndex()];
-      if (option) {
-        option.onSelect?.(dialog);
-        dialog.clear();
-      }
-      evt.preventDefault();
-      return;
-    }
+		if (evt.name === "return" || evt.name === "enter") {
+			const option = filteredOptions()[selectedIndex()];
+			if (option) {
+				option.onSelect?.(dialog);
+				dialog.clear();
+			}
+			evt.preventDefault();
+			return;
+		}
 
-    if (evt.name === "up" || (evt.ctrl && evt.name === "p")) {
-      setSelectedIndex((i) => Math.max(0, i - 1));
-      evt.preventDefault();
-      return;
-    }
+		if (evt.name === "up" || (evt.ctrl && evt.name === "p")) {
+			setSelectedIndex((i) => Math.max(0, i - 1));
+			evt.preventDefault();
+			return;
+		}
 
-    if (evt.name === "down" || (evt.ctrl && evt.name === "n")) {
-      setSelectedIndex((i) => Math.min(filteredOptions().length - 1, i + 1));
-      evt.preventDefault();
-      return;
-    }
+		if (evt.name === "down" || (evt.ctrl && evt.name === "n")) {
+			setSelectedIndex((i) => Math.min(filteredOptions().length - 1, i + 1));
+			evt.preventDefault();
+			return;
+		}
 
-    // Handle text input
-    if (evt.name && evt.name.length === 1 && !evt.ctrl && !evt.meta) {
-      setFilter((f) => f + evt.name);
-      return;
-    }
+		if (evt.name && evt.name.length === 1 && !evt.ctrl && !evt.meta) {
+			setFilter((f) => f + evt.name);
+			return;
+		}
 
-    if (evt.name === "backspace") {
-      setFilter((f) => f.slice(0, -1));
-      return;
-    }
-  });
+		if (evt.name === "backspace") {
+			setFilter((f) => f.slice(0, -1));
+			return;
+		}
+	});
 
-  const maxHeight = Math.floor(dimensions().height * 0.6);
+	const maxHeight = Math.floor(dimensions().height * 0.6);
 
-  return (
-    <box flexDirection="column" padding={1} borderColor={theme.border}>
-      {/* Search input */}
-      <box marginBottom={1}>
-        <text fg={theme.textMuted}>{"> "}</text>
-        <text fg={theme.text}>{filter() || "Type to search commands..."}</text>
-      </box>
+	return (
+		<box flexDirection="column" padding={1} borderColor={theme.border}>
+			{/* Search input */}
+			<box marginBottom={1}>
+				<text fg={theme.textMuted}>{"> "}</text>
+				<text fg={theme.text}>{filter() || "Type to search commands..."}</text>
+			</box>
 
-      {/* Command list */}
-      <box flexDirection="column" maxHeight={maxHeight} borderColor={theme.border}>
-        <For each={filteredOptions().slice(0, 10)}>
-          {(option, index) => (
-            <SelectableBox
-              selected={() => index() === selectedIndex()}
-              flexDirection="column"
-              padding={1}
-              onMouseDown={() => {
-                setSelectedIndex(index());
-                const selectedOption = filteredOptions()[index()];
-                if (selectedOption) {
-                  selectedOption.onSelect?.(dialog);
-                  dialog.clear();
-                }
-              }}
-            >
-               <box flexDirection="column" flexGrow={1}>
-                 <SelectableText
-                   selected={() => index() === selectedIndex()}
-                   primary
-                 >
-                   {option.title}
-                 </SelectableText>
-                 <Show when={option.footer}>
-                   <SelectableText
-                     selected={() => index() === selectedIndex()}
-                     tertiary
-                   >
-                     {option.footer}
-                   </SelectableText>
-                 </Show>
-                 <Show when={option.description}>
-                   <SelectableText
-                     selected={() => index() === selectedIndex()}
-                     tertiary
-                   >
-                     {option.description}
-                   </SelectableText>
-                 </Show>
-               </box>
-            </SelectableBox>
-          )}
-        </For>
-        <Show when={filteredOptions().length === 0}>
-          <text fg={theme.textMuted} style={{ padding: 1 }}>
-            No commands found
-          </text>
-        </Show>
-      </box>
-    </box>
-  );
+			{/* Command list */}
+			<box
+				flexDirection="column"
+				maxHeight={maxHeight}
+				borderColor={theme.border}
+			>
+				<For each={filteredOptions().slice(0, 10)}>
+					{(option, index) => (
+						<SelectableBox
+							selected={() => index() === selectedIndex()}
+							flexDirection="column"
+							padding={1}
+							onMouseDown={() => {
+								setSelectedIndex(index());
+								const selectedOption = filteredOptions()[index()];
+								if (selectedOption) {
+									selectedOption.onSelect?.(dialog);
+									dialog.clear();
+								}
+							}}
+						>
+							<box flexDirection="column" flexGrow={1}>
+								<SelectableText
+									selected={() => index() === selectedIndex()}
+									primary
+								>
+									{option.title}
+								</SelectableText>
+								<Show when={option.footer}>
+									<SelectableText
+										selected={() => index() === selectedIndex()}
+										tertiary
+									>
+										{option.footer}
+									</SelectableText>
+								</Show>
+								<Show when={option.description}>
+									<SelectableText
+										selected={() => index() === selectedIndex()}
+										tertiary
+									>
+										{option.description}
+									</SelectableText>
+								</Show>
+							</box>
+						</SelectableBox>
+					)}
+				</For>
+				<Show when={filteredOptions().length === 0}>
+					<text fg={theme.textMuted} style={{ padding: 1 }}>
+						No commands found
+					</text>
+				</Show>
+			</box>
+		</box>
+	);
 }

src/ui/dialog.tsx

@@ -12,7 +12,7 @@ export type DialogSize = "medium" | "large"
 /**
  * Dialog component that renders a modal overlay with content.
  */
-export function Dialog(
+function Dialog(
   props: ParentProps<{
     size?: DialogSize
     onClose: () => void

src/utils/app-persistence.ts

@@ -1,158 +1,154 @@
 /**
- * App state persistence via JSON file in XDG_CONFIG_HOME
+ * App state persistence — settings, preferences, and custom theme are stored
+ * in the centralized `config.json` (see utils/config.ts). Playback progress
+ * and audio-nav state stay in separate files (they change on every seek and
+ * would thrash config.json).
  *
- * Reads and writes app settings, preferences, and custom theme to a JSON file
+ * No backups — writes always overwrite.
  */
 
 import { ensureConfigDir, getConfigFilePath } from "./config-dir";
-import { backupConfigFile } from "./config-backup";
+import { loadConfig, updateConfig } from "./config";
 import type {
-  AppState,
-  AppSettings,
-  UserPreferences,
-  VisualizerSettings,
+	AppState,
+	AppSettings,
+	UserPreferences,
+	VisualizerSettings,
 } from "../types/settings";
 import { DEFAULT_THEME } from "../constants/themes";
 
-const APP_STATE_FILE = "app-state.json";
-const PROGRESS_FILE = "progress.json";
-const AUDIO_NAV_FILE = "audio-nav.json";
-
 // --- Defaults ---
 
 const defaultVisualizerSettings: VisualizerSettings = {
-  bars: 32,
-  sensitivity: 1,
-  noiseReduction: 0.77,
-  lowCutOff: 50,
-  highCutOff: 10000,
+	bars: 32,
+	sensitivity: 1,
+	noiseReduction: 0.77,
+	lowCutOff: 50,
+	highCutOff: 10000,
 };
 
 const defaultSettings: AppSettings = {
-  theme: "system",
-  fontSize: 14,
-  playbackSpeed: 1,
-  downloadPath: "",
-  visualizer: defaultVisualizerSettings,
+	theme: "system",
+	fontSize: 14,
+	playbackSpeed: 1,
+	downloadPath: "",
+	transparentBackground: false,
+	visualizer: defaultVisualizerSettings,
 };
 
 const defaultPreferences: UserPreferences = {
-  showExplicit: false,
-  autoDownload: false,
+	showExplicit: false,
+	autoDownload: false,
+	autoJumpToPlayer: true,
+	fetchMoreMode: "manual",
 };
 
 const defaultState: AppState = {
-  settings: defaultSettings,
-  preferences: defaultPreferences,
-  customTheme: DEFAULT_THEME,
+	settings: defaultSettings,
+	preferences: defaultPreferences,
+	customTheme: DEFAULT_THEME,
 };
 
-// --- App State ---
+// ── App State (config.json) ─────────────────────────────────────────────────
 
-/** Load app state from JSON file */
+/** Load app state from config.json */
 export async function loadAppStateFromFile(): Promise<AppState> {
-  try {
-    const filePath = getConfigFilePath(APP_STATE_FILE);
-    const file = Bun.file(filePath);
-    if (!(await file.exists())) return defaultState;
-
-    const raw = await file.json();
-    if (!raw || typeof raw !== "object") return defaultState;
-
-    const parsed = raw as Partial<AppState>;
-    return {
-      settings: { ...defaultSettings, ...parsed.settings },
-      preferences: { ...defaultPreferences, ...parsed.preferences },
-      customTheme: { ...DEFAULT_THEME, ...parsed.customTheme },
-    };
-  } catch {
-    return defaultState;
-  }
+	try {
+		const cfg = await loadConfig();
+		if (!cfg || typeof cfg !== "object") return defaultState;
+		return {
+			settings: { ...defaultSettings, ...cfg.settings },
+			preferences: { ...defaultPreferences, ...cfg.preferences },
+			customTheme: { ...DEFAULT_THEME, ...cfg.customTheme },
+		};
+	} catch {
+		return defaultState;
+	}
 }
 
-/** Save app state to JSON file */
-export async function saveAppStateToFile(state: AppState): Promise<void> {
-  try {
-    await ensureConfigDir();
-    await backupConfigFile(APP_STATE_FILE);
-    const filePath = getConfigFilePath(APP_STATE_FILE);
-    await Bun.write(filePath, JSON.stringify(state, null, 2));
-  } catch {
-    // Silently ignore write errors
-  }
+/** Save app state to config.json */
+export function saveAppStateToFile(state: AppState): void {
+	updateConfig({
+		settings: state.settings,
+		preferences: state.preferences,
+		customTheme: state.customTheme,
+	});
 }
 
+// ── Playback Progress (separate file — changes on every seek) ───────────────
+
+const PROGRESS_FILE = "progress.json";
+
 interface ProgressEntry {
-  episodeId: string;
-  position: number;
-  duration: number;
-  timestamp: string | Date;
-  playbackSpeed?: number;
+	episodeId: string;
+	position: number;
+	duration: number;
+	timestamp: string | Date;
+	playbackSpeed?: number;
 }
 
 /** Load progress map from JSON file */
 export async function loadProgressFromFile(): Promise<
-  Record<string, ProgressEntry>
+	Record<string, ProgressEntry>
 > {
-  try {
-    const filePath = getConfigFilePath(PROGRESS_FILE);
-    const file = Bun.file(filePath);
-    if (!(await file.exists())) return {};
+	try {
+		const filePath = getConfigFilePath(PROGRESS_FILE);
+		const file = Bun.file(filePath);
+		if (!(await file.exists())) return {};
 
-    const raw = await file.json();
-    if (!raw || typeof raw !== "object") return {};
-    return raw as Record<string, ProgressEntry>;
-  } catch {
-    return {};
-  }
+		const raw = await file.json();
+		if (!raw || typeof raw !== "object") return {};
+		return raw as Record<string, ProgressEntry>;
+	} catch {
+		return {};
+	}
 }
 
-/** Save progress map to JSON file */
-export async function saveProgressToFile(
-  data: Record<string, unknown>,
-): Promise<void> {
-  try {
-    await ensureConfigDir();
-    await backupConfigFile(PROGRESS_FILE);
-    const filePath = getConfigFilePath(PROGRESS_FILE);
-    await Bun.write(filePath, JSON.stringify(data, null, 2));
-  } catch {
-    // Silently ignore write errors
-  }
+/** Save progress map to JSON file (overwrite, no backup) */
+export function saveProgressToFile(data: Record<string, unknown>): void {
+	(async () => {
+		try {
+			await ensureConfigDir();
+			await Bun.write(
+				getConfigFilePath(PROGRESS_FILE),
+				JSON.stringify(data, null, 2),
+			);
+		} catch {
+			// Silently ignore write errors
+		}
+	})();
 }
 
-interface AudioNavEntry {
-  source: string;
-  currentIndex: number;
-  podcastId?: string;
-  lastUpdated: string;
-}
+// ── Audio Nav State (separate file — changes on every track change) ──────────
+
+const AUDIO_NAV_FILE = "audio-nav.json";
 
 /** Load audio navigation state from JSON file */
 export async function loadAudioNavFromFile<T>(): Promise<T | null> {
-  try {
-    const filePath = getConfigFilePath(AUDIO_NAV_FILE);
-    const file = Bun.file(filePath);
-    if (!(await file.exists())) return null;
+	try {
+		const file = Bun.file(getConfigFilePath(AUDIO_NAV_FILE));
+		if (!(await file.exists())) return null;
 
-    const raw = await file.json();
-    if (!raw || typeof raw !== "object") return null;
+		const raw = await file.json();
+		if (!raw || typeof raw !== "object") return null;
 
-    return raw as T;
-  } catch {
-    return null;
-  }
+		return raw as T;
+	} catch {
+		return null;
+	}
 }
 
-/** Save audio navigation state to JSON file */
-export async function saveAudioNavToFile<T>(
-  data: T,
-): Promise<void> {
-  try {
-    await ensureConfigDir();
-    const filePath = getConfigFilePath(AUDIO_NAV_FILE);
-    await Bun.write(filePath, JSON.stringify(data, null, 2));
-  } catch {
-    // Silently ignore write errors
-  }
+/** Save audio navigation state to JSON file (overwrite, no backup) */
+export function saveAudioNavToFile<T>(data: T): void {
+	(async () => {
+		try {
+			await ensureConfigDir();
+			await Bun.write(
+				getConfigFilePath(AUDIO_NAV_FILE),
+				JSON.stringify(data, null, 2),
+			);
+		} catch {
+			// Silently ignore write errors
+		}
+	})();
 }

src/utils/audio-player.ts

@@ -1,14 +1,11 @@
 /**
- * Cross-platform audio playback engine for PodTUI.
+ * Audio playback engine for PodTUI.
  *
- * Backend priority:
- *   1. mpv   — full IPC control (seek, volume, speed, position tracking)
- *   2. ffplay — basic control via process signals
- *   3. afplay — macOS built-in (no seek/speed, volume only)
- *   4. system — open/xdg-open/start (fire-and-forget, no control)
- *
- * All backends implement the AudioBackend interface so the Player
- * component doesn't need to care which one is active.
+ * Single backend: mpv — full IPC control (seek, volume, speed, position
+ * tracking), so speed/volume/seek changes apply instantly with no process
+ * restart. When mpv isn't installed there is no fallback: the no-op backend
+ * surfaces "No audio player found" honestly rather than degrading through
+ * players that can't change speed/volume without restarting.
  */
 
 import { platform } from "os";
@@ -18,7 +15,7 @@ import { join } from "path";
 
 // ── Types ────────────────────────────────────────────────────────────
 
-export type BackendName = "mpv" | "ffplay" | "afplay" | "system" | "none";
+export type BackendName = "mpv" | "none";
 
 export interface AudioState {
 	playing: boolean;
@@ -78,7 +75,7 @@ function mpvSocketPath(): string {
 // ── mpv Backend ──────────────────────────────────────────────────────
 // Uses JSON IPC over a Unix socket for full bidirectional control.
 
-class MpvBackend implements AudioBackend {
+export class MpvBackend implements AudioBackend {
 	readonly name: BackendName = "mpv";
 	private proc: ReturnType<typeof Bun.spawn> | null = null;
 	private socketPath = mpvSocketPath();
@@ -381,467 +378,6 @@ class MpvBackend implements AudioBackend {
 	}
 }
 
-// ── ffplay Backend ───────────────────────────────────────────────────
-// ffplay has no IPC. We track duration from episode metadata and
-// position via elapsed wall-clock time. Seek requires restarting.
-
-class FfplayBackend implements AudioBackend {
-	readonly name: BackendName = "ffplay";
-	private proc: ReturnType<typeof Bun.spawn> | null = null;
-	private _playing = false;
-	private _paused = false;
-	private _position = 0;
-	private _duration = 0;
-	private _volume = 100;
-	private _speed = 1;
-	private _url = "";
-	private startTime = 0;
-	private pollTimer: ReturnType<typeof setInterval> | null = null;
-
-	async play(url: string, opts?: PlayOptions): Promise<void> {
-		await this.stop();
-
-		this._url = url;
-		this._volume = Math.round((opts?.volume ?? 1) * 100);
-		this._speed = opts?.speed ?? 1;
-		this._position = opts?.startPosition ?? 0;
-
-		this.spawnProcess();
-	}
-
-	private spawnProcess(): void {
-		const args = [
-			"ffplay",
-			"-nodisp",
-			"-autoexit",
-			"-loglevel",
-			"quiet",
-			"-volume",
-			String(this._volume),
-		];
-
-		if (this._position > 0) {
-			args.push("-ss", String(this._position));
-		}
-
-		if (this._speed !== 1) {
-			args.push("-af", `atempo=${this._speed}`);
-		}
-
-		args.push("-i", this._url);
-
-		this.proc = Bun.spawn(args, {
-			stdout: "ignore",
-			stderr: "ignore",
-			stdin: "ignore",
-		});
-
-		this._playing = true;
-		this._paused = false;
-		this.startTime = Date.now();
-		this.startPolling();
-
-		this.proc.exited
-			.then(() => {
-				this._playing = false;
-				this.stopPolling();
-			})
-			.catch(() => {});
-	}
-
-	private startPolling(): void {
-		this.stopPolling();
-		this.pollTimer = setInterval(() => {
-			if (!this._playing) return;
-			const elapsed = ((Date.now() - this.startTime) / 1000) * this._speed;
-			this._position = this._position + elapsed;
-			this.startTime = Date.now();
-		}, 500);
-	}
-
-	private stopPolling(): void {
-		if (this.pollTimer) {
-			clearInterval(this.pollTimer);
-			this.pollTimer = null;
-		}
-	}
-
-	async pause(): Promise<void> {
-		if (this.proc) {
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			try {
-				if (pid) process.kill(pid, "SIGSTOP");
-			} catch {}
-			this._paused = true;
-		}
-		this._playing = false;
-		this.stopPolling();
-	}
-
-	async resume(): Promise<void> {
-		if (!this._url) return;
-		if (this.proc && this._paused) {
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			try {
-				if (pid) process.kill(pid, "SIGCONT");
-			} catch {}
-			this._paused = false;
-			this._playing = true;
-			this.startTime = Date.now();
-			this.startPolling();
-			return;
-		}
-		this.spawnProcess();
-	}
-
-	async stop(): Promise<void> {
-		this.stopPolling();
-		if (this.proc) {
-			try {
-				this.proc.kill();
-			} catch {}
-			this.proc = null;
-		}
-		this._playing = false;
-		this._paused = false;
-		this._position = 0;
-		this._url = "";
-	}
-
-	async seek(seconds: number): Promise<void> {
-		this._position = seconds;
-		if (this._playing && this._url) {
-			// Restart at new position
-			if (this.proc) {
-				try {
-					this.proc.kill();
-				} catch {}
-				this.proc = null;
-			}
-			this.spawnProcess();
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			if (this._paused && pid) {
-				try {
-					process.kill(pid, "SIGSTOP");
-				} catch {}
-				this._playing = false;
-			}
-		}
-	}
-
-	async setVolume(volume: number): Promise<void> {
-		this._volume = Math.round(volume * 100);
-		// ffplay has no runtime IPC; volume will apply on next play/resume.
-		// Restart the process to apply immediately if currently playing.
-		if (this._url && (this._playing || this._paused)) {
-			this.stopPolling();
-			if (this.proc) {
-				try {
-					this.proc.kill();
-				} catch {}
-				this.proc = null;
-			}
-			this.spawnProcess();
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			if (this._paused && pid) {
-				try {
-					process.kill(pid, "SIGSTOP");
-				} catch {}
-				this._playing = false;
-			}
-		}
-	}
-
-	async setSpeed(speed: number): Promise<void> {
-		this._speed = speed;
-		if (this._url && (this._playing || this._paused)) {
-			this.stopPolling();
-			if (this.proc) {
-				try {
-					this.proc.kill();
-				} catch {}
-				this.proc = null;
-			}
-			this.spawnProcess();
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			if (this._paused && pid) {
-				try {
-					process.kill(pid, "SIGSTOP");
-				} catch {}
-				this._playing = false;
-			}
-		}
-	}
-
-	async getPosition(): Promise<number> {
-		return this._position;
-	}
-
-	async getDuration(): Promise<number> {
-		return this._duration;
-	}
-
-	isPlaying(): boolean {
-		return this._playing;
-	}
-
-	dispose(): void {
-		this.stop();
-	}
-}
-
-// ── afplay Backend (macOS) ───────────────────────────────────────────
-// Built-in on macOS. Supports volume and rate but no seek or position.
-
-class AfplayBackend implements AudioBackend {
-	readonly name: BackendName = "afplay";
-	private proc: ReturnType<typeof Bun.spawn> | null = null;
-	private _playing = false;
-	private _paused = false;
-	private _position = 0;
-	private _duration = 0;
-	private _volume = 1;
-	private _speed = 1;
-	private _url = "";
-	private startTime = 0;
-	private pollTimer: ReturnType<typeof setInterval> | null = null;
-
-	async play(url: string, opts?: PlayOptions): Promise<void> {
-		await this.stop();
-
-		this._url = url;
-		this._volume = opts?.volume ?? 1;
-		this._speed = opts?.speed ?? 1;
-		this._position = opts?.startPosition ?? 0;
-
-		this.spawnProcess();
-	}
-
-	private spawnProcess(): void {
-		// afplay supports --volume (0-1) and --rate
-		const args = [
-			"afplay",
-			"--volume",
-			String(this._volume),
-			"--rate",
-			String(this._speed),
-		];
-
-		if (this._position > 0) {
-			args.push(
-				"--time",
-				String(this._duration > 0 ? this._duration - this._position : 0),
-			);
-		}
-
-		args.push(this._url);
-
-		this.proc = Bun.spawn(args, {
-			stdout: "ignore",
-			stderr: "ignore",
-			stdin: "ignore",
-		});
-
-		this._playing = true;
-		this._paused = false;
-		this.startTime = Date.now();
-		this.startPolling();
-
-		this.proc.exited
-			.then(() => {
-				this._playing = false;
-				this.stopPolling();
-			})
-			.catch(() => {});
-	}
-
-	private startPolling(): void {
-		this.stopPolling();
-		this.pollTimer = setInterval(() => {
-			if (!this._playing) return;
-			const elapsed = ((Date.now() - this.startTime) / 1000) * this._speed;
-			this._position = this._position + elapsed;
-			this.startTime = Date.now();
-		}, 500);
-	}
-
-	private stopPolling(): void {
-		if (this.pollTimer) {
-			clearInterval(this.pollTimer);
-			this.pollTimer = null;
-		}
-	}
-
-	async pause(): Promise<void> {
-		if (this.proc) {
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			try {
-				if (pid) process.kill(pid, "SIGSTOP");
-			} catch {}
-			this._paused = true;
-		}
-		this._playing = false;
-		this.stopPolling();
-	}
-
-	async resume(): Promise<void> {
-		if (!this._url) return;
-		if (this.proc && this._paused) {
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			try {
-				if (pid) process.kill(pid, "SIGCONT");
-			} catch {}
-			this._paused = false;
-			this._playing = true;
-			this.startTime = Date.now();
-			this.startPolling();
-			return;
-		}
-		this.spawnProcess();
-	}
-
-	async stop(): Promise<void> {
-		this.stopPolling();
-		if (this.proc) {
-			try {
-				this.proc.kill();
-			} catch {}
-			this.proc = null;
-		}
-		this._playing = false;
-		this._paused = false;
-		this._position = 0;
-		this._url = "";
-	}
-
-	async seek(seconds: number): Promise<void> {
-		this._position = seconds;
-		if (this._playing && this._url) {
-			if (this.proc) {
-				try {
-					this.proc.kill();
-				} catch {}
-				this.proc = null;
-			}
-			this.spawnProcess();
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			if (this._paused && pid) {
-				try {
-					process.kill(pid, "SIGSTOP");
-				} catch {}
-				this._playing = false;
-			}
-		}
-	}
-
-	async setVolume(volume: number): Promise<void> {
-		this._volume = volume;
-		// Restart the process with new volume to apply immediately
-		if (this._url && (this._playing || this._paused)) {
-			this.stopPolling();
-			if (this.proc) {
-				try {
-					this.proc.kill();
-				} catch {}
-				this.proc = null;
-			}
-			this.spawnProcess();
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			if (this._paused && pid) {
-				try {
-					process.kill(pid, "SIGSTOP");
-				} catch {}
-				this._playing = false;
-			}
-		}
-	}
-
-	async setSpeed(speed: number): Promise<void> {
-		this._speed = speed;
-		// Restart the process with new rate to apply immediately
-		if (this._url && (this._playing || this._paused)) {
-			this.stopPolling();
-			if (this.proc) {
-				try {
-					this.proc.kill();
-				} catch {}
-				this.proc = null;
-			}
-			this.spawnProcess();
-			const pid = (this.proc as unknown as { pid?: number } | null)?.pid;
-			if (this._paused && pid) {
-				try {
-					process.kill(pid, "SIGSTOP");
-				} catch {}
-				this._playing = false;
-			}
-		}
-	}
-
-	async getPosition(): Promise<number> {
-		return this._position;
-	}
-
-	async getDuration(): Promise<number> {
-		return this._duration;
-	}
-
-	isPlaying(): boolean {
-		return this._playing;
-	}
-
-	dispose(): void {
-		this.stop();
-	}
-}
-
-// ── System Backend (open/xdg-open) ───────────────────────────────────
-// Fire-and-forget. Opens the URL in the default handler. No control.
-
-class SystemBackend implements AudioBackend {
-	readonly name: BackendName = "system";
-	private _playing = false;
-
-	async play(url: string): Promise<void> {
-		const os = platform();
-		const cmd =
-			os === "darwin" ? "open" : os === "win32" ? "start" : "xdg-open";
-
-		Bun.spawn([cmd, url], {
-			stdout: "ignore",
-			stderr: "ignore",
-			stdin: "ignore",
-		});
-
-		this._playing = true;
-	}
-
-	async pause(): Promise<void> {
-		this._playing = false;
-	}
-	async resume(): Promise<void> {
-		this._playing = true;
-	}
-	async stop(): Promise<void> {
-		this._playing = false;
-	}
-	async seek(): Promise<void> {}
-	async setVolume(): Promise<void> {}
-	async setSpeed(): Promise<void> {}
-	async getPosition(): Promise<number> {
-		return 0;
-	}
-	async getDuration(): Promise<number> {
-		return 0;
-	}
-	isPlaying(): boolean {
-		return this._playing;
-	}
-	dispose(): void {
-		this._playing = false;
-	}
-}
-
 // ── No-op Backend ────────────────────────────────────────────────────
 
 class NoopBackend implements AudioBackend {
@@ -896,53 +432,6 @@ export function detectPlayers(): DetectedPlayer[] {
 		});
 	}
 
-	const ffplayPath = which("ffplay");
-	if (ffplayPath) {
-		players.push({
-			name: "ffplay",
-			path: ffplayPath,
-			capabilities: {
-				seek: true,
-				volume: true,
-				speed: false,
-				positionTracking: false,
-			},
-		});
-	}
-
-	const os = platform();
-	if (os === "darwin") {
-		const afplayPath = which("afplay");
-		if (afplayPath) {
-			players.push({
-				name: "afplay",
-				path: afplayPath,
-				capabilities: {
-					seek: true,
-					volume: true,
-					speed: true,
-					positionTracking: false,
-				},
-			});
-		}
-	}
-
-	// System open is always available as fallback
-	const openCmd =
-		os === "darwin" ? "open" : os === "win32" ? "start" : "xdg-open";
-	if (which(openCmd)) {
-		players.push({
-			name: "system",
-			path: which(openCmd),
-			capabilities: {
-				seek: false,
-				volume: false,
-				speed: false,
-				positionTracking: false,
-			},
-		});
-	}
-
 	return players;
 }
 
@@ -953,14 +442,7 @@ export function createAudioBackend(preferred?: BackendName): AudioBackend {
 	// An explicit `preferred` argument still wins.
 	if (!preferred) {
 		const envPref = process.env.PODTUI_AUDIO_BACKEND as BackendName | undefined;
-		if (
-			envPref &&
-			(envPref === "mpv" ||
-				envPref === "ffplay" ||
-				envPref === "afplay" ||
-				envPref === "system" ||
-				envPref === "none")
-		) {
+		if (envPref && (envPref === "mpv" || envPref === "none")) {
 			preferred = envPref;
 		}
 	}
@@ -970,25 +452,13 @@ export function createAudioBackend(preferred?: BackendName): AudioBackend {
 		if (backend) return backend;
 	}
 
-	// Auto-detect in priority order
-	const players = detectPlayers();
-	if (players.length === 0) return new NoopBackend();
-
-	return createBackendByName(players[0].name) ?? new NoopBackend();
+	return which("mpv") ? new MpvBackend() : new NoopBackend();
 }
 
 function createBackendByName(name: BackendName): AudioBackend | null {
 	switch (name) {
 		case "mpv":
 			return which("mpv") ? new MpvBackend() : null;
-		case "ffplay":
-			return which("ffplay") ? new FfplayBackend() : null;
-		case "afplay":
-			return platform() === "darwin" && which("afplay")
-				? new AfplayBackend()
-				: null;
-		case "system":
-			return new SystemBackend();
 		case "none":
 			return new NoopBackend();
 	}

src/utils/audio-stream-reader.ts

@@ -11,18 +11,18 @@
  */
 
 /** PCM output format constants */
-const SAMPLE_RATE = 44100
-const CHANNELS = 1
-const BYTES_PER_SAMPLE = 2 // s16le
+const SAMPLE_RATE = 44100;
+const CHANNELS = 1;
+const BYTES_PER_SAMPLE = 2; // s16le
 
 /** How many samples to buffer (~1 second) */
-const RING_BUFFER_SAMPLES = SAMPLE_RATE
+const RING_BUFFER_SAMPLES = SAMPLE_RATE;
 
 export interface AudioStreamReaderOptions {
-  /** Audio URL or file path to decode */
-  url: string
-  /** Sample rate (default: 44100) */
-  sampleRate?: number
+	/** Audio URL or file path to decode */
+	url: string;
+	/** Sample rate (default: 44100) */
+	sampleRate?: number;
 }
 
 /**
@@ -30,202 +30,230 @@ export interface AudioStreamReaderOptions {
  * Each start() increments this; the read loop checks it to know
  * if it's been superseded and should bail out.
  */
-let globalGeneration = 0
+let globalGeneration = 0;
 
 export class AudioStreamReader {
-  private proc: ReturnType<typeof Bun.spawn> | null = null
-  private ringBuffer: Float64Array
-  private writePos = 0
-  private totalSamplesWritten = 0
-  private _running = false
-  private generation = 0
-  readonly url: string
-  private sampleRate: number
+	private proc: ReturnType<typeof Bun.spawn> | null = null;
+	private ringBuffer: Float64Array;
+	private writePos = 0;
+	private totalSamplesWritten = 0;
+	private _running = false;
+	private generation = 0;
+	readonly url: string;
+	private sampleRate: number;
 
-  constructor(options: AudioStreamReaderOptions) {
-    this.url = options.url
-    this.sampleRate = options.sampleRate ?? SAMPLE_RATE
-    this.ringBuffer = new Float64Array(RING_BUFFER_SAMPLES)
-  }
+	constructor(options: AudioStreamReaderOptions) {
+		this.url = options.url;
+		this.sampleRate = options.sampleRate ?? SAMPLE_RATE;
+		this.ringBuffer = new Float64Array(RING_BUFFER_SAMPLES);
+	}
 
-  /** Whether the reader is actively reading samples. */
-  get running(): boolean {
-    return this._running
-  }
+	/** Whether the reader is actively reading samples. */
+	get running(): boolean {
+		return this._running;
+	}
 
-  /** Total number of samples written since start(). */
-  get samplesWritten(): number {
-    return this.totalSamplesWritten
-  }
+	/** Total number of samples written since start(). */
+	get samplesWritten(): number {
+		return this.totalSamplesWritten;
+	}
 
-  /**
-   * Start the ffmpeg decode process and begin reading PCM data.
-   *
-   * If already running, the previous process is killed first.
-   * Uses a generation counter to guarantee that only one read loop
-   * is ever active — stale loops from killed processes bail out
-   * immediately.
-   *
-   * @param startPosition Seek position in seconds (default: 0).
-   * @param speed Playback speed multiplier (default: 1). Applies ffmpeg
-   *              atempo filter so visualization stays in sync with audio.
-   */
-  start(startPosition = 0, speed = 1): void {
-    // Always kill the previous process first — no early return on _running
-    this.killProcess()
+	/**
+	 * Start the ffmpeg decode process and begin reading PCM data.
+	 *
+	 * If already running, the previous process is killed first.
+	 * Uses a generation counter to guarantee that only one read loop
+	 * is ever active — stale loops from killed processes bail out
+	 * immediately.
+	 *
+	 * @param startPosition Seek position in seconds (default: 0).
+	 * @param speed Playback speed multiplier (default: 1). Applies ffmpeg
+	 *              atempo filter so visualization stays in sync with audio.
+	 */
+	start(startPosition = 0, speed = 1): void {
+		// Always kill the previous process first — no early return on _running
+		this.killProcess();
 
-    if (!Bun.which("ffmpeg")) {
-      throw new Error("ffmpeg not found — required for audio visualization")
-    }
+		if (!Bun.which("ffmpeg")) {
+			throw new Error("ffmpeg not found — required for audio visualization");
+		}
 
-    // Increment generation so any lingering read loop from a previous
-    // start() will see a mismatch and exit.
-    this.generation = ++globalGeneration
+		// Increment generation so any lingering read loop from a previous
+		// start() will see a mismatch and exit.
+		this.generation = ++globalGeneration;
 
-    const args = [
-      "ffmpeg",
-      "-loglevel", "quiet",
-      "-reconnect", "1",
-      "-reconnect_streamed", "1",
-      "-reconnect_delay_max", "5",
-    ]
+		const args = [
+			"ffmpeg",
+			"-loglevel",
+			"quiet",
+			// Read input at native frame rate so decoded PCM stays in sync with
+			// real-time playback. Without -re, ffmpeg greedily decodes the whole
+			// file as fast as possible: the ring buffer fills with audio seconds
+			// ahead of the player (laggy bars), then the process exits when it
+			// hits EOF (bars freeze ~10s in).
+			"-re",
+			"-reconnect",
+			"1",
+			"-reconnect_streamed",
+			"1",
+			"-reconnect_delay_max",
+			"5",
+		];
 
-    // Seek before input for network efficiency
-    if (startPosition > 0) {
-      args.push("-ss", String(startPosition))
-    }
+		// Seek before input for network efficiency
+		if (startPosition > 0) {
+			args.push("-ss", String(startPosition));
+		}
 
-    args.push("-i", this.url)
+		args.push("-i", this.url);
 
-    // Apply speed via atempo filter if not 1x.
-    // ffmpeg atempo only supports 0.5–100.0; chain multiple for extremes.
-    if (speed !== 1 && speed > 0) {
-      args.push("-af", buildAtempoChain(speed))
-    }
+		// Apply speed via atempo filter if not 1x.
+		// ffmpeg atempo only supports 0.5–100.0; chain multiple for extremes.
+		if (speed !== 1 && speed > 0) {
+			args.push("-af", buildAtempoChain(speed));
+		}
 
-    args.push(
-      "-ac", String(CHANNELS),
-      "-ar", String(this.sampleRate),
-      "-f", "s16le",
-      "-acodec", "pcm_s16le",
-      "-",
-    )
+		args.push(
+			"-ac",
+			String(CHANNELS),
+			"-ar",
+			String(this.sampleRate),
+			"-f",
+			"s16le",
+			"-acodec",
+			"pcm_s16le",
+			"-",
+		);
 
-    this.proc = Bun.spawn(args, {
-      stdout: "pipe",
-      stderr: "ignore",
-      stdin: "ignore",
-    })
+		this.proc = Bun.spawn(args, {
+			stdout: "pipe",
+			stderr: "ignore",
+			stdin: "ignore",
+		});
 
-    this._running = true
-    this.writePos = 0
-    this.totalSamplesWritten = 0
+		this._running = true;
+		this.writePos = 0;
+		this.totalSamplesWritten = 0;
 
-    // Capture generation for this run
-    const myGeneration = this.generation
+		const myGeneration = this.generation;
 
-    // Start async reading loop
-    this.readLoop(myGeneration)
+		this.readLoop(myGeneration);
 
-    // Detect process exit
-    this.proc.exited.then(() => {
-      // Only clear _running if this is still the current generation
-      if (this.generation === myGeneration) {
-        this._running = false
-      }
-    }).catch(() => {
-      if (this.generation === myGeneration) {
-        this._running = false
-      }
-    })
-  }
+		// Detect process exit
+		this.proc.exited
+			.then(() => {
+				// Only clear _running if this is still the current generation
+				if (this.generation === myGeneration) {
+					this._running = false;
+				}
+			})
+			.catch(() => {
+				if (this.generation === myGeneration) {
+					this._running = false;
+				}
+			});
+	}
 
-  /**
-   * Read available samples into the provided buffer.
-   * Returns the number of samples actually copied.
-   *
-   * @param out - Float64Array to fill with samples (scaled ~+/-32768 for cavacore).
-   * @returns Number of samples written to `out`.
-   */
-  read(out: Float64Array): number {
-    const available = Math.min(out.length, this.totalSamplesWritten, this.ringBuffer.length)
-    if (available <= 0) return 0
+	/**
+	 * Read available samples into the provided buffer.
+	 * Returns the number of samples actually copied.
+	 *
+	 * @param out - Float64Array to fill with samples (scaled ~+/-32768 for cavacore).
+	 * @returns Number of samples written to `out`.
+	 */
+	read(out: Float64Array): number {
+		const available = Math.min(
+			out.length,
+			this.totalSamplesWritten,
+			this.ringBuffer.length,
+		);
+		if (available <= 0) return 0;
 
-    // Read the most recent `available` samples from the ring buffer
-    const readStart = (this.writePos - available + this.ringBuffer.length) % this.ringBuffer.length
+		// Read the most recent `available` samples from the ring buffer
+		const readStart =
+			(this.writePos - available + this.ringBuffer.length) %
+			this.ringBuffer.length;
 
-    if (readStart + available <= this.ringBuffer.length) {
-      out.set(this.ringBuffer.subarray(readStart, readStart + available))
-    } else {
-      const firstChunk = this.ringBuffer.length - readStart
-      out.set(this.ringBuffer.subarray(readStart, this.ringBuffer.length))
-      out.set(this.ringBuffer.subarray(0, available - firstChunk), firstChunk)
-    }
+		if (readStart + available <= this.ringBuffer.length) {
+			out.set(this.ringBuffer.subarray(readStart, readStart + available));
+		} else {
+			const firstChunk = this.ringBuffer.length - readStart;
+			out.set(this.ringBuffer.subarray(readStart, this.ringBuffer.length));
+			out.set(this.ringBuffer.subarray(0, available - firstChunk), firstChunk);
+		}
 
-    return available
-  }
+		return available;
+	}
 
-  /**
-   * Stop the ffmpeg process and clean up.
-   * Safe to call multiple times. Guarantees the read loop exits.
-   */
-  stop(): void {
-    // Bump generation to invalidate any running read loop
-    this.generation = ++globalGeneration
-    this._running = false
-    this.killProcess()
-    this.writePos = 0
-    this.totalSamplesWritten = 0
-  }
+	/**
+	 * Stop the ffmpeg process and clean up.
+	 * Safe to call multiple times. Guarantees the read loop exits.
+	 */
+	stop(): void {
+		// Bump generation to invalidate any running read loop
+		this.generation = ++globalGeneration;
+		this._running = false;
+		this.killProcess();
+		this.writePos = 0;
+		this.totalSamplesWritten = 0;
+	}
 
-  /**
-   * Restart the reader at a new position and/or speed.
-   */
-  restart(startPosition = 0, speed = 1): void {
-    this.start(startPosition, speed)
-  }
+	/**
+	 * Restart the reader at a new position and/or speed.
+	 */
+	restart(startPosition = 0, speed = 1): void {
+		this.start(startPosition, speed);
+	}
 
-  /** Kill the ffmpeg process without touching generation/state. */
-  private killProcess(): void {
-    if (this.proc) {
-      try { this.proc.kill() } catch { /* ignore */ }
-      this.proc = null
-    }
-  }
+	/** Kill the ffmpeg process without touching generation/state. */
+	private killProcess(): void {
+		if (this.proc) {
+			try {
+				this.proc.kill();
+			} catch {
+				/* ignore */
+			}
+			this.proc = null;
+		}
+	}
 
-  /** Internal: continuously reads stdout from ffmpeg and fills the ring buffer. */
-  private async readLoop(myGeneration: number): Promise<void> {
-    const stdout = this.proc?.stdout
-    if (!stdout || typeof stdout === "number") return
+	/** Internal: continuously reads stdout from ffmpeg and fills the ring buffer. */
+	private async readLoop(myGeneration: number): Promise<void> {
+		const stdout = this.proc?.stdout;
+		if (!stdout || typeof stdout === "number") return;
 
-    const reader = (stdout as ReadableStream<Uint8Array>).getReader()
-    try {
-      while (this.generation === myGeneration) {
-        const { done, value } = await reader.read()
-        if (done || this.generation !== myGeneration) break
-        if (!value || value.byteLength === 0) continue
+		const reader = (stdout as ReadableStream<Uint8Array>).getReader();
+		try {
+			while (this.generation === myGeneration) {
+				const { done, value } = await reader.read();
+				if (done || this.generation !== myGeneration) break;
+				if (!value || value.byteLength === 0) continue;
 
-        const sampleCount = Math.floor(value.byteLength / BYTES_PER_SAMPLE)
-        if (sampleCount === 0) continue
+				const sampleCount = Math.floor(value.byteLength / BYTES_PER_SAMPLE);
+				if (sampleCount === 0) continue;
 
-        const int16View = new Int16Array(
-          value.buffer,
-          value.byteOffset,
-          sampleCount,
-        )
+				const int16View = new Int16Array(
+					value.buffer,
+					value.byteOffset,
+					sampleCount,
+				);
 
-        for (let i = 0; i < sampleCount; i++) {
-          this.ringBuffer[this.writePos] = int16View[i]
-          this.writePos = (this.writePos + 1) % this.ringBuffer.length
-          this.totalSamplesWritten++
-        }
-      }
-    } catch {
-      // Stream ended or process killed — expected during stop()
-    } finally {
-      try { reader.releaseLock() } catch { /* ignore */ }
-    }
-  }
+				for (let i = 0; i < sampleCount; i++) {
+					this.ringBuffer[this.writePos] = int16View[i];
+					this.writePos = (this.writePos + 1) % this.ringBuffer.length;
+					this.totalSamplesWritten++;
+				}
+			}
+		} catch {
+			// Stream ended or process killed — expected during stop()
+		} finally {
+			try {
+				reader.releaseLock();
+			} catch {
+				/* ignore */
+			}
+		}
+	}
 }
 
 /**
@@ -234,18 +262,18 @@ export class AudioStreamReader {
  * multiple filters for extreme values (e.g. 0.25 = atempo=0.5,atempo=0.5).
  */
 function buildAtempoChain(speed: number): string {
-  const parts: string[] = []
-  let remaining = Math.max(0.25, Math.min(4, speed))
+	const parts: string[] = [];
+	let remaining = Math.max(0.25, Math.min(4, speed));
 
-  while (remaining > 100) {
-    parts.push("atempo=100.0")
-    remaining /= 100
-  }
-  while (remaining < 0.5) {
-    parts.push("atempo=0.5")
-    remaining /= 0.5
-  }
-  parts.push(`atempo=${remaining}`)
+	while (remaining > 100) {
+		parts.push("atempo=100.0");
+		remaining /= 100;
+	}
+	while (remaining < 0.5) {
+		parts.push("atempo=0.5");
+		remaining /= 0.5;
+	}
+	parts.push(`atempo=${remaining}`);
 
-  return parts.join(",")
+	return parts.join(",");
 }

src/utils/audio-waveform.ts

@@ -1,103 +0,0 @@
-/**
- * Audio waveform analysis for PodTUI
- *
- * Extracts amplitude data from audio files using ffmpeg (when available)
- * Results are cache in-memory keyed by audio URL.
- */
-
-/** Number of amplitude data points to generate */
-const DEFAULT_RESOLUTION = 128;
-
-/** In-memory cache: audioUrl -> amplitude data */
-const waveformCache = new Map<string, number[]>();
-
-/**
- * Try to extract real waveform data from an audio URL using ffmpeg.
- * Returns null if ffmpeg is not available or the extraction fails.
- */
-async function extractWithFfmpeg(
-  audioUrl: string,
-  resolution: number,
-): Promise<number[] | null> {
-  try {
-    if (!Bun.which("ffmpeg")) return null;
-
-    // Use ffmpeg to output raw PCM samples, then downsample to `resolution` points.
-    // -t 300: read at most 5 minutes (enough data to fill the waveform)
-    const proc = Bun.spawn(
-      [
-        "ffmpeg",
-        "-i",
-        audioUrl,
-        "-t",
-        "300",
-        "-ac",
-        "1", // mono
-        "-ar",
-        "8000", // low sample rate to keep data small
-        "-f",
-        "s16le", // raw signed 16-bit PCM
-        "-v",
-        "quiet",
-        "-",
-      ],
-      { stdout: "pipe", stderr: "ignore" },
-    );
-
-    const output = await new Response(proc.stdout).arrayBuffer();
-    await proc.exited;
-
-    if (output.byteLength === 0) return null;
-
-    const samples = new Int16Array(output);
-    if (samples.length === 0) return null;
-
-    // Downsample to `resolution` buckets by taking the max absolute amplitude
-    // in each bucket.
-    const bucketSize = Math.max(1, Math.floor(samples.length / resolution));
-    const data: number[] = [];
-
-    for (let i = 0; i < resolution; i++) {
-      const start = i * bucketSize;
-      const end = Math.min(start + bucketSize, samples.length);
-      let maxAbs = 0;
-      for (let j = start; j < end; j++) {
-        const abs = Math.abs(samples[j]);
-        if (abs > maxAbs) maxAbs = abs;
-      }
-      // Normalise to 0-1
-      data.push(Number((maxAbs / 32768).toFixed(3)));
-    }
-
-    return data;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Get waveform data for an audio URL.
- *
- * Returns cached data if available, otherwise attempts ffmpeg extraction
- */
-export async function getWaveformData(
-  audioUrl: string,
-  resolution: number = DEFAULT_RESOLUTION,
-): Promise<number[]> {
-  const cacheKey = `${audioUrl}:${resolution}`;
-  const cached = waveformCache.get(cacheKey);
-  if (cached) return cached;
-
-  const real = await extractWithFfmpeg(audioUrl, resolution);
-  if (real) {
-    waveformCache.set(cacheKey, real);
-    return real;
-  } else {
-    console.error("generation failure");
-    return [];
-  }
-}
-
-export function clearWaveformCache(): void {
-  waveformCache.clear();
-}

src/utils/cache.ts

@@ -1,57 +0,0 @@
-type CacheEntry<T> = {
-  value: T
-  timestamp: number
-}
-
-const CACHE_KEY = "podtui_cache"
-const DEFAULT_TTL = 1000 * 60 * 60
-
-const loadCache = (): Record<string, CacheEntry<unknown>> => {
-  if (typeof localStorage === "undefined") return {}
-  try {
-    const raw = localStorage.getItem(CACHE_KEY)
-    return raw ? (JSON.parse(raw) as Record<string, CacheEntry<unknown>>) : {}
-  } catch {
-    return {}
-  }
-}
-
-const saveCache = (cache: Record<string, CacheEntry<unknown>>) => {
-  if (typeof localStorage === "undefined") return
-  try {
-    localStorage.setItem(CACHE_KEY, JSON.stringify(cache))
-  } catch {
-    // ignore
-  }
-}
-
-const cache = loadCache()
-
-export const cacheValue = <T,>(key: string, value: T) => {
-  cache[key] = { value, timestamp: Date.now() }
-  saveCache(cache)
-}
-
-export const getCachedValue = <T,>(key: string, ttl = DEFAULT_TTL): T | null => {
-  const entry = cache[key] as CacheEntry<T> | undefined
-  if (!entry) return null
-  if (Date.now() - entry.timestamp > ttl) {
-    delete cache[key]
-    saveCache(cache)
-    return null
-  }
-  return entry.value
-}
-
-export const invalidateCache = (prefix?: string) => {
-  if (!prefix) {
-    Object.keys(cache).forEach((key) => delete cache[key])
-    saveCache(cache)
-    return
-  }
-
-  Object.keys(cache)
-    .filter((key) => key.startsWith(prefix))
-    .forEach((key) => delete cache[key])
-  saveCache(cache)
-}

src/utils/cavacore.ts

@@ -16,170 +16,178 @@
  * ```
  */
 
-import { dlopen, FFIType, ptr } from "bun:ffi"
-import { existsSync } from "fs"
-import { join, dirname } from "path"
+import { dlopen, FFIType, ptr } from "bun:ffi";
+import { existsSync } from "fs";
+import { join, dirname } from "path";
 
 // ── Types ────────────────────────────────────────────────────────────
 
 export interface CavaCoreConfig {
-  /** Number of frequency bars (default: 32) */
-  bars?: number
-  /** Audio sample rate in Hz (default: 44100) */
-  sampleRate?: number
-  /** Number of audio channels (default: 1 = mono) */
-  channels?: number
-  /** Automatic sensitivity: 1 = enabled, 0 = disabled (default: 1) */
-  autosens?: number
-  /** Noise reduction factor 0.0–1.0 (default: 0.77) */
-  noiseReduction?: number
-  /** Low frequency cutoff in Hz (default: 50) */
-  lowCutOff?: number
-  /** High frequency cutoff in Hz (default: 10000) */
-  highCutOff?: number
+	/** Number of frequency bars (default: 32) */
+	bars?: number;
+	/** Audio sample rate in Hz (default: 44100) */
+	sampleRate?: number;
+	/** Number of audio channels (default: 1 = mono) */
+	channels?: number;
+	/** Automatic sensitivity: 1 = enabled, 0 = disabled (default: 1) */
+	autosens?: number;
+	/** Noise reduction factor 0.0–1.0 (default: 0.77) */
+	noiseReduction?: number;
+	/** Low frequency cutoff in Hz (default: 50) */
+	lowCutOff?: number;
+	/** High frequency cutoff in Hz (default: 10000) */
+	highCutOff?: number;
+	/** Output scaling mode: 0 = linear (default), 1 = decibel */
+	scalingMode?: number;
 }
 
 const DEFAULTS: Required<CavaCoreConfig> = {
-  bars: 32,
-  sampleRate: 44100,
-  channels: 1,
-  autosens: 1,
-  noiseReduction: 0.77,
-  lowCutOff: 50,
-  highCutOff: 10000,
-}
+	bars: 32,
+	sampleRate: 44100,
+	channels: 1,
+	autosens: 1,
+	noiseReduction: 0.77,
+	lowCutOff: 50,
+	highCutOff: 10000,
+	scalingMode: 0,
+};
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-type CavaLib = { symbols: Record<string, (...args: any[]) => any>; close(): void }
+type CavaLib = {
+	symbols: Record<string, (...args: any[]) => any>;
+	close(): void;
+};
 
 // ── Library resolution ───────────────────────────────────────────────
 
 function findLibrary(): string | null {
-  const platform = process.platform
-  const libName = platform === "darwin"
-    ? "libcavacore.dylib"
-    : platform === "win32"
-      ? "cavacore.dll"
-      : "libcavacore.so"
+	const platform = process.platform;
+	const libName =
+		platform === "darwin"
+			? "libcavacore.dylib"
+			: platform === "win32"
+				? "cavacore.dll"
+				: "libcavacore.so";
 
-  // Candidate paths, in priority order:
-  // 1. src/native/ (development)
-  // 2. Same directory as the running executable (dist bundle)
-  // 3. dist/ relative to cwd
-  const candidates = [
-    join(import.meta.dir, "..", "native", libName),
-    join(dirname(process.execPath), libName),
-    join(process.cwd(), "dist", libName),
-  ]
+	// Candidate paths, in priority order:
+	// 1. src/native/ (development)
+	// 2. Same directory as the running executable (dist bundle)
+	// 3. dist/ relative to cwd
+	const candidates = [
+		join(import.meta.dir, "..", "native", libName),
+		join(dirname(process.execPath), libName),
+		join(process.cwd(), "dist", libName),
+	];
 
-  for (const candidate of candidates) {
-    if (existsSync(candidate)) return candidate
-  }
+	for (const candidate of candidates) {
+		if (existsSync(candidate)) return candidate;
+	}
 
-  return null
+	return null;
 }
 
 // ── CavaCore class ───────────────────────────────────────────────────
 
 export class CavaCore {
-  private lib: CavaLib
-  private plan: ReturnType<CavaLib["symbols"]["cava_init"]> | null = null
-  private inputBuffer: Float64Array | null = null
-  private outputBuffer: Float64Array | null = null
-  private _bars = 0
-  private _channels = 1
-  private _destroyed = false
+	private lib: CavaLib;
+	private plan: ReturnType<CavaLib["symbols"]["cava_init"]> | null = null;
+	private inputBuffer: Float64Array | null = null;
+	private outputBuffer: Float64Array | null = null;
+	private _bars = 0;
+	private _channels = 1;
+	private _destroyed = false;
 
-  /** Use loadCavaCore() instead of constructing directly. */
-  constructor(lib: CavaLib) {
-    this.lib = lib
-  }
+	/** Use loadCavaCore() instead of constructing directly. */
+	constructor(lib: CavaLib) {
+		this.lib = lib;
+	}
 
-  /** Number of frequency bars configured. */
-  get bars(): number {
-    return this._bars
-  }
+	/** Number of frequency bars configured. */
+	get bars(): number {
+		return this._bars;
+	}
 
-  /** Whether this instance has been initialized (and not yet destroyed). */
-  get isReady(): boolean {
-    return this.plan !== null && !this._destroyed
-  }
+	/** Whether this instance has been initialized (and not yet destroyed). */
+	get isReady(): boolean {
+		return this.plan !== null && !this._destroyed;
+	}
 
-  /**
-   * Initialize the cavacore engine with the given configuration.
-   * Must be called before execute(). Can be called again after destroy()
-   * to reinitialize with different parameters.
-   */
-  init(config: CavaCoreConfig = {}): void {
-    if (this.plan) {
-      this.destroy()
-    }
+	/**
+	 * Initialize the cavacore engine with the given configuration.
+	 * Must be called before execute(). Can be called again after destroy()
+	 * to reinitialize with different parameters.
+	 */
+	init(config: CavaCoreConfig = {}): void {
+		if (this.plan) {
+			this.destroy();
+		}
 
-    const cfg = { ...DEFAULTS, ...config }
-    this._bars = cfg.bars
-    this._channels = cfg.channels
+		const cfg = { ...DEFAULTS, ...config };
+		this._bars = cfg.bars;
+		this._channels = cfg.channels;
 
-    this.plan = this.lib.symbols.cava_init(
-      cfg.bars,
-      cfg.sampleRate,
-      cfg.channels,
-      cfg.autosens,
-      cfg.noiseReduction,
-      cfg.lowCutOff,
-      cfg.highCutOff,
-    )
+		this.plan = this.lib.symbols.cava_init(
+			cfg.bars,
+			cfg.sampleRate,
+			cfg.channels,
+			cfg.autosens,
+			cfg.noiseReduction,
+			cfg.lowCutOff,
+			cfg.highCutOff,
+			cfg.scalingMode,
+		);
 
-    if (!this.plan) {
-      throw new Error("cava_init returned null — initialization failed")
-    }
+		if (!this.plan) {
+			throw new Error("cava_init returned null — initialization failed");
+		}
 
-    // Pre-allocate output buffer (bars * channels)
-    this.outputBuffer = new Float64Array(cfg.bars * cfg.channels)
-    this._destroyed = false
-  }
+		// Pre-allocate output buffer (bars * channels)
+		this.outputBuffer = new Float64Array(cfg.bars * cfg.channels);
+		this._destroyed = false;
+	}
 
-  /**
-   * Feed PCM samples into cavacore and get frequency bar values back.
-   *
-   * @param samples - Float64Array of PCM samples (scaled ~±32768).
-   *                  The array length determines the number of samples processed.
-   * @returns Float64Array of bar values (0.0–1.0 range, length = bars * channels).
-   *          Returns the same buffer reference each call (overwritten in place).
-   */
-  execute(samples: Float64Array): Float64Array {
-    if (!this.plan || !this.outputBuffer) {
-      throw new Error("CavaCore not initialized — call init() first")
-    }
+	/**
+	 * Feed PCM samples into cavacore and get frequency bar values back.
+	 *
+	 * @param samples - Float64Array of PCM samples (scaled ~±32768).
+	 *                  The array length determines the number of samples processed.
+	 * @returns Float64Array of bar values (0.0–1.0 range, length = bars * channels).
+	 *          Returns the same buffer reference each call (overwritten in place).
+	 */
+	execute(samples: Float64Array): Float64Array {
+		if (!this.plan || !this.outputBuffer) {
+			throw new Error("CavaCore not initialized — call init() first");
+		}
 
-    // Reuse input buffer if same size, otherwise allocate new
-    if (!this.inputBuffer || this.inputBuffer.length !== samples.length) {
-      this.inputBuffer = new Float64Array(samples.length)
-    }
-    this.inputBuffer.set(samples)
+		// Reuse input buffer if same size, otherwise allocate new
+		if (!this.inputBuffer || this.inputBuffer.length !== samples.length) {
+			this.inputBuffer = new Float64Array(samples.length);
+		}
+		this.inputBuffer.set(samples);
 
-    this.lib.symbols.cava_execute(
-      ptr(this.inputBuffer),
-      samples.length,
-      ptr(this.outputBuffer),
-      this.plan,
-    )
+		this.lib.symbols.cava_execute(
+			ptr(this.inputBuffer),
+			samples.length,
+			ptr(this.outputBuffer),
+			this.plan,
+		);
 
-    return this.outputBuffer
-  }
+		return this.outputBuffer;
+	}
 
-  /**
-   * Release all native resources. Safe to call multiple times.
-   * After calling destroy(), init() can be called again to reuse the instance.
-   */
-  destroy(): void {
-    if (this.plan && !this._destroyed) {
-      this.lib.symbols.cava_destroy(this.plan)
-      this.plan = null
-      this._destroyed = true
-    }
-    this.inputBuffer = null
-    this.outputBuffer = null
-  }
+	/**
+	 * Release all native resources. Safe to call multiple times.
+	 * After calling destroy(), init() can be called again to reuse the instance.
+	 */
+	destroy(): void {
+		if (this.plan && !this._destroyed) {
+			this.lib.symbols.cava_destroy(this.plan);
+			this.plan = null;
+			this._destroyed = true;
+		}
+		this.inputBuffer = null;
+		this.outputBuffer = null;
+	}
 }
 
 // ── Factory ──────────────────────────────────────────────────────────
@@ -190,41 +198,42 @@ export class CavaCore {
  * to the static waveform display.
  */
 export function loadCavaCore(): CavaCore | null {
-  try {
-    const libPath = findLibrary()
-    if (!libPath) return null
+	try {
+		const libPath = findLibrary();
+		if (!libPath) return null;
 
-    const lib = dlopen(libPath, {
-      cava_init: {
-        args: [
-          FFIType.i32,    // bars
-          FFIType.u32,    // rate
-          FFIType.i32,    // channels
-          FFIType.i32,    // autosens
-          FFIType.double, // noise_reduction
-          FFIType.i32,    // low_cut_off
-          FFIType.i32,    // high_cut_off
-        ],
-        returns: FFIType.ptr,
-      },
-      cava_execute: {
-        args: [
-          FFIType.ptr,  // cava_in (double*)
-          FFIType.i32,  // samples
-          FFIType.ptr,  // cava_out (double*)
-          FFIType.ptr,  // plan
-        ],
-        returns: FFIType.void,
-      },
-      cava_destroy: {
-        args: [FFIType.ptr], // plan
-        returns: FFIType.void,
-      },
-    })
+		const lib = dlopen(libPath, {
+			cava_init: {
+				args: [
+					FFIType.i32, // bars
+					FFIType.u32, // rate
+					FFIType.i32, // channels
+					FFIType.i32, // autosens
+					FFIType.double, // noise_reduction
+					FFIType.i32, // low_cut_off
+					FFIType.i32, // high_cut_off
+					FFIType.i32, // scaling_mode
+				],
+				returns: FFIType.ptr,
+			},
+			cava_execute: {
+				args: [
+					FFIType.ptr, // cava_in (double*)
+					FFIType.i32, // samples
+					FFIType.ptr, // cava_out (double*)
+					FFIType.ptr, // plan
+				],
+				returns: FFIType.void,
+			},
+			cava_destroy: {
+				args: [FFIType.ptr], // plan
+				returns: FFIType.void,
+			},
+		});
 
-    return new CavaCore(lib as CavaLib)
-  } catch {
-    // Library load failed — missing dylib, wrong arch, etc.
-    return null
-  }
+		return new CavaCore(lib as CavaLib);
+	} catch {
+		// Library load failed — missing dylib, wrong arch, etc.
+		return null;
+	}
 }

src/utils/clipboard.ts

@@ -106,7 +106,7 @@ export namespace Clipboard {
   /**
    * Read text from the clipboard.
    */
-  export async function readText(): Promise<string | undefined> {
+  async function readText(): Promise<string | undefined> {
     const os = platform()
 
     if (os === "darwin") {

src/utils/config-backup.ts

@@ -1,96 +0,0 @@
-/**
- * Config file backup utility for PodTUI
- *
- * Creates timestamped backups of config files before updates.
- * Keeps the most recent N backups and cleans up older ones.
- */
-
-import { readdir, unlink } from "fs/promises"
-import path from "path"
-import { getConfigDir, ensureConfigDir } from "./config-dir"
-
-/** Maximum number of backup files to keep per config file */
-const MAX_BACKUPS = 5
-
-/**
- * Generate a timestamped backup filename.
- * Example: feeds.json -> feeds.json.2026-02-05T120000.backup
- */
-function backupFilename(originalName: string): string {
-  const ts = new Date().toISOString().replace(/[:.]/g, "").slice(0, 15)
-  return `${originalName}.${ts}.backup`
-}
-
-/**
- * Create a backup of a config file before overwriting it.
- * No-op if the source file does not exist.
- */
-export async function backupConfigFile(filename: string): Promise<boolean> {
-  try {
-    await ensureConfigDir()
-    const dir = getConfigDir()
-    const srcPath = path.join(dir, filename)
-    const srcFile = Bun.file(srcPath)
-
-    if (!(await srcFile.exists())) return false
-
-    const content = await srcFile.text()
-    if (!content || content.trim().length === 0) return false
-
-    const backupName = backupFilename(filename)
-    const backupPath = path.join(dir, backupName)
-    await Bun.write(backupPath, content)
-
-    // Clean up old backups
-    await pruneBackups(filename)
-
-    return true
-  } catch {
-    return false
-  }
-}
-
-/**
- * Keep only the most recent MAX_BACKUPS backup files for a given config file.
- */
-async function pruneBackups(filename: string): Promise<void> {
-  try {
-    const dir = getConfigDir()
-    const entries = await readdir(dir)
-
-    // Match pattern: filename.*.backup
-    const prefix = `${filename}.`
-    const suffix = ".backup"
-    const backups = entries
-      .filter((e) => e.startsWith(prefix) && e.endsWith(suffix))
-      .sort() // Lexicographic sort works because timestamps are ISO-like
-
-    if (backups.length <= MAX_BACKUPS) return
-
-    const toRemove = backups.slice(0, backups.length - MAX_BACKUPS)
-    for (const name of toRemove) {
-      await unlink(path.join(dir, name)).catch(() => {})
-    }
-  } catch {
-    // Silently ignore cleanup errors
-  }
-}
-
-/**
- * List existing backup files for a given config file, newest first.
- */
-export async function listBackups(filename: string): Promise<string[]> {
-  try {
-    const dir = getConfigDir()
-    const entries = await readdir(dir)
-
-    const prefix = `${filename}.`
-    const suffix = ".backup"
-    return entries
-      .filter((e) => e.startsWith(prefix) && e.endsWith(suffix))
-      .sort()
-      .reverse()
-  } catch {
-    return []
-  }
-}

src/utils/config-dir.ts

@@ -13,7 +13,7 @@ import path from "path"
 const APP_DIR_NAME = "podtui"
 
 /** Resolve the XDG_CONFIG_HOME directory, defaulting to ~/.config */
-export function getXdgConfigHome(): string {
+function getXdgConfigHome(): string {
   const xdg = process.env.XDG_CONFIG_HOME
   if (xdg) return xdg
 
@@ -44,7 +44,7 @@ export async function ensureConfigDir(): Promise<string> {
 }
 
 /** Resolve the XDG_DATA_HOME directory, defaulting to ~/.local/share */
-export function getXdgDataHome(): string {
+function getXdgDataHome(): string {
   const xdg = process.env.XDG_DATA_HOME
   if (xdg) return xdg
 
@@ -55,12 +55,12 @@ export function getXdgDataHome(): string {
 }
 
 /** Get the application-specific data directory path */
-export function getDataDir(): string {
+function getDataDir(): string {
   return path.join(getXdgDataHome(), APP_DIR_NAME)
 }
 
 /** Get the downloads directory path */
-export function getDownloadsDir(): string {
+function getDownloadsDir(): string {
   return path.join(getDataDir(), "downloads")
 }