RetroArch: Difference between revisions

(4 intermediate revisions by 4 users not shown)

Line 1:

~~You can install~~ retroarch ~~with some~~ cores ~~(actual emulators) by putting something like this~~ in ~~your <code>/etc/nixos/configuration~~.~~nix</code>:~~

[https://www.retroarch.com/ RetroArch] is a all-in-one front-end for emulators, game engines and media players. Nix allows for installing RetroArch cores in a declarative and customizable way.

<~~syntaxhighlight lang~~=~~"nix"~~>

== Installation ==

environment.systemPackages = with pkgs; [

A RetroArch installation can be customized via different packages:

(retroarch.~~override {~~

cores = with ~~libretro~~; [

* <code>retroarch-full</code>, contains all libretro cores.

* <code>retroarch-free</code>, excludes unfree cores.

* <code>retroarch.withCores</code>, a helper function for generating a retroarch package with a custom list of cores.

=== Installing only certain cores ===

Using <code>retroarch.withCores</code>:

{{File|3={

environment.systemPackages = with pkgs; [

(retroarch.withCores (cores: with cores; [

genesis-plus-gx

snes9x

beetle-psx-hw

];

]))

})

];

}|name=/etc/nixos/configuration.nix|lang=nix}}

</~~syntaxhighlight>~~

~~The~~ cores ~~are defined~~ here:

One can browse the available cores [https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/emulators/libretro here]

~~https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/emulators/retroarch/cores.nix#L61~~

== Troubleshooting ==

== ~~Gotchas~~ ==

=== Graphics ===

Line 43:

Line 49:

# After switching over to the new configuration and restarting Retroarch, you will see the mappings got updated.

# Now you can create a pull request from your fork to the retroarch-joypad-autoconfig project to upstream your changes.

~~== Bugs ==~~

=== Input Reset ===

Line 53:

Line 57:

No icons show in the GUI, including the mouse cursor. You need to go to <code>Online Updater > Update Assets</code> to download the icons. You can navigate the GUI with only the keyboard. Press enter to open sections/pages, backspace to go back out, arrow keys to choose between options (left/right change some values).

~~== Error Messages ==~~

=== Error save controller profile ===

@@ Line 1: / Line 1: @@
-You can install retroarch with some cores (actual emulators) by putting something like this in your <code>/etc/nixos/configuration.nix</code>:
+[https://www.retroarch.com/ RetroArch] is a all-in-one front-end for emulators, game engines and media players. Nix allows for installing RetroArch cores in a declarative and customizable way.
-<syntaxhighlight lang="nix">
+== Installation ==
-environment.systemPackages = with pkgs; [
+A RetroArch installation can be customized via different packages:
-  (retroarch.override {
-    cores = with libretro; [
+* <code>retroarch-full</code>, contains all libretro cores.
+* <code>retroarch-free</code>, excludes unfree cores.
+* <code>retroarch.withCores</code>, a helper function for generating a retroarch package with a custom list of cores.
+=== Installing only certain cores ===
+Using <code>retroarch.withCores</code>:
+{{File|3={
+  environment.systemPackages = with pkgs; [
+    (retroarch.withCores (cores: with cores; [
        genesis-plus-gx
        snes9x
        beetle-psx-hw
-     ];
+     ]))
-   })
+   ];
-];
+}|name=/etc/nixos/configuration.nix|lang=nix}}
-</syntaxhighlight>
-The cores are defined here:
+One can browse the available cores [https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/emulators/libretro here]
-https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/emulators/retroarch/cores.nix#L61
+== Troubleshooting ==
-== Gotchas ==
 === Graphics ===
@@ Line 43: / Line 49: @@
 # After switching over to the new configuration and restarting Retroarch, you will see the mappings got updated.
 # Now you can create a pull request from your fork to the retroarch-joypad-autoconfig project to upstream your changes.
-== Bugs ==
 === Input Reset ===
@@ Line 53: / Line 57: @@
 No icons show in the GUI, including the mouse cursor. You need to go to <code>Online Updater > Update Assets</code> to download the icons. You can navigate the GUI with only the keyboard. Press enter to open sections/pages, backspace to go back out, arrow keys to choose between options (left/right change some values).
-== Error Messages ==
 === Error save controller profile ===