No description
  • Crystal 98.6%
  • Shell 1.4%
Find a file
2026-04-04 12:54:44 +02:00
scripts init as submodule 2026-03-26 05:58:17 +01:00
spec init as submodule 2026-03-26 05:58:17 +01:00
src feat: opaque color for vewiew window itself 2026-04-04 12:54:44 +02:00
vendor feat: wayland backend layer surfaces 2026-04-03 17:48:12 +02:00
.editorconfig init as submodule 2026-03-26 05:58:17 +01:00
.gitignore init as submodule 2026-03-26 05:58:17 +01:00
LICENSE init as submodule 2026-03-26 05:58:17 +01:00
README.md init as submodule 2026-03-26 05:58:17 +01:00
shard.lock init as submodule 2026-03-26 05:58:17 +01:00
shard.yml feat: wayland backend layer surfaces 2026-04-03 17:48:12 +02:00

VSKI OS Launcher

WPE WebKit-based kiosk launcher for Wayland compositors.

Features

  • WPE WebKit rendering via libcogcore
  • wlr-layer-shell support for docks/panels
  • Sandboxed URL loading (CSP enforcement)
  • Configurable window layers (background, bottom, top, overlay)

Build

docker build -t vski-wpe -f /home/anton/vski_os/Dockerfile /home/anton/vski_os
docker run --rm -v $(pwd):/workspace/launcher -w /workspace/launcher vski-wpe crystal build src/launcher.cr

Usage

launcher [options]

Options:
  -c, --config PATH    Configuration file path
  -u, --url URL        URL to load
  -f, --fullscreen     Enable fullscreen mode
  -d, --debug          Enable debug logging
  -h, --help           Show help
  -v, --version        Show version

Configuration

INI-style config at /etc/launcher/launcher.conf:

[launcher]
url = https://example.com
fullscreen = true
width = 1920
height = 1080
layer = background
debug = false

Layer Options

Layer Description
background Below all windows
bottom Above background
top Above normal windows
overlay Topmost layer