How jellyfin/jellyfin-vue works
Overview
Jellyfin Vue is an experimental Vue-based browser client for Jellyfin, not a replacement for the main Jellyfin Web client. The primary product is the frontend under packages/frontend/src. A browser or desktop host serves its assets; the selected Jellyfin server is the documented application backend. Hosted deployments serve static assets, after which the client connects directly to the configured Jellyfin server.
Core components
• Application bootstrap and shell — packages/frontend/src/main.ts: Frontend entry point, with the application shell represented by the Vue app, layouts, plugins, and global styles.
• Route and page surface — packages/frontend/src/pages: User-facing routes for libraries, media details, search, playback, server selection/login, settings, administration, and setup.
• Reusable UI and media controls — packages/frontend/src/components: Vue components for navigation, item cards, dialogs, metadata editing, playback controls, images, users, and system feedback.
• Jellyfin server integration — packages/frontend/src/plugins/remote: Remote authentication, HTTP integration, socket support, SDK-related code, and server-facing types. This is the boundary to the externally selected Jellyfin server.
• Client state and local data — packages/frontend/src/store: Client stores for settings, API-oriented data, playback, task management, and shared/synchronized state. The tree indicates database-oriented client storage areas, but not their exact persistence behavior.
• Shared UI toolkit — packages/ui-toolkit/src/components: Reusable Vue components and supporting composables/utilities intended to be consumed by frontend-facing packages.
• Localization — packages/i18n/src/index.ts: Localization package entry area, backed by the language resources under packages/i18n/strings.
• Cross-environment utilities — packages/shared/src/universal: Shared browser/universal helpers such as HTML, promise, and validation utilities.
• Optional desktop runtime — packages/tauri-runtime/entrypoint.ts: Tauri-specific runtime support. Native packaging is separately represented under packaging/tauri/src; it is an alternate host for the frontend rather than part of the normal hosted-browser path.
Public and external interfaces
The principal application entry is packages/frontend/src/main.ts. Named package source entry files also include packages/i18n/src/index.ts and the toolkit component index at packages/ui-toolkit/src/components/index.ts; exact exports are not verifiable from the tree alone. External actors are the user’s browser or desktop host and the Jellyfin server selected by that user. The README states that the client does not proxy normal frontend/server traffic through the asset host.
Relationships
The host loads the frontend entry point, which presents routed pages and reusable components. Those UI areas are organized alongside composables and stores that represent client settings, server data, playback, and tasks. Server-facing operations are owned by the remote integration area, while shared utilities, localization, and the UI toolkit provide reusable support. Tauri and packaging directories provide alternative runtime/distribution boundaries; they are not sequential stages in the browser application pipeline.
Main entry points: main.ts Application Bootstrap · pages Routes and Pages · remote Jellyfin Integration · entrypoint.ts Tauri Runtime
Components 12
Other components
- Browser/Desktop Host · Loads the hosted frontend assets or provides the desktop host.
- Application Bootstrap · Bootstraps the Vue app, shell, layouts, plugins, and global styles.
packages/frontend/src/main.ts - Routes and Pages · Provides user-facing library, playback, login, settings, and administration routes.
packages/frontend/src/pages - UI and Media Controls · Provides reusable navigation, media, metadata, playback, and feedback components.
packages/frontend/src/components - Jellyfin Integration · Owns authentication, HTTP, sockets, SDK-related code, and server-facing types.
packages/frontend/src/plugins/remote - Client State and Data · Holds settings, server data, playback, tasks, and shared synchronized state.
packages/frontend/src/store - Shared UI Toolkit · Supplies reusable Vue components and supporting composables.
packages/ui-toolkit/src/components - Localization · Provides localization backed by language resources.
packages/i18n/src/index.ts - Universal Utilities · Provides shared browser and universal helpers.
packages/shared/src/universal - Tauri Runtime · Provides an optional alternate desktop host for the frontend.
packages/tauri-runtime/entrypoint.ts - Tauri Packaging · Provides native distribution support for the desktop runtime.
packaging/tauri/src - Selected Jellyfin Server · Receives direct server-facing operations from the client.
Connections 11
- Browser/Desktop Host → Application Bootstrap: loads
- Tauri Runtime → Application Bootstrap: hosts
- Application Bootstrap → Routes and Pages: presents
- Routes and Pages → UI and Media Controls: uses
- Routes and Pages → Client State and Data: uses
- Routes and Pages → Jellyfin Integration: uses
- Shared UI Toolkit → UI and Media Controls: supports
- Localization → Application Bootstrap: localizes
- Universal Utilities → Application Bootstrap: supports
- Jellyfin Integration → Selected Jellyfin Server: connects to
- Tauri Packaging → Tauri Runtime: packages