How hippomasakib1/lets-listen-together works
Tune Together is a social media-listening platform: users authenticate, create or join an invited room, then synchronize playback and collaborate through queueing, chat, reactions, voice, and screen sharing. The frontend presents these room workflows; FastAPI serves REST operations while a Socket.IO hub handles live events and WebRTC signaling, with PostgreSQL-backed room and playback state. The README documents key client capabilities and network paths; unsampled frontend wiring is represented only where documented, not inferred from component names.
Main entry points: page.tsx Room experience · rooms.py Room and search routes · hub.py Socket event hub · main.py FastAPI application
Components 27
Web Client
- Entry and invites
frontend/app/invite/[token]/page.tsx - Sign-in and registration
frontend/app/login/page.tsx - Room experience
frontend/app/room/page.tsx - Playback and queue
frontend/components/YouTubePlayer.tsx - Room chat
frontend/components/ChatPanel.tsx - Members and voice status
frontend/components/MemberList.tsx - Floating reactions
frontend/components/FloatingReactions.tsx - Screen share viewer
frontend/components/ScreenShareViewer.tsx - HTTP client
frontend/lib/api.ts - Socket client
frontend/lib/socket.ts - WebRTC mesh
frontend/lib/webrtc.ts - Authentication state
frontend/store/authStore.ts - Room state
frontend/store/roomStore.ts
REST and Identity
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/routers/auth.py - Auth validation
backend/app/schemas/auth.py - JWT verification
backend/app/auth/jwt.py - Request identity
backend/app/auth/deps.py - Room and search routes
backend/app/routers/rooms.py - Room validation
backend/app/schemas/room.py
Live Room Services
- Socket event hub
backend/app/sockets/hub.py
Persistence
- User records
backend/app/models/user.py - Room and media records
backend/app/models/room.py - Async database
backend/app/database.py
Other components
- Room participant
- PostgreSQL
- YouTube player API
Connections 36
- Room participant → Entry and invites: opens invite
- Room participant → Sign-in and registration: authenticates
- Room participant → Room experience: uses room
- Entry and invites → Sign-in and registration: preserves destination
- Sign-in and registration → HTTP client: uses HTTP
- Room experience → Playback and queue: presents playback
- Room experience → Room chat: presents chat
- Room experience → Members and voice status: shows members
- Room experience → Floating reactions: shows reactions
- Room experience → Screen share viewer: shows sharing
- Playback and queue → YouTube player API: controls playback
- Room experience → HTTP client: requests REST
- HTTP client → FastAPI application: calls REST
- Room experience → Socket client: uses live sync
- Socket client → Socket event hub: exchanges events
- Room experience → WebRTC mesh: uses peer media
- WebRTC mesh → Room participant: streams peer-to-peer
- Socket event hub → WebRTC mesh: relays signaling
- FastAPI application → Authentication routes: mounts routes
backend/app/main.py - FastAPI application → Room and search routes: mounts routes
backend/app/main.py - FastAPI application → Socket event hub: mounts ASGI hub
backend/app/main.py - FastAPI application → Async database: initializes on startup
backend/app/main.py - Authentication routes → Async database: gets sessions
backend/app/routers/auth.py - Authentication routes → User records: queries users
backend/app/routers/auth.py - Authentication routes → Auth validation: validates payloads
backend/app/routers/auth.py - Authentication routes → JWT verification: creates tokens
backend/app/routers/auth.py - Request identity → JWT verification: verifies tokens
backend/app/auth/deps.py - Room and search routes → Async database: gets sessions
backend/app/routers/rooms.py - Room and search routes → Room and media records: reads and writes
backend/app/routers/rooms.py - Room and search routes → User records: queries members
backend/app/routers/rooms.py - Room and search routes → Room validation: validates payloads
backend/app/routers/rooms.py - Room and search routes → Request identity: requires identity
backend/app/routers/rooms.py - Socket event hub → Async database: loads sessions
backend/app/sockets/hub.py - Socket event hub → Room and media records: updates room state
backend/app/sockets/hub.py - Socket event hub → JWT verification: verifies socket token
backend/app/sockets/hub.py - Async database → PostgreSQL: persists data