Overview
• source code • report an issue
Signls (pronounced signals) is a non-linear, generative MIDI sequencer designed for music composition and live performances, all within the terminal. It allows you to create complex, evolving musical patterns using a grid-based approach. You can place nodes on the grid, and these nodes can emit signals, relay them, or trigger MIDI notes. There are 9 different types of nodes to explore, each with its own unique behavior.
With Signls, you can generate dynamic, generative music, meaning that the patterns evolve and change over time. It's designed to give you a powerful creative tool to build intricate sequences without being stuck in a rigid timeline or structure.
It takes inspiration from Orca and Nodal.
Features
- Non-linear sequencing: unlike traditional sequencers, Signls doesn't force you into a single direction. Your sequences can move and shift in multiple ways, allowing for complex and unique arrangements.
- Randomize everything: create evolving musical patterns that shift over time, adding depth and unpredictability to your compositions.
- Live performance: designed to be used in real-time, making it a adequate tool for live performances where improvisation is key.
- Keyboard first: Signls operates directly from your terminal, giving you control in a simple, lightweight environment, where everything is controllable via keyboard.
- Cross-platform: runs on Linux, macOS, and Windows
Installation
Signls is available for Linux, macOS and Windows.
Download the last release for your platform.
Linux & macOS
In your terminal:
# Extract files
mkdir -p signls && tar -zxvf signls_VERSION_PLATFORM.tar.gz -C signls
# Run signls
./signls
Windows
We recommend using Windows Terminal with a good monospace font like Iosevka to display Signls correctly on Windows.
Some specific Windows bugs regarding unicode characters prevent us to display some UI elements (randomization indicator or non-empty bank slot) but it should not degrade the experience that much.
Unzip the archive and, in the same directory, run:
.\signls.exe
Replace ./signls by .\signls.exe for every following commands.
Build it yourself
You can also build it yourself if your want to.
Usage
Basic commands
# Run signls
./signls
# Display current version
./signls --version
Hit ?
to see all keybindings. esc
to quit.
Keyboard mapping
Keys mapping is fully customizable. After running signls for the first time, a config.json is created. You can edit all the keys inside it.
You can select one of the default keyboard layouts available:
# QWERTY
./signls --keyboard qwerty
# AZERTY
./signls --keyboard azerty
# QWERTY MAC
./signls --keyboard qwerty-mac
# AZERTY MAC
./signls --keyboard azerty-mac
Default keybindings
For qwerty keyboards, here's the default mapping:
space
play or stoptab
show bank1
...9
add nodes↑
↓
←
→
move cursorshift
+↑
↓
←
→
multiple selection (or modify alt parameter mode in edit mode)ctrl
+↑
↓
←
→
modify selected node direction (modify parameter or alt parameter value).
modify selected parameterbackspace
remove selected nodes (or grid in bank)enter
edit selected nodesm
toggle selected nodes muteM
mute/unmute all selected nodes/
trigger selected node-
=
modify tempo'
;
modify root note"
:
modify scalectrl
+c
x
v
copy, cut, paste selectionescape
exit parameter edit or bank selectionf2
select midi devicef10
fit grid to window?
show helpctrl
+q
quit
Key binding reference
MIDI
Signls doesn't generate sound on its own, but it works seamlessly with MIDI software or hardware. You can connect it to your favorite synthesizers, virtual instruments, or any MIDI-compatible devices for live performances or production.
Press the f2
key to cycle through the available MIDI devices and set up your preferred MIDI output.
On macOS, you might need to enable the IAC driver if you're only using webmidi instruments.
Some companion apps that receive MIDI for testing Signls:
- Webmidi synths
- Enfer (github) works only on linux
- QSynth
Workflow
User Interface
- Grid: The grid is where you place nodes. Each nodes displays its type and emit/relay directions. Signals are displayed in white.
- Selection indicator: Shows the currently selected nodes.
- Mode indicator: Shows the current mode - move, edit or bank.
- Selector position: Shows the current selector position.
- Grid size: Shows the current grid size. Useful to know if the grid is bigger than the current terminal window.
- Tempo: Shows the current tempo in bpm (beats per minute).
- Play status: Shows if the grid is currently playing (▶) or stopped (■). Also shows the number of 1/16 notes since it started to play.
- Root key: Shows the current root key.
- Scale: Shows the current scale.
- Bank: Shows the currently selected grid in the bank, and the name of the bank (which is the bank filename).
- MIDI device: Shows the currently selected MIDI device.
- Control zone: Shows either grid informations and parameters (move mode), selected node parameters (edit mode) or bank grid slots (bank mode).
Grid
The grid serves as a canvas for your sequencing, where you control the flow of MIDI signals across various nodes. You can start or stop the grid's underlying sequencer by pressing space
.
By default, the size of the grid adapts to your terminal size. If you increase the terminal window, the grid will expand accordingly. However, if you decrease the terminal size, the grid remains unchanged to prevent the accidental loss of nodes outside the visible bounds. You can still scroll through the grid even if the terminal is smaller.
If you want to force the grid to resize and match the terminal (which may result in some nodes being deleted), you can press f10
to do so manually.
Nodes
Nodes can perform three main functions based on their type:
- they can emit new signals
- they can relay incoming signals to up to 4 directions
- they can trigger MIDI messages
To add nodes on the grid, move the cursor using the arrow keys and press keys 1
to 9
to choose one of the 9 available node types.
To remove nodes from the grid, move the cursor using the arrow keys and press backspace
.
You can manually trigger a node by using /
.
You can mute nodes to temporarily silence their behavior:
- Press
m
to toggle mute on the selected nodes. - Press
M
to force mute sync across all selected nodes, ensuring they are all muted or unmuted together.
This is useful for controlling which nodes are active during live performances or while experimenting with different parts of your sequence.
You can easily manage nodes on the grid by copying, cutting, and pasting them using the usual key bindings:
ctrl
+C
to copy,ctrl
+X
to cutctrl
+V
to paste.
To move nodes in bulk, you can select multiple nodes by holding shift
+ ↑
↓
←
→
to define a selection area. This makes it easy to reposition or replicate parts of your sequence.
Emit and relay directions
A key feature of each node is the direction in which it emits or relays signals. You can configure up to four directions: up, down, left, and right. To modify a node's directions, move the cursor to the desired node and press Ctrl
+ ↑
↓
←
→
to add or remove directions. The way a node uses these directions (one or multiple) depends on its specific behavior.
Parameters
Each node has adjustable parameters that you can edit to modify its behavior. To enter node editing mode, move the cursor to the node you want to modify and press enter
. The available parameters will appear in the control bar at the bottom. You can navigate between parameters using ←
→
keys. To change a parameter value, press ctrl
+↑
to increase or ctrl
+↓
to decrease it.
You can edit a parameter value precisely by pressing the .
key. This opens a text input where you can type the value manually. Press enter
to confirm the change.
Each node parameter can have up to four alternative values:
- Main 1
Ctrl
+↑
/↓
: adjusts the main value - Main 2
Ctrl
+←
/→
: adjusts a second value, often used for randomization - Alt 1
Shift
+↑
/↓
: adjusts a third alternative value - Alt 2
Shift
+←
/→
: adjusts a fourth alternative value
We will refer to these as Main 1, Main 2, Alt 1, and Alt 2 for simplicity
Each node (except "The Hole") shares five common MIDI parameters.
Parameters are displayed in two parts if an alternative value (for example randomization) is set:
- the actual value: here F5 for the key or 100 for the velocity
- the alternative value: here +8 for the key or -18 for the velocity
Key: key of the MIDI note
- Value Range: A1 - G10
- Main 1: key value for the note
- Main 2: randomization range
- Alt 1: unused
- Alt 2: note modes (random | silent)
Velocity: intensity of the MIDI note
- Value Range: 0 - 127
- Main 1: velocity value for the note
- Main 2: randomization range
- Alt 1: unused
- Alt 2: unused
Length: duration of the MIDI note.
- Value Range: 1/64 - inf
- Main 1: length value of the note
- Main 2: randomization range
- Alt 1: unused
- Alt 2: unused
Channel: MIDI channel
- Value Range: 1 - 16
- Main 1: channel value
- Main 2: randomization range
- Alt 1: unused
- Alt 2: unused
Probability: the chance of triggering the MIDI note
- Value Range: 0 - 100
- Main 1: probability value
- Main 2: unused
- Alt 1: unused
- Alt 2: unused
You can edit multiple nodes at once by selecting them together.The common parameters for all selected nodes will be displayed, and any changes you make will apply to all of them simultaneously.
Timing
Each position on the grid represents a 1/16 note. You can adjust the tempo (in beats per minute, or BPM) to control how fast signals move across the grid. To modify the tempo, simply press =
to increase the BPM or -
to decrease it, allowing you to set the pace of your sequence in real time.
Transposition
The MIDI notes assigned to each node are fixed. However, when the root key or scale of the grid is changed, these notes are transposed according to the new root key and scale. This means the original note values are shifted in relation to the grid's updated musical context, allowing you to easily adjust the overall harmony without manually changing the notes on each node. The transposition happens relative to the set root and scale, providing a flexible way to experiment with different keys and tonalities.
To modify the root key and scale, use:
'
;
to decrease and increase the root key"
:
to cycle through the available scales
Available scales include the chromatic scale, the 7 diatonic modes, a few pentatonic scales and a tetratonic scale:
- chromatic
- ionian
- dorian
- phrygian
- lydian
- mixolydian
- aeolian
- locrian
- pentatonic major
- pentatonic minor
- hirajoshi
- iwato
- tetratonic
Randomization
You can apply randomization to most node parameters. When editing randomization, you can specify positive or negative randomization values.
For example, if you set the velocity to 80+5, the random value will be picked between 80 and 85. If you set the velocity to 80-5, the random value will be picked between 75 and 80. This allows for subtle variations in your sequences, adding a layer of unpredictability while keeping control over the range of changes.
Randomized node keys will always conform to the current scale.
Bank
You manage your projects using a bank. When you start the program, you can provide a bank JSON file, or if none is provided, a default file (default.json) will be created or loaded automatically. Each bank can store up to 32 grids.
./signls --bank my-grids.json
The grids are saved automatically whenever you make changes or exit the program, so you never have to worry about losing progress.
To load a specific grid from the bank, press tab
to switch to the bank view, then use the arrow keys to select a grid slot and press enter
to load it. This allows you to quickly swap between different configurations during live performances or while working on different projects.
The ̠ character under the grid number indicates that the grid slot is not empty.
Like nodes, you can copy, cut and paste grids in the bank.
Nodes reference
Here is a reference guide for all the node types available in Signls. Each node has common note parameters (except for the Hole) like key, velocity, length, channel, and probability. Some nodes also have extra parameters that give them unique behavior.
Bang
- Description: emits a signal when the grid starts playing and relays signals on all configured directions
- Key binding:
1
- Extra Parameters: none
Euclid
- Description: emits signals based on the euclidean rhythm algorithm, ensuring an even distribution of steps across the grid. Relays signals on all configured directions
- Key binding:
2
- Extra Parameters:
- Steps: number of total steps in the pattern
- Value Range: 1 - 128
- Main 1: steps value
- Main 2: randomization range
- Alt 1: unused
- Alt 2: unused
- Triggers: number of signals to emit within the total steps
- Value Range: 1 - 128
- Main 1: triggers value
- Main 2: randomization range
- Alt 1: unused
- Alt 2: unused
- Offset: shifts the start point of the pattern
- Value Range: 0 - 128
- Main 1: offset value
- Main 2: randomization range
- Alt 1: unused
- Alt 2: unused
- Steps: number of total steps in the pattern
Pass
- Description: passes signals through without affecting their direction. No direction configuration is possible
- Key binding:
3
- Extra Parameters: none
Spread
- Description: relays signals on all configured directions, distributing them evenly
- Key binding:
4
- Extra Parameters: None
Cycle
- Description: relays signals in a clockwise direction, starting from the "up" direction, one at a time
- Key binding:
5
- Extra Parameters: none
Dice
- Description: relays signals in a randomly selected direction each time it is triggered
- Key binding:
6
- Extra Parameters: none
Toll
- Description: relays signals on all configured directions, but only after being triggered a specific number of times
- Key binding:
7
- Extra Parameters:
- Threshold: the number of times the node must be triggered before it relays a signal
- Value Range: 1 - no upper limit
- Main 1: offset value
- Main 2: randomization range
- Alt 1: unused
- Alt 2: unused
- Threshold: the number of times the node must be triggered before it relays a signal
Zone
- Description: relays signals on all configured directions and immediately propagates the trigger to all neighboring nodes, making it ideal for triggering chords
- Key binding:
8
- Extra Parameters: none
Hole
- Description: instantly teleports the signal to a specified location on the grid without triggering any notes
- Key binding:
9
- Extra Parameters:
- Destination: The coordinate of the destination
- Value Range: 1 - grid width/height
- Main 1: y-coordinate value of the destination
- Main 2: x-coordinate value of the destination
- Alt 1: randomization range for the y-coordinate
- Alt 2: randomization range for the y-coordinate
- Destination: The coordinate of the destination