b5de077ac3af44c662bb8cac346956b5777cf7f5
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
- Fullscreen, borderless splash screen with hidden cursor (SDL2)
- Displays a supplied image via SDL2_image (fallback to black if load fails)
- Launches the target executable and exits when it finishes
- 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:
# Build the binary in the project root
make
# Install system-wide (defaults to /usr/local)
sudo make install
# Staged install (useful for packaging):
DESTDIR=/some/staging/path make install
Smoke test (headless)
Run a lightweight headless smoke test that uses the dummy video driver so it doesn't require a display:
make check
Usage
./gsplash <image_path> <game_executable> [game_arguments...]
Example:
./gsplash assets/splash.jpg /path/to/game --fullscreen --profile=default
Description
Splash screen wrapper for Linux. Hide your desktop when transitioning from the launcher to the game.
Languages
C
77.3%
Shell
16.8%
Makefile
5.9%