drumr 1.7.4 USER MANUAL ============================================================================== A hands-on drum sequencer for macOS, designed and developed by Riley Deacon. Draw beats, play fills, shape the groove and record the result. Drumr runs as a standalone app; a DAW or other Curio instrument is not required. CONTENTS 1. Install and update 2. Your first beat 3. Find your way around 4. Draw, erase and set velocity 5. Ratchets and triplets 6. Patterns, loops and fills 7. Generate, duplicate and copy 8. Jank, Swing and half speed 9. Choose, import and remove sounds 10. Mix, Tape, metronome and tempo 11. MIDI input and note recording 12. MIDI clock input and output 13. Print a stereo audio recording 14. Save, reopen and move songs 15. Shortcut reference 16. Troubleshooting 17. About this release 1. INSTALL AND UPDATE --------------------- Requires macOS 14 or later. This is a Universal build for Apple silicon and Intel Macs. Open Drumr-1.7.4-macos.dmg. Quit Drumr, then drag drumr.app onto Applications and choose Replace if asked. Launch from Applications, then eject the disk image. This download installs the standalone macOS app. Your songs/imports/presets remain separate. 2. YOUR FIRST BEAT ------------------ 1. Choose kit 1 and main pattern 1. 2. Keep or add kick hits on steps 1, 5, 9 and 13. 3. Keep or add snares on 5 and 13, and hats on every other step. 4. Click Play or press Space. Adjust row gain, Tape, Swing or Jank. 5. Press Command-S to save the beat and its settings. 6. Click the small P near MTR when you want a stereo WAV recording. An empty step adds a hit when clicked. An occupied step erases it, so adjust any notes already present in the starting pattern. 3. FIND YOUR WAY AROUND ----------------------- There are five sound rows, each with 16 grid steps: k for kick, s for snare, h for hi-hat, r for ride and ? for percussion. Click the row letter to choose its sound. Each row has a gain knob on the right and a smaller pan knob beside it. - Kit select 1-4 chooses among four sound kits. - Pattern select 1-4 chooses main rhythm patterns. Small 5 and 6 buttons are momentary fills. The indicators below main numbers set loop repeats. - Play starts playback, Stop stops it, and Space toggles play/stop. Rec arms MIDI note recording; Q and F choose recording timing. - Gen creates a beat, Jank changes its feel, and Dup copies it to another main slot. Clear empties the pattern you are editing. - Output controls overall level. Tape adds character. MTR switches the metronome. Swing, 1/8, 1/16 and 0.5x shape timing/speed. - The small 1-4, r and t buttons below the grid latch drawing modifiers. These are separate from the kit and pattern selectors. 4. DRAW, ERASE AND SET VELOCITY ------------------------------- Draw and erase Click an empty step to add a hit; click an occupied step to erase it. Drag across the grid to paint several steps. Starting on an occupied step erases as you drag, unless a velocity modifier is active. Clear empties only the pattern you are editing. Save before a large edit. Hit strength Command-click a step to cycle its velocity through 30, 60, 100 and 127. Softer hits appear fainter; louder hits have stronger ink. Hold g while drawing for quiet ghost notes at velocity 30. Drawing keys / buttons Velocity 1 30 2 60 3 100 4 127 Hold a number while drawing, or click its small button beneath the grid to latch it. Click an active button again to release it. With several velocity choices active, new hits alternate through the selected levels in activation order. 5. RATCHETS AND TRIPLETS ------------------------ Ratchets: several hits inside one step Hold r or click the small r button beneath the grid to latch ratchet drawing. Clicking or dragging over a step cycles two, three and four hits, then a single hit. Revisit a step to change its roll. Velocity and ghost-note choices also apply. Triplet brush Hold t or latch the small t button. In each group of four grid boxes, triplet drawing uses the first, second and fourth positions. It skips and clears the third box. Drag across a beat to hear the triplet spacing. Combined drawing With r and t active together, the brush writes triplet-timed notes with a three-hit subdivision. Erasing clears the hit and its timing/subdivision. Release held keys and switch latched r, t or velocity buttons off to return to ordinary drawing. The 0.5x control changes playback speed separately. 6. PATTERNS, LOOPS AND FILLS ---------------------------- Main patterns 1-4 Click a main number to select it. During playback, a main-pattern change waits for the next loop boundary. Command-click a main number to enable or disable that pattern; disabled patterns are skipped. The dot and repeat label beneath each main number cycle L, 2, 4, 8 and 16. L stays on that pattern; the other choices repeat it that many times before advancing to another enabled main pattern. Momentary fills 5 and 6 Hold the small 5 or 6 button, or its keyboard number, to punch in that fill. Release it to return to the main pattern. Entry and exit land on step boundaries and preserve ringing sound tails. To draw or change a fill, hold its number key while editing. The grid and pattern tools address that fill while it is held. Save a state before replacing fill material. 7. GENERATE, DUPLICATE AND COPY ------------------------------- Gen Gen replaces the current pattern with a new beat. The first four ideas are classic rhythms; subsequent presses create fresh procedural variations. Gen keeps your selected sounds. Command-click Gen to replace main patterns 1-4 with four related parts; during playback, that replacement is queued. Dup Dup copies the current pattern to the next empty main slot. If all main slots are occupied, it uses the next main slot. It then selects that slot, or queues the selection during playback. Copy and paste Right-click a pattern number, including a fill, for Copy Pattern / Paste Pattern. Right-click a track letter for copy/paste of one row. Row paste copies notes and timing while retaining the destination row's sound. Gen, Command-click Gen, Clear and Paste can replace existing material. Save with Command-S first; reopen that saved state for an exact earlier version. 8. JANK, SWING AND HALF SPEED ----------------------------- Jank Click Jank to cycle the current pattern through levels 1-9, then 0. Each press chooses a random groove feel and varies timing and accents across the tracks. The snare can rush or relax; hats and ride can lead; the kit can push or pull together, alternate steps or drift through a bar. Higher levels make the variation stronger. The result is stored in the pattern and repeats consistently until changed. Jank preserves your note positions, rolls and authored triplet/free timing. At 0, it removes its added timing but retains accumulated velocity changes. Reopen a saved state if you want to restore the entire earlier beat. Swing Drag Swing upward for more lilt and downward for less. Select 1/8 or 1/16 to choose which divisions swing. Swing and Jank can be used together. Half speed Click 0.5x for half-speed sequencing; click it again for normal speed. While playing, the rate change lands on a musical quarter-note boundary. The metronome keeps the quarter-note pulse. Half speed does not change how many hits are stored in a step. 9. CHOOSE, IMPORT AND REMOVE SOUNDS ----------------------------------- Bundled sounds and kits Drumr makes four random kits at launch. Choose one with kit select 1-4. Click a row letter to choose another sound without changing its notes. Save a state to preserve the kit and sound choices you like. A checkmark identifies the active sound in each row's sound menu. Import a sound Choose Import Sound from a row's sound menu, or drag a WAV, AIF/AIFF or MP3 from Finder onto that row's letter. Dotted clay targets appear around the letters while dragging; the current target turns solid. Drumr keeps up to the first 10 seconds and loads a local copy. Keep the original audio file. What survives quitting and updates? Imported sounds remain in the local library after quitting and after replacing/updating the app. The library lives at: ~/Library/Application Support/Drumr/Samples That library does not automatically restore your current beat or selected assignments. Save a song state with Command-S and reopen it with Command-O to recall those choices. Saved JSON files do not contain imported audio. Remove an imported sound First select the imported sound in its row menu. Then choose Remove Imported Sound... and confirm the displayed name, or Cancel. Drumr's copied audio goes to macOS Trash; your original file remains untouched. The active row switches to a bundled fallback. Bundled sounds cannot be removed using this command. Saved songs referring to a removed sound show a missing-sound message and use a bundled fallback. Reimporting creates a new library entry: choose it for the row and save the song again. It does not automatically reconnect the old reference. 10. MIX, TAPE, METRONOME AND TEMPO ---------------------------------- Gain, pan and Output Drag a knob upward to increase its value and downward to decrease it. Hold Shift while dragging for finer control. Each row's larger knob sets gain; its tiny knob sets pan. Command-click a pan knob to center it. Output sets the overall level. Tape Turn Tape up for saturation and tape character; turn it down for a cleaner sound. Balance its colour against Output, comparing at a similar listening level. Tape is part of the stereo signal path and is included in printed audio. Metronome Click MTR to turn the metronome on or off. The small nearby knob controls its volume. It follows the quarter-note pulse even at half speed. An audible metronome is included in the stereo print; turn it off for a clean drum recording. Tempo Use - and + to change internal tempo in 1 BPM steps, from 60 to 200 BPM. Command-click for 10 BPM steps. When MIDI clock is in control, the readout shows EXT; set tempo in the sending device or app. 11. MIDI INPUT AND NOTE RECORDING --------------------------------- Drumr automatically listens to connected MIDI sources. A controller can play the currently loaded sounds with these MIDI note numbers: Row Sound MIDI note k Kick 48 s Snare 50 h Hi-hat 54 r Ride 63 ? Percussion 51 Other note numbers are ignored. Octave names differ between devices, so use the numbers above. Incoming velocity controls hit strength. Each mapped note triggers the loaded sound; note input works without recording armed. Record incoming notes into a pattern Rec arms MIDI note recording in quantized mode. Q snaps incoming hits to the 1/16-step grid. F preserves free timing as offsets within that grid. Click an active Q or F again to disarm recording. Run the sequencer and play the mapped MIDI notes to write into the pattern you are editing. Hold 5 or 6 to address a fill while recording. Recorded hits can then be painted, erased, changed in velocity or shaped with Jank. Save the result with Command-S. Rec/Q/F captures note triggers. It does not record a microphone or incoming audio, and incoming clock alone does not write notes. 12. MIDI CLOCK INPUT AND OUTPUT ------------------------------- Receive clock Send MIDI Clock and Start / Continue / Stop from a DAW or hardware source. Drumr follows it and displays EXT. Set tempo in the sender. If clock disappears, Drumr stops the external transport and returns to internal tempo; check the connection and restart the sender. Send clock The public app creates a virtual Mac MIDI source named Curio drumr. Select it as the clock input in a receiving app and enable that app's external sync. During playback, Drumr sends standard 24-PPQN MIDI clock, transport and song position. When following an external source, it can pass timing onward to a downstream receiver. For physical hardware, use a MIDI-routing app/interface to forward Curio drumr to a physical MIDI output. Drumr's output sends timing, not the five drum notes or audio in real time. For notes, export a MIDI file from the File menu or drag Dup into your DAW (see Pairing Features). Use a stereo WAV print for Drumr's actual sound. Choose one clock leader Avoid a feedback loop. If a DAW clocks Drumr, do not route Curio drumr back into that DAW's clock input. Ordinary outgoing clock is straight: Swing and Jank shape Drumr's own hits rather than transmitting those accents to the receiver. 13. PRINT A STEREO AUDIO RECORDING ---------------------------------- Click the small P near MTR to start stereo audio capture; click it again to finish. P is an on-screen button, not a keyboard shortcut. The capture includes Drumr's output, Tape, levels, pan, any audible metronome and silence while stopped. You can perform fills, change sounds and move knobs while printing. The WAV is written to your Desktop using this filename pattern: drumr_print_YYYYMMDD_HHmmss.wav For a clean take: turn MTR off, click P, start playback, perform the beat, stop playback, let the last sounds decay, then click P again. Bring the WAV into a DAW or editor. Printing produces a stereo mix; separate stem export is unavailable. MIDI-file export is a separate File-menu action. 14. SAVE, REOPEN AND MOVE SONGS ------------------------------- Save and reopen Command-S saves a JSON song state wherever you choose. It contains the pattern bank, loop settings, selected sounds/kit, tempo, Swing, playback rate, mixer, Tape and drawing modifier settings. Command-O opens a supported Drumr JSON state and replaces the current session. Save before opening a different song. Do not rely on quitting to save the current song. Keep dated versions before Gen, Clear, Paste or other large edits. Older supported Drumr states still open; new Jank timing metadata is optional. Song state versus audio A JSON state lets you reopen and edit the beat. A WAV print contains the sound of one performance. Save the state and print the audio when you want both. Move to another Mac A JSON state refers to local imported-sound library entries and does not embed their audio. Keep the original sound files. On another Mac, import those files, open the song, choose each missing row's replacement and save an updated state. Missing or removed imports use a bundled fallback with a message. 15. SHORTCUT REFERENCE ---------------------- Space Play / stop Command-S Save song state Command-O Open song state Command-Shift-D Export diagnostics to Desktop Hold 1 / 2 / 3 / 4 Draw velocity 30 / 60 / 100 / 127 Hold g Draw ghost notes Hold r Ratchet drawing Hold t Triplet drawing Hold 5 / 6 Punch in and edit a fill Command-click step Cycle hit velocity Command-click Gen Replace four main patterns Command-click main number Enable / disable that pattern Command-click pan Center pan Command-click tempo - / + Change tempo by 10 BPM Shift-drag knob Fine adjustment Right-click row / pattern Copy / paste notes and timing Small modifier buttons beneath the grid latch velocity, r and t choices; click them again to switch them off. Release held keys after using a modifier. The kit and main-pattern numbers are separate selectors. 16. TROUBLESHOOTING ------------------- No sound Check the Mac's audio output device, the Output knob and row gain. Confirm playback is active and the selected pattern contains lit steps. MIDI input must use the mapped note numbers in section 11. Unexpected notes, timing or tempo Check the current pattern, enabled main patterns, loop repeats and held fills. Release held drawing keys and turn off latched modifiers. Check 0.5x, Swing, Jank and EXT. If externally clocked, set tempo in the sender. Reopen a saved state to recover an earlier complete beat. Missing imported sound Choose another sound, or reimport the original file and assign it to the row. Save the updated state. Restoring a JSON song does not restore the audio files of removed or unavailable imports. Metronome or silence in a WAV P records the complete stereo output. Turn MTR off before a clean take, and begin/finish P around the performance and its final decay. Time spent stopped while P is active is recorded as silence. Clock does not follow or drops out Check that the sender is delivering MIDI Clock and transport to a source Drumr can receive. For a receiver following Drumr, choose Curio drumr and enable external sync. Use one clock leader and avoid routing its clock back into itself. Restart the sending transport after fixing the route. Reporting a problem Press Command-Shift-D to export a timestamped diagnostic JSON to your Desktop. Include the app version, what you were doing and whether you used imported sounds or external clock. Diagnostics are not a saved song state; save your song separately with Command-S. 17. ABOUT THIS RELEASE ---------------------- Version 1.7.4 includes the handmade interface and groove-cube icon, drag-to-track sound import, in-app imported-sound removal, varied Jank grooves that can rush or relax, MIDI clock output, and improved Save/Open and live import interaction. This manual describes the individual macOS release. Designed and developed by Riley Deacon. Tape effect algorithm by Chris Johnson / Airwindows. Website: https://rileydeacon.com 1.7.4 NATIVE UPDATE ------------------- This is the self-contained macOS drum machine. Edit > Undo / Redo (Command-Z / Shift-Command-Z) recovers a complete drawing stroke, Clear, Gen, Jank, Dup, Paste, repeat/enable edits and recorded notes. History is limited to 100 edits and resets when opening a song. It changes patterns and Jank/generator state only, not sounds, mixer settings or tempo. Undo does not stop, restart or rebase the clock and does not switch the viewed pattern. Copy buffers and transient fill holds remain separate. Untracked pattern changes clear older history rather than silently overwriting them. Fast drawing fills crossed cells on the same row; crossing rows or leaving the grid does not draw an unintended diagonal. Shifted notes/ratchets sit over a persistent faint base grid. Existing velocity-modifier order remains. The factory library is the original 38 sounds: 8 kicks, 8 snares, 8 hats, 6 rides and 8 percussion, unchanged from the released 1.5.3 audio files. Tape and level defaults retain the original character. Tuning, MIDI handoff and portable kits remain available. There is no new EQ/effects panel, stem export or multi-output; P prints stereo. TUNING, MIDI AND KITS This is the standalone macOS drum machine. TUNING: Open a drum's sound menu and choose Tuning, -12 to +12 semitones (one-semitone choices). Zero is the original sound. Pitch changes sample playback speed and length; it is not time stretching. Tuning is saved with the song. Earlier songs load with zero tuning. MIDI HANDOFF: File > Export Current Pattern MIDI… saves a Standard MIDI File. Drag Dup into a DAW to copy the current beat as MIDI; clicking Dup still duplicates the pattern. File > Export Pattern Chain MIDI… exports enabled main patterns 1–4 in order, with their repeat counts (L exports once). Empty enabled bars remain as rests. MIDI contains note velocities, ratchets, swing, bounded Jank timing, tempo and half-speed duration. Notes use channel 10 and 48/50/54/63/51. Early micro-offsets wrap into the preceding end of the repeating clip. MIDI does not contain audio, sample choices or effects. KITS: File > Export Drumr Kit… saves a .drumrkit for compatible Drumr versions. Stop playback before File > Import Drumr Kit…. A kit carries the five factory/custom sounds, drum levels/pans/tuning and tape drive. Custom sounds are embedded. It does not replace patterns, tempo, output or effects. Keep saved songs as well as kits when you want complete recall. Drumr remains stereo; there are no separate outputs/stems. The app and disk image are Developer ID signed and notarized by Apple. The original 38 factory sounds are included. Hold Option while dragging a row gain knob to tune ±12 semitones; Shift adds fine adjustment. A floating value appears only while tuning is dragged. Option-double-click resets tuning to zero without changing gain. Release Option to use gain. Tape DSP and signal routing retain the released 1.5.3 behavior.