Songify โ An Open Source Music Player for Everyone
An ad-free, personalized music experience built with Flutter.
๐ต Open Source โข
๐จโ๐ป Community Driven โข
๐ฑ Beginner Friendly
๐ Live Website: songify-website.vercel.app
---
## ๐ฑ Open Source & Community Driven
Songify is an open-source project built by developers for music enthusiasts. Whether you are an experienced Flutter developer or making your very first open-source pull request, your contributions, ideas, and feedback are warmly welcomed!
We welcome help across all areas:
- ๐ **Bug Fixes** โ Squashing bugs and fixing edge cases
- ๐จ **UI/UX Improvements** โ Refining layouts, themes, and micro-interactions
- โจ **New Features** โ Building useful player tools and controls
- ๐ **Documentation** โ Improving guides, setup steps, and code comments
- ๐งช **Testing** โ Testing across different Android devices and screen resolutions
- โก **Performance** โ Optimizing memory usage, speed, and audio streaming
- ๐ก **Ideas & Feedback** โ Suggesting new ideas and reporting problems
> **New to open source? That's completely okay.** We love supporting first-time contributors! Look for issues tagged with [`good first issue`](https://github.com/Alisonpinto/Songify/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) and [`help wanted`](https://github.com/Alisonpinto/Songify/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) to get started with confidence.
---
## ๐ About
Songify is a music streaming application built with **Flutter**, created to explore how a modern music player can be designed and developed without the interruptions of traditional ad-supported streaming.
The project focuses on delivering a clean, simple, and personalized listening experience while providing hands-on experience with mobile development, external APIs, UI/UX design, and scalable application architecture.
### ๐ก Why I Built It
I started Songify because I wanted a music experience without constant interruptions from ads.
Instead of simply complaining about it, I decided to build my own solution and use the project as an opportunity to learn, experiment, and improve my development skills.
---
## โจ Features
- ๐ต **Ad-free music listening experience** โ Enjoy uninterrupted playback
- ๐ **Search** โ Search for songs, artists, and albums
- ๐ง **Music playback and controls** โ Seamless audio streaming and playback controls
- โค๏ธ **Personalized music experience** โ Tailored recommendations and quick access
- ๐ฑ **Built with Flutter** โ Cross-platform mobile foundation
- ๐จ **Clean and simple UI** โ Intuitive, minimalist user interface
- โก **Fast and responsive** โ Smooth navigation and quick loading
> *Features may change as the project continues to evolve.*
---
## ๐ธ Screenshots
Home Screen
|
Search Screen
|
Player Screen
|
Music Library
|
Player Interface
|
|
---
## ๐ค Contributing
Songify is open source, and contributions are welcome! ๐
Whether you want to add new capabilities, resolve a bug, refine the interface, or improve documentation, every contribution helps make Songify better for everyone.
Contributors can help with:
- ๐ **Features** โ New player functionality and tools
- ๐ **Bug Fixes** โ Squashing bugs and fixing edge cases
- ๐จ **UI/UX** โ Visual polish and responsive design
- ๐ **Documentation** โ Clearer guides and code documentation
- ๐งช **Testing** โ Device testing and test cases
- โก **Performance** โ Speed, memory, and audio streaming optimizations
- ๐ก **Ideas** โ Feature proposals and architectural suggestions
### ๐ฑ Contributing for Beginners
New to open source or Flutter? Songify is a beginner-friendly project where you can learn the open-source workflow step by step.
Check out our beginner-friendly issues on GitHub:
- [`good first issue`](https://github.com/Alisonpinto/Songify/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
- [`help wanted`](https://github.com/Alisonpinto/Songify/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
#### Quick Contribution Workflow
1. โญ **Star the repository** to support the project and follow updates
2. ๐ด **Fork the repository** to your personal GitHub account
3. ๐ฅ **Clone your fork** locally:
```bash
git clone https://github.com/YOUR-USERNAME/Songify.git
cd Songify
```
4. ๐ฟ **Create a new branch** for your work:
```bash
git checkout -b feature/your-feature-name
```
5. ๐ ๏ธ **Make your changes** cleanly and follow project structure
6. ๐งช **Test your changes**:
```bash
flutter analyze
flutter run
```
7. ๐ค **Push your branch** to your fork:
```bash
git push origin feature/your-feature-name
```
8. ๐ **Open a Pull Request** against the `main` branch with a clear description of your work
๐ **[Read the Full Contribution Guide (CONTRIBUTING.md)](CONTRIBUTING.md)**
### ๐ Looking for something to work on?
Start with our beginner-friendly issues:
๐ **[Good First Issues](https://github.com/Alisonpinto/Songify/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)**
If you're unsure where to start, feel free to open an issue or ask in the discussion.
---
## ๐ Getting Started
Follow these steps to get Songify running on your local development machine.
### Prerequisites
Before running Songify locally, make sure you have:
- [Flutter](https://flutter.dev/) (SDK) installed
- [Dart](https://dart.dev/) installed
- [Git](https://git-scm.com/) installed
- An Android device (with USB debugging enabled) or an Android emulator
### Installation
1. **Clone the repository:**
```bash
git clone https://github.com/Alisonpinto/Songify.git
cd Songify
```
2. **Install dependencies:**
```bash
flutter pub get
```
3. **Run the application:**
```bash
flutter run
```
---
## ๐ ๏ธ Tech Stack
- **[Flutter](https://flutter.dev/)** โ Mobile application development framework
- **[Dart](https://dart.dev/)** โ Core application programming language
- **JioSaavn unofficial endpoints** โ Music data and audio streaming endpoints
- **[Vercel](https://vercel.com/)** โ Project website hosting
---
## ๐ Project Status
Songify is an **independent learning and portfolio project** that is actively being maintained and improved.
- It is completely open source and community-driven.
- The project may contain experimental features, unofficial integrations, and ongoing architectural changes.
- Breaking changes may occur as development continues.
---
## ๐ฅ Contributors
Songify is built and improved by people who contribute code, ideas, design, testing, documentation, and feedback.
A heartfelt thanks to everyone who helps make Songify better!
๐ **[View Contributors](CONTRIBUTORS.md)**
---
## โ ๏ธ Disclaimer
Songify is strictly an **educational and portfolio project**. It is not intended for commercial use, monetization, or public distribution.
- Songify does not host or own any music content made available through the application.
- All music, audio streams, artwork, metadata, lyrics, and artist information remain the intellectual property of their respective copyright holders.
- The application uses unofficial endpoints for educational purposes and is **not affiliated with, endorsed by, or sponsored by JioSaavn**.
- Please respect applicable copyright laws and terms of service in your region.
---
## ๐ License
This project is intended for educational and portfolio purposes.
See the repository's [`LICENSE`](LICENSE) file for the applicable terms.
---
## ๐ฌ Contact
- **Project Owner:** Alison Pinto โ [alisonpinto955@gmail.com](mailto:alisonpinto955@gmail.com)
- **Co-Creator:** Praful Mohite โ [prafulmohite2006@gmail.com](mailto:prafulmohite2006@gmail.com)
---
**Built with โค๏ธ, Flutter, and a slightly unreasonable desire for better music apps.**