🎵 met

A fast, keyboard-driven terminal metronome for musicians who live in the CLI.

• Charming TUI aesthetics
• Accurate tempo with optional swing and downbeat accent
• Multiple built-in sounds and color themes
• Fully configurable via a simple config file
• Written in Go, runs everywhere

Install

go install github.com/knowareco/met@latest

Or build from source:

git clone https://github.com/knowareco/met
cd met
go build .

Usage

met [flags]

Flags

-b, --bpm int        bpm (20-300) (default 120)
-m, --time int       beats per measure (2-12) (default 4)
-w, --swing float    swing (0.0-0.45)
-a, --accent         accent downbeat
-s, --sound string   sound: click, tock, beep, thud (default "click")
-t, --theme string   theme name (default "tokyonight")
-l, --list           list themes

Controls

Space       start/stop
↑/↓ or k/j  adjust bpm ±1
K/J         adjust bpm ±5
←/→ or h/l  change time signature
s           cycle swing
a           toggle accent
n           cycle sound
t           tap tempo
q           quit

Config

Create ~/.config/met/config.toml to set defaults:

theme = "tokyonight"
bpm = 120
time_signature = 4
swing = 0.0
accent = false
sound = "click"

Themes

Built-in: catppuccin, dracula, gruvbox, nord, rosepine, tokyonight

Custom themes go in ~/.config/met/themes/.

Why

I wanted a clean, aesthetic TUI metronome I could fire up between meetings. Existing terminal options were either too barebones, overcomplicated, or abandoned. I built this to scratch my own itch, and I hope you find it useful too!