Documentation
Everything you need to get the most out of LoveLofi.
Getting Started
Install LoveLofi from the Chrome Web Store or Firefox Add-ons. After installing, click the extension icon in your toolbar to open the popup player.
- Click the LoveLofi icon in your browser toolbar
- Choose a radio station from the station list
- Press play — you're listening to lo-fi radio!
- Explore presets or tweak individual effects
Radio Stations
LoveLofi includes 20+ curated radio stations streaming 24/7 lo-fi music across genres: lo-fi hip-hop, chillhop, jazz, ambient, synthwave, and chill-out.
Free tier: 3 curated stations.
Premium: Full station library + up to 10 custom stations via direct Icecast/Shoutcast URLs.
Adding Custom Stations
Premium users can add custom stations by providing a direct stream URL (Icecast or Shoutcast format). Navigate to the station list, click "Add Custom Station", and enter your stream URL and station name.
Audio Effects
LoveLofi processes audio through a chain of 12 real-time effects using the Web Audio API. Each effect has an enable toggle and an intensity slider (0-100%).
Free Effects
- Low-Pass Filter — Rolls off high frequencies for warmth. Higher intensity = more muffled.
- Reverb — Adds room ambience using a synthetic impulse response.
Premium Effects
- High-Pass Filter — Cuts low frequencies for a thinner, "through the wall" sound.
- Tape Saturation — Adds warm analog-style harmonic distortion.
- Bitcrusher — Reduces bit depth for retro digital crunch.
- Chorus — Gentle pitch modulation for shimmer and width.
- Vinyl Crackle — Adds vinyl surface noise (mixes in parallel).
- Pitch Wobble — Simulates tape wow and flutter.
- Stereo Drift — Subtle stereo field movement.
- Dropout — Random brief volume dips, like worn tape.
- Slowdown — Simulates slowing/dying tape speed.
- Vocal Cut — Attenuates center-panned vocals.
Effects Chain Order
Effects are processed in a fixed chain: Low-Pass → High-Pass → Vocal Cut → Tape Saturation → Bitcrusher → Reverb → Chorus → Pitch Wobble → Stereo Drift → Dropout → Slowdown → Output. Vinyl Crackle mixes into the output in parallel.
Presets
Presets are pre-configured effect combinations that instantly set a mood. LoveLofi includes 20+ built-in presets across categories: subtle, vinyl/analog, spacious, lo-fi radio, digital degradation, room/space, muffled, and moody.
Free tier: 4 presets — Sunday Morning, Late Night Study, Rainy Cafe, Dreamy.
Premium: All 20+ presets + save up to 20 custom presets.
LoveLofi also suggests a preset based on the time of day: Dreamy in the morning, Rainy Cafe in the afternoon, Late Night Study in the evening, and Old Cassette late at night.
Tab Audio Mode
Tab Audio is a premium feature that captures audio from any browser tab and routes it through the LoveLofi effects chain. Listen to Spotify, YouTube, SoundCloud, or any website with lo-fi effects applied in real-time.
- Open the LoveLofi popup and switch to the "Tab Audio" tab
- Click "Capture Tab Audio" — the current tab's audio will be captured
- Apply presets or tweak effects as usual
- Click "Stop Capture" when done
Note: Tab capture uses the tabCapture permission and runs through an
offscreen document as required by Manifest V3.
Keyboard Shortcuts
Premium users can control playback without opening the popup.
| Action | Default Shortcut |
|---|---|
| Play / Pause | Space |
| Next Station | → |
| Previous Station | ← |
| Volume Up | ↑ |
| Volume Down | ↓ |
| Toggle Mute | M |
Themes
LoveLofi includes 16 themes organized as 8 light/dark pairs:
- Cafe Nocturne / Cafe Eclipse
- Midnight Session / Morning Session
- Sakura Study / Sakura Night
- Vinyl Noir / Ivory Brass
- Forest Cabin / Forest Night
- Ocean Drift / Coastal Breeze
- Lavender Haze / Lavender Dusk
- Neon Tokyo / Neon Dawn
Free tier: Cafe Nocturne and Cafe Eclipse (light/dark pair).
Premium: All 16 themes.
License & Account
Premium licenses are managed through Polar.sh. After purchase, you'll receive a license key that you can activate in the extension settings.
- License keys sync across all Chrome profiles via
chrome.storage.sync - Validation happens weekly with a 7-day grace period if you're offline
- Monthly and annual plans can be cancelled anytime through your Polar.sh dashboard
- Lifetime purchases include all future updates at no additional cost