4 Commits

Author SHA1 Message Date
8d5a106ab3 docs: Update documentation 2026-05-26 16:02:43 +05:30
4e7c53d79f docs: Update README to remove video and add asset link
Removed video demo from README and added a link to GitHub assets.
2026-05-26 15:57:15 +05:30
bb2b60de5b fix: md rendering 2026-05-26 15:52:58 +05:30
1159868e15 docs: Added demo video 2026-05-26 15:51:20 +05:30
2 changed files with 32 additions and 28 deletions

View File

@@ -2,6 +2,8 @@
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.
https://github.com/user-attachments/assets/22da49b4-0f1f-4208-8d0b-9eeef14e35e5
## Features
1. Fullscreen, borderless splash screen with hidden cursor (SDL2)
@@ -39,6 +41,36 @@ sudo make install
DESTDIR=/some/staging/path make install
```
## Usage
```bash
gsplash <image_or_video_path> <game_executable> [game_arguments...]
```
Example:
```bash
gsplash assets/splash.jpg /path/to/game --fullscreen --profile=default
# Video splash (supported formats depend on ffmpeg build)
gsplash assets/splash.mp4 /path/to/game --fullscreen --profile=default
```
Gsplash allows you to configure how the image or video is displayed with 3 modes:
- `center` (default): letterbox
- `crop`: fill screen by cropping
- `stretch`: Distort to fill screen
You can set these by using the `-m` or `--mode` flag:
```bash
build/gsplash [--mode=stretch|center|crop] <background> <executable> [args...]
build/gsplash -m stretch|center|crop <background> <executable> [args...]
```
## Testing
Gsplash includes several testing utilities to ensure proper functionality without requiring a heavy game binary.
@@ -71,31 +103,3 @@ For manual testing, a `dummy_game` binary is built alongside `gsplash`. It mimic
./build/gsplash path/to/image.png ./build/dummy_game 10
```
## Usage
```bash
gsplash <image_or_video_path> <game_executable> [game_arguments...]
```
Example:
```bash
gsplash assets/splash.jpg /path/to/game --fullscreen --profile=default
# Video splash (supported formats depend on ffmpeg build)
gsplash assets/splash.mp4 /path/to/game --fullscreen --profile=default
```
Gsplash allows you to configure how the image or video is displayed with 3 modes:
- `center` (default): letterbox
- `crop`: fill screen by cropping
- `stretch`: Distort to fill screen
You can set these by using the `-m` or `--mode` flag:
```bash
build/gsplash [--mode=stretch|center|crop] <background> <executable> [args...]
build/gsplash -m stretch|center|crop <background> <executable> [args...]
```

BIN
docs/assets/demo.mp4 Normal file

Binary file not shown.