🎧 Just a music bot. Made for you. By PasswordFS aka Sanchit. Built to vibe, sync, and sing.
Shots is a cinematic Discord music bot engineered for seamless playback, intelligent media search, and direct delivery. Built with discord.py, yt-dlp, and FFmpeg, it supports YouTube, SoundCloud, and Spotify, offering a modern user experience with embedded controls and private downloads.
🔑 Core Features
- Smart Search
Users simply type !play —no links required. The bot automatically searches YouTube or SoundCloud and plays the top result using yt-dlp's default_search engine.
- Voice Channel Playback
High-quality streaming directly into Discord voice channels using FFmpeg, with support for pause, resume, skip, and volume control.
- DM Downloads
Automatically sends the audio file to the requester via DM for personal use. Optional compressed video DM support available.
- Cinematic Embeds
Playback cards include thumbnails, song metadata, requester mention, and interactive control labels. Inspired by premium music interfaces like Spotify and YouTube Music.
- Bot Activity Status
Displays custom status like “Streaming YouTube 🎶” for branding and presence.
- Error Handling
Gracefully manages format issues, restricted content, and unavailable streams with fallback logic and user-friendly messages.
🎛️ Embedded Controls (Visual)
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
🛠️ Technologies Used
- discord.py — Discord bot framework
- yt-dlp — Media extraction from YouTube, SoundCloud, Spotify
- FFmpeg — Audio playback and conversion
- Python 3.11+
- Optional .bat control scripts for Windows deployment
- VPS-ready architecture with modular folder structure
📦 Deployment Ready
- requirements.txt for easy setup
- .bat launchers for start/stop/restart
- config.json for token and prefix management
- Auto-restart logic for production stability
- Compatible with Windows, Linux, and cloud VPS
🧠 Advanced Capabilities (Optional Modules)
- !trending — Fetches trending YouTube or Spotify tracks via OpenRouter GPT-OSS-120B
- !translate — Localizes song titles or lyrics
- !voice2text — Converts spoken requests into song searches
- !dashboard — Web-based control panel for remote playback and queue management
- Contributor parsing, animated embeds, floss-style branding
Would you like me to prep this as a GitHub README, complete with badges, screenshots, and install instructions? Or design a branded logo and embed theme to match your “Shots” identity? Let’s make it unforgettable.