How wa1o/radio-campus works
Radio Campus lets campus listeners vote on two context-selected songs, while a public screen plays the winning music and scheduled announcements. Administrators manage the catalog, rules, events, announcements, live controls, and settings. The server’s Director coordinates station state; contextual selection, catalog tools, and persistence support it. The README documents optional YouTube playlist import and AI narration. Some page and route implementations were not excerpted, so uncertain interactions are omitted or marked unverified.
Main entry points: admin.js Admin API · schema.sql PostgreSQL · index.js HTTP and sockets · director.js Station director
Components 23
Campus interfaces
- Public screen
client/src/pages/Screen.jsx - Mobile voting
client/src/pages/Vote.jsx - Admin panel
client/src/pages/Admin.jsx - Route entry
client/src/main.jsx - Socket client
client/src/socket.jsx - Browser speech
client/src/speech.js
Station runtime
- HTTP and sockets
server/src/index.js - Station director
server/src/director.js - Public API
server/src/routes/public.js - Admin authentication
server/src/auth.js - PostgreSQL
server/src/schema.sql - Announcer text
server/src/dj.js
Catalog and context
- Context selection
server/src/context.js - Song tools
server/src/songtools.js - Playlist import
server/src/youtube.js
Administration
- Admin API
server/src/routes/admin.js - Station settings
server/src/settings.js - Backup restore
server/src/backup.js
Other components
- Listeners
- Administrator
- Open-Meteo
- YouTube Data API
- Gemini
Connections 38
- Route entry → Public screen: routes to
client/src/main.jsx - Route entry → Mobile voting: routes to
client/src/main.jsx - Route entry → Admin panel: routes to
client/src/main.jsx - Listeners → Mobile voting: vote via
README.md - Listeners → Public screen: view playback
README.md - Administrator → Admin panel: manage station
README.md - Public screen → Socket client: uses connection
client/src/pages/Screen.jsx - Mobile voting → Socket client: uses connection
client/src/pages/Vote.jsx - Admin panel → Socket client: uses connection
client/src/pages/Admin.jsx - Admin panel → Browser speech: previews voice
client/src/pages/Admin.jsx - Admin panel → HTTP and sockets: requests API
- HTTP and sockets → Public API: mounts routes
server/src/index.js - HTTP and sockets → Admin API: mounts routes
server/src/index.js - HTTP and sockets → Station director: dispatches events
server/src/index.js - HTTP and sockets → Admin authentication: seeds admin
server/src/index.js - Public API → PostgreSQL: queries
server/src/routes/public.js - Public API → Admin authentication: uses auth
server/src/routes/public.js - Admin API → PostgreSQL: queries
server/src/routes/admin.js - Admin API → Admin authentication: requires admin
server/src/routes/admin.js - Admin API → Playlist import: imports playlists
server/src/routes/admin.js - Admin API → Song tools: calls song tools
server/src/routes/admin.js - Admin API → Backup restore: handles backup
server/src/routes/admin.js - Admin API → Announcer text: previews narration
server/src/routes/admin.js - Station director → PostgreSQL: reads and writes
server/src/director.js - Station director → Station settings: loads settings
server/src/director.js - Station director → Context selection: selects candidates
server/src/director.js - Station director → Announcer text: requests narration
server/src/director.js - Context selection → PostgreSQL: reads catalog
server/src/context.js - Context selection → Station settings: loads settings
server/src/context.js - Context selection → Open-Meteo: fetches temperature
server/src/context.js - Song tools → PostgreSQL: stores songs
server/src/songtools.js - Song tools → Playlist import: requests metadata
server/src/songtools.js - Playlist import → PostgreSQL: imports playlist
server/src/youtube.js - Playlist import → Song tools: cleans and tags
server/src/youtube.js - Backup restore → PostgreSQL: exports and restores
server/src/backup.js - Station settings → PostgreSQL: reads and writes
server/src/settings.js - Playlist import → YouTube Data API: requests data
server/src/youtube.js - Announcer text → Gemini: optional AI
README.md