diff --git a/docs/docs/download.md b/docs/docs/download.md index 22b39d32..213ac12a 100644 --- a/docs/docs/download.md +++ b/docs/docs/download.md @@ -57,8 +57,7 @@ Supported architectures: x86_64 and aarch64 !!! warning "Accessible Directories" When using the flatpak installation method, only the `~/.var/app/app.xemu.xemu/data/xemu/xemu` directory can be written to by xemu. The Hard Disk image must be placed there, for example at `~/.var/app/app.xemu.xemu/data/xemu/xemu/xbox_hdd.qcow2`. - - If you want to whitelist additional directories, you can [do so with Flatseal](troubleshooting.md#flatpak-release-will-not-load-bios-mcpx-rom-hard-drive). + If you want to whitelist additional directories, you can [do so with `flatseal` or `flatpak override`](troubleshooting.md#flatpak-release-will-not-load-the-hard-drive). ### Ubuntu PPA diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md index 15d3aeef..09bcae4c 100644 --- a/docs/docs/troubleshooting.md +++ b/docs/docs/troubleshooting.md @@ -12,14 +12,18 @@ Please check the [list of frequently asked questions](faq.md). * Surround Sound isn't supported in xemu yet, you should disable this in your [EEPROM](eeprom.md) if you have enabled it. -## Flatpak release will not load BIOS / MCPX ROM / Hard Drive +## Flatpak release will not load the Hard Drive -Flatpak programs are normally sandboxed, restricting their access to the filesystem. +As explained in the [readme](https://github.com/flathub/app.xemu.Xemu?tab=readme-ov-file#usage): Only `$HOME/.var/app/app.xemu.xemu/data/xemu/xemu` can be written by xemu. The Hard Disk image has to be placed there, for example, at `$HOME/.var/app/app.xemu.xemu/data/xemu/xemu/xbox_hdd.qcow2`. To enable write permissions for the xbox_hdd.qcow2 hard drive file located outside xemu's flatpak system directory, you must grant xemu access to write in an alternative directory. This can be accomplished using either flatpak or flatseal. -By default, xemu can only access `~/.var/app/app.xemu.xemu/data/xemu/xemu` +Note: This step is not necessary for other system files, such as the BIOS or the MCPX ROM. -If you want to allow xemu access to other folders, then: +### Flatpak +1. `sudo flatpak override app.xemu.xemu --filesystem="$HOME/savedgames/xemu/` +Note: Using the same command non-root with the `flatpak --user` parameter will not work. + +### Flatseal 1. Install [Flatseal](https://flathub.org/apps/details/com.github.tchx84.Flatseal) 2. Select app.xemu.xemu 3. In the Filesystem section, allow access to the folders your BIOS / MCPX / Hard Drive Image are in