RUB docs
Factory, User, and Imported songs — load, save, star, sort, and import.
RUB songs live as .rub JSON files. The header PRESET well is how you browse them, save your own, and keep favorites.


| Kind | Where it lives | Notes |
|---|---|---|
| Init | Built-in | Empty-ish starting point (one C3 on step 0). Always first in the list. |
| Factory | App bundle / presets/ | Shipped 303-style songs. Read-only. |
| User | ~/Library/Application Support/RUB/Presets/ (macOS) | Anything you Save. |
| Imported | …/Presets/Imported/ | Files or zips you bring in via IMPORT. |
Older User/Imported files with "format": "rdsong" still load; the library rewrites them to "format": "rub" when it scans.
The well shows the current song name. Factory and User names are the .rub stem; Init is always Init.
SAVE writes the current song into User (licensed builds only). Demo standalone can play and edit but cannot save .rub files.
On User and Imported rows, hover to reveal:
Factory and Init cannot be deleted. Stars work on every category if you want a shortlist.
At the bottom of the preset menu:
| Control | Effect |
|---|---|
| A–Z | Alphabetical within each category (Init → Factory → User → Imported) |
| STARRED | Starred rows float to the top of each category, then A–Z |
Sort choice is remembered between sessions.
IMPORT (menu footer) — or OPTS → Import Presets, in plugins and standalone alike — opens a file picker for:
.rub files.zip of .rub filesImports land in Imported. Name collisions are skipped or reported; check the status if something doesn’t appear.