tek/README.md
okay stopped screaming 54f0a95f3a
Some checks failed
/ build (push) Has been cancelled
stopped my pc from falling by letting it fall
2026-03-08 23:06:54 +02:00

75 lines
3.3 KiB
Markdown

# tek [![Please don't upload to GitHub](https://nogithub.codeberg.page/badge.svg)](https://nogithub.codeberg.page)
***tek*** is a a music making program for [24-bit unicode terminals](https://sw.kovidgoyal.net/kitty/).
written in [rust](https://www.rust-lang.org/)
with [ratatui](https://ratatui.rs/) on [crossterm](https://docs.rs/crossterm/latest/crossterm/)
for [jack](https://jackaudio.org/) and [pipewire](https://www.pipewire.org/).
it plays well with your midi controller, wav samples, and lv2 plugins.
**tek** is available as [source](https://codeberg.org/unspeaker/tek#building-from-source),
[statically linked binaries](https://codeberg.org/unspeaker/tek/releases), and on the
[aur](https://codeberg.org/unspeaker/tek#arch-linux).
author is reachable via [**mastodon** `@unspeaker@mastodon.social`](https://mastodon.social/@unspeaker)
or [**matrix** `@unspeaker:matrix.org`](https://matrix.to/#/@unspeaker:matrix.org)
| | |
|-|-|
|![Screenshot of Arranger Mode](https://codeberg.org/unspeaker/tek/attachments/5014ff4d-9ece-4862-90de-3bc6573eacf6)|![Screenshot of Groovebox Mode](https://codeberg.org/unspeaker/tek/attachments/bbc12eda-1d5e-4e0f-9474-f585128255a5)<br>![Screenshot of Help in Groovebox Mode](https://codeberg.org/unspeaker/tek/attachments/d8963b84-8183-4c05-b77b-349a4c4c6161)|
## project status
codebase and author currently undergoing renormalization (with one welcoming it
while the other keeps feinting.)
getting to some of these hot tui pix above was such a pain in the upper trunk, that debugging
the last 20% of the app into existence became an effective impossibility (what with an attention
span frazzled by precarious work commitments in teleologically paradoxical pocket dimensions,
chat is this permanent.)
current focus is on removing a layer of inner cruft in `tengri` and finally making the whole
affair totally live-codable using `dizzle`.
to that end, besides the default commitments of the AGPL3, currently the **author explicitly
requests: thoughts, prayers**, mantras to be chanted, candles to be lit, etc., any treasured
personal and/or tribal superstitions to be observed extra hard, etc. and all in the name of
the upcoming version
for people who don't have any to spare, try
recalling some silly folktale, idiom, or other harmless nonsense meme from the surrounding
vernacular, and coming up with a half-convincing interpretation of its secret occult,
plain-sight esoteric, outrageously conspiratorial, ancient and justified true meaning.
that should also help.
## installation
### binary download
you can download [tek 0.2.0 "almost static"](https://codeberg.org/unspeaker/tek/releases/tag/0.2.0)
from codeberg releases. this is a standalone binary release targeting glibc-based systems.
### from distro repositories
[![Packaging status](https://repology.org/badge/vertical-allrepos/tek.svg)](https://repology.org/project/tek/versions)
#### arch linux
[tek 0.2.0-rc7](https://aur.archlinux.org/packages/tek) is available as a package in the AUR.
you can install it using your preferred AUR helper (e.g. `paru`):
```sh
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
```