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.

  1. Click the LoveLofi icon in your browser toolbar
  2. Choose a radio station from the station list
  3. Press play — you're listening to lo-fi radio!
  4. 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.

  1. Open the LoveLofi popup and switch to the "Tab Audio" tab
  2. Click "Capture Tab Audio" — the current tab's audio will be captured
  3. Apply presets or tweak effects as usual
  4. 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.

ActionDefault Shortcut
Play / PauseSpace
Next Station
Previous Station
Volume Up
Volume Down
Toggle MuteM

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