xemu-project/xemu-website
1
0
Fork 0
mirror of https://github.com/xemu-project/xemu-website.git synced 2024-11-23 03:19:44 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Update download.md and troubleshooting.md: Add flatpak override to access xbox_hdd.qcow2 in custom directories (#157)

Browse Source 
* 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"
This commit is contained in:
David Hedlund 2024-11-17 20:45:44 +01:00 committed by GitHub
parent 03e686124a
commit f5d70dc611
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
docs/docs/download.md
View File

@ -57,8 +57,7 @@ Supported architectures: x86_64 and aarch64
!!! warning "Accessible Directories" !!! 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`. 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` or `flatpak override`](troubleshooting.md#flatpak-release-will-not-load-the-hard-drive).
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).
### Ubuntu PPA ### Ubuntu PPA

12
docs/docs/troubleshooting.md
View File

@ -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. * 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) 1. Install [Flatseal](https://flathub.org/apps/details/com.github.tchx84.Flatseal)
2. Select <kbd>app.xemu.xemu</kbd> 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 3. In the <kbd>Filesystem</kbd> section, allow access to the folders your BIOS / MCPX / Hard Drive Image are in