Repository files navigation

📓User Manual • 📺See it in action

Signls (pronounced signals) is a non-linear, generative midi sequencer designed for music composition and live performance. It's cross-platform (Linux, macOS et Windows) and it runs in the terminal (TUI).

It takes inspiration fromOrca andNodal.

Signls is still in development, but it is expected to be relatively stable.

Feel free toopen an issue.

Download the last release for your platform.

Then:

# Extract filesmkdir -p signls&& tar -zxvf signls_VERSION_PLATFORM.tar.gz -C signlscd signls# Run signls./signls

You'll needgo 1.23 minimum.Although you should be able to build it for eitherlinux,macOS orWindows, it has only been tested onlinux.

# Linuxsudo apt-get install libasound2-devmake GOLANG_OS=linux build# macOSmake GOLANG_OS=darwin build# Windowsmake GOLANG_OS=windows build# Raspberry Pi OSsudo apt install libasound2-devmake GOLANG_OS=linux GOLANG_ARCH=arm64 build

# Run signls./signls# Display current version./signls --version

Hit? to see all keybindings.esc to quit.

Some companion apps that receive MIDI for testing Signls:

• Webmidi synths
• Enfer (github)works only on linux
• QSynth

Keys mapping is fully customizable. After running signls for the first time, aconfig.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

For qwerty keyboards, here's the default mapping:

• spaceplay orstop
• tabshow bank
• 1 ...9add nodes
• ↑↓←→move cursor
• shift+↑↓←→multiple selection (or modify alt parameter mode in edit mode)
• ctrl+↑↓←→modify selected node direction (modify parameter or alt parameter value)
• .text edit mode for selected parameter
• backspaceremove selected nodes (or grid in bank)
• enteredit selected nodes
• mtoggle selected nodes mute
• Mmute/unmute all selected nodes
• /trigger selected node
• -=modify tempo
• ';modify root note
• ":modify scale
• ctrl+cxvcopy, cut, paste selection
• escapeexit parameter edit or bank selection
• f2edit midi configuration
• f10fit grid to window
• ?show help
• ctrl+qquit

Each time you start Signls, a json file (default:default.json) containing 32 grid slots is loaded.For selecting a different file, use the--bank flag:

./signls --bank my-grids.json

Each time you change grid or quit the program, the current grid is saved to the file.

Signls uses a few awesome packages:

• gomidi/midi for all midi communication
• charmbracelet/bubbletea as the main TUI framework
• charmbracelet/lipgloss for making things beautiful