From f5d70dc61194fea65d26b62d04e1618a3bcc0012 Mon Sep 17 00:00:00 2001 From: David Hedlund Date: Sun, 17 Nov 2024 20:45:44 +0100 Subject: [PATCH] Update download.md and troubleshooting.md: Add `flatpak override` to access xbox_hdd.qcow2 in custom directories (#157) * Update download.md: Replace `flatseal` with `flatpak override` * Update troubleshooting.md: Replace `flatseal` with `flatpak override` * Update download.md Link to troubleshooting.md#flatpak-release-will-not-load-the-hard-drive for `flatpak override` instructions * Update troubleshooting.md * Update troubleshooting.md Restore flatseal as an alternative option * Update download.md restore flatseal as an alternative option * Update troubleshooting.md Solved https://github.com/xemu-project/xemu-website/pull/157#pullrequestreview-2429143807 * Update troubleshooting.md Solved https://github.com/xemu-project/xemu-website/pull/157#pullrequestreview-2429149762 * Update download.md removed duplication of " do so with" --- docs/docs/download.md | 3 +-- docs/docs/troubleshooting.md | 12 ++++++++---- 2 files changed, 9 insertions(+), 6 deletions(-) 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