Skip to content
pubscout

dart_jellyfin

0.4.3, released 6 days ago by ales-drnz.com

Dart client for Jellyfin media servers with authentication, browsing, and streaming.

WASM-ready
$ flutter pub add dart_jellyfin
Source repository

What it does

Provides a pure Dart client for Jellyfin 12+ media servers. Handles user authentication, library browsing, playlists, audio/video streaming, lyrics with timing, live events via WebSockets, and search using typed models.

AI-written summary of version 0.4.1, based on the package's README and metadata. Report an inaccuracy

Use it when

  • Building a Flutter or pure Dart client for a Jellyfin media server
  • Streaming audio and video or browsing media libraries programmatically

Skip it when

  • You are connecting to a non-Jellyfin media server backend like Plex or Emby

Strengths

  • Pure Dart with no native plugin dependencies, supporting all platforms including the web
  • Fully typed models, errors, and parameters matching the Jellyfin OpenAPI specification
  • Background isolate parsing for large API responses to maintain UI frame rates

Weaknesses

  • Tightly coupled to the Jellyfin media server API ecosystem
  • Requires managing HTTP client lifecycle and connection state manually

Setup

Kind
Pure Dart
Effort
Low
Code generation
No
Direct dependencies
3

Requires Dart 3.10 or later and a reachable Jellyfin server instance (v12.0 or later).

import 'package:dart_jellyfin/dart_jellyfin.dart';

Future<void> main() async {
  final jellyfin = JellyfinClient(
    baseUrl: 'https://jellyfin.example.com',
    credentials: const JellyfinCredentials(
      client: 'MyApp',
      device: 'iPhone',
      deviceId: 'PUT-YOUR-UUID-HERE',
      version: '1.0.0',
    ),
  );

  final auth = await jellyfin.user.authenticateByName(
    username: 'me',
    password: 'hunter2',
  );
  jellyfin.setSession(token: auth.accessToken, userId: auth.user.id);
  jellyfin.close();
}

Alternatives

Packages that do the same job and could replace dart_jellyfin.

Works with

Packages commonly used together with dart_jellyfin: ones it builds on, ones built on it, and its own family.