RetroArch - Revision history

Jasi: /* Installation */ Move link to introduction and change wording.

2025-06-23T02:51:44Z

Installation: Move link to introduction and change wording.

← Older revision		Revision as of 02:51, 23 June 2025
Line 1:		Line 1:
	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.		[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.

	== Installation ==		== Installation ==
	~~[https://www.retroarch.com/~~ RetroArch~~] is available in nixpkgs~~ via ~~a few~~ different packages,		A RetroArch installation can be customized via different packages:

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

Jasi: Transition to modern style.

2025-06-23T02:47:55Z

Transition to modern style.

← Older revision		Revision as of 02:47, 23 June 2025
Line 1:		Line 1:
			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.

	== Installation ==		== Installation ==
	[https://www.retroarch.com/ RetroArch] is available in nixpkgs via a few different packages,		[https://www.retroarch.com/ RetroArch] is available in nixpkgs via a few different packages,

	* <code>retroarch-full</code>, contains all libretro cores		* <code>retroarch-full</code>, contains all libretro cores.
	* <code>retroarch-free</code>, ~~contains only~~ cores ~~available under a free-software license~~		* <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.		* <code>retroarch.withCores</code>, a helper function for generating a retroarch package with a custom list of cores.

	=== Installing only certain cores ===		=== Installing only certain cores ===
	~~In NixOS 24.11, you override the~~ retroarch ~~derivation to pass a list of custom cores like below~~.<~~syntaxhighlight lang~~=~~"nix">~~
	environment.systemPackages = with pkgs; [		Using <code>retroarch.withCores</code>:
	(retroarch.~~override {~~		{{File\|3={
	cores = with ~~libretro~~; [		environment.systemPackages = with pkgs; [
			(retroarch.withCores (cores: with cores; [
	genesis-plus-gx		genesis-plus-gx
	snes9x		snes9x
	beetle-psx-hw		beetle-psx-hw
	];		]))
	})		];
	];		}\|name=/etc/nixos/configuration.nix\|lang=nix}}
	</~~syntaxhighlight>~~

	~~After NixOS 24~~.~~11, the RetroArch derivation was refactored, and the interface is now <code>retroarch.withCores</code>:<syntaxhighlight~~ lang="nix">
	~~environment.systemPackages = with pkgs; [~~
	~~(retroarch.withCores (cores: with cores; [~~
	~~genesis-plus-gx~~
	~~snes9x~~
	~~beetle-psx-hw~~
	~~]))~~
	];
	~~</syntaxhighlight>~~

	~~The cores are defined here:~~

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

	== ~~Gotchas~~ ==		== Troubleshooting ==

	=== Graphics ===		=== Graphics ===
Line 59:		Line 49:
	# After switching over to the new configuration and restarting Retroarch, you will see the mappings got updated.		# 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.		# Now you can create a pull request from your fork to the retroarch-joypad-autoconfig project to upstream your changes.

	~~== Bugs ==~~

	=== Input Reset ===		=== Input Reset ===
Line 69:		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).		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 ===		=== Error save controller profile ===

Phanirithvij: /* Installing only certain cores */

2025-03-16T03:59:18Z

Installing only certain cores

← Older revision		Revision as of 03:59, 16 March 2025
Line 28:		Line 28:
	];		];
	</syntaxhighlight>		</syntaxhighlight>

			The cores are defined here:

			https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/emulators/libretro

	== Gotchas ==		== Gotchas ==

Peeley: Provide example for the retroarch.withCores interface

2025-02-08T21:38:32Z

Provide example for the retroarch.withCores interface

← Older revision		Revision as of 21:38, 8 February 2025
Line 19:		Line 19:
	</syntaxhighlight>		</syntaxhighlight>

	After NixOS 24.11, the RetroArch derivation was refactored, and the interface is now <code>retroarch.withCores</code>. ~~See the libretro README in nixpkgs for example usage~~.		After NixOS 24.11, the RetroArch derivation was refactored, and the interface is now <code>retroarch.withCores</code>:<syntaxhighlight lang="nix">
			environment.systemPackages = with pkgs; [
			(retroarch.withCores (cores: with cores; [
			genesis-plus-gx
			snes9x
			beetle-psx-hw
			]))
			];
			</syntaxhighlight>

	== Gotchas ==		== Gotchas ==

