Fuelcard 🔥

The Most Advanced Discord Music Card Generator

By Ramkrishna & ZayDocs

🚀 Features

• 🎨 4 Premium Themes - Fuelex, Classic, Neon, Flame
• 🦊 Unique Mascot - Cyber-fox branding with golden flames
• ⚡ High Performance - Native canvas bindings (@napi-rs/canvas)
• 🎵 Universal Compatibility - Works with DisTube, Riffy, Shoukaku, Erela.js
• 📦 Simple API - Async functions with clean options

📦 Installation

npm install fuelcard

🎨 Themes

| Theme | Description | |-------|-------------| | Fuelex | Main theme with large mascot on the right | | Classic | Dark background with orange accents | | Neon | Glowing cyan/magenta cyberpunk effects | | Flame | Fire gradient with corner mascot |

💻 Quick Start

import { Fuelex, Classic, Neon, Flame } from 'fuelcard';

// Generate a Fuelex card (recommended)
const card = await Fuelex({
    thumbnail: 'https://...album-art.jpg',
    trackName: 'Blinding Lights',
    artistName: 'The Weeknd',
    progress: 52,
    startTime: '1:45',
    endTime: '3:22'
});

// Use with Discord.js
import { AttachmentBuilder } from 'discord.js';
const attachment = new AttachmentBuilder(card, { name: 'now-playing.png' });
await channel.send({ files: [attachment] });

🎵 Integration Examples

DisTube

client.distube.on('playSong', async (queue, song) => {
    const card = await Fuelex({
        thumbnail: song.thumbnail,
        trackName: song.name,
        artistName: song.uploader?.name || 'Unknown',
        progress: 0,
        startTime: '0:00',
        endTime: song.formattedDuration
    });
    
    queue.textChannel.send({
        files: [new AttachmentBuilder(card, { name: 'now-playing.png' })]
    });
});

Riffy / Lavalink

client.riffy.on('trackStart', async (player, track) => {
    const card = await Fuelex({
        thumbnail: track.thumbnail,
        trackName: track.title,
        artistName: track.author,
        progress: 0,
        startTime: '0:00',
        endTime: formatTime(track.length)
    });
    
    channel.send({
        files: [new AttachmentBuilder(card, { name: 'now-playing.png' })]
    });
});

⚙️ Theme Options

Fuelex Options

await Fuelex({
    thumbnail: string | Buffer,      // Album art (required)
    trackName: string,               // Song title
    artistName: string,              // Artist name
    progress: number,                // 0-100
    startTime: string,               // e.g., '1:45'
    endTime: string,                 // e.g., '3:22'
    backgroundColor: string,         // Hex color (default: '#1a1a2e')
    accentColor: string              // Hex color (default: '#ff6b00')
});

📄 License

Private & Proprietary - © 2026 Ramkrishna & ZayDocs

This package is closed-source. Unauthorized distribution is prohibited.