gsplash/README.md

gsplash

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

Features

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

Build Requirements

• C compiler (GCC or Clang)
• make
• pkg-config
• SDL2
• SDL2_image

Install

Arch Linux (PKGBUILD) for integrating with your system package manager:

makepkg -si

For other distributions, build and install manually:

make
sudo make install

Usage

Build output installs to /usr/local/bin by default. Override with PREFIX.

gsplash <image_path> <game_executable> [game_arguments...]

gsplash assets/splash.jpg /path/to/game --fullscreen --profile=default