git404hub

what is chromatui fr?

lucky7xz/chromatui — explained in plain English

Analysis updated 2026-05-18

3RustAudience · generalComplexity · 2/5LicenseSetup · moderate

tl;dr

A Rust terminal app that turns microphone or system audio pitch into a real time scrolling color spectrogram.

vibe map

mindmap
  root((chromaTUI))
    What it does
      Terminal spectrogram
      Pitch to color mapping
      Rainbow per octave
    Tech stack
      Rust
      ratatui
      cpal audio
    Use cases
      Visualize voice pitch
      Visualize internal audio
      Compare terminal renderers
    Requirements
      Truecolor terminal
      Microphone
      Large terminal window

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Watch your voice or an instrument's pitch turn into scrolling color in real time from the terminal.

VIBE 2

Visualize your computer's internal audio output as a color spectrogram on Linux.

VIBE 3

Compare how different terminal emulators render a fast repainting full screen animation.

what's the stack?

Rustratatuicpal

how it stacks up fr

lucky7xz/chromatuiadsharma/ast-grepcodeitlikemiley/antigravity-sdk-rust
Stars333
LanguageRustRustRust
Setup difficultymoderateeasyhard
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Needs the Rust toolchain, a microphone, a large true color terminal window, and Linux ALSA headers to build.

Free to use, modify, and distribute for any purpose, including commercial use, as long as the copyright notice is kept.

in plain english

chromaTUI is a terminal application written in Rust that turns sound into color, rebuilding an existing web based tool called the Chromatone spectrogram so it runs directly in your terminal. You speak or make noise near your microphone, and the program listens to the pitch of what it hears and paints it as color, with every note called A shown in red and a full rainbow of colors repeating once per musical octave. The display fills your whole terminal window, and it needs a fairly large one, at least 140 by 35 character cells, along with a terminal that supports full true color and a working microphone. If your terminal window is smaller than that, chromaTUI shows a message saying the screen is too small instead of drawing anything. To install it you need the Rust programming toolchain. You can install it directly from the project's online repository with a single cargo command, or clone the project first and install or run it from your own copy. On Linux you also need some audio system libraries installed before it will build. The tool has mainly been tested on Linux, though the microphone capture should also work on macOS and Windows. Switching to visualize your computer's internal audio output instead of the microphone relies on a Linux specific audio tool, so that feature will not work on other operating systems. You control the display with keyboard shortcuts: arrow keys and number keys select and adjust settings like how sharply it distinguishes close notes, how smoothly the display blends between frames, how fast the colors scroll across the screen, and how loud a sound needs to be before it appears at all. A calibration key measures your room's background noise for about a second so the sensitivity matches your environment. Your chosen settings are saved automatically between runs. The project notes that it was built with heavy use of AI coding assistants, though the design decisions were made by the author. It is released under the MIT license.

prompts (copy fr)

prompt 1
Install chromaTUI with cargo and run it fullscreen in a terminal that supports true color.
prompt 2
Adjust chromaTUI's fft size and smoothing settings to make the pitch display more responsive.
prompt 3
Help me install the ALSA development libraries on Linux so chromaTUI's microphone capture builds correctly.
prompt 4
Walk me through calibrating chromaTUI's midpoint sensitivity differently for microphone input versus internal audio.

Frequently asked questions

what is chromatui fr?

A Rust terminal app that turns microphone or system audio pitch into a real time scrolling color spectrogram.

What language is chromatui written in?

Mainly Rust. The stack also includes Rust, ratatui, cpal.

What license does chromatui use?

Free to use, modify, and distribute for any purpose, including commercial use, as long as the copyright notice is kept.

How hard is chromatui to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is chromatui for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.