Repository navigation
Handheld Guide
Manual home · Handheld gallery
The same plugin works on a SteamOS PC and a SteamOS handheld. There is no separate handheld download or layout switch. FileExplorer adapts to Steam's available window size, including when using an external display. Installation and updates use the same Decky procedure.
On a smaller screen, the file manager and its viewers fill the space between Steam's system header and controller bar. Larger viewports use a centered window. The screenshots in this guide were captured on a ROG Ally running SteamOS; they are real handheld captures, not scaled-down PC screenshots.
Open Decky → FileExplorer → Launch FileExplorer. Press L1 / LB for the left panel or R1 / RB for the right, then use the D-pad or left stick to move through its files. A opens a folder or supported preview, X selects items, and Y copies them into the other panel. Menu / Start opens file options. Steam draws the glyphs for the active controller.

For archives, A enters the archive, X selects its contents and Y extracts them into the other panel. See Everyday use and Archives for the complete controls.
- Open Decky → FileExplorer → Settings → Interface scale.
- Choose 90%, 80% or 70% for smaller controls, or 100% for the default.
- Reopen FileExplorer to apply the appearance settings.
- Adjust Text size separately if file names or editor text need to be larger.
The outer window keeps its available size. A smaller interface scale fits more content into it, including in the text editor and media player. For an initial comparison, try 80%, then keep the size that is comfortable to read on your screen.

Settings remain in Decky's compact sidebar. Use up/down to choose a setting, left/right to change a slider and X to expand its explanation. Moving up/down closes the explanation. B returns to FileExplorer's own menu.
Settings → Controller legend offers Panel only, Steam bar only, Both and Hidden. Reopen FileExplorer after changing it. Hiding the hints keeps controller actions available; closing FileExplorer restores Steam's normal controls. The panel and Steam bar use the same active hints and order.
Press A on a text file, move to the desired position and press A again to open Steam's keyboard. The editor keeps its width and reduces its height to fit above the keyboard, scrolling the active line into view.
- L3 hides or shows the toolbar, including while the keyboard is open.
- R3 reveals and focuses the toolbar; it hides the keyboard when necessary. Use left/right to choose an action. R3 again returns to the text.
- Menu / Start performs Undo. Y saves; hiding the keyboard does not save.
- With the keyboard hidden, hold RT / R2 + directions to select text and use View / Select to copy. Open Steam's keyboard and choose Paste to insert it. While that keyboard is open, RT/R2 belongs to its Enter action.

See Text editor for formatting, encodings and limits.
A opens a supported picture, audio or video file. In the image viewer, left/right changes pictures. In the media player, A plays or pauses, left/right seeks ten seconds, L1/R1 changes files, X stops and Y switches video fullscreen. R3 reaches the media toolbar. B leaves fullscreen first, then closes the player.
See Image viewer, Media player and the supported formats. Those guides include handheld captures.
The handheld has the same SMB discovery and connection controls as the PC. Both panels can use a local folder or SMB share. A copy or extraction continues when FileExplorer closes, with progress notifications at 25%, 50%, 75% and completion. Keep the device awake and the source and destination available. Closing the panel is different from shutting down, restarting or ending the SteamOS user session, which interrupts the worker.
A failed background copy offers Resume, Start again, Cancel and Open FileExplorer. See Copying and background jobs for recovery details and actual handheld extraction notifications. For display or control issues, use Troubleshooting.
FileExplorer · Manual home · Latest release · Report a problem
- Manual home
- Installation and updates
- First setup and profiles
- Everyday use
- Handheld guide
- Copying and background jobs
- Archives
- Steam integration
- Text editor
- Image viewer
- Media player
- Supported formats
- Handheld gallery
- Network shares
- Settings and Trash
- How it works
- Troubleshooting
- Support FileExplorer
