Open source · SwiftUI · iOS 17+

Podium

A click wheel and a spinning record for the music playing in Spotify.

A free iPhone app that controls the Spotify app on your phone. Its widgets put the record you're playing on your Home Screen and Lock Screen.

View on GitHub How to build it

33⅓ rpmTap the record to stop it

Two ways to play

Switch between them with the icon in the top-right corner. Both show the track, the artist and a progress bar you can drag to seek.

Click wheel

Turn the wheel to flip through what Spotify recommends for you, with a haptic tick at every step.

Rotate
Browse albums and playlists
Center
Play the one you stopped on
Top
Jump back to what's playing
Left, right
Previous or next track
Bottom
Play or pause

Vinyl

The record fills the screen and turns at 33⅓ rpm while music plays, with the album art as its label. No buttons: the record is the control.

Tap
Play or pause
Swipe left
Next track
Swipe right
Previous track

Recorded in the iPhone 17 Pro Simulator.

The record, on your Home Screen and Lock Screen

The Now Playing widget comes in five sizes, and each one shows what Podium is playing. Add it from the Home Screen or Lock Screen editor by searching for Podium.

Home Screen

Small Podium widget: a record with the Thriller cover as its label and a waveform in the corner. Medium Podium widget: a record with the Thriller cover beside the track Beat It by Michael Jackson and a progress bar.
Small
The record with the album art as its label. A waveform appears in the corner while music plays.
Medium
The record beside the track and the artist, with a progress bar.

Lock Screen

Inline
The track and the artist, next to the date.
Circular
A ring that fills as the track plays.
Rectangular
The track, the artist and a progress bar.

Updates when the music changes

Podium refreshes its widgets when the track changes, when you pause and when you seek. Nothing polls in the background.

Progress without refreshes

The widget knows when the track started and when it ends, so iOS moves the bar along on its own between updates.

Tap to open Podium

The app shares a small snapshot with its widgets through an App Group. Label art is saved at 256 × 256 px to stay under WidgetKit's image size limit.

Build it yourself

Podium isn't on the App Store. Spotify's developer terms allow apps like it for personal, non-commercial use, so you build it from source and install it on your own iPhone.

  1. Run it in the Simulator

    Open the project and press Run. The Simulator plays a demo library, so there's nothing to set up.

    git clone https://github.com/mateuszlomni/podium.git
open podium/Podium.xcodeproj

  2. Create a Spotify app

    In the Spotify Developer Dashboard, create an app, select iOS, and add your bundle ID and this redirect URI.

    podium-player://spotify-login-callback

  3. Add your keys

    Copy the example config, then fill in PODIUM_BUNDLE_ID, DEVELOPMENT_TEAM and SPOTIFY_CLIENT_ID. Git ignores this file.

    cp Config/Secrets.example.xcconfig Config/Secrets.xcconfig

  4. Run it on your iPhone

    Turn on Developer Mode and run from Xcode. Start playing something in Spotify, open Podium and tap Connect.

Support Podium

Podium is free and open source, and every feature is in the code for everyone. If it earned a spot on your Home Screen, you can support its development with a coffee. It's voluntary and doesn't unlock anything in the app.

Support on Buy Me a Coffee