File Management, learn how to manage your files like a wizard.
File Management Table of Contents
Managing ROM Files
How to Manage ROMs with Multiple Discs
Preface
An M3U File is a "playlist" for ROMs with multiple discs. Like a music playlist, the first ROM is the "first track", the second is the "second track" and so on.
Emulators will typically treat the M3U file itself as the ROM and auto-play the playlist (each disc) as you progress through the game. This section will cover how to create those M3U files so you can handle those multi-disc games like an emulator aficionado.
Quick Tips
- Compress your ROMs
- Open the EmuDeck application on your desktop and run the
Compression Tool
to.chd
. Compression will make managing your ROM folder and creating your M3Us infinitely easier - Re-run Steam ROM Manager after compressing your ROMs (this can be done after you have finished creating an M3U file)
- Open the EmuDeck application on your desktop and run the
- After you have created an M3U file, use the various emulator quick-menus to seamlessly move onto the next disc
- For a full list of hotkeys, see the Hotkeys page
Emulators without M3U Support
- PCSX2 does not support M3U files
- Xenia does not support M3U files
How to Create an M3U File
Quick and Dirty Guide
- In your ROM folder, right click, click
Create New Text File
- Name it
GAMENAME.m3u
- Replace GAMENAME with the game name
- Right click the text file, click
Open with Kate
or a text editor of your choice - Place the full file name of each ROM disc including the file extension on a separate line
- If your ROM file extensions are
.cue
and.bin
, only write the.cue
files in the M3U file- For Dreamcast, only write the
.gdi
files
- For Dreamcast, only write the
- If your ROM file extensions are
- Save and close out of the text file
- From now on, you can treat the newly created M3U file as the game file
For how to use the M3U with Steam ROM Manager, see Steam ROM Manager: How to Manage ROMs with Multiple Discs
For how to use the M3U with EmulationStation-DE, see EmulationStation-DE: How to Manage ROMs with Multiple Discs
In-Depth Guide
Here's How:
- In your ROM folder, right click, click
Create New Text File
- Name it
GAMENAME.m3u
- The file name of the M3U file is up to you. However, it is recommended you match the M3U file as closely as possible to the game name so Steam ROM Manager and EmulationStation-DE can scrape the appropriate game art or game info
- For example, with the game:
The Legend of Dragoon
, you may name the M3U file,The Legend of Dragoon.m3u
so Steam ROM Manager or EmulationStation-DE can locate the appropriate art. However, if you name itLoD.m3u
as an example, neither tool will know to matchLoD
toLegend of Dragoon
- Right click the text file, click
Open with Kate
or a text editor of your choice - Place the full file name of each ROM disc including the file extension on a separate line
- IMPORTANT: If you are using both
.bin
and.cue
files, only write the.cue
files in the M3U file. If you are using both.gdi
and.bin
files, only write the.gdi
files in the M3U file- It is recommended you use the EmuDeck compression tool for easier file management
- Example (Using D2 for the Dreamcast):
- IMPORTANT: If you are using both
- Save and close out of the text file
- From now on, you can treat the newly created M3U file as the game file, and play the respective ROM discs by running the newly created M3U file through one of EmuDeck's included front-ends: Steam shortcuts created by Steam ROM Manager, EmulationStation-DE, or by running the emulator directly
- Steam ROM Manager:
- Steam ROM Manager will still parse all of your discs in addition to the M3U file. To solve this, you can hide each disc entry, and only allow Steam ROM Manager to parse the M3U file
- To learn more, see: Steam ROM Manager: How to Manage ROMs with Multiple Discs
- Steam ROM Manager will still parse all of your discs in addition to the M3U file. To solve this, you can hide each disc entry, and only allow Steam ROM Manager to parse the M3U file
- EmulationStation-DE:
- EmulationStation-DE will display all of your discs in addition to the M3U file. To solve this issue, EmulationStation-DE allows you to treat directories as files.
- To learn more, see: EmulationStation-DE: How to Manage ROMs with Multiple Discs
- EmulationStation-DE will display all of your discs in addition to the M3U file. To solve this issue, EmulationStation-DE allows you to treat directories as files.
- Alternatively, you can move all of your Multi-Disk games to a new folder
- For example:
psx-multidisk
, and keep the .m3u files in thepsx
folder, changing the contents to point to the disks in their new location. This will prevent those disks from being read, as the parsers will not look in the new folders created- Note: Not all emulators support absolute pathing
- For example:
- Steam ROM Manager:
Video: How to Create an M3U File
How to Verify ROMs
How to Verify a ROM Successfully Transferred
Sometimes, data loss or corruption can occur when you transfer ROMs to your Steam Deck. You can verify that the ROM successfully transferred by checking its MD5 Checksum. An MD5 Checksum is a 32-character hexadecimal number that is computed on a file. If the MD5 checksum on both the file on the Steam Deck and the original PC is an exact match, the file transferred successfully. If they do not match, the file is potentially corrupt. You will need to correct or adjust how you transfer files.
Here's How
On the Steam Deck
- Right click the ROM
- Click Properties
- Click the Checksums tab
- Click
Calculate
to the right ofMD5
On the non-Steam Deck PC
- Windows:
- Mac: https://ss64.com/osx/md5.html
- Linux (Command-line): https://man7.org/linux/man-pages/man1/md5sum.1.html
How to Verify a ROM is Valid
For one reason or another, your ROM may be corrupt and may not work properly. One way to confirm that you have a valid ROM is by comparing it to the ROM page on redump.org. Redump is an internet community "dedicated to collecting precise and accurate information about every video game ever released". You can validate your ROM by comparing its MD5 Checksum, a 32-character hexadecimal number that is computed on a file, to the MD5 Checksum on redump.org.
Here's How
How to Find your MD5 Checksum
Note: Vampire Night
, for the Playstation 2 is being used as an example in the below guide.
- Right click the ROM
- Click Properties
- Click the Checksums tab
- Click
Calculate
to the right ofMD5
How to Compare your MD5 Checksum to Redump
- Open redump.org, and search for your ROM
- For example, Vampire Night's page: http://redump.org/disc/13152/
- Note down the MD5 Checksum on the redump.org page and compare it to your ROM
- The Vampire Night ISO MD5 Checksum matches to the MD5 Checksum on the redump page, meaning the ROM is valid
Managing Emulators and Tools
How to Swap out AppImages and Binaries
Preface
Sometimes, when an emulator updates, there can be regressions for certain games or bugs that break the emulator temporarily. You can downgrade to a previous version by replacing the emulator in /home/deck/Applications
.
Additionally for Yuzu, you can also use this feature to download the Early Access
version of Yuzu.
For some emulators, your ROMs launch using a script created by EmuDeck, which look for the corresponding emulator, depending on how it is installed or downloaded. In the case of PCSX2 and Yuzu, the script looks for two things:
- The most recently downloaded version in
/home/deck/Applications
, based on the file date. - The emulator name at the beginning of the file. Anything after the emulator name is ignored.
pcsx2-Qt
in the case of PCSX2 andYuzu
in the case of Yuzu. For example, if the latest version ofYuzu
is1351
and you would like to downgrade to1349
. When you downloadyuzu 1349
, you could rename it toYuzu-1349.AppImage
, and EmuDeck's script will ignore the-1349
in the file name, allowing you to record which versions of Yuzu you are using through the file name.
List of Supported Emulators and Tools
- Cemu (AppImage)
- Executable Location:
/home/deck/Applications/Cemu.AppImage
- Download Link: https://github.com/cemu-project/Cemu/releases
- Executable Location:
- Cemu (Swap out its EXE)
- Executable Location:
Emulation/roms/wiiu/cemu.exe
- Download Link: https://github.com/cemu-project/Cemu
- Executable Location:
- EmulationStation-DE
- Executable Location:
Emulation/tools/EmulationStation-DE-x64_SteamDeck.AppImage
- Download Link: https://gitlab.com/es-de/emulationstation-de/-/packages/
- Executable Location:
- mGBA
- Executable Location:
/home/deck/Applications/mGBA.AppImage
- Download Link: https://github.com/mgba-emu/mgba/releases
- Executable Location:
- PCSX2-QT
- Executable Location:
/home/deck/Applications/pcsx2-Qt.AppImage
- Download Link: https://pcsx2.net/downloads/#nightly-anchor
- Executable Location:
- Ryujinx
- Executable Location:
/home/deck/Applications/publish/Ryujinx
- Download Link: https://github.com/Ryujinx/release-channel-master/releases
- Steam ROM Manager
- Executable Location:
Emulation/tools/srm/Steam-ROM-Manager.AppImage
- Download Link: https://github.com/SteamGridDB/steam-rom-manager/releases
- Executable Location:
- Vita3K
- Executable Location:
/home/deck/Applications/Vita3K/Vita3K
- Executable Location:
- Xenia (Swap out its EXE)
- Executable Location:
Emulation/roms/xbox360/xenia_canary.exe
- Download Link: https://github.com/xenia-canary/xenia-canary/releases
- Executable Location:
- Yuzu
- Executable Location:
/home/deck/Applications/yuzu.AppImage
- Download Link: https://github.com/yuzu-emu/yuzu-mainline/releases
- Executable Location:
How to Swap Out Emulators
- Download the version of the emulator you would like to use, from the list above to your
/home/deck/Downloads
folder - Open the respective emulator folder location, using the list above: List of Supported Emulators and Tools
- Move the downloaded emulator from Step 1 to the folder in Step 2
- Rename or delete the original emulator file
- Rename it so it can be distinguished from your downloaded file
- A Few Examples:
- Rename
Yuzu.AppImage
toYauzu.AppImage
- Rename
Yuzu.AppImage
to add a.bak
to the end of the file extension,Yuzu.AppImage.bak
- Rename
Yuzu.AppImage
to add the version number. For example, if the latest version is 1351, rename it toYuzu-1351.AppImage
- Rename
- A Few Examples:
- Rename it so it can be distinguished from your downloaded file
- Right click the newly downloaded emulator, click
Properties
, clickPermissions
, checkIs executable
- Your games will now launch using the version of the emulator you downloaded
Watch the following GIF for a visual (Yuzu is being used as an example in this GIF):
How to Reset an Emulator's Configurations to EmuDeck's Defaults
Sometimes after installing EmuDeck, you may notice an emulator's configurations were not set properly or you tweaked something on accident and you do not remember the default settings.
You may reset an emulator's configurations in the Manage Emulators
page.
Tutorial
- Open EmuDeck on your desktop.
- Click the
Manage Emulators
button. - Select which emulator configurations you would like to reset in the drop-down menu.
- Click
Reset configuration
, wait a moment. - Your selected emulator has been reset.
Emulator Save and Save State Locations
See Save Management: Emulator Save and Save State Locations.
Managing Files
How to Use Symlinks
Preface
Symbolic links, or symlinks for short, are a powerful way to link files or directories. Symlinks are a kind of file that points to another file, similar to a shortcut on Windows. However, symlinks are much more versatile.
A few features of symlinks include: renaming the symlink, crossing partitions (between an SD card and an internal SSD for example), and creating multiple symlinks to the same file.
It is recommended you symlink your folders inside of the folders created by EmuDeck. For example, if you would like to symlink a PlayStation 2 ROM folder, symlink this folder inside of the Emulation/roms/ps2
folder instead of overwriting the ps2
folder.
Use Cases
Let's go over a few use cases specifically pertaining EmuDeck:
- If you wanted to install EmuDeck on multiple storage devices, you could instead install EmuDeck to the internal SSD and symlink ROM folders from the various storage devices to the ROM folders within the
Emulation
folder on the internal SSD. - If you had a large texture pack folder or a large folder of any sort, you could place this folder on your removable storage device and symlink it to its expected location on the internal SSD.
- If you wanted to symlink your NAS to your
Emulation
folder.
How to create a Symlink
You can create a symlink a couple of ways. One method is to create a symlink through Dolphin (file manager). Keep in mind that within Dolphin (file manager), you can open tabs and view multiple folders at the same time.
When you have your original folder or file and the destination ready, drag the original folder or file to the destination and click Link here
. A symlink is indicated with a small link icon and the file name in italics.
Photos
GIF
How to Transfer Files to a Steam Deck
Preface
By default, Steam Deck formats your SD card in ext4 format, which is not readable on Windows without additional tinkering. Use one of the following methods to transfer files to your Steam Deck.
List of File Transfer Methods
- Method 1: SSH
- Method 2: DeckMTP
- Method 3: Removable Storage Device
- Method 4: AnyDesk
- Method 5: SMB Shares
Method 1: SSH
Select one of the two tutorials below:
Although the below guide may look lengthy, SSH is a quick and easy process to set up. Once you have it set up, you can transfer files with ease in both Desktop Mode and Game Mode, no additional storage device needed.
Tutorial 1: Text
Part 1 of 2: On the Steam Deck
- Open
Konsole
- In Konsole, type
passwd
and follow the prompts to set a password for the account- Your password will be invisible. Press enter when you've finished, you will be prompted to type it once again as confirmation
- In Konsole, type
sudo systemctl enable --now sshd
to both start and permanently enable the service - In Konsole, type
ip addr | grep inet | grep wlan0
, jot down the###.###.##.##
number in front ofinet
Part 2 of 2: On the Non-Steam Deck PC
Install Filezilla or WinSCP on your computer. No additional program is needed on the Steam Deck.
WinSCP is only available on Windows: https://winscp.net/eng/download.php
Filezilla is available on Linux, Mac, and Windows:
- Windows: https://filezilla-project.org/download.php?platform=win64
- Mac: https://filezilla-project.org/download.php?platform=osx
Select one of the two and follow the respective guide below.
Option 1: How to Use Filezilla
- Install FileZilla: https://filezilla-project.org/ on your non-Steam Deck PC
- No additional program is needed on the Steam Deck
- Click the icon in the top left
- Click
New Site
, give it a memorable name - Use the following template:
- Click
Connect
- (Optional) To browse to your SD Card, click the
..
at the top two times, select therun
folder,media
,mmcblk0p1
- Drag files between the two windows or use the context menu (
Right Click
) to transfer files
Option 2: How to Use WinSCP
- Install WINSCP: https://winscp.net/eng/index.php on your non-Steam Deck PC
- No additional program is needed on the Steam Deck
- Open WinSCP and you should be prompted with WinSCP's address book
- On the right side of the screen, use the following template:
- Click
Save
under theUser name
box and give the site name a memorable name - Click
Login
- (Optional) To browse to your SD Card, click the
..
at the top two times, select therun
folder,media
,mmcblk0p1
- Drag files between the two windows or use the context menu (
Right Click
) to transfer files
Post File Transfer
After you are finished setting up SSH and you have transferred your files, you may want to consider disabling SSH.
With a weak sudo password, leaving SSH enabled may be a security risk if you take your Steam Deck outside of your home and connect it to public Wi-Fi. With a strong sudo password, this risk is less apparent. Regardless, this section will cover how to disable SSH.
Select one of the two and follow the respective section below.
Option 1: Terminal Command
- In Desktop Mode, enter the below command in Konsole to disable SSH
sudo systemctl disable --now sshd
- To re-enable SSH, enter the below command in Konsole
sudo systemctl enable --now sshd
Option 2: Decky Loader Plugin
Skip Steps 1-4 if you have already installed Decky Loader
- Open
EmuDeck
on your desktop - Select
Power Tools
- Enter your password, and click
Install PowerTools
- If you have not set a password, this page will prompt you to create one
- Restart your Steam Deck
- In Game Mode, press the
...
button, press the Socket icon - Click the store icon in the top right, install
System Toolbox
- After installing
System Toolbox
: In Game Mode, press the QAM (...
) button, press the socket icon (Decky Loader's icon), selectSystem Toolbox
and disableRemote Terminal Access
- When you would like to transfer files again, re-enable
Remote Terminal Access
Tutorial 2: Video
Watch: https://www.youtube.com/watch?v=F790rBfyAQM
Method 2: DeckMTP
Preface
Watch: https://www.youtube.com/watch?v=4GcbEWl12Uc
For further reading: https://github.com/dafta/DeckMTP
DeckMTP is a Decky Loader plugin that allows the Steam Deck to be detected as a MTP drive (similar to a USB drive), once directly plugged into a PC via USB. (MacOS users may need the Android File Transfer App to be able to transfer files to MTP devices.)
How to Install DeckMTP
- Boot to desktop mode and open
Konsole
- In Konsole, type
passwd
and follow the prompts to set a password for the account- Your password will be invisible. Press enter when you've finished, you will be prompted to type it once again as confirmation
- Install Decky Loader by choosing one of the two following ways:
- Install through the EmuDeck application
- Install from the DeckyLoader Github: https://github.com/SteamDeckHomebrew/decky-loader
- Press the big
Download
button at the top
- Restart the Steam Deck
- In Game Mode, press the QAM (
...
) button - Press the
Socket
icon at the bottom of the list - In the top right, press the
Store
icon - Install DeckMTP
How to Set up DeckMTP
DeckMTP requires enabling DRD.
For a Youtube Video, watch: https://www.youtube.com/watch?v=4GcbEWl12Uc
- To enable DRD, shut down your Steam Deck
- Enter the BIOS by holding Volume Up and Power until you hear a beep
- Select Setup Utility
- Select Advanced
- Select USB Configuration
- Select USB Dual-Role Device
- Select DRD instead of the existing XHCI
- Plugging your Steam Deck into a PC via USB should now make it show up as a drive
Method 3: Removable Storage Device
Use a flash drive or a removable storage device that can be read on both Windows and Linux. You may need either a USB C adapter or a USB C Hub.
Method 4: AnyDesk
On the Steam Deck
- Install Anydesk from Discover (Shopping Bag icon) in desktop mode
- Install Flatseal from Discover (Shopping Bag icon) in desktop mode
- Open Flatseal
- On the left, select AnyDesk
- Under
Filesystem
, toggleAll system files, filesystem=host
On the Non-Steam Deck PC
- Install AnyDesk on your other PC from the website: https://anydesk.com/
- Connect to your Steam Deck
- Use AnyDesk's file transfer feature to transfer files between your Steam Deck and non Steam Deck PC
How to use AnyDesk to Transfer Files
- Connect to your Steam Deck
- Click the box with a right arrow at the top
- Your non-Steam Deck PC will be on the left side of the screen, your Steam Deck will be on the right side of the screen, right click files on either side to
Upload
orDownload
to the respective devices
Tips
- Your SD Card path is
/run/media/...
. To navigate to your SD Card, click the..
dots at the top until you are in the/
directory. You will see therun
folder, you can navigate to the remaining folders from here
Method 5: SMB Shares
Pick a tutorial:
- Watch: https://www.youtube.com/watch?v=x4_Sexd1UAw
- Read (Verbose): https://www.reddit.com/r/SteamDeck/comments/wdyqya/the_semiultimate_guide_to_smb_shares_on_steam_deck/
- Read (Succinct): https://www.reddit.com/r/SteamDeck/comments/tfjq1m/how_to_connect_to_smb_shares/iosxjcm/