Skip to content

Commit 0ce04cd

Browse files
authored
Update install-gnu.md: Added AM AppImage management guide
1 parent b379d8b commit 0ce04cd

1 file changed

Lines changed: 64 additions & 1 deletion

File tree

docs/guides/install-gnu.md

Lines changed: 64 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,70 @@ installing RetroArch on systems running the GNU/Linux kernel.
1818

1919
---
2020

21-
## Flatpak (suitable for most Linux distributions)
21+
## AppImage (suitable for most GNU/Linux distributions)
22+
23+
### AM
24+
25+
[AM](https://github.com/ivan-hc/AM) is a powerful command-line package manager for managing AppImage software. It allows users to install, update, and remove AppImages either system-wide or locally without manual setup.
26+
27+
1. Installation
28+
29+
There are no system packages available for AM in common repositories, so it must be installed manually.
30+
31+
Follow the official installation instructions provided at: https://github.com/ivan-hc/AM
32+
33+
During setup, you’ll be prompted to choose one of two installation modes:
34+
35+
* Option 1: AM – for system-wide AppImage management (requires root privileges).
36+
* Option 2: appman – for local, user-level AppImage management (no root access required).
37+
38+
Choose the option that best suits your environment and permissions.
39+
40+
41+
2. Searching for AppImages
42+
43+
Once installation is complete, verify that AM or AppMan is working by performing a search.
44+
Use the appropriate command depending on your installation:
45+
46+
47+
```
48+
# For system-wide installation
49+
am -q retroarch
50+
51+
# For user-level installation
52+
appman -q retroarch
53+
```
54+
55+
This query searches for available AppImages matching “retroarch” and displays a list of results.
56+
Example output:
57+
58+
``
59+
$ appman -q retroarch
60+
61+
SEARCH RESULTS FOR "RETROARCH":
62+
63+
◆ retroarch-nightly : RetroArch is a free and open-source, cross-platform frontend for emulators, game engines, video games, media players and other applications.
64+
◆ retroarch-qt-nightly : RetroArch is a free and open-source, cross-platform frontend for emulators, game engines, video games, media players and other applications.
65+
◆ retroarch-qt : RetroArch is a free and open-source, cross-platform frontend for emulators, game engines, video games, media players and other applications.
66+
◆ retroarch : RetroArch is a free and open-source, cross-platform frontend for emulators, game engines, video games, media players and other applications.
67+
```
68+
69+
3. Installing an AppImage
70+
71+
To install your chosen AppImage, use the -i flag.
72+
For example, to install the RetroArch Nightly build (ideal for testing or bug reporting):
73+
74+
`appman -i retroarch-nightly`
75+
76+
AM or AppMan will automatically download, validate, and integrate the AppImage into your environment.
77+
78+
4. Notes and Recommendations
79+
80+
* Nightly builds are recommended when submitting bug reports or testing new features.
81+
* Stable releases are better suited for everyday use.
82+
* Use the same tool (am or appman) for all lifecycle tasks—installation, updates, and removal.
83+
84+
## Flatpak (suitable for most GNU/Linux distributions)
2285
2386
Flatpak is a distribution-agnostic packaging format with broad support
2487
throughout the Linux ecosystem. An official [RetroArch

0 commit comments

Comments
 (0)