A Deemo-style rhythm game for PC (Linux, Windows) built around a chart server:
- Charts: upload and download packs, browse public profiles, and compete on leaderboards.
- Stars and pp: every chart is rated from its content, and every play earns pp; the profile sums the best plays.
- Two independent cursors: one per hand, each judged separately.
The game itself: a song library and falling notes at the judge line.
Each cursor is judged separately. A graphics tablet is the usual left-hand device; the mouse drives the other. Tablet support is at an early stage: only a few models are mapped so far, and the list keeps growing — see TABLETS.md.
On Linux, if the pen is not detected, run once:
sudo scripts/install-udev.shand replug the tablet. The script grants access to the raw HID device and tells the compositor to ignore the pen, so it moves only the game cursor.
Download deemo-0.1.1-linux-x86_64.tar.gz from the
releases page, then:
tar xzf deemo-0.1.1-linux-x86_64.tar.gz
cd deemo-0.1.1
./deemoThe game keeps its state in data/ next to the binary — settings, results,
replays, imported packs. Run it from the extracted directory (the paths are
relative to the working directory).
Verify the download:
sha256sum -c SHA256SUMSscripts/build.sh # or: cd native && cargo build --release
./native/target/release/deemoRun it from the repository root so that data/ is found: the game resolves
data/fonts/, data/sprites/, data/imported/ and its own state files
relative to the working directory.
The build needs edition 2024, so Rust 1.85 or newer.
The library is built from data/library.json plus every pack installed under
data/imported/<id>/. A pack is a folder with a pack.json at its root and its
charts, audio and cover inside. There are four ways to get one in:
- Inbox folder. Drop a
.deemopack(or.zip, or an unpacked pack folder) intodata/inbox/. The folder is polled once a second; installed packs move todata/inbox/_installed/, failures todata/inbox/_failed/. - File picker. Press
F7anywhere in the game, or use Settings → Install pack from file…. This opens the native dialog (kdialog, elsezenity), which also works on Wayland where window drag & drop does not. - Download all packs. Settings → Download all packs fetches the vanilla
bundle (
/api/bundle/vanilla.zip) from the chart server athttp://199.247.22.102, unpacks it intodata/imported/, and skips packs that are already installed. Progress and a cancel (Esc) are shown in the settings row. - Manually. Unzip a
.deemopackintodata/imported/<id>/yourself and pressF5in the library to rescan.
Library (song select):
| Input | Action |
|---|---|
| typing | search by title, artist or album |
| click a song | select it, start the preview |
Enter / click PLAY |
play the selected chart |
Home / End |
jump to the first / last song |
PageUp / PageDown |
scroll one page |
| mouse wheel | scroll the list |
| drag the scrollbar | scrub the list |
F1 |
Settings |
F5 |
rescan data/imported/ |
F7 |
install a pack from a file |
F11 |
fullscreen |
Esc |
clear the search, then the selection, then quit |
Play:
| Input | Action |
|---|---|
Space |
pause / resume |
↑ / ↓ |
note speed (0.5–9.5) |
G |
toggle note guides |
F2 |
save the raw input of the run to data/replays/ |
F11 |
fullscreen |
Esc |
back to the library |
S (while paused) |
open Settings |
Result:
| Input | Action |
|---|---|
Enter / Esc |
back to the library |
F3 |
apply the recommended split offsets (mouse / tablet) and save them |
Settings:
| Input | Action |
|---|---|
↑ / ↓ / Tab |
move between rows |
← / → |
change a value |
Enter / space / click |
toggle or activate |
Esc |
close (back) |
The menu scroll speed itself is adjusted with Ctrl+[ / Ctrl+].
The code is released into the public domain — Unlicense. Do what you want with it.
That dedication covers the code, not the bundled assets. data/sprites/ is
Deemo game art, and two of the fonts in data/fonts/ are decorative faces from
the Deenote Deemo asset set, included for a fan project; Noto Sans is OFL. See
THIRD_PARTY.md and
data/fonts/README.md. If a decorative font is missing
the game simply falls back to Noto Sans and still starts.
Not affiliated with Rayark or the Deemo authors. Charts, audio and covers are not distributed with the game.


