Project · Wed, 29 Jul, 2026 · 12:17 pm UTC
Bluppi - Music Syncing App
- SSaikat
It is a social media kind of app, for music listeners.
README
Loading README…
Hackers
Builders behind this 503 Day project.
S
Saikat
Project · Wed, 29 Jul, 2026 · 12:17 pm UTC
It is a social media kind of app, for music listeners.
Loading README…
Builders behind this 503 Day project.
Listen together. Vibe together.
Bluppi is a real-time synchronized music platform where users create rooms, listen to tracks together, and chat live — all synced across devices through gRPC streaming. Built with Flutter + Riverpod on the client and a distributed Go backend.
🔗 Backend: bluppi-backend — Go microservices powering UserService, TrackService, and RoomService via gRPC.
🎵 Music: Real-time synchronized playback with just_audio. Includes queue management, swipe-to-minimize floating player, and weekly discovery feeds.
👥 Social: Create/join rooms with live chat. Follow system, user profiles with genre tags, and suggested friends.
🔍 Discovery: Full-text track search (Solr-backed) with cursor-paginated infinite scroll and liked tracks library.
🔐 Auth: Firebase Google Sign-In with a comprehensive onboarding flow and profile customization.
Latest release: GitHub Releases
Download the APK directly from the Releases page. No Play Store needed.
| Minimum | |
|---|---|
| Android | API 21 (Lollipop 5.0) |
| Storage | ~50 MB |
| Network | Required (streaming app) |
| Layer | Technology |
|---|---|
| Framework | Flutter 3.10.7+ / Dart 3.x |
| State Management | Riverpod 3.2 (AsyncNotifier, .autoDispose, .family) |
| Networking | gRPC + Protocol Buffers (HTTP/2) |
| Auth | Firebase Auth + Google Sign-In |
| Audio | just_audio + audio_service (background playback) |
| Navigation | GoRouter with refreshListenable auth redirects |
| Caching | cached_network_image, shared_preferences |
| UI Polish | Lottie, Skeletonizer, fl_chart |
>= 3.10.7protoc)dart pub global activate protoc_plugin
google-services.json)git clone https://github.com/dis70rt/bluppi.git
cd bluppi
flutter pub get
Place your google-services.json in:
android/app/google-services.json
You need a Firebase project with Authentication (Google Sign-In) enabled.
Create a .env file in the project root:
GRPC_SERVER_ADDRESS=your-server.example.com
GRPC_SERVER_PORT=443
GATEWAY_SERVER_ADDRESS=your-server.example.com
GATEWAY_SERVER_PORT=443
AUDIO_SERVER_URL=https://your-server.example.com/api/rest
chmod +x protobuf.sh
./protobuf.sh
Or manually:
protoc --dart_out=grpc:lib/generated \
-Ilib/protobufs \
-I/usr/include \
lib/protobufs/*.proto \
google/protobuf/timestamp.proto
flutter run
If running the backend locally, forward gRPC ports to your Android device:
adb reverse tcp:50051 tcp:50051
adb reverse tcp:8001 tcp:8001
Bluppi requires the bluppi-backend to function. The backend exposes three gRPC services:
| Service | Responsibilities |
|---|---|
| UserService | Auth, profiles, follow system, suggested friends, search |
| TrackService | Track metadata, search (Solr), history, likes, top tracks |
| RoomService | Room CRUD, member management, live chat, playback sync |
🔗 bluppi-backend — See the backend repo for server setup, database schema, and gRPC service definitions.
| Version | Date | Highlights |
|---|---|---|
v1.0.0-alpha | 2026-04 | Core music streaming, rooms, live chat, profiles, follow system, search, floating player, edit profile, logout teardown |
For deeper dives into the project internals, see:
Contributions are welcome! Please follow the issue-first workflow:
mainThis project is licensed under the MIT License — see the LICENSE file for details.
Built with ❤️ by dis70rt
