🦀 a colorful music making program for your linux terminal 🦀
Find a file
unspeaker e6bf5c1f6e
Some checks failed
/ build (push) Has been cancelled
almost compiles
the long-standing architectural issues
around how the Draw, Layout, and Content
traits from Tengri should, well, actually work -
that has subsided for now. somewhat.

going to amend this commit with fixes to
the remaining import not founds,
and then... what?
2025-09-29 09:36:04 +03:00
.forgejo/workflows ci: disable cache 2025-04-19 23:07:37 +03:00
.old unify default configs 2025-07-31 21:00:32 +03:00
app almost compiles 2025-09-29 09:36:04 +03:00
build document build directory 2025-04-20 00:46:25 +03:00
deps almost compiles 2025-09-29 09:36:04 +03:00
device almost compiles 2025-09-29 09:36:04 +03:00
engine break up into crates again 2025-09-10 01:58:32 +03:00
.dockerignore add containerized release build 2025-04-19 01:20:41 +03:00
.editorconfig break up into crates again 2025-09-10 01:58:32 +03:00
.gitignore add stub target 2025-04-20 00:42:22 +03:00
.gitmodules local dockerized build 2025-04-19 03:23:09 +03:00
architecture.svg move some docs to root 2024-12-30 21:56:52 +01:00
bacon.toml break up into crates again 2025-09-10 01:58:32 +03:00
Cargo.lock break up into crates again 2025-09-10 01:58:32 +03:00
Cargo.toml break up into crates again 2025-09-10 01:58:32 +03:00
CONTRIBUTING.md local dockerized build 2025-04-19 03:23:09 +03:00
Justfile tests pass again 2025-09-08 20:12:32 +03:00
LICENSE add license 2025-03-24 03:18:18 +02:00
README.md update screenshots in readme 2025-05-16 14:01:15 +00:00
shell.nix perf: use mold 2025-09-08 01:04:23 +03:00

tek Please don't upload to GitHub

a music making program for 24-bit unicode terminals.

written in rust with ratatui on crossterm for jack and pipewire.

tek is available as source, statically linked binaries, and on the aur.

author is reachable via mastodon @unspeaker@mastodon.social or matrix @unspeaker:matrix.org

Screenshot of Arranger Mode Screenshot of Groovebox Mode
Screenshot of Help in Groovebox Mode

usage

  • requirements: linux; jack or pipewire; 24-bit terminal (i use kitty)
  • recommended: midi controller; samples in wav format; lv2 plugins.

keymaps

  • Arranger:
    • arrows: navigate
    • tab: enter editor
    • q: enqueue clip
    • space: play/pause
  • Editor:
    • arrows: navigate
    • , / .: change note length
    • enter: write note
    • - / =: zoom midi editor
    • z: zoom lock/unlock
    • del: delete
  • Global:
    • esc: options menu
    • f1: help/command list
    • f2: rename
    • f6: save
    • f9: load

installation

binary download

you can download tek 0.2.0 "almost static" from codeberg releases. this standalone binary release, should work on any glibc-based system.

from distro repositories

Packaging status

arch linux

tek 0.2.0-rc7 is available as a package in the AUR. you can install it using your preferred AUR helper (e.g. paru):

paru -S tek

building from source

requires docker.

git clone --recursive -b 0.2 https://codeberg.org/unspeaker/tek
cd tek                             # enter directory
cat bin/release-glibc.sh           # preview build script
sudo bin/release-glibc.sh          # run build script
sudo cp bin/tek /usr/local/bin/tek # install

design goals

  • inspired by trackers and hardware sequencers, but with the critical feature that 90s samplers lack: able to resample, i.e. record while playing!

  • pop-up scratchpad for musical ideas. low resource consumption, can stay open in background. but flexible enough to allow expanding on compositions

  • human- and machine- readable project format simple representation for project data enable scripting and remapping.