Jellyfin on Steam Deck in 2026: Complete Setup for Desktop Mode, Game Mode & Offline Viewing

Jellyfin on Steam Deck in 2026: Complete Setup for Desktop Mode, Game Mode & Offline Viewing

Jellyfin on Steam Deck in 2026: Desktop Mode, Game Mode & Offline Viewing

The Steam Deck is not just a gaming handheld - it is a full Linux PC running Arch-based SteamOS. Unlike the Nintendo Switch (which requires homebrew for Jellyfin), the Steam Deck runs Jellyfin natively with zero hacks.

You have three options: the web browser, Jellyfin Media Player (JMP) in Desktop Mode, or JMP as a non-Steam game in Game Mode with full controller support.


Why the Steam Deck Is Great for Jellyfin

  • No homebrew required - it is a standard Linux PC
  • Full codec support - H.264, H.265, AV1, VP9 hardware decode via AMD APU
  • HDR on OLED model - Steam Deck OLED supports HDR10
  • Controller navigation - works in Game Mode with Steam Input
  • Wi-Fi 6E (OLED model) - fast enough for 4K remux streaming
  • 720p/800p display - even 1080p encodes look sharp at this size
  • Offline potential - download files to microSD for travel

Method 1: Jellyfin Media Player in Desktop Mode (Best Quality)

Install JMP via Flatpak

  1. Switch to Desktop Mode (hold Power → Switch to Desktop)
  2. Open Discover (the app store)
  3. Search for Jellyfin Media Player
  4. Click Install
  5. Launch JMP from the application menu

Connect to your server

  1. Enter your Jellyfin server URL
  2. Log in with your credentials
  3. Start watching

Why JMP over the browser

FeatureJMP (Flatpak)Firefox/Chrome
H.265 Direct PlayYes (hardware)No (transcodes)
AV1 Direct PlayYesYes
HDR passthrough (OLED)YesNo
Subtitle rendering (ASS)Full stylingBasic
Keyboard shortcutsFullLimited
Gapless audioYesNo

JMP uses MPV as its playback engine - the same engine that powers the best Linux media players. It hardware-decodes everything the Steam Deck APU supports.


Method 2: JMP in Game Mode (Controller Support)

This is the killer feature. You can launch Jellyfin from Game Mode and navigate entirely with the Steam Deck controls.

Add JMP as a non-Steam game

  1. In Desktop Mode, open Steam
  2. Click Games → Add a Non-Steam Game
  3. Browse to: /var/lib/flatpak/exports/bin/com.github.iwalton3.jellyfin-media-player
  4. Add it
  5. Rename it to "Jellyfin" in your library

Configure Steam Input for Jellyfin

In Game Mode, press the Steam button on Jellyfin → Controller Settings:

Steam Deck controlMap toAction in JMP
D-padArrow keysNavigate UI
A buttonEnterSelect/Play
B buttonEscape/BackGo back
X buttonSpacePlay/Pause
Left stickMousePointer (for web UI)
L1/R1Left/Right arrowSeek ±10 seconds
StartFToggle fullscreen

Launch from Game Mode

Switch back to Game Mode. Jellyfin appears in your library. Launch it - full controller navigation, no keyboard needed.


Method 3: Web Browser (Simplest, Least Capable)

  1. In Game Mode, add Firefox or Chrome as a non-Steam game
  2. Navigate to your Jellyfin server URL
  3. Works but H.265 will transcode on your server

Only use this if you cannot install JMP for some reason.


Codec Support on Steam Deck

The Steam Deck uses an AMD Van Gogh APU (custom RDNA 2 + Zen 2):

CodecHardware decodeNotes
H.264 (AVC)YesUniversal
H.265 (HEVC) Main 10Yes4K HDR capable
AV1Yes (OLED model)LCD model: software only
VP9Yes
MPEG-2YesLegacy content

HDR on Steam Deck OLED

