How It Works
ChillStep Radio is a fully client-side web application. It automatically discovers your music library by scanning the folder structure when you click SCAN /music or on first load.
1. Music Library
Place albums in /music/album-name/. Each folder can contain MP3 files + optional cover.jpg. Tracks are auto-detected and durations fetched from metadata.
2. Atmospheric Videos
Add looping MP4 videos to /videos/ (global) or inside an album folder (album-specific). Videos are intelligently grouped by name and auto-cycle. Album videos take priority; user selection is preserved when switching albums.
3. Ambient Sounds
Add folders under /sounds/ containing an audio file (mp3/wav) + optional icon. Use the Ambient tab to layer rain, fire, etc. with master volume control. State persists across refreshes.
4. Manifest (Optional)
For faster loads or production, generate manifest.json via the download button after scanning. The app prefers it if present.
Key Features v1.0
• Full music player with shuffle, repeat, seek, volume, keyboard shortcuts (Space/←/→/S/R/?)
• Sleep Timer with smooth 8-second audio + ambient fade-out
• Pomodoro Focus Timer (customizable durations) + Live Clock (12/24h toggle)
• Favorites (heart icons everywhere) + Recently Played row (last 10)
• Album modal with track list + "Play Entire Album"
• Smart filters (All / Favorites / 3+ min) + real-time search
• Per-album or global video visuals that persist intelligently
• Todo/Reminders with quick time badges (persisted)
• Session stats, floating mini-player on scroll, ZIP album downloads
• Fully modular codebase (easy to extend or connect to backend later)