RetroRig is shell script to setup a Linux x86_64 system with several emulators, and XBMC as graphical front end.The inspiration for doing this lies almost completely with the RetroPie Project. I wanted to provide something similar, but with XBMC, x86_64, and my favorite interface, "Rom Collection Browser." This project is intended to be run on Ubuntu (currently 14.04 LTS), and a gamepad / controller. At some point in the future, I want to try and branch this to other distributions if possible. Please see the features page on the wiki for ideas and future plans.
I invite you to challenge the configs and scripts to help improve my ultimate goal to provide an easy way to get up and running with RetroGaming on x86_64 Linux systems. Pull requests or Issues are very much welcome! Please see the AUTHORS file in the root directory for all the awesome people that contribute to this project.
You can follow RetroRig's development by staring the github.com page, or with joining the IRC channel #retrorig-dev
located under the irc.freenode.net network. The main op is me "ProfessorKaos64". You can also follow me on twitter with the username "@N3RD42". There is also a forum for any and all discussion.
Please be advised:
RetroRig requires sudo access to inject the xboxdrv
init sripts, install softwate via apt-get, and other
various items. All script code and config files are
available for review.
Thank you for your patience.
RetroRig is meant to be a standalone setup for XBMC on Ubuntu. Soon, RetorRig will use it's own dotfile so you can continue to use your own XBMC implementation. RetroRig now makes use of a custom-patched XBMC binary as well to allow hotplugging for support controllers is possible. It is mainly targeted at folks wishing to repurpose an old physical PC. VirtualBox support exists, (to an extent), but can behave erratcially with emulator speed/framerates and is not advised. I do hope to corrrect some of that in due time, but right now, it is more of an "extra" or a "test bed."
It is mainly targeted at folks wishing to repurpose an old physical PC. VirtualBox support exists, (to an extent), but can behave erratcially with emulator speed/framerates and is not advised. I do hope to corrrect some of that in due time, but right now, it is more of an "extra" or a "test bed."
It will overwrite some folders for supported emulators and a few system files. Please see the wiki entries under "Installation," and "Advanced Configuration," or checkout the source code.
For all other features and future plans, please see the wiki
- No need to install an entire separate distro on your Mint/Debian machine
- Custom XBMC binary package
- Custom XBMC home screen and button layout
- Seperate dot file (.retrorig, not .xbmc) so you can have your cake and eat it too!
- Hotplugging support for supported wireles game controllers
- Dual monitor support for XBMC
- Auto-install software, emulator configs, and required components
- Many supported consoles (more added frequently)
- Gamepad select menu
- SSH and samba share support
- Preset Controller mappings for supported gamepads
- Resolution presets/custom selection for emulators that support it
- Save state, load state, exit emulators with gamepad
- A cobbled together "first run" state of RCB with a blank games database and pre-set configs
- Functions to update git repo, emulator binaries, upgrade system and more
- Automatically start XBMC, then directly into RCB itself (option to boot to XBMC session in settings menu)
- ROM pre-loader
- BIOS pre-loader
- Modular design for expandability
- Unity configuration set during config-setup to lengthen screen timeout + remove screen lock
First, I must direct you to read the wiki on this github page, as it contains extra iformation outside this wiki. https://github.com/ProfessorKaos64/RetroRig/wiki
Please also note
You may add the --help flag to the script for a quick help file. Come on, do it, it has psychedelic colorrrrsss!
Pre-requisites:
You will need git,figlet and dialog to run the installer:
sudo apt-get install dialog git figlet
RetroRig will try to install them for you (for instance, if you download the zip archive), but if you experience any issues starting the script,enusre they exist with the CLI commands 'which dialog' and 'which git" to ensure they report back. Please also ensure your graphics card or onboard graphics chipset supports OpenGL.
To clone this repo via the CLI:
git clone https://github.com/ProfessorKaos64/RetroRig
To install:
cd RetroRig
sudo ./retrorig_setup.sh
Currently,Only Ubuntu 14.04 LTS is supported, but more will be added in due time! You can perform a git checkout Beta to try our Beta branch, but please do so with caution and backup any file before hand!
You can also download a zip file or by other means on the github page.
The retrorig_setup.sh script also currently contains mechanisms to upgrade Ubuntu, update the emulator binaries, update our patched XBMC version, and also a way to pull the latest files from github.
This project is not yet complete! Project notes and guide will be hosted at www.libregeek.org at some point in the near future.