Skip to content

lyssadev/Spotilol

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Spotilol Logo

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 a local MITM proxy with a custom CA cert so Spotify doesn't clock you're on a WebView. that's the magic trick. everything else passes through untouched.


Preview

screenshot 1 screenshot 2 screenshot 3

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 🚫
  • 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: The Certificate Thing

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 — 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.


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

About

A android app that wraps Spotify's web player with built-in adblocker

Topics

Resources

Stars

32 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors

Languages