Shoʦ

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.