@playsvideo/app is the browser media catalog built on top of the playsvideo engine.
It is responsible for:
- scanning local folders
- maintaining a durable media catalog
- storing per-device playback history
- syncing playback facts between devices
- enriching catalog entries with optional TMDB metadata
- presenting the catalog/player UI
This package is not the playback engine itself. The engine lives in the root playsvideo package.
- App architecture overview: docs/app-architecture.md
- Data model notes: docs/data-model-separation.md
- TMDB metadata architecture: docs/tmdb-metadata-architecture.md
- Routes: app/src/routes.ts
- Database schema: app/src/db.ts
- Scan pipeline: app/src/scan.ts
- Player page: app/src/pages/Player.tsx
- Sync: app/src/firebase.ts
- Metadata: app/src/metadata
catalog.idis the stable local route/UI identitycanonicalPlaybackKeyis the cross-device playback identitycatalogstores durable media rowsplaybackstores this device's playback factsremotePlaybackstores playback facts pulled from other devices
The app treats missing local files as missing, not deleted. The catalog is meant to outlive any one folder scan.
Run the app:
pnpm --filter app devTypecheck:
pnpm --filter app typecheck