Floyd

Play or stop audio using the floyd command line player.

Supported formats: .mp3, .wav, .flac

The PID of any running floyd process is stored in /tmp/floyd.pid.

Steps

Step 1 — Ensure floyd is installed

Check if floyd is on the PATH:

which floyd

If not found, detect the OS and download the appropriate binary from the latest release:

OS=$(uname -s)
if [ "$OS" = "Darwin" ]; then
    curl -L https://github.com/robrohan/floyd/releases/tag/v1.0.0/floyd-mac -o /usr/local/bin/floyd
else
    curl -L https://github.com/robrohan/floyd/releases/tag/v1.0.0/floyd -o /usr/local/bin/floyd
fi
chmod +x /usr/local/bin/floyd

If /usr/local/bin is not writable, try ~/.local/bin instead (create it if needed) and inform the user they may need to add it to their PATH.

---

If the user wants to stop playback (argument is "stop" or user says stop/pause):

1. Check if /tmp/floyd.pid exists. If not, tell the user nothing is playing.
2. Stop the process and clean up:

kill $(cat /tmp/floyd.pid) && rm /tmp/floyd.pid

3. Tell the user playback has stopped.

---

If the user wants to start playback (argument is a file or directory path):

1. If $ARGUMENTS is empty, ask the user which file or directory they want to play.
2. If /tmp/floyd.pid exists, stop any currently playing audio first:

kill $(cat /tmp/floyd.pid) 2>/dev/null; rm -f /tmp/floyd.pid

3. floyd only accepts a single file at a time — never pass a directory path to floyd directly.

   • If the argument is a single file, play it directly:

     (floyd -d "$ARGUMENTS") &
     echo $! > /tmp/floyd.pid
     

   • If the argument is a directory, find all supported files recursively and play them one by one in a loop:

     (find "$ARGUMENTS" -type f \( -iname "*.mp3" -o -iname "*.wav" -o -iname "*.flac" \) | sort | while read f; do floyd -d "$f"; done) &
     echo $! > /tmp/floyd.pid
     

4. Tell the user what is playing and that they can stop it with /floyd stop.