Spotilol

         

a lil Android app that wraps Spotify's web player with built-in adblocking.

it's a fork of Spotifuck by deviato, ported from smali to clean Kotlin. all free, all open-source.

runs in two modes: normal (no certificate, works out of the box - the default) or proxy MITM (local proxy with a custom CA cert) so Spotify doesn't clock you're on a WebView. everything else passes through untouched.

📖 documented at deepwiki.com/lyssadev/Spotilol

---

---

Download

grab the latest APK from the releases page.

download the .apk file and install it on your device. you may need to toggle "Install from unknown sources" in your Settings.

---

Features

• blocks audio ads 🚫
• works with or without a certificate: normal mode (default) & proxy MITM
• media notification with play/pause, skip, seek, like/unlike
• works with lock screen, Bluetooth, Wear OS
• autoplay modes: off, once at start, or permanent
• mobile-friendly CSS/JS layout tweaks
• AMOLED dark mode (pure black)
• keeps screen on while you're vibing
• browse your library through Spotify's API
• update checker (auto & manual)

---

Requirements

• Android 8.0+ (API 26)
• a Spotify account (free or premium)
• Google Chrome / WebView (comes with your phone)

---

Quick Start

install the APK, open it, done. Spotilol runs in normal mode by default - no certificate, no setup, no "Certificate Required" screen. it just works out of the box.

Switching to Proxy MITM Mode

want the full fingerprint treatment? flip the mode in Settings → Connection Mode → "MITM Proxy (Certificate)". the app restarts and walks you through the cert install.

The Certificate Thing (proxy mode only)

Spotilol generates a local CA cert so Spotify doesn't know you're in a WebView. it lives on your device, stays on your device.

1. open Spotilol in proxy mode — you'll see the "Certificate Required" screen
2. tap "Export .pem" to save it to your Downloads
3. go to Settings > Security > Encryption & Credentials > Install a certificate > CA certificate
4. find spotilol_ca.pem in your Downloads and tap it
5. it'll warn you about network monitoring — tap "Install anyway"
6. come back to Spotilol and tap "Check". if it worked, you're in.

Note: if you ever clear your device's credential storage (like after a factory reset), you'll have to do this again.

---

Build It Yourself

git clone https://github.com/lyssadev/Spotilol
cd Spotilol
./gradlew assembleDebug

APK lands at app/build/outputs/apk/debug/app-debug.apk.

Google Services

this project uses Firebase (analytics, crash reporting, performance). to build, you need:

1. create a Firebase project at console.firebase.google.com
2. register an Android app with package name com.project.lol
3. download the google-services.json and place it in app/

---

Contributing

contributions are welcome. open issues, throw PRs, suggest stuff — free for all.

---

Credits

Spotilol exists because deviato did the reverse-engineering work on Spotifuck. this ports the core logic from smali to Kotlin with extra features and maintenance.

Open-sourced by lyssadev <3 deviato