Awesome
abendbrot
Welcome to abendbrot
, the third-party Gentoo overlay full of:
- Old-school console emulation (e.g., RetroArch, LibRetro, EmulationStation).
- New-school GTK, KDE and X.org themes.
Installation
abendbrot
is installable in two ways. Assuming emerge
(and not
that other disreputable fellow):
The portage way:
-
Install
dev-vcs/git
* Execute the following with root rights (`su -l` or `sudo -i`) $ curl --create-dirs -o /etc/portage/repos.conf/abendbrot.conf https://raw.githubusercontent.com/stefan-gr/abendbrot/master/tools/abendbrot.conf $ emerge --sync
The layman way:
-
Install
layman
with USE=git, Gentoo's official overlay manager.$ emerge --ask layman * For <=app-portage/layman-2.2.0-r7 $ echo 'source /var/lib/layman/make.conf' >> /etc/portage/make.conf * For >=app-portage/layman-2.3.0-r1[sync-plugin-portage] $ Nothing
-
Fetch overlay list.
$ layman -f
-
Add the
abendbrot
overlay.$ layman -a abendbrot
-
Synchronize overlays.
$ layman -S
Compilation
Most ebuilds hosted at this overlay are trivially compilable. Ebuilds overwriting or updating official Portage ebuilds are keyworded and will require manual unmasking.
Some ebuilds, however, require what can only charitably be referred to as the "Thai keyboard massage."
RetroArch
RetroArch is the official frontend for LibRetro, a lightweight C[++] API unifying console emulators, game engines, standalone games, media players, and (...wait for it) more under the same umbrella interface. Each implementation of the LibRetro API is referred to as a core. Cores exist for most popular open-source emulators (e.g., Nestopia) and game engines (e.g., ScummVM) – with (...wait for it) more continually on the way and waiting in the wings.
RetroArch and LibRetro are beasts. Let abendbrot
tame these beasts for you:
-
Unmask RetroArch, the official LibRetro frontend. While alternative frontends exist, you almost certainly want RetroArch for your first forays into LibRetro Land™. This overlay provides both:
-
(Recommended) Stable RetroArch releases, No unmasking required.
-
(Not recommended) The unstable live RetroArch repository, unmasked by adding the following line to
/etc/portage/package.accept_keywords
:~games-emulation/retroarch-9999 **
-
-
Set LibRetro core USE flags. For each core , enable the corresponding USE flag provided by the
games-emulation/libretro-meta
ebuild. To prevent this ebuild from attempting to install other undesired LibRetro cores, disable all other USE flags provided by this ebuild. For example, to enable only the Nestopia and mGBA LibRetro cores, add the following line to/etc/portage/package.use
:games-emulation/libretro-meta mgba nestopia -2048 -4do -beetle-psx -bnes -bsnes -desmume -dolphin -fba -fceu-next -gambatte -genplus -handy -imame4all -mame -mednafen-gba -mednafen-ngp -mednafen-pce-fast -mednafen-psx -mednafen-snes -mednafen-vb -mednafen-wswan -meteor -mupen64plus -nxengine -pcsx-rearmed -mednafen-supergrafx -picodrive -pocketsnes -ppsspp -prboom -prosystem -quicknes -scummvm -snes9x -snes9x-next -stella -tgbdual -tyrquake -vba-next -vbam -yabause
-
(Optional) Set RetroArch USE flags. The
games-emulation/retroarch
ebuild provides a variety of USE flags. While the defaults should suffice for most use cases, the good Gentooer expects more. For example, to enable achievement support but disable SDL1 support, add the following line to/etc/portage/package.use
:games-emulation/retroarch cheevos -sdl
-
Install RetroArch:
$ emerge --ask retroarch
-
Live on the bleeding edge. The stable cores provided by this overlay are updated quite often. But, if you want to experience retroarch completely on the edge then add these lines to
/etc/portage/package.accept_keywords
:games-emulation/*libretro* ** games-emulation/retroarch ** To update the *9999 ebuilds only when their repo updated: $ emerge -a app-portage/smart-live-rebuild
Issues
Please report ebuild issues, feature requests, and other pressing concerns at our closely followed issue tracker.
Thanks, guys!
Etymology
Abendbrot is German for "night bread," but broadly refers to the traditional evening meal in German-speaking regions of fatty bread, fatty sliced meat, fatty cheese, and fatty pickles. Witness the traditionally unhappy German family in its native abendbrot environment:
Don't be like them. Play RetroArch.