Skip to content
imamjeslyPublic

About

Now Playing display & music remote with Flipper Zero - album art, song info, LED beat pulse and controls, with an Android companion app

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎵 FlipTunes

Now Playing display and music remote with Flipper Zero

See what's playing on your Android phone - title, artist, progress and album art - right on your Flipper Zero, control the music from it, and watch the LED pulse to the beat.

Build License: GPL-3.0 Flipper Zero Android

FlipTunes on a Flipper Zero showing album art, song title, artist, Spotify and a progress bar

Features

  • 🖼️ Album art - the cover, dithered to 48x48 black-and-white for the Flipper's screen
  • 📝 Song info - title and artist (scrolling when long), player app, live progress bar
  • ⏯️ Controls - play/pause, next/previous, volume, seek
  • 💡 LED beat pulse - the LED flashes orange in time with the music (tempo-locked, adjustable sync)
  • 📳 Track-change buzz - a gentle double tap when a new song starts by itself
  • 🔒 Lock mode - screen stays on, buttons ignored: put it on your desk or in your pocket
  • ⚙️ Settings menu - every effect can be switched on or off
  • 🎧 Works with any music app that shows media controls (Spotify, YouTube Music, Samsung Music, podcasts...)
  • 🔐 No internet, no accounts, no tracking - phone and Flipper talk directly over Bluetooth

Screenshots


Start screen

Settings

More settings

First run: allow access

Now playing + Flipper cover preview

Test controls and activity log

How it works

flowchart LR
    A[Music app<br/>Spotify, YouTube Music...] -- now playing info --> B[FlipTunes<br/>Android app]
    B -- "title, artist, progress,<br/>album art, beat tempo" --> C[FlipTunes<br/>Flipper app]
    C -- "play/pause, next,<br/>volume, seek" --> B
    B -- controls --> A
Loading

The Android app reads the phone's media session (the same info your lock screen shows), and sends it to the Flipper over Bluetooth Low Energy. Button presses travel back the other way. Read the full walkthrough in docs/HOW-IT-WORKS.md.

Install

You need both parts. Downloads are on the Releases page.

1. Flipper Zero

  1. Update your Flipper to the latest official firmware (qFlipper or lab.flipper.net).
  2. Download fliptunes.fap from the latest release.
  3. Copy it to the SD card at apps/Bluetooth/ (qFlipper > File manager).

2. Android phone (Android 12 or newer)

  1. Download FlipTunes.apk from the latest release and open it. Android may ask you to allow installs from your browser/file manager.
  2. Open FlipTunes and tap Allow for:
    • Notification access - this is how Android lets apps see what's playing. Nothing else is read.
    • Bluetooth - to talk to the Flipper.
    • Optional: Microphone - only used to feel the music's beat for the LED pulse. Android groups audio analysis under this permission. No audio is recorded or sent anywhere.

Note on Android's new developer verification: Google is rolling out a requirement for sideloaded apps to come from verified developers (enforced in Brazil, Indonesia, Singapore and Thailand since September 2026, worldwide in 2027). If your phone shows a warning, Android's "install unverified app" option still works - it just adds a few steps and a waiting period.

3. Connect

  1. On the Flipper: Apps > Bluetooth > FlipTunes.
  2. On the phone: Choose Flipper > pick your Flipper > Start bridge.
  3. If asked, confirm the pairing code on both devices.
  4. Play some music. 🎶

Close the official Flipper mobile app while using FlipTunes - both use the same Bluetooth link.

Controls

Button Action
OK Play / Pause
Hold OK Settings
Left / Right Previous / Next track
Hold Left / Right Seek back / forward
Up / Down Volume (hold to repeat)
Back Exit
Hold Back Lock / unlock buttons

Settings

Setting What it does
Key vibration Vibrate on button presses
Track change buzz Double tap when a new song starts on its own
LED beat pulse Orange LED flashes to the beat
Beat sensitivity Low / Medium / High - how easily beats are picked up
Beat sync offset Move flashes earlier/later (-400 to +400 ms), e.g. for Bluetooth earbuds
Keep screen on Display stays lit while the app is open
Seek step 5 / 10 / 15 / 30 seconds
Lock buttons now Lock mode (hold Back to unlock)

Troubleshooting

Problem Fix
Flipper stays on "Waiting for phone" Check Choose Flipper picked the right device, the Flipper's Bluetooth is on, and the official Flipper app is closed.
"No art" Some players only share a web link to the cover, not the image. Try another player.
LED pulse looks random or steady The app's Beat: line shows the status. Some players block audio analysis; then a steady 120 BPM is used.
LED a bit early or late Settings > Beat sync offset. Bluetooth earbuds usually need a positive (later) offset.
Song titles show ? The Flipper's font only has basic Latin letters.

Build from source

Flipper app (ufbt):

pip install ufbt
cd flipper
ufbt launch        # build, install and run on a connected Flipper

Android app: open the android/ folder in Android Studio and press Run.

Every push is built automatically by GitHub Actions - see the Actions tab for test builds.

Project layout

flipper/   Flipper Zero app (C, ufbt)
android/   Android app (Kotlin, Jetpack Compose)
docs/      How it works, message protocol, images

Similar projects

  • villenull/flipper-now-playing - an earlier, independently built Now Playing app for Flipper Zero with an Android companion. Worth checking out too.

Contributing

Issues and pull requests are welcome - bug reports with your phone model, music app and Flipper firmware version help a lot.

License

GPL-3.0 © Imaam Jesly

FlipTunes is an independent project and is not affiliated with or endorsed by Flipper Devices Inc. "Flipper Zero" is a trademark of Flipper Devices Inc.

About

Now Playing display & music remote with Flipper Zero - album art, song info, LED beat pulse and controls, with an Android companion app

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages