🎵 AloneMusic

---

🚀 Introduction

AloneMusic is a Python-based music bot/service that allows users to play, pause, skip, and manage playlists with ease.
It’s designed to be lightweight, fast, and customizable.

---

✨ Features

• 🎶 Play / Pause / Skip / Stop songs
• 📂 Playlist management (add/remove/list)
• 🔗 Play via song name or URL
• ⚡ Fast and smooth performance
• ⚙️ Easy configuration with .env file
• 🐳 Docker & Heroku deployment support

---

❤️ Support

💬 Telegram: AloneMusic

🆘 Any Problem? DM: 𝚨Łꪮⲛ𝛆 🚩𝗧ε᧘‌ᴍ

📂 GitHub Issues: Report a Problem

---

📜 License

🧾 This project is licensed under the GNU GPLv3 License — see the LICENSE file for details.

---

🚀 Deployment Methods

🔹 1. Deploy on Heroku (One Click)

Click this button to deploy instantly on Heroku:

• Update System and Install Dependencies:

  sudo apt update && sudo apt upgrade -y && sudo apt install -y ffmpeg git python3-pip tmux nano

• Install uv for Efficient Dependency Management:

  pip install uv

• Clone the Repository:

  git clone https://github.com/TheAloneTeam/AloneMusic cd AloneMusic

• Create and Activate a Virtual Environment:

  • You can create and activate the virtual Environment before cloning the repo.

  uv venv .venv && source .venv/bin/activate

• Install Python Requirements:

  uv pip install -e .

• Copy and Edit Environment Variables:

  cp sample.env .env && nano .env

  After editing, press Ctrl+X, then Y, and press Enter to save the changes.

• Start a tmux Session to Keep the Bot Running:

  tmux

• Run the Bot:

  python3 -m AloneMusic

• Detach from the tmux Session (Bot keeps running):
  Press Ctrl+b, then d