winget install --id=Lunasans.MovieShelf -e MovieShelf Desktop manages your film and series collection locally, enriches it with metadata, shows it as posters, a list or a table, and syncs it with your MovieShelf account. The film search needs your own free TMDb key - created in a minute at themoviedb.org.
Filmsammlung lokal verwalten – und optional mit deiner MovieShelf-Instanz synchronisieren.
Eine Desktop-App für alle, die ihre physische DVD-/Blu-ray-Sammlung im Blick behalten wollen: Filme und Serien erfassen, Metadaten und Cover automatisch von TMDb ziehen, nach Regalstandort und Zustand sortieren, Listen bauen und auswerten.
MovieShelf läuft wahlweise komplett offline oder angebunden an eine MovieShelf-Web-Instanz. Die Wahl triffst du beim ersten Start und kannst sie jederzeit in den Einstellungen ändern.
| Standalone | Online | |
|---|---|---|
| Datenhaltung | lokale SQLite-Datei | MovieShelf-Web-API |
| Internet nötig | nur für TMDb und Cover | ja |
| Sync | – | manuell unter /sync, mit Konfliktauflösung |
Im Standalone-Modus verlassen deine Daten den Rechner nicht. Die Datenbank liegt als einzelne Datei unter dem Benutzerdatenverzeichnis und lässt sich per Backup als .ms-Archiv (Datenbank plus Cover) exportieren und wieder einspielen.
Über winget:
winget install Lunasans.MovieShelf
Oder den signierten Installer aus den Releases laden.
Das .deb-Paket aus den Releases:
sudo dpkg -i movieshelf-desktop_*_amd64.deb
Ein Flatpak-Manifest liegt unter flatpak/info.movieshelf.desktop.yml.
Vorausgesetzt sind Node.js 22 und npm.
git clone https://github.com/lunasans/movieshelf-desktop.git
cd movieshelf-desktop
npm install
npm run dev
npm run dev startet nur den Vite-Dev-Server für das Renderer-Frontend, ohne Electron-Shell.
| Befehl | Zweck |
|---|---|
npm run build | Typprüfung und Produktions-Build |
npm run electron:build | Installer für die aktuelle Plattform bauen |
npm test | Unit-Tests der IPC-Handler (vitest) |
npm run test:e2e | End-to-End-Tests (Playwright, benötigt gebaute App) |
Läuft npm test mit einem NODE_MODULE_VERSION-Fehler auf, wurde better-sqlite3 zuletzt gegen Electron gebaut. npm rebuild better-sqlite3 stellt die Node-Variante wieder her.
Electron 41 mit Vue 3, TypeScript, Vite, Pinia, Tailwind CSS und better-sqlite3.
electron/
main.ts Fenster, Protokolle, Auto-Updater
preload.ts window.electron – die einzige Brücke zum Renderer
database.ts SQLite-Schema und Migrationen
handlers/ IPC-Handler je Domäne
src/
views/ Seiten
components/ nach Domäne gegliedert
stores/ Pinia
composables/ API-Client, TMDb-Suche, Sync-Engine
Renderer und Hauptprozess reden ausschließlich über die in preload.ts freigegebene Oberfläche miteinander. Eine neue Fähigkeit beginnt immer dort.
Für den TMDb-Import brauchst du einen eigenen API-Schlüssel von themoviedb.org; eingetragen wird er in den Einstellungen. Für den Online-Modus kommen die URL deiner MovieShelf-Instanz und ein Zugriffstoken dazu.
Der Jellyfin-Import fragt nach Server-Adresse, Benutzername und Passwort; die Anmeldung wird als Token verschlüsselt abgelegt. Im Online-Modus schreibt er in die lokale Datenbank – die übernommenen Titel erscheinen in der Sammlung erst nach einem Abgleich unter /sync.
Fehlerberichte und Vorschläge sind willkommen – bitte über die Issues. Sicherheitslücken bitte nicht öffentlich melden, sondern wie in SECURITY.md beschrieben.
MovieShelf Desktop ist kostenlos und quelloffen. Wer die Weiterentwicklung unterstützen möchte, kann das über Buy Me a Coffee tun – der Link findet sich auch in der App unter Einstellungen → Info.
MIT – Rene Neuhaus