A Renoise tool for keyboard-centric note manipulation in pattern and phrase editors.
- Nudge: Increment/decrement note properties using keyboard shortcuts
- Note pitch, Instrument, Volume, Panning, Delay
- Effect number and amount
- Move: Relocate notes directionally (up/down/left/right)
- Single notes and selections
- Clone: Duplicate notes to adjacent positions
- Clear: Reset note properties to blank state
- Works in both Pattern Editor and Phrase Editor (Renoise 3.5+)
- Download the latest release
.xrnxfile from Releases - Locate your Renoise tools directory:
- Windows:
%APPDATA%\Renoise\V3.5.0\Scripts\Tools\ - macOS:
~/Library/Preferences/Renoise/V3.5.0/Scripts/Tools/ - Linux:
~/.renoise/V3.5.0/Scripts/Tools/
- Windows:
- Copy the
.xrnxfile to the tools directory - Restart Renoise
- Verify the tool appears in
Tools > Note Propertiesmenu
Quick Setup: See KEYBINDINGS.md for detailed setup instructions and alternatives.
Configure in Preferences > Keys > Tools > cc.asaf:
| Operation | Suggested Shortcut | Description |
|---|---|---|
| Nudge Up | Ctrl+Up (Win/Linux)Cmd+Up (macOS) |
Increment current property |
| Nudge Down | Ctrl+Down (Win/Linux)Cmd+Down (macOS) |
Decrement current property |
| Move Up | Ctrl+Shift+Up |
Move note to line above |
| Move Down | Ctrl+Shift+Down |
Move note to line below |
| Move Left | Ctrl+Shift+Left |
Move note to left column |
| Move Right | Ctrl+Shift+Right |
Move note to right column |
| Clone Up | Ctrl+Alt+Up |
Duplicate note above |
| Clone Down | Ctrl+Alt+Down |
Duplicate note below |
| Clone Left | Ctrl+Alt+Left |
Duplicate note to left |
| Clone Right | Ctrl+Alt+Right |
Duplicate note to right |
| Clear | Ctrl+Delete (Win/Linux)Cmd+Delete (macOS) |
Clear note properties |
Note: These shortcuts work in both pattern and phrase editors
- Select a note column or effect column
- Position cursor on the property you want to modify
- Press the keybinding to nudge, move, clone, or clear
The tool automatically detects which property you're editing (note, instrument, volume, etc.) and adjusts accordingly.
Edit config.lua to customize behavior:
- Wrapping at value boundaries
- Auto-advance cursor after operations
- Debug logging level
- OSC network settings
- Recommended: Renoise 3.5.0+ (for full phrase editor support)
- Minimum: Renoise 3.4.0 (limited phrase editor features)
Selection Operations (Work in Progress):
⚠️ Selection move/clone operations are not yet fully implemented- Single note operations work correctly (cursor-based)
- Selection operations only update selection bounds (don't move notes)
- See MOVING_FORWARD.md for implementation roadmap
Workaround: Use single-note operations with cursor navigation for now.
Version 2.0.4-beta - Current Status:
- ✅ Complete effect column nudging (all properties)
- ✅ Full phrase editor integration (Renoise 3.5 API)
- ✅ Single note operations working (move, clone, clear)
- ✅ Respect visible_note_columns
- ✅ Undo/redo integration with batch grouping
- ✅ Comprehensive error handling and validation
- ✅ Configurable behavior via config.lua
- ✅ Test framework with Busted
⚠️ Known Issue: Selection move/clone not yet implemented (see MOVING_FORWARD.md)
Next Release (v2.0.5-beta): Input context tracking for cursor vs selection intent
See ARCHITECTURE_OVERHAUL.md for architectural details and MOVING_FORWARD.md for roadmap.
Latest Release: v2.0-beta
- Beta Releases (
v2.x-beta): Feature-complete with comprehensive testing needed - Stable Releases (
v2.x): Production-ready, fully tested
Download the latest .xrnx file from the Releases page.
See CHANGELOG.md for detailed version history and migration guides.
The project includes an automated test suite using Busted:
# Install Busted
luarocks install busted
# Run tests
busted
# Run with coverage
busted --coverageSee tests/README.md for detailed testing documentation.
See DEVELOPMENT.md for architecture and contribution guidelines.
- Issues: GitHub Issues
- Documentation: See
docs/folder - Source: GitHub Repository