golden-queen-voice-note

🎙️ Golden Queen Voice Note

Convert any audio URL into a WhatsApp PTT (Push-To-Talk) voice note — powered by FFmpeg & Baileys.

✨ Features

• 🔄 Fetches audio from any URL and streams it directly through FFmpeg
• 🎵 Converts to Opus format (WhatsApp compatible)
• 📊 Auto-generates a waveform for the voice note UI
• 📨 Sends the audio as a PTT (voice note) via Baileys socket
• ⚡ Lightweight, async, and easy to integrate

📦 Installation

npm install golden-queen-voice-note

🚀 Usage

const { VoiceNote } = require('golden-queen-voice-note');

Basic Example

const { VoiceNote } = require('golden-queen-voice-note');

// Inside your Baileys message handler:
await VoiceNote(
  'https://example.com/audio/sample.mp3',  // 🔗 Audio URL
  message.key.remoteJid,                    // 📱 JID (chat ID)
  sock                                       // 🔌 Baileys socket instance
);

📖 Full Integration Example (with Baileys)

const { default: makeWASocket, useMultiFileAuthState } = require('@whiskeysockets/baileys');
const { VoiceNote } = require('golden-queen-voice-note');

async function startBot() {
  const { state, saveCreds } = await useMultiFileAuthState('./auth');

  const sock = makeWASocket({
    auth: state,
    printQRInTerminal: true,
  });

  sock.ev.on('creds.update', saveCreds);

  sock.ev.on('messages.upsert', async ({ messages }) => {
    const msg = messages[0];
    if (!msg.message) return;

    const jid = msg.key.remoteJid;
    const text = msg.message.conversation || '';

    // 🎙️ Send a voice note when user types !voice
    if (text === '!voice') {
      await VoiceNote(
        'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3',
        jid,
        sock
      );
    }
  });
}

startBot();

🧩 API Reference

VoiceNote(url, jid, sock)

Parameter	Type	Required	Description
url	string	✅ Yes	Public URL of the audio file to convert & send
jid	string	✅ Yes	WhatsApp JID of the target chat or user
sock	object	✅ Yes	Baileys WebSocket instance (makeWASocket(...))

Returns: Promise<void>

🛠️ How It Works

• Fetches the audio from the provided URL using undici
• Streams it through fluent converting to OGG at 24kHz mono
• Builds a basic waveform from audio chunk peaks (up to 64 points)
• Sends the processed buffer as a PTT voice note via Baileys sendMessage

⚙️ FFmpeg Output Settings

Setting	Value
Format	ogg
Codec	libopus
Channels	1 ()
Sample Rate	24000 Hz
Mimetype	audio/ogg;

❗ Requirements

Tool / Library	Version
Node.js	>= 16.x
undici	latest
@whiskeysockets/baileys	latest

🐛 Error Handling

The function handles errors internally and logs them to the console. Common errors:

• "Error: url, jid or sock missing" — One or more required arguments were not passed
• "Failed to fetch audio" — The URL is unreachable or returned a non-OK response
• "FFmpeg Error: ..." — Audio format is unsupported or stream failed

📄 License

MIT © G QUEEN OFC

_{Built with ❤️ by VIMAMODS | GOLDEN QUEEN OFC}