README.md

fftviz

A lightweight, customizable FFT visualizer for audio files. Built with Rust + Bevy.

Installation

Cargo

cargo install fftviz

Homebrew

brew tap gursi26/fftviz
brew install fftviz

Keybinds

• q to close window.
• e to open config gui in player window.
• Space to pause/play.
• ↑ to increase volume.
• ↓ to decrease volume.

Usage

• Run fftviz with a path to an audio file.

fftviz "path/to/audio/file.mp3"

• Run with -h flag for configuration options

fftviz -h
A lightweight, customizable FFT visualizer for audio files

Usage: fftviz [OPTIONS] <FILE_PATH>

Arguments:
  <FILE_PATH>  File path to Audio file

Options:
      --smoothness <SMOOTHNESS>              Smoothing factor for spatial interpolation between bars
      --freq-resolution <FREQ_RESOLUTION>    Number of individual frequencies detected by the FFT
      --min-freq <MIN_FREQ>                  Maximum frequency detected by FFT
      --max-freq <MAX_FREQ>                  Minimum frequency detected by FFT
      --volume <VOLUME>                      Volume
      --width <WINDOW_WIDTH>                 Window width
      --height <WINDOW_HEIGHT>               Window height
      --border-size <BORDER_SIZE>            Border size for each bar
      --border-color <BORDER_COLOR>          Border color for each bar (in hex)
      --bar-color <BAR_COLOR>                Color for each bar (in hex)
      --track-name                           Use if you want track name to be printed
      --display-gui                          Use if you want the gui to be open when launched
      --text-color <TEXT_COLOR>              Color for currently playing text (in hex)
      --font-size <FONT_SIZE>                Font size of currently playing label
      --background-color <BACKGROUND_COLOR>
  -h, --help                                 Print help
  -V, --version                              Print version