Disclaimer: This repository is only for educational purpose. Only use this with your own files/backups.

This script aims to help people adding improvements, fixing known bugs or resetting certain configurations. It can be run directly from the retropie and apply updates locally, or you can run it on a device in the same local network by providing ssh credentials.

Join Rick's discord server to keep track on the latest changes.

• Installation of the Tool
• Warning
• Features
  • Improvements
    • Download and Install Updates
    • Manually Install Downloaded Updates
    • Manually Install Downloaded Unofficial Updates
    • Package Unofficial Updates
    • Update Status
    • Validate Downloaded Updates
    • Manual Updates Story
  • System Tools and Utilities
    • Gamelist (Etc) Utilities
      • Check or Clean Game List Utilities
        • Check Game Lists
        • Clean Game Lists
        • Restore Clean Game List Logs
        • Remove Check or Clean Game List Logs
        • Clean Unofficial Roms
      • Genre Utilities
        • Manually Select Genres
        • Realign Genre Collections
        • Clear Recent Additions Collection
      • Sort Game Lists
      • Check or Clean Emulators Config Utilities
        • Check Emulators Config
        • Clean Emulators Config
        • Remove Check or Clean Emulators Config Logs
      • Count of Games
    • System overlays
    • Handheld Mode
    • Reset Permissions
  • Installation
    • Install
    • Update
    • Uninstall
  • Settings
    • Select Update Notification
    • Toggle Auto Clean
    • Toggle Count Official Only
  • Support
• SSH Remote Installation

Installation of the Tool

Simply run the following command on your Retropie via SSH (this is the recommended way, click here for further instruction) or access a terminal by connecting a keyboard and pressing F4 (Replace [link] with a URL to the MEGA storage containing the updates):

bash <(curl 'https://raw.githubusercontent.com/h3xp/RickDangerousUpdate/main/install.sh' -s -N) [link]

Installation will make the tool available from the "Options" tab in EmulationStation.

The script will also install a new command "update_tool" with which you can easily run the script from the CLI.

Note that if you do not install the tool, it will not be able to track what updates you have applied to your system and you will be prompted the install all available updates each time you run the tool until you do properly install it.

Warning

• It is strongly recommended to actually install the tool rather than just running it.
• Running the tool without installing it is at your own risk and is no longer supported.
• The script has been tested, however we can't give a 100% guarantee that it might not break something on your retropie. Therefore, use this at your own risk.

Features

Improvements

This is the "main" feature and reason to create this tool.

Download and Install Updates

This will allow you to easily select single or multiple updates to download from the MEGA drive directory and install them.

Manually Install Downloaded Updates

This allows you to install updates that you have manually downloaded from the MEGA drive directory.

Manually Install Downloaded Unofficial Updates

This allows you to install unofficial update packages that you have found and manually downloaded from that are not part of the official build.

Package Unofficial Updates

This allows you to create distribution packages of unofficial games you have previously manually added to your installation of the build.

Update Status

This does a check of your exisiting installation and lets you know which updates you have installed and what other updates are available to you.

Validate Downloaded Updates

This option checks the update files you have downloaded to confirm their validity for use.

Manual Updates Story

This option will describe the effects of applying manually downloaded updates before they are applied.

System Tools and Utilities

Various settings, tools and resets.

Gamelist (Etc) Utilities

Gamelist (Etc) Utilities provide a lot of functions to clean up, in general, and work with your gamelist.xml files.

Check or Clean Game List Utilities

Check Game Lists

This will check your gamelist.xml files and optionally check for orphaned roms, artwork, video snapshots, and multiple disk files.

Clean Game Lists

This will clean your gamelist.xml files by removing invalid entries, it will also delete orphaned files like roms.

Restore Clean Game List Logs

This will let you reverse the changes you applied with the "Clean Game Lists"-feature.

Remove Check or Clean Game List Logs

Allows you to delete log files left by previous gamelist utilities clean or check actions.

Clean Unofficial Roms

Allows you to select and uninstall unofficial roms you have previously added to your installation.

Genre Utilities

Manually Select Genres

