🎵 ChrxmeeStream

A dead-simple Lavalink alternative powered by FFMPEG + yt-dlp. Even a baby could use it. 🍼

What is this?

ChrxmeeStream is a standalone audio node for Discord bots.
Your bot sends commands over WebSocket → ChrxmeeStream resolves the source, runs FFMPEG, and streams raw PCM audio back.
No bloat. No Java. No suffering.

Requirements

Before starting, make sure you have these installed on your server:

Install

npm install chrxmeestream

Start the server

# Default settings
npx chrxmeestream

# Custom settings via environment variables
CHRXMEE_PORT=2333 \
CHRXMEE_PASSWORD=mysecretpassword \
CHRXMEE_AUDIO_DIR=./audio \
npx chrxmeestream

Connecting from your Discord bot

Connect via WebSocket with these headers:

const ws = new WebSocket("ws://localhost:2333", {
  headers: {
    "Authorization": "chrxmee",   // your password
    "Guild-Id": "123456789",       // Discord guild ID
  }
});

Commands (ops)

Send JSON text frames to control playback.

▶️ Play

{ "op": "play", "source": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

{ "op": "play", "source": "WRITE(mysong.mp3)" }

{ "op": "play", "source": "https://soundcloud.com/artist/track" }

⏹️ Stop

{ "op": "stop" }

⏸️ Pause / ▶️ Resume

{ "op": "pause" }
{ "op": "resume" }

🔊 Volume (0–200)

{ "op": "volume", "value": 80 }

⏩ Seek (seconds)

{ "op": "seek", "value": 90 }

🎛️ Filter

{ "op": "filter", "filters": ["bassboost"] }
{ "op": "filter", "filters": ["nightcore", "echo"] }
{ "op": "filter", "filters": [] }

Events (what ChrxmeeStream sends back)

Receive JSON text frames for control events.
Receive binary frames for raw PCM audio chunks.

Binary frames = raw PCM audio (s16le, 48kHz, stereo) — pipe straight into @discordjs/voice.

WRITE() — Local file playback

Drop any audio file into your /audio folder and play it with:

{ "op": "play", "source": "WRITE(mysong.mp3)" }

Or shorthand (no WRITE() needed if it doesn't start with http):

{ "op": "play", "source": "mysong.mp3" }

Supported formats: .mp3 .wav .ogg .flac .m4a .opus .aac .webm

Supported streaming services

Anything yt-dlp supports — which is a lot:

• ✅ YouTube
• ✅ SoundCloud
• ✅ Twitch (live streams too)
• ✅ Bandcamp
• ✅ Deezer
• ✅ Tidal
• ✅ Vimeo
• ✅ Twitter / X
• ✅ Reddit
• ✅ Bilibili
• ⚠️ Spotify (requires yt-dlp Spotify plugin or spotDL)
• ⚠️ Apple Music (regional restrictions may apply)
• ➕ 1000+ more sites

Available filters

Apply audio effects to any track:

Stack them:

{ "op": "filter", "filters": ["bassboost", "echo"] }

Clear filters:

{ "op": "filter", "filters": [] }

Example bot snippet (discord.js + @discordjs/voice)

import { createAudioPlayer, createAudioResource, NoSubscriberBehavior } from "@discordjs/voice";
import { Readable } from "stream";
import WebSocket from "ws";

const ws = new WebSocket("ws://localhost:2333", {
  headers: { "Authorization": "chrxmee", "Guild-Id": guildId }
});

const audioStream = new PassThrough();
const resource    = createAudioResource(audioStream);
const player      = createAudioPlayer({ behaviors: { noSubscriber: NoSubscriberBehavior.Pause } });

player.play(resource);
voiceConnection.subscribe(player);

ws.on("message", (data, isBinary) => {
  if (isBinary) {
    // Raw PCM chunk — push it into the stream
    audioStream.push(data);
  } else {
    const event = JSON.parse(data.toString());
    console.log("Event:", event);
  }
});

// Play a song
ws.send(JSON.stringify({ op: "play", source: "https://youtu.be/dQw4w9WgXcQ" }));

License

MIT — do whatever you want with it.

Made with 💀 and FFMPEG suffering.