FluxerGroovy

A music bot for Fluxer — play your favorite songs from YouTube and more.

---

Features

• Play music from YouTube (URLs or search queries)
• Song queue with skip, pause, resume, and stop
• Streams audio through LiveKit via ffmpeg
• Ships as a standalone .exe — no Node.js install needed

Setup

Option A1: Download the latest release (standalone)

1. Grab the latest standalone release from the Releases page
2. Extract the zip — you'll get a folder with groovy.exe, ffmpeg.exe, and node_modules/
3. Edit bot.env and set your bot token:

   FLUXER_BOT_TOKEN=your_token_here
   

   See here to acquire a bot token.
4. Run groovy.exe

Option A2: Download the latest release (lightweight, requires Node)

1. Grab the latest lightweight release from the Releases page
2. Extract the zip — you'll get a folder with bot.mjs, bot.env, and node_modules/
3. Edit bot.env and set your bot token:

   FLUXER_BOT_TOKEN=your_token_here
   

   See here to acquire a bot token.
4. Run node bot.mjs in the terminal.

Option B: Build from source

1. Clone and install:

   git clone https://github.com/Bonnie39/FluxerGroovy.git
   cd FluxerGroovy
   npm install

2. Edit bot.env and set your bot token:

   FLUXER_BOT_TOKEN=your_token_here
   

3. Run directly:

   npm run dev

   Or build a standalone exe:

   node build-exe.mjs

   This produces a release/ folder with groovy.exe and everything it needs.

Commands

Command	Aliases	Description
!play <url or search>		Play a song or add it to the queue
!skip	!s	Skip the current song
!stop	!leave, !disconnect, !dc	Stop playback, clear the queue, and leave
!pause		Pause playback
!resume	!unpause	Resume playback
!queue	!q	Show the current queue
!nowplaying	!np	Show what's currently playing
!help		List all commands

Tech

• Fluxer (Discord-compatible API)
• @discordjs/core for gateway + REST
• LiveKit for voice via @livekit/rtc-node
• yt-dlp for media lookup
• ffmpeg for audio decoding