Ivy Logo

Ivy Discord Music Bot — Features & Technical Sheet

This document compiles all capabilities, command manuals, custom integrations, and developer guidelines for Ivy (formerly Audim). Share this directly with your web developer to build landing pages, control panels, or marketing websites.

General Overview

Ivy is a cozy, cat-themed, high-performance Discord Music Bot built with Discord.js (v14) and Lavalink (v4). It focuses on lossless audio quality, smooth user interactions, and robust "auto-healing" failovers to bypass common stream blocks.

Key Technical Capabilities

  • Multi-Source Streaming

    Lossless Audio Engine: Powered by Lavalink v4.
    Spotify Integration: Paste Spotify track, album, or playlist links. The bot automatically resolves metadata and streams matches from search providers.
    Apple Music Support: Full support for Apple Music track/album/playlist links.
    SoundCloud & YouTube: Fallback search engines for direct keyword queries or direct links.

  • Auto-Healing Stream Safeguard

    Bypass Blocks: If a YouTube audio stream throws a playback error (e.g. YouTube blocks or rate limits), Ivy automatically and silently intercepts the error, parses the track title, searches SoundCloud for a matching high-quality stream, and hot-swaps it into the voice queue within milliseconds to ensure uninterrupted listening.

  • Smart Auto-DJ Recommendations

    When a server queue ends, Ivy doesn't just stand by. If Auto Recommendation is enabled, it uses the genre and artist tags of the last played track to automatically queue similar cozy tracks, keeping the voice channel active 24/7.

Interactive Discord Components

  • Now Playing Panel: Renders dynamic button controls (Play/Pause, Skip, Back, Loop, Shuffle, Open Dashboard, Lyrics) directly under the active song cover banner.
  • Interactive HelpDesk: Merges prefix and slash commands into a single column category guide with navigation buttons and selection dropdowns.
  • Paginated Queue: Lists tracks in clean groups of 10 with interactive ◀️ Previous and Next ▶️ buttons to page through long queues.
  • ANSI Status Board: Employs ANSI color code formatting inside code blocks to output beautiful, aligned /ping stats and process uptime.

Commands Directory

🎵 Music Playback

  • /play [song/url] — Plays audio from Spotify, Apple Music, YouTube, or SoundCloud.
  • /playnext [song/url] — Forces a track to be added to the top of the queue.
  • /radio [station] — Instantly streams preset streams (options: Lofi Hip Hop, Synthwave, Jazz Classics).
  • /mood [profile] — Automatically queues a list of songs matching cat moods (options: Chill, Energetic, Lofi).

🎛️ Queue & Playback Controls

  • /pause — Pauses playback.
  • /resume — Resumes paused playback.
  • /skip — Skips the current track.
  • /back — Plays the previous song in history.
  • /seek [timestamp] — Jumps to a specific timestamp in a song (e.g. 1:30).
  • /volume [0-150] — Adjusts playback volume.
  • /loop [mode] — Loops the active track, the whole queue, or disables loops.
  • /shuffle — Shuffles the queue randomly.
  • /jump [position] — Skips directly to a specific track position in the queue.
  • /remove [position] — Removes a specific track from the queue.
  • /clear — Clears all upcoming tracks.

🤖 Automation & Utilities

  • /recommend — Toggles the Auto-DJ recommendations when the queue ends.
  • /twentyfourseven — Toggles whether the bot stays in the voice channel permanently.
  • /nowplaying — Re-spawns the interactive controller panel.
  • /queue — Views the paginated list of upcoming songs.
  • /history — Views recently played tracks.
  • /filters [preset] — Applies real-time equalizer filters (presets: Bass Boost, Nightcore, Vaporwave, Pop/Rock).
  • /ping — Shows color-coded WebSocket latency and bot uptime stats.
  • /help — Spawns the interactive helpdesk.