LibreBash Entertainment System
An offline-first, cross-platform collection of silly party mini games to play with a group of friends. The games are quick to learn and easy to pause mid-round, and they play two ways: pass a single phone around — waiting in line, sitting in the woods, wherever — or Play Together, where one device hosts a room on the local network (or its own hotspot) and everyone else joins from their own phone, or straight from a browser — no install needed. The shared board can even live on a TV. No internet, no accounts, no tracking: every byte stays inside the room.
Get the app
Release packages (Android and Linux) are attached to each GitLab release.
On Android, the easiest way to install and stay up to date is
Obtainium, which tracks GitLab releases
directly — add the app with the repository URL
https://gitlab.com/johnkneevsource/librebash.
On Linux, each release carries .deb, .rpm, .AppImage, .pacman,
.zip, .flatpak, and .snap packages; see the
packaging guide for details.
Documentation
Three audiences, three homes:
- Player guide — how rooms work, the rules and roster sizes for every game, known issues, and browser quirks. Written for people playing games, not for people writing code.
- Developer guide — how the codebase works and how to build, test, package, and release it, with a suggested reading order. This is the source of truth for architecture and conventions.
- Architecture decision records — why specific technical choices were made. Historical and repo-only; they are not updated when implementation evolves, so read the developer guide for current behavior.
- Project plan — the original phased roadmap, kept for historical context in the repo.
Released under the GPL-3.0 license.