GitHub - emprcl/sektron: a midi step sequencer in the terminal, made with live performance in mind :loop: 路 GitHub
/" data-turbo-transient="true" />
Skip to content
Type / to search
Sign in<br>Sign upAppearance settings
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading. Please reload this page.
emprcl
sektron
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star<br>79
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>276 Commits<br>276 Commits
.github/workflows
.github/workflows
docs
docs
filesystem
filesystem
midi
midi
sequencer
sequencer
ui
ui
.gitignore
.gitignore
.golangci.yml
.golangci.yml
LICENSE
LICENSE
Makefile
Makefile
README.md
README.md
VERSION
VERSION
go.mod
go.mod
go.sum
go.sum
main.go
main.go
sektron.tape
sektron.tape
View all files
Repository files navigation
Sektron
馃摀 User Manual
Sektron is a midi step sequencer, made with live performance in mind, that runs in the terminal (TUI).<br>Its main purpose is to mimic the fun and immediacity of hardware sequencers by being entirely controllable via keyboard.
It's heavily inspired by elektron devices.
Sektron has only been tested on linux (it should work on macOS as well) and you may experience some crashes here and there.
Feel free to open an issue.
Features
Fully (and only) controllable by keyboard
Customizable keyboard mapping
Up to 10 midi tracks , that can be attached to specific midi device and channel
Up to 128 steps per track . The number of steps per track is independent, allowing complex polyrhythms
Parameters can be set per track or step (parameter locking )
Up to 64 patterns can be loaded at the same time
Pattern chaining
See Roadmap for more.
Installation
Download the last release for your platform.
Then:
# Extract files<br>mkdir -p sektron && tar -zxvf sektron_VERSION_PLATFORM.tar.gz -C sektron
# Run sektron<br>./sektron
Build it yourself
You'll need go 1.22 minimum.<br>Although you should be able to build it for either linux , macOS or Windows , it has only been tested on linux .
# Linux<br>make GOLANG_OS=linux build
# macOS<br>make GOLANG_OS=darwin build
# Windows<br>make GOLANG_OS=windows build
# Raspberry Pi OS<br>sudo apt install libasound2-dev<br>make GOLANG_OS=linux GOLANG_ARCH=arm64 build
Usage
# Run sektron<br>./sektron
# Display current version<br>./sektron --version
Hit ? to see all keybindings. esc to quit.
Some companion apps that receive midi for testing Sektron:
Enfer (github)
QSynth
Keyboard mapping
Keys mapping is fully customizable. After running Sektron for the first time, a config.json is created.<br>You can edit all the keys inside it.
You can select one of the default keyboard layouts available:
# QWERTY<br>./sektron --keyboard qwerty
# AZERTY<br>./sektron --keyboard azerty
# QWERTY MAC<br>./sektron --keyboard qwerty-mac
# AZERTY MAC<br>./sektron --keyboard azerty-mac
Default keyboard mapping
The default key mapping looks like this:
For qwerty keyboards, here's the default mapping:
space play or stop
tab toggle parameter mode (track, record)
` toggle pattern select mode
1 2 3 4 5 6 7 8 9 0 select track
! @ # $ % ^ & * ( ) toggle track
q w e r t y u i q s d f g h j k select step or switch to pattern
Q W E R T Y U I Q S D F G H J K toggle step or chain pattern
, previous step
. next step
= add track
- remove track
+ add step to the selected track
_ remove step from the selected track
p page up either steps or patterns if more than 16 items
; page down either steps or patterns if more than 16 items
shift+up increase tempo
shift+down decrease tempo
ctrl+c copy selected step
ctrl+v paste selected step
ctrl+up add new midi control to the selected track
ctrl+down remove midi control . It will remove the selected one
enter validate selection
left move parameter selection to the left
right move parameter selection to the right
up increase selected parameter value
down decrease selected parameter value
? show help
escape or ctrl+q quit
Patterns management
Each time you start Sektron, a json file (default: patterns.json) containing 128 pattern slots is loaded.<br>For selecting a different file, use the --patterns flag:
./sektron --patterns my-patterns.json
Each time you change pattern or quit the program, the current pattern is saved to the file.
Acknowledgments
Sektron uses a few awesome packages:
gomidi/midi for all midi communication
charmbracelet/bubbletea as the main TUI framework
charmbracelet/lipgloss for making things beautiful
Roadmap
The project isn't under active development right now. I may fix some bugs here and there. But I'll considerer adding more features if there's...