Blog

Jellyfin keeps buffering? Start with these 5 checks

You press play, the spinner turns, the movie starts, and ten minutes later it stops again. Jellyfin buffering is one of the most common complaints, and it's rarely Jellyfin's fault. Nearly every case comes down to one of five things.

Work through them in order. The first two cause most of the trouble.

1. Your server is converting the video as it plays

When a phone or TV can't play a file as it is, Jellyfin converts it on the fly. That's called transcoding. Done by the processor alone, it's heavy work, and a 4K movie can easily be more than an ordinary PC can convert in real time.

How to tell: while the video plays, open Jellyfin's Dashboard. The active session shows whether it's playing directly or transcoding, and why.

The fix: turn on hardware acceleration, so the graphics chip does the converting instead. Jellyfin supports Intel Quick Sync, NVIDIA NVENC, AMD AMF and Apple VideoToolbox. The setting is in the Dashboard under Playback. Pick the one that matches your hardware. If you choose wrong, playback fails instead of getting faster, so test a video afterwards.

2. The computer is going to sleep

Windows and macOS put a computer to sleep after a while with no keyboard or mouse use. Streaming doesn't count as use. Playback stalls, or the server simply vanishes from your TV.

The fix: set the computer to stay awake while it's plugged in. On Windows that's in Settings, under Power. On a Mac, it's in System Settings, under Energy or Battery.

3. Your files are on a slow or sleeping drive

Files on a network drive or a USB disk that spins down can take seconds to wake up. That shows up as a long pause at the start, or stalls when you skip ahead.

The fix: keep the disk from spinning down, or move your most-watched files to an internal drive. On Windows, make sure Jellyfin can actually reach mapped network drives. A drive letter you see in File Explorer isn't always visible to a program running in the background.

4. Wi-Fi between the server and the TV

A busy or distant Wi-Fi link can't always keep up with a high-bitrate file, even at home.

The fix: connect the server to the router with a cable if you can. If the TV must stay on Wi-Fi, try lowering the playback quality in the Jellyfin app on that device and see whether the stalls stop. If they do, the network is your bottleneck.

5. Your home upload speed, when you're away

At home, video travels across your own network. Away from home, it has to leave through your internet connection's upload speed, which is often far lower than download.

The fix: in the Jellyfin app you're watching on, lower the streaming quality for remote playback. That forces a smaller stream that fits your upload, and it's another reason to have hardware acceleration on (see #1).

The quick way to check all five

Each of these is easy to fix once you know it's the problem. The hard part is knowing which one it is.

Reelhost's free check-up looks at your Jellyfin server and tells you, in plain words, which of these apply. It checks video speed (hardware acceleration, tested before it's turned on), sleep settings and network drives, and more. Every fix is previewed and backed up first, and Restore puts the old settings back. Reelhost is an independent app that works with Jellyfin. It isn't made by the Jellyfin project.

More detail on the biggest cause is in our hardware transcoding guide.

Run the free check-up. It takes a few seconds, with no account and no card.