gsplash/README.md

gsplash

A fullscreen splash-screen wrapper for launching a game or app. It displays an image (or a fallback text label), starts your executable, and closes when the process exits or loses focus after launch.

Features

1. Fullscreen, borderless splash screen with hidden cursor
2. Displays a supplied image via Pillow (fallback text if load fails)
3. Launches the target executable and exits when it finishes
4. Closes on focus loss after the game starts or on Esc

Requirements

• Python 3.12+
• Tkinter (usually bundled with Python; on some Linux distros you may need a tk system package)
• Pillow

Install

Using uv (recommended):

uv sync

Using pip:

python -m venv .venv
source .venv/bin/activate
pip install .

Usage

python main.py <path_to_image> <game_executable> [game_arguments...]

Example:

python main.py assets/splash.jpg /path/to/game --fullscreen --profile=default