mirror of
https://github.com/stornic56/debianito-post-install.git
synced 2026-10-31 13:08:06 +00:00
Recovered 70 prior commits from Gitea mirror and resolved divergent history using --allow-unrelated-histories. Integrated 16 recent local commits via patch. Applied targeted technical fixes: added explicit bash shell declaration in shellcheck YAML configuration (commit 693caff) and targeted SC2120 disables in modules/utils.sh (commit 3614b56). All verifications passed: shellcheck compliance, bash syntax check (bash -n), and BATS test suite passing cleanly. Symmetrically synchronized repository state across GitHub and Gitea.
This commit is contained in:
stornic56
+12
-12
@@ -18,16 +18,16 @@ When installed via `apt`, RetroArch uses these locations:
|
||||
Because the core and info directories are owned by root, you cannot write to them without `sudo`.
|
||||
You have two options:
|
||||
|
||||
1. **Manual installation** – download cores and info files yourself and copy them with `sudo`.
|
||||
1. **Manual installation**: download cores and info files yourself and copy them with `sudo`.
|
||||
2. **Reconfigure RetroArch** to use user‑writable folders, then use the built‑in **Core Downloader**.
|
||||
|
||||
Both methods work; choose the one that suits you best.
|
||||
|
||||
---
|
||||
|
||||
## Method 1 – Manual Core Installation (Recommended for Reliability)
|
||||
## Method 1: Manual Core Installation (Recommended for Reliability)
|
||||
|
||||
This method guarantees that you can add any core, even if the online updater is blocked.
|
||||
This method works for any core, even when the online updater is blocked.
|
||||
|
||||
### 1. Download and Install the Core (`.so`)
|
||||
|
||||
@@ -41,7 +41,7 @@ sudo mv ppsspp_libretro.so /usr/lib/x86_64-linux-gnu/libretro/
|
||||
rm ppsspp_libretro.so.zip
|
||||
```
|
||||
|
||||
> **Replace `ppsspp` with any core name** – e.g., `mame_libretro`, `dolphin_libretro`, etc.
|
||||
> **Replace `ppsspp` with any core name**: e.g., `mame_libretro`, `dolphin_libretro`, etc.
|
||||
> Browse all available cores at:
|
||||
> [https://buildbot.libretro.com/nightly/linux/x86_64/latest/](https://buildbot.libretro.com/nightly/linux/x86_64/latest/)
|
||||
|
||||
@@ -61,11 +61,11 @@ sudo mv ppsspp_libretro.info /usr/share/libretro/info/
|
||||
|
||||
---
|
||||
|
||||
## Method 2 – Enable the Built‑in Core Downloader
|
||||
## Method 2: Enable the Built‑in Core Downloader
|
||||
|
||||
If you prefer using RetroArch’s graphical interface to download cores, you can change the core directories to writable locations.
|
||||
|
||||
### Step 1 – Edit RetroArch Configuration
|
||||
### Step 1: Edit RetroArch Configuration
|
||||
|
||||
Create or edit `~/.config/retroarch/retroarch.cfg` and add these lines:
|
||||
|
||||
@@ -82,19 +82,19 @@ mkdir -p ~/.config/retroarch/libretro
|
||||
mkdir -p ~/.config/retroarch/libretro-info
|
||||
```
|
||||
|
||||
### Step 2 – Update Core Info Files
|
||||
### Step 2: Update Core Info Files
|
||||
|
||||
- Launch RetroArch.
|
||||
- Go to **Online Updater** → **Update Core Info Files**.
|
||||
- Wait for the update to complete.
|
||||
|
||||
### Step 3 – Download Cores
|
||||
### Step 3: Download Cores
|
||||
|
||||
- Go to **Online Updater** → **Core Downloader**.
|
||||
- Select the core you want (e.g., PPSSPP).
|
||||
- The core will be downloaded to your user directory and will appear in the core list.
|
||||
|
||||
> ⚠️ **Note:** Some cores may require additional system files (BIOS/assets). These are still placed in `~/.config/retroarch/system/` – you’ll need to obtain them separately (see below).
|
||||
> ⚠️ **Note:** Some cores may require additional system files (BIOS/assets). These are still placed in `~/.config/retroarch/system/`. You’ll need to obtain them separately (see below).
|
||||
|
||||
---
|
||||
|
||||
@@ -139,7 +139,7 @@ You can find many asset packs at:
|
||||
## ROM / Game File Formats
|
||||
|
||||
- **Supported formats** for PPSSPP: `.iso`, `.cso`, `.chd`, `.pbp`.
|
||||
- **Always decompress your ROMs** – do not leave them in `.zip`, `.rar`, or `.7z` archives; the cores cannot read compressed archives directly.
|
||||
- **Always decompress your ROMs**: do not leave them in `.zip`, `.rar`, or `.7z` archives; the cores cannot read compressed archives directly.
|
||||
|
||||
---
|
||||
|
||||
@@ -151,13 +151,13 @@ You can find many asset packs at:
|
||||
| Core info files (GitHub) | [https://github.com/libretro/libretro-core-info](https://github.com/libretro/libretro-core-info) |
|
||||
| System assets (BIOS, firmware, etc.) | [https://buildbot.libretro.com/assets/system/](https://buildbot.libretro.com/assets/system/) |
|
||||
| Official RetroArch documentation | [https://docs.libretro.com/](https://docs.libretro.com/) |
|
||||
| Debian Wiki – RetroArch | [https://wiki.debian.org/RetroArch](https://wiki.debian.org/RetroArch) |
|
||||
| Debian Wiki: RetroArch | [https://wiki.debian.org/RetroArch](https://wiki.debian.org/RetroArch) |
|
||||
|
||||
---
|
||||
|
||||
## Final Notes
|
||||
|
||||
- The Debian package disables auto‑updates and the core downloader **by default** – this is intentional for stability.
|
||||
- The Debian package disables auto‑updates and the core downloader **by default**: this is intentional for stability.
|
||||
- Manual installation (Method 1) is the most straightforward and works for **any** core, regardless of distribution restrictions.
|
||||
- If you choose Method 2, remember that you may still need to manually place BIOS/asset files in `~/.config/retroarch/system/`.
|
||||
- Always test your video driver setting; `vulkan` is recommended for PPSSPP and other 3D‑heavy cores.
|
||||
|
||||
Reference in New Issue
Block a user