You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guides/install-gnu.md
+64-1Lines changed: 64 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,70 @@ installing RetroArch on systems running the GNU/Linux kernel.
18
18
19
19
---
20
20
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)
22
85
23
86
Flatpak is a distribution-agnostic packaging format with broad support
24
87
throughout the Linux ecosystem. An official [RetroArch
0 commit comments