Reading PDFs on Your Steam Deck Without Losing Your Mind
I spent way too long trying to get PDFs working smoothly on this thing before I figured out what actually works. The Steam Deck is great at a lot of things, but opening a simple document shouldn't require three terminal windows and a prayer. Here is what I found after testing every viewer I could install through Discover or the terminal. The short version: use the desktop mode, install Okular from the Discover store, and stop overcomplicating it. Yes, Okular is KDE software and yes, it works on SteamOS fine. The KDE dependency isn't a problem you need to worry about. But there is a catch most guides don't mention. Okular's PDF rendering engine will choke on anything over about 200MB if it's heavily scanned or image-dense. I learned this when a 400MB technical manual with embedded diagrams caused the Deck to stall for eight seconds on every page turn. That isn't usable. What I ended up doing was converting those large scanned PDFs to text-based PDFs using OCRmyPDF in a Docker container on my work machine, then transferring the cleaned files over. The resulting files were roughly one-third the size and loaded instantly. This shortcut saved me from carrying around a separate e-reader.
For smaller, standard documents, Okular is solid. The zoom controls map well to the trackpads. Double-tap to zoom, swipe to scroll. It feels natural once your muscle memory adjusts. Don't try to use the touch screen for this since the Deck's touchscreen doesn't support pressure sensitivity, which some viewers expect for annotation features.
Alternative Viewers and Why I Ditched Them
I tried MuPDF first because it's supposedly lightweight. It opens fast, but the navigation is terrible on a handheld. There is no smooth scrolling, and pinch-to-zoom requires a second finger that the Deck's touch surface doesn't reliably track in gaming mode. I switched back to Okular after about an hour of frustration. Calibre built-in viewer is another option people recommend. It works, but Calibre itself is a bloated installation for what amounts to a one-feature task. If you already use Calibre on your computer to manage books, sure, export the PDF and transfer it. But installing Calibre just for PDF reading on the Deck is overkill. The biggest problem I keep running into is with DRM-protected PDFs from corporate portals. Okular will open them, but copy-paste and annotation get blocked at the viewer level. I haven't found a workaround for this other than printing to PDF through a browser on desktop first, which strips the restrictions. If you're reading work documents, plan for that extra step.
Get the Full Details
Practical Setup Steps
Switch to desktop mode by holding the Steam button and selecting the switch to desktop option. Open Discover, search for Okular, and install it. Launch it from the desktop start menu. Go to Settings > Configure Okular and set the default zoom to fit page width. This saves you from manually adjusting every time you open a new document. If you want quick access, create a Steam shortcut for Okular so you can launch it from gaming mode. Right-click the library, add a non-Steam game, browse to /usr/bin/okular, and confirm. You can rename it to something cleaner. This means you don't have to boot into desktop mode just to read a PDF while sitting on the couch. File transfer is straightforward through Steam Link or a USB cable. I use a micro SD card for bulk transfers since it's faster than SFTP for large document libraries. A 128GB card holds roughly 600 average-sized PDFs, which covers most personal reading material without filling up the internal storage.
Where This Breaks Down
Long documents with complex layouts, like academic journals with multi-column formats, render poorly in Okular. The columns get reordered and text flows in the wrong direction. For those, I just use a browser instead. Chrome on desktop mode handles multi-column PDFs without breaking the flow, even if it uses more RAM. The tradeoff is real but manageable on the Deck's hardware. Another issue is password-protected PDFs. Okular prompts for the password, but if the document is encrypted with certain algorithms, it simply refuses to open. I ran into this with a scanned contract from a lawyer's portal. The workaround was opening it in Firefox first, entering the password there, and saving a decrypted copy. Firefox handles more encryption types than Okular does. If you find yourself needing annotation-heavy workflows, this whole setup falls apart. Okular supports basic highlighting and notes, but it lacks the precision you'd want for marked-up PDFs. In that case, Pairing the Deck with an external keyboard and mouse makes annotation tolerable, but honestly, you'd be better off just using a laptop for anything that requires serious markup work. The trackpads are fine for reading, not for editing.
Overall, this is about as good as it gets on a handheld. The hardware isn't designed for document editing, and trying to force it into that role leads to disappointment. Reading and light annotation work fine. Anything beyond that needs different tools.
