A tool for RetroPie to generate splashscreens with random video game related Fun Facts!.

WARNING: Splashscreens are only available on the Raspberry Pi.

cd /home/pi/
git clone https://github.com/hiulit/RetroPie-Fun-Facts-Splashscreens.git
cd RetroPie-Fun-Facts-Splashscreens/
sudo chmod +x fun-facts-splashscreens.sh

You can also install Fun Facts! Splashscreens as a scriptmodule via the RetroPie-Extra repository. Check the supplementary section.

sudo ./fun-facts-splashscreens.sh [OPTIONS]

If no options are passed, you will be prompted with a usage example:

USAGE: sudo ./fun-facts-splashscreens.sh [OPTIONS]

Use '--help' to see all the options.

• --help: Print the help message and exit.
• --splash-path [OPTIONS]: Set the image to use as Fun Facts! Splashscreen.
• --text-color [OPTIONS]: Set the text color to use on the Fun Facts! Splashscreen.
• --bg-color [OPTIONS]: Set the background color to use on the Fun Facts! Splashscreen.
• --add-fun-fact [OPTIONS]: Add new Fun Facts!.
• --remove-fun-fact: Remove Fun Facts!.
• --create-fun-fact: Create a new Fun Facts! Splashscreen.
• --apply-splash: Apply the Fun Facts! Splashscreen.
• --enable-boot: Enable script at boot.
• --disable-boot: Disable script at boot.
• --gui: Start GUI.
• --edit-config: Edit config file.
• --reset-config: Reset config file.
• --update: Update script.
• --version: Show script version.
• --enable-log: Enable logging.
• --disable-log: Disable logging.
• --restore-defaults: Restore default files.

If --splash-path, --text-color, --bg-color, --enable-boot, disable-boot, enable--log or disable-log are not set, the script takes the defaults:

• splashscreen_path: ./retropie-default.png
• text_color: white
• boot_script: false
• log: false

See the config file.

Print the help message and exit.

sudo ./fun-facts-splashscreens.sh --help

Set the image to use as Fun Facts! Splashscreen.

Must be an absolute path (e.g /home/pi/my-awesome-splashscreen.png).

• path/to/splashscreen: Path of the image to use as Fun Facts! Splashscreen.

sudo ./fun-facts-splashscreens.sh --splash-path "/home/pi/my-awesome-splashscreen.png"

Set the text color to use on the Fun Facts! Splashscreen.

• color: Text color of the Fun Facts! Splashscreen.

sudo ./fun-facts-splashscreens.sh --text-color "white"

Set the background color to use on the Fun Facts! Splashscreen.

• color: Background color of the Fun Facts! Splashscreen.

sudo ./fun-facts-splashscreens.sh --bg-color "black"

Add new Fun Facts!.

• text: Fun Fact! text.

sudo ./fun-facts-splashscreens.sh --add-fun-fact "You're new and amazing Fun Fact!"

Remove Fun Facts!.

sudo ./fun-facts-splashscreens.sh --remove-fun-fact

Create a new Fun Facts! Splashscreen.

The resulting splashscreen will be in /home/pi/RetroPie/splashscreens/.

sudo ./fun-facts-splashscreens.sh --create-fun-fact

Apply the Fun Facts! Splashscreen.

This command must be run in order to use the Fun Facts! Splashscreen.

sudo ./fun-facts-splashscreens.sh --apply-splash

Enable script at boot.

sudo ./fun-facts-splashscreens.sh --enable-boot

Disable script at boot.

sudo ./fun-facts-splashscreens.sh --disable-boot

Start GUI.

It lets you perform all the functions, but in a more friendly manner.

sudo ./fun-facts-splashscreens.sh --gui

Edit config file.

Opens a simple text editor.

When using this option from the terminal, it opens the nano text editor. To save the changes, press ctrl + o and then press enter. To exit, press ctrl + x.

When using the GUI, use the tab key to select Save or Back.

sudo ./fun-facts-splashscreens.sh --edit-config

Reset config file.

Removes all values from the config file. Next time the script is executed, it will populate the config file with defaults.

sudo ./fun-facts-splashscreens.sh --reset-config

Update script.

sudo ./fun-facts-splashscreens.sh --update

If you're using Fun Facts! Splashscreens via RetroPie-Setup (if you installed it as a scriptmodule via the RetroPie-Extra repository), this function won't work. The scriptmodules have their own update function.

If that's the case, go to:

• Manage packages
• Manage experimental packages
• fun-facts-splashscreens
• Update from source

Show script version.

sudo ./fun-facts-splashscreens.sh --version

Enable logging.

The log file is fun-facts-splashscreens.log.

sudo ./fun-facts-splashscreens.sh --enable-log

Disable logging.

sudo ./fun-facts-splashscreens.sh --disable-log

Restore default files.

• ./retropie-default.png (default splashscreen)
• ./fun-facts-splashscreens-settings.cfg (default config file)
• ./fun-facts.txt (default Fun Facts!)

sudo ./fun-facts-splashscreens.sh --restore-defaults

When using --splash-path, --text-color, --bg-color, --enable-boot, disable-boot, enable--log or disable-log, whether it's done via the terminal or the GUI, the generated values are stored in fun-facts-splashscreens-settings.cfg.

# Fun Facts! Splashscreens Settings.

# Set splashscreen path
#
# Must be an absolute path (e.g /home/pi/my-awesome-splashscreen.png).
splashscreen_path = ""

# Set splashscreen text color
#
# Short list of available colors:
#
# black, white, gray, gray10, gray25, gray50, gray75, gray90,
# pink, red, orange, yellow, green, silver, blue, cyan, purple, brown.
#
# TIP: run the 'convert -list color' command to get a full list.
text_color = ""

# Set background color
bg_color = ""

# Enable/disable script at boot
#
# Boolean: true/false.
boot_script = ""

# Enable/disable logging
#
# Boolean: true/false.
log = ""

You can edit this file directly instead of using --splash-path, --text-color, --bg-color, --enable-boot, disable-boot, enable--log or disable-log.

• Open fun-facts.txt.
• Add a new Fun Fact! (see style guide).

• Each Fun Fact! must be in one line.
• All video game names must be enclosed in double quotes (e.g. "Sonic the Hedgehog").
• Check the names using the TheGamesDB or any other reliable source.
• Fun Facts! aren't funnier even if they're written with exclamations marks. Don't use them.
• Tacky Fun Facts! aren't funnier either.
• Stick to Fun Facts! about video games that can be played with RetroPie (see supported systems).
• Try not to make Fun Facts! too long.

If you have an awesome Fun Fact! that you'd like to share, you can create a new issue with your awesome Fun Fact! and I'll gladly add it to the repository for everyone to enjoy! 😃🎉

Also (and preferably), if you know how, you can create a pull request 😉

See CHANGELOG.

See CONTRIBUTING.

Me 😛 @hiulit.

Thanks to:

• Parviglumis - For the idea of creating the Fun Facts! Splashscreens.
• meleu - For all his help and wisdom with the code and for all the PRs! :D
• zerojay - For adding Fun Facts! Splashscreens to the RetroPie-Extra repository.
• Thunderforge - For adding more Fun Facts!.
• All the people at the RetroPie Forum.

MIT License.