Skip to content

Commit

Permalink
Update download.md and troubleshooting.md: Add flatpak override to …
Browse files Browse the repository at this point in the history
…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 #157 (review)

* Update troubleshooting.md

Solved #157 (review)

* Update download.md

removed duplication of " do so with"
  • Loading branch information
davidhedlund authored Nov 17, 2024
1 parent 03e6861 commit f5d70dc
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 6 deletions.
3 changes: 1 addition & 2 deletions docs/docs/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
12 changes: 8 additions & 4 deletions docs/docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <kbd>app.xemu.xemu</kbd>
3. In the <kbd>Filesystem</kbd> section, allow access to the folders your BIOS / MCPX / Hard Drive Image are in
Expand Down

0 comments on commit f5d70dc

Please sign in to comment.