Skip to content

robrohan/floyd

Repository files navigation

Floyd CLI

Floyd CLI is a simple command line audio player that can play mp3, flac, and wav files on Linux and macOS (it does not currently work on Windows). It has a simple interface that can be used either on the command line, or via Claude Code using the included skill. See Claude Code section below.

If you like floyd_cli, you might like the GUI based version.

Human Usage of CLI

floyd <input.[wav|mp3|flac]>

CLI

Key Bindings

Key Function
q quit
j scrub backwards
; scrub forwards
s stop
p play
r rewind

Claude Code (LLM) Skill

To use floyd with Claude Code you can just ask it to install the skill:

will you please install the skill from here: https://raw.githubusercontent.com/robrohan/floyd/refs/heads/main/skills/floyd/SKILL.md

ask claude code to install the skill via URL

Then when you ask it to play some sounds, if you do not have the binary installed, Claude will try to download the binary and put it in your PATH:

installing the binary for your platform

If that doesn't work, just ask it for help.

And finally, it can play folders of files in the background if you just ask it to:

Play a directory of music in the background

🎶🎵d(^_^)b🎵🎶

Building

It should just be a matter of running

make build

or have a look at the Makefile to see how to build.

About

Small, local command line audio player that works well with claude code (no telemetry)

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages