black and brown leather padded tub sofa
ADD TO SERVER

Need help with SporkMP3 or have a suggestion? Join the discord server!

SporkMP3 Server

Configurable!

Free to use!

Easy to use!

SporkMP3 Bot Guide

Introduction

SporkMP3 is a Discord music bot that allows you to play music files directly in your Discord server's voice channels. Unlike other music bots that stream from platforms like YouTube or Spotify, SporkMP3 lets you upload your own audio files.

Getting Started

  1. Invite the bot to your Discord server

  2. Upload files by mentioning the bot @SporkMP3 and attaching audio files

  3. Join a voice channel before using any commands

  4. Use commands listed below to control playback

Supported Audio Formats

  • MP3 (.mp3)

  • WAV (.wav)

  • OGG (.ogg)

  • M4A (.m4a)

  • FLAC (.flac)

  • AAC (.aac)

Basic Usage

The most common way to use the bot is:

  1. Join a voice channel

  2. Mention the bot and attach audio files: @SporkMP3 + files

  3. Use /play to start playback

  4. Control with commands like /pause, /resume, /skip, etc.

Commands

Core Commands

/play

  • Start playing the queued tracks

  • Used when you want to begin playback

  • Example: /play

/pause

  • Pause the current track without removing it from queue

  • Used when you need to temporarily stop playback

  • Example: /pause

/resume

  • Resume playback after pausing

  • Used to continue a paused track

  • Example: /resume

/stop

  • Stop playback but keep the queue intact

  • Unlike disconnect, this keeps your playlist ready for later

  • Example: /stop

/skip

  • Skip to the next track in queue

  • Used when you want to move to the next song

  • Example: /skip

/disconnect

  • Disconnect the bot and clear the queue

  • Used when you're completely finished using the bot

  • Example: /disconnect

Queue Management

/queue

  • Show all tracks currently in the queue

  • Displays track names, requesters, and queue position

  • Example: /queue

/clear

  • Remove all tracks from the queue

  • Current playing track continues playing

  • Example: /clear

/remove

  • Remove a specific track from queue by position number

  • Positions start at 1 (not 0)

  • Example: /remove 3 (removes the third track in queue)

/loop

  • Toggle loop mode for the current track

  • Without parameter: loops infinitely

  • With number: loops that many times

  • Examples:

    • /loop (infinite loop)

    • /loop 5 (repeat 5 times)

Playback Control

/playing

  • Show details about the current track

  • Displays track name, requester, duration, and progress bar

  • Example: /playing

/volume

  • Set the playback volume (0-120%)

  • 100 is the default volume

  • Values above 100 will amplify sound but may cause distortion

  • Example: /volume 80

/forward

  • Skip forward by specified number of seconds

  • Used to move ahead in the current track

  • Example: /forward 30 (skips 30 seconds ahead)

/backward

  • Skip backward by specified number of seconds

  • Used to replay a section of the current track

  • Example: /backward 15 (goes back 15 seconds)

/timestamp

  • Jump to a specific position in the current track

  • Parameters: hours, minutes, seconds

  • Example: /timestamp 0 1 30 (jumps to 1 minute and 30 seconds)

Administrative Commands

/autoplay

  • Enable or disable automatic playback of queued tracks

  • When enabled, tracks play automatically one after another

  • When disabled, you need to use /play to start each track

  • Example: /autoplay true

/autodisconnect

  • Enable or disable automatic disconnection when queue is empty

  • When enabled, bot disconnects after queue is empty

  • When disabled, bot stays in channel even when nothing is playing

  • Example: /autodisconnect true

/blacklist

  • Manage users who aren't allowed to use the bot

  • Admin only command

  • Example: /blacklist add @User

/role_config

  • Manage which roles are allowed to use the bot

  • Admin only command

  • Example: /role_config add @DJ

/help

  • Show all available commands

  • Provides a quick reference of command syntax

  • Example: /help

File Upload

Simply mention the bot and attach files to upload them to the queue:

@SporkMP3 [attach audio files]

  • You can upload multiple files at once (up to 10)

  • Files are added to the queue in the order they're uploaded

  • The bot will automatically connect to your voice channel

Automatic Features

Auto-Disconnect After Inactivity

  • Bot disconnects after 5 minutes of being alone in a voice channel

  • Helps conserve server resources

Inactive Cleanup

  • Bot cleans up unused resources after 1 hour of inactivity

  • Prevents cluttering server resources

Rate Limiting

  • Commands have a 2-second cooldown per server to prevent spam

  • Ensures fair usage across all servers

Troubleshooting

Bot doesn't respond to commands

  • Ensure the bot has proper permissions (voice chat and text permissions)

  • Check if you're blacklisted

  • Make sure you have the required roles if a whitelist is active

Music doesn't play

  • Check if you're in a voice channel

  • Verify the bot has permission to join and speak

  • Confirm the audio file format is supported

Bot disconnects unexpectedly

  • The bot automatically disconnects after 5 minutes alone in a channel

  • Check if your server has auto-disconnect enabled

  • Ensure your audio files aren't corrupted

For more help

  • Use the /help command to see a summary of all available commands

Terms of Use

  1. By using SporkMP3 Bot, you agree to these terms and conditions.

  2. Users must have the legal right to play any MP3 files they upload.

  3. The bot cannot be used to play copyrighted material without proper authorization.

  4. Server administrators have the right to manage bot access through role whitelisting and user blacklisting.

  5. We reserve the right to disable bot access for users or servers that violate these terms.

  6. The bot's functionality may be modified or interrupted at any time without notice.

  7. Users are responsible for any content they upload through the bot.

Limitations

  • Maximum file size and queue restrictions apply

  • The bot may disconnect automatically after periods of inactivity

  • Service availability is not guaranteed

  • Audio quality may vary based on server conditions

  • Maximum video conversion length of 10 minutes

  • Use the conversion feature to bypass YouTube's terms of service

  • Attempt to convert restricted or age-limited content

User Conduct

Users agree not to:

  • Upload illegal or unauthorized content

  • Attempt to abuse or exploit the bot's features

  • Use the bot to harass or disturb others

  • Interfere with the bot's normal operation

Privacy Policy

Data Collection

SporkMP3 Bot collects and stores:

  • Discord Server IDs

  • User IDs for blacklist functionality

  • Role IDs for whitelist functionality

  • Server settings preferences

  • Temporary MP3 files during playback

Data Usage

  • Server and User IDs are used solely for bot functionality

  • MP3 files (uploaded or converted) are stored temporarily and deleted after use

  • No user content is permanently stored

  • No personal information is collected beyond Discord IDs

  • No data is shared with third parties

Data Storage

  • Server settings are stored in a local database

  • Audio files are stored temporarily in a cache directory

  • All temporary files are automatically deleted after use

  • Database information is cleared when the bot leaves a server

Data Retention

  • MP3 files (uploaded or converted): Deleted immediately after use

  • Server settings: Retained until bot removal

  • Blacklist/whitelist data: Retained until manually cleared

  • Queue data: Cleared on bot restart or disconnect

Changes to Policy

We reserve the right to update these policies at any time. Continued use of the bot constitutes acceptance of any changes.

For questions or concerns about these policies, please contact the bot administrator @guntware

Last Updated: December 25, 2024

© 2024. All rights reserved.