Marquee is a home-theater app for browsing and playing a private local movie and TV library. It combines a remote-first, ten-foot interface with offline cataloging, profile-aware discovery, sidecar artwork, and libmpv playback.
Marquee v3 is the product: C++23, Qt 6/QML, libmpv, and SQLite, built with CMake
and Ninja for Omarchy/Arch Linux. The released Swift v2.0.1 macOS app remains in
Marquee/ as a frozen, read-only reference for behavior and appearance. It is
not built, tested, or fixed. This repository is not the separate web/Roku
streaming project.
./scripts/configure-v3-debug.sh
cmake --build build/v3-debug
ctest --test-dir build/v3-debug --output-on-failureDependencies, run options, and local data locations are in
BUILDING.md. The verification gate and what each suite can and
cannot prove are in docs/QUALITY_GATES.md.
src/— C++ behavior and state:app/(composition, paths),catalog/(SQLite catalog, scanner, worker),models/(Qt models and browse projections),navigation/,playback/(libmpv render item, player session),profiles/,search/,settings/,ui/,support/.qml/— presentation only:Main.qml,Theme.qml,screens/,components/,shaders/.tests/— Qt Test targets registered intests/CMakeLists.txt; each links the shippedMarqueeQML module.scripts/—configure-v3-debug.shandrun-v3-debug.shfor v3. The other scripts belong to the frozen Swift reference and are not used.docs/— v3 design, gates, manual QA, and operations notes.Marquee/,MarqueePatches/,Marquee.xcodeproj,Package.swift— the frozen Swift v2 reference.issues.md— open bugs and gaps.CHANGELOG.md— user-facing changes.
The macOS download is the frozen Swift app, built by the manual
.github/workflows/macos-release.yml workflow against the official MPVKit
1.1.0-n9.0.2 release. The disk image and its checksum are on this
repository's GitHub Releases page. It is a universal (Apple silicon and Intel)
disk image, ad-hoc signed and not notarized: open Marquee.app once; when
macOS blocks it, go to System Settings, Privacy & Security, and choose Open
Anyway (on macOS 14 and earlier, right-click and choose Open). If macOS still
refuses, run xattr -dr com.apple.quarantine /Applications/Marquee.app.
- Offline browsing must remain functional without TMDB or network access.
- Local sidecar artwork is authoritative.
- Credentials and the live media catalog are never committed or packaged.
- Automated tests use Qt test paths and temporary roots, never the live library.
- A library root that is missing or unreadable never deletes catalog rows.
See AGENTS.md for repository invariants,
docs/ARCHITECTURE_V3.md for the v3 design, and
docs/ARCHITECTURE.md for the frozen v2 system the
parity work reads from.
Marquee is free software licensed under the
GNU General Public License version 3 only. Third-party dependencies
keep their own licenses; see THIRD_PARTY_NOTICES.md.
The repository itself doesn't contain MPVKit, libmpv, FFmpeg, or Qt binaries. The historical v2.0.1 binary's exact dependency source and build flags weren't retained, so that binary isn't suitable for public redistribution. Apart from the macOS 2.0.2 download above, any other binary release must be rebuilt from recorded corresponding source. See the source-publication boundary before publishing a release.