Allows you to manually select official Rick Dangerous genres for roms that you have added manually, and add them to the correct collections.

Realign Genre Collections

Scans gamelist.xml files and completely rebuilds genre collections from gamelist entries.

Clear Recent Additions Collection

Resets Recent Additions collection to empty.

Sort Game Lists

Sorts your gamelist.xml files by Name for easier readability.

Check or Clean Emulators Config Utilities

Check Emulators Config

This will check your emulators.cfg file for duplicate or invalid entries.

Clean Emulators Config

Sorts your emulators.cfg file, removing duplicate or invalid entries.

Remove Check or Clean Emulators Config Logs

Allows you to delete log files left by previous gamelist utilities clean or check actions.

Count of Games

Displays the total game count within gamelist.xml files from selected systems. When you count all systems this will also drop a counts.txt file and a games_list.txt file, so you can easily validate against official game counts and view a comprehensive listing of all games.

System overlay

This lets you easily activate and deactivate the bezels/overlays for each system.

Handheld mode

This will reset the video settings and deactivate the bezels for these systems to make them more enjoyable on a handheld screen. Don't use this if you have your retropie connected to a TV. These systems will be adjusted:

• atarylynx
• gamegear
• gb
• gba
• gbc
• ngpc
• wonderswancolor

Reset Permissions

Reset Permissions will correct the ownership of parts of the installation if they have been accidentally changed.

Installation

Install

N.B. This option is here for existing users who have not previously installed the tool who know how to directly run the tool. The method of operation is no longer officially recommended.

This option will install the update tool fresh to the "Options" tab in EmulationStation. If an existing configuration exists then an Update operation is performed instead. This is done to avoid losing your installation history.

Update

This option will update your version to the most current version of the tool available.

Uninstall

This option will remove the tool entirely from the "Options" tab in EmulationStation and from your system.

Settings

Select Update Notification

Select Update Notification allows you to set what method is used to notify you of image updates and tool updates

• False - No notifications of updates or upgrades are displayed
• Theme - A message is displayed on the system selection screen when image updates or an upgrade to the tool is available
• Tool - At boot time the update tool can be optionally executed when image updates are available. This option should only be set if you have a keyboard attached to your Pi. This option includes the behaviour of the Theme notification.

Toggle Auto Clean

Toggle Auto Clean allows you to turn on or off automatic cleaning of your gamelist files after any updates are loaded.

Toggle Count Official

Toggle Count Offical allows to turn on or off inclusion of unofficial games within gamelist.xml files. Offical games are those provided by Rick. These are tagged noting their origin.

Support

Displays links to the Discord server and the Update Tool project

SSH Remote Installation

1. Make sure your pi is connected to the same network as your personal computer.

2. Make sure ssh is installed on your computer.

   • If you are on Windows you can check this by pressing Windowskey + R then type cmd and hit return.
   • Now a command line windows should have opened. Simply type ssh and hit return.
   • If you have ssh installed your output should look like this:

usage: ssh [-46AaCfGgKkMNnqsTtVvXxYy] [-B bind_interface]
           [-b bind_address] [-c cipher_spec] [-D [bind_address:]port]
           [-E log_file] [-e escape_char] [-F configfile] [-I pkcs11]
           [-i identity_file] [-J [user@]host[:port]] [-L address]
           [-l login_name] [-m mac_spec] [-O ctl_cmd] [-o option] [-p port]
           [-Q query_option] [-R address] [-S ctl_path] [-W host:port]
           [-w local_tun[:remote_tun]] destination [command]

• If it doesnt look like that, you can find help for Windows here

3. Now you need to know your retropies IP address. The easiest way to get it is by opening the "Options" tab in EmulationStation and use the "Show IP" menu entry.
4. You are all set! Simply run this command in your command line window (Windowskey + R then type cmd and hit return):

Replace [IP] with the IP adress you just found out and [link] with a URL to the MEGA storage containing the updates.

ssh pi@[IP] bash <(curl 'https://raw.githubusercontent.com/h3xp/RickDangerousUpdate/main/install.sh' -s -N) [link]

5. Enjoy !