https://github.com/robrohan/floyd

Small, local command line audio player that works well with claude code (no telemetry)
https://github.com/robrohan/floyd

audio audio-player claude-skills cli music music-player skills

Last synced: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/robrohan/floyd
• Owner: robrohan
• License: other
• Created: 2024-05-12T07:35:54.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2026-03-24T07:27:55.000Z (4 months ago)
• Last Synced: 2026-03-25T06:36:03.387Z (4 months ago)
• Topics: audio, audio-player, claude-skills, cli, music, music-player, skills
• Language: C
• Homepage: https://therohans.com/floyd/
• Size: 4.39 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 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](https://therohans.com/floyd/).

## Human Usage of CLI

```

floyd 

```

![CLI](./doc/cli.png)

### 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](doc/install.png)

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](doc/binary.png)

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](doc/loop.png)

🎶🎵d(^_^)b🎵🎶

## Building

It should just be a matter of running

```bash

make build

```

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