Skip to main content

Getting Started with Llamafin

Version: 2.0.0 Last Updated: April 7, 2026

Welcome to Llamafin — the most powerful, feature-rich music player for Jellyfin. This guide will help you get up and running quickly.

What is Llamafin?​

Llamafin is a cross-platform music player application that connects to your self-hosted Jellyfin media server. It provides a premium listening experience with:

  • Professional Audio Engine — 10-band EQ, stereo width control, loudness normalisation
  • Offline Downloads — Smart quality selection, chunked downloads, transcoding support
  • DJ Mode — Auto-generates playlists based on similar tracks, same artist, or era
  • Remote Device Control — Synchronised playback across multiple devices via P2P
  • Sonic Analysis — BPM detection, musical key analysis, "Sonic Twins" feature
  • Stunning Visuals — Butterchurn/MilkDrop visualizer, spectrum analyser, lyrics
  • Cross-Platform — iOS, Android, Windows, macOS, Linux
  • Completely Free — No subscriptions, no premium tiers, no ads

Prerequisites​

Before you begin, ensure you have:

  1. A Jellyfin Server — Version 10.8.0 or later, running and accessible
  2. Your Media Library — Music content properly organised in Jellyfin
  3. A Compatible Device — See Platform Support for details
  4. Network Access — Your device must be able to reach your Jellyfin server

Installation​

Android​

Download from Google Play for one-tap install and automatic updates.

iOS​

Requires sideloading. See the Download page for step-by-step instructions using AltStore or Sideloadly.

Desktop (Windows/macOS/Linux)​

See Download page.

First Launch​

1. Connect to Your Jellyfin Server​

When you first open Llamafin, you'll be prompted to:

  1. Enter your server URL — e.g., https://jellyfin.yourdomain.com or http://192.168.1.100:8096 (local network)
  2. Enter your credentials — Your Jellyfin username and password (or use Quick Connect)
  3. Select your library — Llamafin will automatically detect your music libraries

2. Quick Connect (Alternative)​

If your Jellyfin server supports Quick Connect:

  1. Select "Quick Connect" on the Llamafin login screen
  2. Enter the 6-digit code displayed on your Jellyfin server's Quick Connect page
  3. You're logged in — no password required

3. Initial Setup​

After logging in, Llamafin will:

  • Fetch your music library structure
  • Cache album art and metadata
  • Apply default settings (dark theme, standard audio profile)
  • Check for network connectivity and speed

Basic Navigation​

Home Screen​

Your home screen displays:

  • Recently Played — Quick access to your latest listening history
  • Recently Added — New content from your library
  • Frequently Played — Your most-listened albums and artists

Library​

Browse your entire music collection by:

  • Albums — With letter navigation (A-Z + #)
  • Artists — Sorted alphabetically
  • Songs — Individual track listing
  • Genres — Browse by music genre
  • Playlists — Your created and auto-generated playlists
  • Folders — Direct folder browsing from your server

Player​

The player offers 5 viewing modes:

  • Cover — Album artwork with playback controls
  • Record — Spinning vinyl animation
  • Lyrics — Synchronised lyrics display
  • Visualiser — Butterchurn/MilkDrop or spectrum analyser
  • Turntable — Retro turntable Visualisation

Search across your entire library:

  • Online and offline search
  • Results in 5 categories: albums, artists, songs, playlists, genres
  • Voice search support
  • 20 pre-type suggestions

Downloads​

Manage your offline content:

  • View all downloaded content
  • Monitor download progress
  • Smart downloads (WiFi/cellular aware)
  • Cache management and healing

Settings​

10 categories of customisation:

  • Account, Source, Language, Appearance
  • Playback, Music Quality, Downloads
  • Notifications, Advanced, About

Next Steps​

Once you're comfortable with the basics, explore these advanced features:

Troubleshooting​

Can't connect to my Jellyfin server​

  • Verify the server URL is correct
  • Ensure your device is on the same network (for local connections)
  • Check that your Jellyfin server is running (version 10.8.0+)
  • If using HTTPS, ensure the certificate is valid

Music won't play​

  • Check your internet connection
  • Verify your Jellyfin server has the correct transcoder settings
  • Try lowering the streaming quality in Settings → Music Quality

Can't download music for offline​

  • Ensure you have sufficient storage space
  • Check your download settings in Settings → Downloads
  • Try repairing corrupted downloads from the Downloads page

Getting Help​

If you need additional help:

Last Updated: 2026-04-07 | Version: 2.0.0