Getting Started¶
Get up and running with r0astr in under 5 minutes.
Choose Your Path¶
The fastest way to start. No installation needed.
- Open the app: Launch
r0astr - Click anywhere on the page to enable audio (browser requirement)
- You're ready! Continue to Your First Pattern below
For development or offline use.
Prerequisites: Node.js 18+ and npm
# Clone the repository
git clone https://github.com/piatra-automation/r0astr.git
cd r0astr
# Install dependencies
npm install
# Start development server
npm run dev
Open http://localhost:5173 in your browser.
For the full experience with remote control.
Your First Pattern¶
Let's make some noise.
Step 1: Find Panel 1¶
You'll see several panels on screen. Each panel is an independent instrument. Find Panel 1.
Step 2: Enter a Pattern¶
Click in the editor and paste this drum pattern:
What does this mean?
s("...")plays samples (sounds)bd*4= bass drum 4 times~ sd ~ sd= snare on beats 2 and 4 (~is silence)hh*8= hi-hat 8 times.gain(0.8)= volume at 80%
Step 3: Hit Play¶
Click the Play button on Panel 1. You should hear a basic drum beat!
Congratulations!
You just wrote your first live coding pattern.
Add a Second Instrument¶
Now let's layer in some bass.
Step 1: Find Panel 2¶
Leave Panel 1 playing. Find Panel 2.
Step 2: Enter a Bass Pattern¶
Paste this into Panel 2:
What does this mean?
note("...")plays synth notesc2,e2= notes (C and E, octave 2).s("sawtooth")= sawtooth wave synth.lpf(400)= low-pass filter at 400Hz.gain(0.6)= volume at 60%
Step 3: Hit Play on Panel 2¶
Click Play. The bass joins the drums — perfectly in sync!
Try More Patterns¶
Add these to Panels 3 and 4:
Panel 3: Melody¶
Panel 4: Ambient Pad¶
Now you have a full arrangement with drums, bass, melody, and ambient texture!
What You've Learned¶
- Panels are independent instruments
s()plays samples,note()plays synths- All panels share the same clock (they stay in sync)
- Play/Pause controls each panel independently
Next Steps¶
-
Concepts
Understand panels, the master panel, and synchronization.
-
Example Arrangements
Complete multi-panel tracks you can copy and paste.
-
Desktop App
Download for offline use and remote control.