dtourolle
f388777185
A day of debugging Linux native video produced four defects (DR-238 … DR-241) and one regression from fixing them in the wrong place. None of them were mpv bugs. All four trace to the same missing seam. `PlayerBackend` abstracts a *device* — load, then seek — rather than an *intent*. A start position is therefore not expressible, so every caller sequences load-then-seek itself and each races the engine's asynchronous load independently. That is why resume worked through the adapter, which seeks after "file loaded", and silently failed through the command, which seeks immediately: two callers, one intent, two behaviours. The same gap put transport rules above the engines. Whether a stream can be seeked in place was decided by a truth table in a command handler, on behalf of engines it does not own, which is how `use_html5` came to mean both "who renders" and "how do I seek". And nothing in the contract obliged an engine to report its own state, so a handler for mpv's `pause` property sat unreachable while the UI waited for an event that never came. Supporting evidence for the diagnosis: commands/player/mod.rs is 3,561 lines and is where "stop → rebuild URL → update queue → load → seek" lives; player_play_item needed a cfg(not(linux)) guard; and the frontend carries didStartNativePlayback, didStopBackendEarly and hasPerformedInitialSeek — playback state in the UI, which contradicts the one-directional rule. The proposal is a MediaPlayer contract whose `open` carries the start position, whose `seek` states a destination and leaves in-place-versus-re-open to the engine, whose `snapshot` is one coherent read, and whose `Phase` includes `Opening` — the state the previous design could not express and the window a seek was lost in. Testability is the half that makes it worth doing: one conformance suite run against every engine, and a FakePlayer that lets the controller, queue, autoplay and session logic be tested with no engine at all. The suite is written before the second engine on purpose, so it cannot encode whatever the first happened to do. Migration is a strangler in eight steps; the first three are pure addition.
JellyTau
A cross-platform Jellyfin client built with Tauri, SvelteKit, and TypeScript.
Business logic lives in a Rust backend; a UI-rich Svelte frontend handles presentation and talks to it over Tauri's IPC. Targets Linux (libmpv) and Android (ExoPlayer).
Getting Started
This project uses bun as its package manager.
# Activate the Rust environment (fish shell)
source "$HOME/.cargo/env.fish"
# Install dependencies
bun install
# Run in development
bun run tauri dev
# Type-check the frontend
bun run check
# Build for Linux
bun run tauri build
# Build for Android
bun run tauri android build
For the full set of build, test, and Android helper scripts, see scripts/README.md.
Documentation
| Topic | Location |
|---|---|
| Architecture overview & subsystem docs | docs/architecture/ |
| Requirements, traceability & technical debt | docs/requirements.md |
| Build & release process | docs/build/build-release.md |
| Docker builds | docs/build/docker.md |
| Traceability tooling & CI | docs/traceability.md, docs/traceability-ci.md |
| Release checklist | docs/release-checklist.md |
| UX flows | docs/ux-flows.md |
| CI operations (builder image, secrets, runner) | docs/build/ci-operations.md |
Contributing
CONTRIBUTING.md covers the setup, the gates a change has to pass, and the two rules that catch people out (bug fixes start with a failing test; Jellyfin's taxonomy stays in Rust). Please also read the Code of Conduct.
Found a security problem? Do not open an issue — see SECURITY.md.
Verifying a download
Every release publishes SHA256SUMS covering all of its artifacts, plus an SBOM
of what went into the build:
sha256sum -c SHA256SUMS
Desktop builds update themselves from Settings → Updates, verifying each payload against JellyTau's signing key before installing. Android installs are handled by the system installer, so the app links to the releases page instead.
Recommended IDE Setup
VS Code + Svelte + Tauri + rust-analyzer.
License
MIT