Space Whiskey
An Open Game Launcher
What is Space Whiskey
Space Whiskey is a game launcher for the Raspberry Pi and other systems. It is designed to allow you to browse your games easily with only the addition of a simple config file.
How it Works
- Looks in the Games folder of the current user
- Looks in each folder for a metadata.json file
- Looks in the Games folder for a library.json file for external games and directories
- Lists the games in a minimal user interface
- Provides a simple way to launch any of the games
Goals
- Use no libraries other than pygame
- Work on 2.7 and 3.6
- Be B&W in order to draw attention to the games
Sample config.json
This file goes in the src folder of Space Whiskey but is not required:
{
"fullscreen": false,
"logfile": log.log
}
Sample metadata.json
This file should be included in your game directory:
{
"title": "My Game",
"description": "A great game",
"image": "200x120-image-for-game.png*",
"command": "start command for game"
}
Sample Game
You can see a sample metadata setup or test your installation with the following repo: https://github.com/littletinman/space-whiskey-pong
Sample library.json
This file should go in the /Games directory of your user
{
"games": [
{
"title": "My Game 1",
"description": "A great game",
"image": null or absolute path*,
"command": "game executable"
}
],
"directories": ["absolute/path/to/game/directory"]
}
Install
- Download Repo
- Install python and pygame
- Add games to
/Games
or add directories to/Games/library.json
- Run
python space-whiskey.py
Linux Install
- Download Repo -
https://github.com/littletinman/space-whiskey.git
- Install pygame, choose one of following options
a. Use pip -pip install pygame
b. Debian/Ubuntu -sudo apt-get install python3-pygame
c. Fedora -sudo yum install python3-pygame
- Test pygame installation -
python3 -m pygame.examples.aliens
- Add games to
/Games
or add directories to/Games/library.json
- Run
python space-whiskey.py