Real-Time Music Map

See the sound around you - live.

Introduction • Features • Feedback • Documentation • Build Process • Built Using • Contributors • License

Introduction

Real-Time Music Map is a live geosocial platform that visualizes what people are listening to around you. Connect your Spotify account, see nearby listeners, explore local trends, and share your own music vibe — all in real-time.

Available for both iOS and Android.

Android .apk: Download from itch.io

   

Features

🎵 Live Music Visualization

• Real-time listener map: See nearby users with their currently playing tracks.
• Hotspots: Identify areas with high musical activity (popular hangouts or public places).
• Geohash precision: Adjustable location granularity (pinpoint exact or general area).

🎧 Music Integration

• Spotify sync: Display your currently playing track automatically.
• Listening history: Recent plays with timestamps.
• Top stats: Favorite artists/albums/tracks.

📊 Local Music Analytics

• Area trends: See what's popular in specific zones (hotspots or draw custom areas).
• Heatmaps: Visualize musical activity density.
• Time filters: Compare trends by hour/day/week. ( not implemented )

⚙️ Technical Features

• Battery-optimized updates: Smart location refresh intervals.
• Cross-platform: Works on iOS and Android.
• Secure auth: Spotify OAuth2 login with minimal permissions.

🤝 Social Features ( not implemented )

• Friend system: Add users or auto-follow option.
• Block list: Manage unwanted interactions.
• Playlist sharing: Recommend tracks to others.

🔐 Privacy & Sharing ( not implemented )

• Multi-mode visibility:
  • 🌍 Public - visible to all users
  • 👥 Friends-only - share with connections
  • 👻 Ghost mode - hide location (shows only music data)
• Proximity ghosts: Animated indicators for nearby ghost-mode users.

Feedback

Feel free to send us feedback on Discord or file an issue. Feature requests are always welcome. If you wish to contribute, please take a quick look at the guidelines!

Documentation

• Database

• Spotify Auth Flow

Build Process

Install all dependencies:

cd real-time-music-map
npm run install:all

Setup environment variables

to do that you can run:

python3 configure.py

or:

change .env_sample to .env and setup your API/private keys

Run server:

cd /backend
npm run dev

Run react native app

cd /frontend
npx expo start

Run with Docker

Run backend + database

1. Configure backend/.env and database/.env files based on backend/.env_sample and database/.env.example
2. Run:

docker compose up

Run backend + database + cloudflare tunnel

1. Configure backend/.env and database/.env files based on backend/.env_sample and database/.env.example
2. Configure ./.env file based on ./.env_sample
3. Run

docker compose -f tunnel.compose.yaml up

Built Using

• React Native (Expo)
• TailwindCSS
• Node.js + Express.js
• PostgreSQL + PostGIS
• Spotify OAuth2
• Docker

Contributors

• Emilia Biros
• Filip Jarzyna
• Jakub Steć
• Aleksander Wiśniewski

License

GPL-3.0

---