gitwtfhub

wtf is fuskyom?

nesthings/fuskyom — explained in plain English

Analysis updated 2026-05-18

34RustAudience · developerComplexity · 2/5LicenseSetup · moderate

TL;DR

A terminal based music player, written in Rust, that shows album cover art using colored text blocks.

Mindmap

mindmap
  root((fuskyom))
    What it does
      Terminal music player
      Album art rendering
      Library browsing
    Tech stack
      Rust
      ratatui
      chafa
    Use cases
      Play local music
      View cover art
      Search library
    Setup
      Install Rust
      Install chafa
      Build from source
    Audience
      Terminal power users

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

Why would anyone build with this?

REASON 1

Play a local music library from the terminal with keyboard controls.

REASON 2

View album cover art rendered directly in the terminal window while a song plays.

REASON 3

Browse and search a music folder without leaving the command line.

REASON 4

Switch between color themes and a live audio wave visualizer while listening.

What's in the stack?

Rustratatuichafarodio

How it stacks up

nesthings/fuskyomelliotgao2/handsetsmoritzheiber/crowbar
Stars343535
LanguageRustRustRust
Last pushed2023-06-01
MaintenanceDormant
Setup difficultymoderateeasymoderate
Complexity2/53/52/5
Audiencedeveloperdeveloperops devops

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires installing Rust, chafa, and platform-specific audio or build libraries.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

This project is a music player that runs entirely inside a terminal window rather than a graphical app, written in the Rust programming language. It is inspired by an older terminal music player called cmus, and its main extra feature is that it can display a song's album cover art directly in the terminal, using colored text blocks to draw the image. A user points it at a folder of music files and gets a text based interface for browsing folders and audio files, playing and pausing tracks, seeking within a song, adjusting volume, and searching the library by typing. It supports common audio formats including MP3, FLAC, OGG, WAV, M4A, and AIFF. There is a settings screen for choosing default music folders, switching between five color themes, and toggling an audio wave visualizer that can look like a bar chart or a sparkline. It plays audio on its own separate background thread so that drawing the album art or updating the screen never causes the music to stutter. Internally it uses a handful of Rust libraries for reading audio files, decoding different formats, extracting embedded cover art, and rendering the interface. Installing it requires setting up the Rust programming toolchain, then either downloading a pre-built version from the project's releases page on Linux, or compiling it from source on Linux, macOS, or Windows. It also depends on a separate terminal image rendering tool called chafa being installed on the system, plus some audio and build libraries depending on the operating system. This is aimed at people comfortable working in a terminal who want a lightweight, keyboard driven way to play their own local music library, rather than a streaming service.

Yoink these prompts

Prompt 1
Walk me through installing Rust and chafa so I can run fuskyom on my system.
Prompt 2
Help me build fuskyom from source and point it at my music folder.
Prompt 3
Explain how fuskyom renders album art in the terminal using chafa.
Prompt 4
Show me how to configure default music directories and color themes in fuskyom's settings.
Prompt 5
What audio file formats does fuskyom support, and how do I add a new music folder?

Frequently asked questions

wtf is fuskyom?

A terminal based music player, written in Rust, that shows album cover art using colored text blocks.

What language is fuskyom written in?

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

What license does fuskyom use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is fuskyom to set up?

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

Who is fuskyom for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.