Documentation
Everything you need to make music with muuic.
Getting Started
muuic is a browser-based music production tool. No installation needed — just open it and start creating. It works entirely in your browser using the Web Audio API.
- Click anywhere on the page to initialize audio (browsers require a user gesture).
- Make sure the Pencil tool is selected (it is by default).
- Click on the grid to place notes. The vertical axis is pitch (higher = higher pitch), the horizontal axis is time.
- Press Space to play back what you've created.
Piano Roll
The piano roll is the main editing area where you create and arrange notes.
Tools
| Tool | Shortcut | Usage |
|---|---|---|
| Pencil | 1 | Click to place notes, drag right edge to resize, drag body to move |
| Select | 4 | Click notes to select, Shift+click for multi-select, drag empty area for box select |
| Eraser | 8 | Click notes to delete them. Hold and drag to continuously erase everything you touch. |
Navigation
- Scroll vertically: Mouse wheel
- Scroll horizontally: Shift + mouse wheel, or drag the beat header bar (the row showing 1, 2, 3...)
- Zoom: Ctrl + mouse wheel (zooms toward cursor), or use the Zoom slider in the toolbar
- Pan: Middle-click and drag
- Right-click: Delete note under cursor. Hold and drag to erase everything you sweep over.
Snap Grid
Notes snap to a grid for rhythmic precision. Change the snap resolution from the Snap dropdown in the toolbar:
- 1/4 — Quarter notes
- 1/8 — Eighth notes
- 1/16 — Sixteenth notes (default)
- 1/32 — Thirty-second notes
Click the Snap toggle button to disable snap entirely for free-form placement. Hold Alt while dragging to temporarily bypass snap without toggling the button.
Keyboard Shortcuts
| Key | Action |
|---|---|
| Space | Play / Pause |
| R | Toggle recording |
| 1 | Pencil tool |
| 4 | Select tool |
| 8 | Eraser tool |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |
| Ctrl+S | Save project |
| Ctrl+A | Select all notes |
| Delete | Delete selected notes |
| Ctrl+C | Copy selected notes |
| Ctrl+V | Paste notes at playhead position |
| Ctrl+D | Duplicate selected notes |
| L | Set loop region to selected notes |
| Ctrl+K | Open command bar |
| ? | Show keyboard shortcuts panel |
| Alt + drag | Temporarily bypass snap-to-grid |
| Shift + click header | Set loop start point |
QWERTY Piano
Your computer keyboard doubles as a piano keyboard. The layout follows FL Studio's pattern with two rows:
Lower Row (C3–B3)
| Key | Note | Key | Note |
|---|---|---|---|
| Z | C3 | S | C#3 |
| X | D3 | D | D#3 |
| C | E3 | ||
| V | F3 | G | F#3 |
| B | G3 | H | G#3 |
| N | A3 | J | A#3 |
| M | B3 |
Upper Row (C4–C6)
| Key | Note | Key | Note |
|---|---|---|---|
| Q | C4 | 2 | C#4 |
| W | D4 | 3 | D#4 |
| E | E4 | ||
| R | F4 | 5 | F#4 |
| T | G4 | 6 | G#4 |
| Y | A4 | 7 | A#4 |
| U | B4 | ||
| I | C5 | 9 | C#5 |
| O | D5 | 0 | D#5 |
| P | E5 |
MIDI Controller
muuic supports MIDI controllers via the Web MIDI API. Simply plug in your MIDI keyboard and muuic will auto-detect it.
- The toolbar shows MIDI: Connected when a device is detected.
- Note velocity from your controller is preserved.
- All 128 MIDI notes are supported (C-1 to G9).
- Works with USB MIDI keyboards, pads, and controllers.
Recording
Record notes in real-time from your keyboard or MIDI controller directly into the piano roll.
- Click the Rec button (turns red when active).
- Playback starts automatically. Play notes on your keyboard or MIDI controller.
- Notes are captured and placed on the piano roll at the current playhead position.
- Click Rec again to stop recording (playback continues).
- Click Stop to stop everything.
Metronome
Enable the Click toggle next to the Rec button for a metronome during recording. It plays a higher-pitched click on downbeats and a softer click on other beats.
Quantization
Recorded notes are automatically quantized to the current snap grid setting. Use a finer snap (1/32) for more precise recording, or a coarser snap (1/4) for tighter timing.
Instruments
Each project can have multiple instruments. Each note belongs to one instrument, shown by its color in the piano roll.
| Type | Description |
|---|---|
| Grand Piano | Acoustic grand piano with sampled sounds. Warm, rich tone for melodies, chords, and classical passages. |
| Saw Lead | Bright, buzzy sawtooth synthesizer. Good for leads, basslines, and aggressive melodies. |
| Square Lead | Hollow, retro square wave. Good for chiptune, 8-bit melodies, and punchy bass. |
| Sine Pad | Pure, smooth sine tone. Good for pads, sub-bass, and gentle ambient textures. |
| Triangle | Soft, mellow triangle wave. Good for flute-like melodies and gentle leads. |
| FM Synth | FM synthesis — electric piano and bell-like tones. Great for Rhodes-style keys and metallic sounds. |
| Pluck | Karplus-Strong plucked string. Guitar and harp-like tones with natural decay. |
| Organ | Additive Hammond-style organ with drawbar harmonics. Classic for chords, jazz, and gospel. |
| Sub Bass | Deep, warm 808-style sub-bass with subtle saturation. Foundation for hip-hop, trap, and electronic music. |
| Noise/Drums | Filtered noise for percussive hits — hi-hats, snares, and rhythmic textures. |
| Custom Sample | Upload your own audio sample. Pitch-shifted across the keyboard. |
| Audio Track | Recorded or uploaded audio clip (vocals, guitar, etc). No pitch shifting. |
Add instruments via the + button next to the instrument selector, or from the Instrument Browser panel (Instr button).
Audio Tracks
Audio tracks let you add recordings and audio files to your project — vocals, guitar, field recordings, or any audio.
Record from Microphone
- Click the Mic button in the toolbar.
- Grant microphone permission when prompted.
- Recording starts — speak, sing, or play into your mic.
- Click Mic again to stop.
- The recording is uploaded and placed as an audio track in your project.
Upload Audio File
- Click + to add an instrument and select Audio Track.
- Click Upload Audio File and pick a file.
- Supported formats: WAV, MP3, OGG, WebM, MP4, M4A, AAC.
- Maximum file size: 20 MB.
Storage Limits
| Plan | Audio Storage |
|---|---|
| Free | No audio (upgrade required) |
| Hobby | 50 MB |
| Pro | 5 GB |
Mixer
Open the mixer with the Mixer button in the toolbar. Each instrument has its own channel strip:
- Volume — Adjusts the instrument's loudness (0–150%). Values above 100% can boost quieter instruments.
- Pan — Moves the sound left or right in the stereo field.
- Mute (M) — Silences the instrument without removing it.
- Solo (S) — Solos the instrument, muting everything else. Multiple instruments can be soloed.
Effects
Open the effects panel with the FX button. Effects are applied to the master output.
Reverb
- Wet — Amount of reverb mixed in (0–100%).
- Decay — How long the reverb tail lasts (0.5–5 seconds).
Delay
- Wet — Amount of delay mixed in.
- Time — Delay time in milliseconds.
- Feedback — How many times the echo repeats (0–90%).
Chorus
- Rate — Speed of the LFO modulation (0.1–5 Hz).
- Depth — Intensity of the modulation (1–20 ms).
- Mix — Wet/dry balance.
Distortion
- Drive — Amount of saturation/overdrive (0–100).
- Mix — Wet/dry balance.
Filter
- Type — Lowpass, highpass, or bandpass.
- Frequency — Cutoff frequency (50–15000 Hz).
- Q — Resonance/sharpness (0.1–20).
Compressor
- Threshold — Level where compression starts (-60 to 0 dB).
- Ratio — Compression ratio (1:1 to 20:1).
- Attack — How fast compression engages (1–200 ms).
- Release — How fast compression releases (10–1000 ms).
EQ (3-band)
- Low — Boost/cut below 320 Hz (-12 to +12 dB).
- Mid — Boost/cut around 1 kHz (-12 to +12 dB).
- High — Boost/cut above 3.2 kHz (-12 to +12 dB).
AI Custom Effects
Paid plans can use AI to generate custom audio effects from a text description. These are implemented as Web Audio API processing nodes.
Arrangement View
The arrangement view is a compact horizontal timeline above the piano roll showing an overview of your entire project.
- Colored blocks represent note regions per instrument.
- Click anywhere on the arrangement to scroll the piano roll to that position.
- A white playhead line tracks playback position.
- Bar numbers and grid lines provide time reference.
- Click the Arr button to collapse/expand the view.
Velocity Editing
The bottom 40 pixels of the piano roll canvas are a velocity editing lane. Each note is represented by a vertical bar whose height corresponds to its velocity (1–127).
- Click and drag in the velocity lane to adjust individual note velocities.
- Bars are colored by instrument for easy identification.
- Higher velocity = louder and brighter sound.
- Default velocity for new notes is 100.
Copy, Paste & Duplicate
- Ctrl+C — Copy selected notes to clipboard (relative positions preserved).
- Ctrl+V — Paste clipboard at the current playhead position.
- Ctrl+D — Duplicate selected notes (copies and pastes immediately after the selection).
AI Composer
The AI Composer generates music from text descriptions. Open it with the AI button in the toolbar.
Target Instrument
The Target dropdown at the bottom of the AI panel lets you choose which instrument the generated notes will be applied to. This is key to building multi-instrument arrangements:
- Select Grand Piano as target → ask for a melody → Apply
- Switch target to Sub Bass → ask for a bassline → Apply
- Switch target to Noise/Drums → ask for a drum pattern → Apply
Modes
- New — Generates a fresh part for the target instrument. If other notes exist, the AI composes a complementary part that fits.
- Extend — Same as New, but emphasizes extending existing material (good for "add more bars", "continue the melody").
- Edit Selection — Transform selected notes. First select notes with the Select tool, then describe how to change them (e.g. "harmonize", "change to minor key", "add swing"). The AI replaces the selected notes with the modified version.
Tips for Good Prompts
- Mention a genre: "lo-fi hip hop", "classical waltz", "trap beat"
- Specify BPM if desired: "120 BPM"
- Describe the mood: "dark and moody", "upbeat and happy"
- Mention key or scale: "in C minor", "Bb major"
- Request specific elements: "with syncopated hi-hats", "jazzy chords"
- Specify length: "4 bars", "8 bars"
- Describe the part: "a walking bassline", "arpeggiated chords", "four-on-the-floor kick"
Actions
- Preview — Play the generated notes without adding them to the project.
- Apply — Add the generated notes to the target instrument's piano roll.
- Discard — Throw away the generated result.
AI Models by Plan
Higher plans get access to more capable AI models for better compositions:
| Plan | AI Model | Requests / Day |
|---|---|---|
| Free | Haiku (fast, good basics) | 3 |
| Hobby ($14/mo) | Sonnet (richer compositions) | 15 |
| Pro ($29/mo) | Sonnet + 5 Opus/day (best quality) | 30 |
Loop Mode
Click the Loop button in the toolbar to enable loop mode (turns green when active). When enabled, playback automatically loops back to the beginning when it reaches the end of your notes.
This is useful for auditioning your composition while making changes, or for jamming over a repeating pattern.
Loop Region
- Shift+click the beat header to set loop start.
- Shift+right-click the beat header to set loop end.
- Press L to set loop region from selected notes' time range.
- The loop region is displayed as a green highlight in the beat header.
Projects
Saving
Press Ctrl+S or use File > Save. The first time you save, you'll be asked for a project name. Your project is saved to the cloud and accessible from any browser.
Loading
Use File > Open to see your saved projects. Click one to load it. If you have unsaved changes, you'll be prompted to confirm.
New Project
Use File > New to start fresh. If you have unsaved changes, you'll be asked to confirm before clearing.
Unsaved Changes
An asterisk (*) in the page title indicates unsaved changes. You'll also get a browser warning if you try to close the tab with unsaved work.
Project Limits
| Plan | Max Projects | Max Instruments |
|---|---|---|
| Free | 3 | 3 |
| Hobby | 20 | 8 |
| Pro | Unlimited | Unlimited |
Sharing & Social
Share your music with the world. Click the Share button in the toolbar to open the share dialog.
Public Projects
Toggle "Make project public" to create a shareable public link. Public projects get a dedicated page at muuic.com/project/<slug> with:
- A visual mini piano roll showing your notes
- A built-in player so anyone can listen
- Social share buttons for Twitter, Facebook, and Reddit
- A "Remix" button for others to open the project in muuic
Social Sharing
Once your project is public, share it directly to:
- Twitter / X — Posts a tweet with your project link
- Facebook — Creates a share post with Open Graph preview
- Reddit — Submits to any subreddit of your choice
- Copy Link — Copies the URL to your clipboard
File Formats
muuic supports several file formats for import and export:
| Format | Extension | Contains |
|---|---|---|
| Project file | .muuic | Full project: notes, instruments, effects, view state |
| Instrument file | .muuicinst | Single instrument with settings and sample data |
| Effects file | .muuicfx | Effect chain settings |
| WAV export | .wav | Rendered audio (44.1 kHz, 16-bit stereo) |
Access these from the File menu in the toolbar. WAV export and file exports require a Hobby or Pro plan.
Collaboration
muuic supports real-time collaboration. Click Share > Start Collab Session to create a room and share the invite link.
How It Works
- Save your project first.
- Click Share in the toolbar and then Start Collab Session.
- An invite link is copied to your clipboard. Send it to your collaborators.
- When they open the link, they join your room and can edit in real-time.
Features
- Colored cursors — Each collaborator has a named, color-coded cursor visible on the piano roll.
- Live note sync — Note additions, edits, and deletions are broadcast instantly.
- Transport sync — Play, pause, and stop are synchronized across all users.
- Join/leave notifications — Toast messages when collaborators join or leave.
- Collaborator panel — Click the Collab button (appears when connected) to see who's in the room.
Room Owner Controls
The user who creates the room is the owner. Owners can:
- Kick users — Remove collaborators via the collaborator panel.
- Close the room — End the session for everyone.
- Copy invite link — Reshare the link at any time.
Persistent Rooms
Collab rooms are saved to your account. The invite code stays valid until you close the room, so collaborators can rejoin if they disconnect.
| Plan | Collaborators |
|---|---|
| Free | None |
| Hobby | Up to 2 |
| Pro | Up to 5 |
Plans & Pricing
| Feature | Free | Hobby | Pro |
|---|---|---|---|
| Projects | 3 | 20 | Unlimited |
| Instruments | 3 | 8 | Unlimited |
| Track duration | 2 minutes | 4 minutes | Unlimited |
| AI model | Haiku | Sonnet | Sonnet + Opus |
| AI requests / day | 3 | 15 | 30 (5 Opus) |
| Audio recording | — | 50 MB | 5 GB |
| Collaboration | — | 2 users | 5 users |
| File export | — | All formats | All formats |
| AI effects | — | Yes | Yes |
View pricing and subscribe from the Pricing button in the toolbar.