Aliana-Musicard

Create stunning music cards with canvas-based customization for Discord bots and more.

Developed by Npg

✨ Features

• 🎨 8 Stunning Predefined Themes: Anime, Nature, Minecraft, and Futuristic styles
• 🖌️ Full Canvas Customization: Control every element - position, colors, fonts, images
• 🎵 Discord Bot Ready: Perfect for music bots with easy integration
• 📦 Export Options: PNG or JPEG with configurable dimensions
• 🔧 TypeScript Support: Full type safety and autocomplete
• ⚡ Fast Generation: Optimized canvas rendering for quick responses

📦 Installation

npm install aliana-musicard

🚀 Quick Start

const { Musicard } = require('aliana-musicard');

// Create a music card
const card = new Musicard({ theme: 'cherry-blossom' });

const buffer = await card.build({
  title: 'Sakura Dreams',
  artist: 'Yuki Yamamoto',
  duration: 240,
  currentTime: 108,
  platform: 'spotify'
});

// buffer is now a PNG image you can use anywhere!

🎮 Discord Bot Integration

const { AttachmentBuilder } = require('discord.js');
const { Musicard } = require('aliana-musicard');

client.on('messageCreate', async (message) => {
  if (message.content === '!nowplaying') {
    const card = new Musicard({ theme: 'cyberpunk-anime' });
    
    const buffer = await card.build({
      title: 'Neon Nights',
      artist: 'Synthwave Artist',
      duration: 180,
      currentTime: 90
    });

    const attachment = new AttachmentBuilder(buffer, { 
      name: 'musiccard.png' 
    });

    await message.reply({ files: [attachment] });
  }
});

🎨 Available Themes

• Anime: cherry-blossom, cyberpunk-anime
• Nature: forest-nature, ocean-sunset
• Minecraft: minecraft-overworld, minecraft-nether
• Futuristic: neon-grid, space

🔧 Custom Themes

Create your own themes with complete control:

const customTheme = {
  id: 'my-theme',
  name: 'My Custom Theme',
  category: 'custom',
  background: {
    type: 'gradient',
    value: { 
      colors: ['#FF0000', '#00FF00'], 
      direction: '135deg' 
    }
  },
  title: { 
    fontSize: 48, 
    color: '#FFFFFF',
    x: 80, 
    y: 140
  },
  // ... customize every element
};

const card = new Musicard({ theme: customTheme });

📖 Documentation

Visit the GitHub repository for:

• Complete API reference
• All theme configurations
• Advanced customization examples
• Discord bot setup guide
• Live demo and theme previewer

🧪 Test Discord Bot

This repository includes a test Discord bot that demonstrates all features:

Commands:

• !musicard - Generate a music card with default settings
• !themes - List all available themes
• !custom [theme] [title] [artist] - Generate a custom card

🛠️ Development

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

📄 License

MIT © Npg

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

💝 Support

If you like this project, please give it a ⭐️ on GitHub!

🔗 Links

• GitHub Repository
• npm Package
• Report Issues

Developer: Npg
Package: aliana-musicard
Version: 1.0.0