What you need
A Linux computer
Ubuntu, Linux Mint, Zorin OS, or a similar modern desktop distribution.
A browser and Python
Firefox or a Chromium-based browser plus Python 3. Both are already present on many systems.
You also need flock from util-linux. The installer checks every requirement and explains what is missing before it continues.
Quick installation
Open a terminal, paste the complete command below, and press Enter:
curl -fsSL https://raw.githubusercontent.com/TrissyGE/cozy-kids-launcher/main/scripts/install.sh | bash
Terminal
main pinned to the latest stable published release. Unreleased development is never served through this installer path.What happens next
- Log out of the Linux session and sign in again.
- Cozy Kids Launcher opens automatically.
- Open Parent to adjust apps, websites, media, and screen time.
- Optionally set a parent PIN.
Common installation options
For a customized installation, download the repository and call the script with options:
bash scripts/install.sh --lang en --launch-mode fullscreen
Example
Language
--lang auto detects the language. --lang de and --lang en select one explicitly.
Window mode
window is the most universal. fullscreen and kiosk use the entire display.
Tile size
--layout gross shows four large tiles; --layout klein shows nine compact tiles per page.
Power off
--install-shutdown-helper optionally adds a button for a clean computer shutdown.
Updating
The installed updater downloads published releases, verifies their SHA-256 checksum, and preserves your configuration:
bash ~/.local/share/cozy-kids-launcher/update.sh
Update
If the launcher does not start
- Check that Firefox or Chromium is installed.
- Log out completely and sign back in once after installation.
- For display issues, try
windoworfullscreenmode. - Download a privacy-safe diagnostic bundle from Parent settings and attach it to a GitHub issue.