The OLED model supports HDR10 output:

  1. In SteamOS: Settings → Display → Enable HDR
  2. In JMP: HDR content passes through automatically
  3. The 90Hz OLED panel displays HDR natively

The LCD model does NOT support HDR - content plays in SDR regardless.

JellyWatchTry JellyWatch — Your Jellyfin companion, everywhere.

Offline Viewing: Download to microSD

The Steam Deck has a microSD slot. For travel without internet:

Option A: Sync files directly

  1. In Desktop Mode, mount your microSD
  2. Use rsync or a file manager to copy media files
  3. In JMP, add the microSD path as a local media source
  4. Watch offline - no server needed

Option B: Use Jellyfin's download feature (experimental)

Some Jellyfin clients support offline downloads. JMP does not natively, but you can:

  1. Install Findroid via sideloaded APK (Android layer not available on Deck)
  2. Or simply copy files manually - the Steam Deck is a Linux PC

Recommended format for offline

For maximum battery life and smooth playback on the Deck:

  • Codec: H.265 (hardware decode = low power)
  • Resolution: 1080p (overkill for 800p screen but future-proof)
  • Bitrate: 5-10 Mbps (plenty for the small screen)
  • Audio: AAC stereo (saves battery vs surround decode)

Performance and Battery Life

ActivityBattery life (LCD)Battery life (OLED)
Streaming 1080p H.265 (Wi-Fi)~5-6 hours~6-7 hours
Streaming 4K H.265 (Wi-Fi)~4-5 hours~5-6 hours
Local playback (microSD)~6-7 hours~7-8 hours
Gaming (comparison)~2-3 hours~3-4 hours

Media playback is dramatically more efficient than gaming. The GPU idles during video decode.

Tips for maximum battery

  • Set screen brightness to 50%
  • Use H.265 content (hardware decode uses less power than H.264 on AMD)
  • Disable Wi-Fi if playing from microSD
  • Set TDP limit to 4W in Game Mode (Power → TDP Limit)

Steam Deck vs Other Portable Jellyfin Options

DevicePriceJellyfin appOfflineHDRBattery (video)
Steam Deck LCD~$399JMP (native)Yes (manual)No~6h
Steam Deck OLED~$549JMP (native)Yes (manual)Yes~7h
Android tablet~$200+FindroidYes (built-in)Varies~8-10h
iPad~$329+Swiftfin/InfuseYes (Infuse)Yes~10h
Nintendo Switch~$299Switchfin (homebrew)NoNo~4h

The Steam Deck wins on codec support and controller integration. Tablets win on battery life and offline downloads.


FAQ

Do I need to install Windows on the Steam Deck? No. JMP runs natively on SteamOS (Linux). No dual-boot needed.

Does Jellyfin work in Game Mode? Yes - add JMP as a non-Steam game and configure controller mapping.

Can the Steam Deck handle 4K? Yes for decode (hardware H.265/AV1). But the screen is 800p/720p, so 1080p is the sweet spot.

Does the Steam Deck 2 work with Jellyfin? The Steam Deck 2 (if/when released) will also run SteamOS Linux - JMP will work identically.

Is there a Jellyfin app in the Steam Store? No. Install JMP via Flatpak in Desktop Mode, then add as non-Steam game.


Streaming Jellyfin on your Steam Deck? Monitor your server from your phone. Download JellyWatch on Google Play - see every active session including Steam Deck streams.

Comments 2

DeckGamer·

JMP as a non-Steam game in Game Mode with controller mapping is brilliant. Watched an entire season of a show on a flight using my Steam Deck OLED. Battery lasted over 6 hours. Better than any tablet for this.

LinuxFan·

The Flatpak install is dead simple. One command in Desktop Mode and you have a full MPV-powered Jellyfin client with hardware decode for everything. No Windows needed, no compromises.

Leave a comment

Never displayed publicly.
0 / 2000 · Supports limited Markdown: **bold**, *italic*, `code`, [link](url), lists, > quote.