Skip to content

Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.

docs: refresh changelog and reconcile documentation with behavior

Samir Hossainseae48feccd42
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9f684ed..b3d098d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,9 +2,54 @@
## [Unreleased]
-### Added
-- **Pure-Rust Async DNS Engine**: Enabled `hickory-dns` in the HTTP client so the prebuilt `musl` Linux binary resolves DNS hostnames automatically without requiring `/etc/resolv.conf`, enabling zero-configuration out-of-the-box networking on Android/Termux and minimal container environments.
-- **Termux Installer DNS Helper**: Automatically populate `$PREFIX/etc/resolv.conf` with fallback nameservers (`1.1.1.1` and `8.8.8.8`) during Termux installation.
+### Fixed
+- **DNS resolution on Android/Termux and minimal containers**: Replaced the reqwest
+ `hickory-dns` feature flag with a custom resolver (`src/net.rs`) that reads the OS
+ DNS configuration first (`/etc/resolv.conf`, registry on Windows) and falls back to
+ embedded public resolvers (Cloudflare, Google, Quad9) when none exists. The previous
+ approach failed every lookup on platforms without `/etc/resolv.conf` (hickory reads
+ only the hardcoded `/etc/resolv.conf` path); the Termux `$PREFIX/etc/resolv.conf`
+ installer workaround it required is removed.
+- **Crash on multibyte titles**: Year stripping sliced remote HTML titles at a raw
+ byte offset and could abort the whole app on CJK/accented characters.
+- **Windows self-update never applied**: The staged binary lived inside a temporary
+ directory deleted before the detached `.bat` helper ran, so the update silently
+ never replaced the executable. Staging now persists beside the installed binary,
+ the helper consumes and cleans it, and stale staging artifacts are swept at startup.
+- **State file durability**: History/favorites/config writes fsync before rename and
+ never delete the existing destination unless a replacement has succeeded.
+- **install.sh correctness**: Install-directory fallback now happens outside the
+ spinner subshell (reported path and shell-rc PATH edits previously used the wrong
+ directory), INT/TERM exit cleanly instead of continuing, the version temp file is
+ cleaned up on failure, PATH/profile matching is literal (regex-safe paths), missing
+ `--version`/`--dir` values fail with clear errors, unknown arguments warn, trailing
+ slashes in `--dir` are normalized, and reinstalling over a running binary avoids
+ `ETXTBSY`.
+- **install.ps1 hardening**: TLS 1.2 is enabled independently so older .NET stacks
+ keep it even when TLS 1.3 is unavailable; User PATH updates are written through the
+ registry preserving REG_EXPAND_SZ variables and use exact segment matching; the
+ uninstaller removes its stale User PATH entry; `-Version 0.1.x` is accepted and
+ normalized to `v0.1.x`.
+- **Mouse click accuracy**: Search-result hit testing uses the real scroll offset
+ instead of deriving it from the selection, fixing clicks selecting or opening the
+ wrong title after sorting or scrolling partway.
+- **Poster memory footprint**: Decoded posters are downscaled to ≤512px before
+ caching, decoded/encoded cache sizes were right-sized (roughly 10× less RAM on
+ low-end devices), failed posters retry after 10 minutes instead of being negatively
+ cached forever, and prefetch shares one concurrency limiter instead of creating a
+ new semaphore per scroll batch.
+- **Rendering & input polish**: The terminal graphics probe is capped at 400ms and
+ runs off the UI thread (previously up to 2s of blank screen at startup); resize
+ performs a single deferred clear instead of two flashes; grid poster width derives
+ from real terminal cell metrics; the input caret blink keeps animating while
+ typing; the mouse wheel scrolls one result row per notch; `NO_COLOR` now overrides
+ `MOVIEBOX_THEME`; strict 256-color terminals receive quantized indexed palettes
+ rather than RGB sequences.
+
+### Changed
+- CI: `Publish to Crates.io` and `Update Homebrew Formula` now skip gracefully when a
+ Release run completed without publishing a new version; the live-network acceptance
+ test is opt-in via `MOVIEBOX_LIVE_TESTS=1 cargo test --test real_acceptance -- --ignored`.
## [0.1.14] - 2026-08-26
diff --git a/docs/config.md b/docs/config.md
index aa5a9ae..eaabf3a 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -33,7 +33,7 @@ macOS `~/Library/Application Support/moviebox-tui`, Linux `~/.config/moviebox-tu
| Variable | Purpose |
| ------------------------- | --------------------------------------------------------------------------------- |
-| `MOVIEBOX_LOG` | Log level: `off`, `warn`, `info`, `debug`, `trace`. See [logging.md](logging.md). |
+| `MOVIEBOX_LOG` | Log level: `off`, `error`, `warn`, `info`, `debug`, `trace`. See [logging.md](logging.md). |
| `MOVIEBOX_PLAYER` | Preferred player (overrides `default_player`). |
| `MOVIEBOX_MPV_PATH` | Custom mpv executable. |
| `MOVIEBOX_VLC_PATH` | Custom VLC executable. |
diff --git a/docs/known-issues.md b/docs/known-issues.md
index bbabb08..7dabdc0 100644
--- a/docs/known-issues.md
+++ b/docs/known-issues.md
@@ -29,6 +29,6 @@ Tracked here so future work and issue reports reference the same facts.
## Verification
-- Automated testing is enforced via `cargo test --all-features --locked` covering 173 unit and integration tests across 16 test suites (see [`docs/testing.md`](testing.md)). The count is updated when tests change; it does not replace real-player and real-device verification.
+- Automated testing is enforced via `cargo test --all-features --locked` covering 192 unit and integration tests across 16 test suites (see [`docs/testing.md`](testing.md)). The count is updated when tests change; it does not replace real-player and real-device verification.
- Static correctness is enforced by strict compiler type checking, the lint gate (`cargo clippy --all-targets --all-features --locked -- -D warnings`), formatting (`cargo fmt --check`), dependency vulnerability scanning (`cargo audit`), and packaging verification (`cargo package --locked`).
- Runtime and platform-specific behavior (terminal resize, focus handling, external player launch, and Termux chooser) are verified through the release checklist in [`release-checklist.md`](release-checklist.md).
diff --git a/docs/logging.md b/docs/logging.md
index d989687..28a8823 100644
--- a/docs/logging.md
+++ b/docs/logging.md
@@ -14,7 +14,7 @@ The active file is `moviebox-tui_rCURRENT.log`; rotated files are
## Behavior
-- **Level** is controlled by `MOVIEBOX_LOG` (`off|warn|info|debug|trace`). Default is
+- **Level** is controlled by `MOVIEBOX_LOG` (`off|error|warn|info|debug|trace`). Default is
`warn` in release builds, `info` in debug builds.
- **Rotation**: rotates at 5MB and keeps 3 files.
- **Terminal output**: normal log lines go only to the file without writing to stdout or stderr, preventing screen bleed before entering alternate screen mode. Setup errors (if any) are reported on `stderr`.
diff --git a/docs/modules.md b/docs/modules.md
index b64c995..939584a 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -9,7 +9,7 @@ src/
main.rs Entry point. Logging init, panic hook, raw mode, alternate
screen, TerminalGuard, App::new + App::run.
lib.rs Crate root: declares pub mod cache/config/download/favorites/
- history/logging/models/player/providers/service/tui/updater.
+ history/logging/models/net/player/providers/service/tui/updater.
cache.rs Disk cache: provider-namespaced directories, TTL expiry,
atomic temp-file writes, payload validation, background purge.
@@ -36,6 +36,11 @@ src/
SubjectIdentity (cross-provider identity rules shared by
history and favorites).
+ net.rs Shared HTTP plumbing: FallbackResolver (hickory DNS reading the
+ OS configuration, falling back to Cloudflare/Google/Quad9 when
+ absent) wired into every reqwest client via
+ net::http_client_builder().
+
player.rs Player detection (OnceLock) and command construction for
mpv / VLC / IINA / Android intent, subtitle args, headers,
terminal-sized window.