Aidalgol: Update installation section

2024-12-03T04:34:13Z

Update installation section

← Older revision		Revision as of 04:34, 3 December 2024
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>:~~		== Installation ==
			[https://www.retroarch.com/ RetroArch] is available in nixpkgs via a few different packages,

	<syntaxhighlight lang="nix">		* <code>retroarch-full</code>, contains all libretro cores
			* <code>retroarch-free</code>, contains only cores available under a free-software license
			* <code>retroarch.withCores</code>, a helper function for generating a retroarch package with a custom list of cores.

			=== Installing only certain cores ===
			In NixOS 24.11, you override the retroarch derivation to pass a list of custom cores like below.<syntaxhighlight lang="nix">
	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	(retroarch.override {		(retroarch.override {
Line 13:		Line 19:
	</syntaxhighlight>		</syntaxhighlight>

	~~The cores are defined here:~~		After NixOS 24.11, the RetroArch derivation was refactored, and the interface is now <code>retroarch.withCores</code>. See the libretro README in nixpkgs for example usage.

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

	== Gotchas ==		== Gotchas ==

Ibizaman: Add more info about mappings.

2024-04-21T05:12:56Z

Add more info about mappings.

@@ Line 19: / Line 19: @@
 == Gotchas ==
 Not all the graphics settings are in the same place. You'll want to look under the top-level Settings (in the left column under Main Menu) and also under <code>Main Menu -> Quick Menu -> Options</code>
 == Bugs ==
@@ Line 31: / Line 54: @@
 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).
 [[Category:Applications]]
 [[Category:Gaming]]

Klinger: added to categories applications and gaming

2024-04-19T16:26:12Z

added to categories applications and gaming

← Older revision		Revision as of 16:26, 19 April 2024
Line 30:		Line 30:

	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).		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).

			[[Category:Applications]]
			[[Category:Gaming]]

imported>Zaechus: fix line number for github link and remove erroneous line about directly running games

2023-03-14T16:36:24Z

fix line number for github link and remove erroneous line about directly running games

← Older revision		Revision as of 16:36, 14 March 2023
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>		You can install retroarch with some cores (actual emulators) by putting something like this in your <code>/etc/nixos/configuration.nix</code>:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
Line 15:		Line 15:
	The cores are defined here:		The cores are defined here:

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

	~~Once you update your system you can run <code>retroarch</code> to access the main gui, or eg <code>retroarch-mednafen-psx-hw my-game-file.cue</code> to run a game directly.~~

	== Gotchas ==		== Gotchas ==

imported>Zaechus at 05:53, 26 February 2023

2023-02-26T05:53:24Z

← Older revision		Revision as of 05:53, 26 February 2023
Line 3:		Line 3:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	(retroarch.override {		(retroarch.override {
	cores = with libretro; [		cores = with libretro; [
	genesis-plus-gx		genesis-plus-gx
	snes9x		snes9x
	beetle-psx-hw		beetle-psx-hw
	];		];
	})		})
	];		];
	</syntaxhighlight>		</syntaxhighlight>

imported>Zaechus: improve cores example

2023-02-07T18:01:40Z

improve cores example

← Older revision		Revision as of 18:01, 7 February 2023
Line 4:		Line 4:
	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	(retroarch.override {		(retroarch.override {
	cores = [		cores = with libretro; [
	~~libretro.~~genesis-plus-gx		genesis-plus-gx
	~~libretro.~~snes9x		snes9x
	~~libretro.~~beetle-psx-hw		beetle-psx-hw
	];		];
	})		})
	~~libretro.genesis-plus-gx~~
	~~libretro.snes9x~~
	~~libretro.beetle-psx-hw~~
	];		];
	</syntaxhighlight>		</syntaxhighlight>