🎵 Musicoff – Listen to Your Favorite Music Offline

Musicoff is a simple, beautiful app that lets you download music from YouTube and listen to it offline without ads. It’s fully open source and built to give you freedom over your music.

✨ Features

• 🎧 Listen to music offline
• ⬇️ Download music directly from YouTube
• 📈 Auto-generated Top 10 list based on your listening habits
• 🎶 Playlist management
• 🔀 Shuffle and random playback
• 🔍 Filters, sorting, and search
• ❤️ Add songs to your favorites

---

🚀 Getting Started

1. Clone the repository

git clone https://github.com/itsalb3rt/musicoff.git
cd musicoff

2. Get a Google API Key

To enable YouTube access, follow these steps to get your Google API key.

---

📱 Frontend Setup

Install dependencies

yarn install

Android

Start in development mode

yarn dev:android

Build your own version for android

yarn build:android

After building the Android studio is supposed to open, now you can push the "Play" button in Android Studio to run the app on an emulator or connected device and the app will be installed automatically.

iOS

Start in development mode

yarn dev:ios

Build your own version for iOS

yarn build:ios

After building, The Xcode is supposed to open. You can then run the app on an emulator or connected device by pressing the "Play" button in Xcode.

---

🐍 Backend (Python)

The backend handles downloading music from YouTube. You only need to run it when you're downloading songs—no need to keep a server running all the time.

cd server
python3 app.py

Enpoints:

• GET http://localhost:4000/download-audio: Download a song from YouTube
• GET http://localhost:4000/health: Check the health status of the server

---

🤝 Contributing

We welcome contributions of all kinds! Whether it's fixing a bug, improving documentation, or adding a new feature — we’d love your help.

To contribute:

1. Fork the repository
2. Create a new branch: git checkout -b feature-name
3. Make your changes
4. Submit a Pull Request 🙌

Please read our CONTRIBUTING.md (coming soon) for more details.

---

💖 Support the Project

If you like Musicoff and want to support its development, consider becoming a sponsor!

📢 Become a GitHub Sponsor to support continued development and get a shoutout in the project!

And the core project made this possible by Quasar Framework.

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

⚠️ Disclaimer

Musicoff is intended for personal, educational, and non-commercial use only. This application allows users to download music from YouTube for offline listening, but you are solely responsible for ensuring that your use complies with copyright laws in your country.

Downloading copyrighted content without permission may violate YouTube's Terms of Service and local laws.
The developers of this project do not condone or support piracy.

---

Made with ❤️ by Albert using Quasar Framework.