Skip to content

A minimalistic window with lyrics synced to Spotify on the surface of your screen

License

Notifications You must be signed in to change notification settings

PureAspiration/SpotifySurface

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Logo

Spotify Surface

A minimalistic window with lyrics synced to Spotify
on the surface of your screen

Usage and Features · Report Bug · Request Feature


Table of Contents
  1. About
  2. Usage and Features
  3. Installation/Downloading
  4. Setup
  5. Acknowledgments and Credits
  6. Developer
  7. License

About

A minimalistic window that shows you the current song playing on Spotify with synced lyrics.
The application is non-distracting with all the information you need about the song you are listening to. This window is pinned to the top of the screen for all your lyrics needs.

Usage and Features

Synced Lyrics
Lyrics are shown at the center of the interface, with a following rectangle.
Synced Lyrics Demo

Automatic Lyric Scrolling
The lyrics scroll down automatically.
But what if you want to read the lyrics? Then just scroll.
Once you're done, just click the follow button, and the lyrics will scroll automatically once again.
Automatic Lyric Scrolling Demo

Live Lyrics Fetching
The application searches for lyrics immediately after you change songs on Spotify.
Logo

Quick Access Controls *
With the quick access controls, you can play/pause, skip, return, shuffle, and repeat songs with the click of a singular button.
* Note that some of these functions require Spotify Premium to work. If you do not have Spotify Premium, the play/pause, skip, and return buttons will attempt to skip directly from the device. This function will only work on Windows machines.
Quick Access Controls Demo

Window Dragging, Resize, and Alignment Lock
The window can be dragged and resized like a normal window, but when dragging the window near the side of the screen, the window locks and aligns to the side or at the taskbar.
Window Dragging and Alignment Lock Demo




Installation/Downloading

  • Clone or download this repo
  • Install the required dependencies with pip command: pip install -r requirements.txt

Setup

Tokens and Environment Variables

The following 3 tokens can be put into an environment variable.

To do this, create a file named .env in your folder containing the main.py file.

In the file, enter the following, replacing <TOKEN> with your respective token.

SPOTIFY_REFRESH_TOKEN=<TOKEN>
SPOTIFY_BASE64_TOKEN=<TOKEN>
MUSIXMATCH_TOKEN=<TOKEN>

Spotify Tokens

Follow this Youtube video from 1:22 to 14:32.
You will only need to save 2 tokens from this video:

  • Spotify Refresh Token (14:25)
  • Spotify Base64 Token (10:50)

Musixmatch Token

You may remove the MUSIXMATCH_TOKEN variable from the .env file if you do not have a Musixmatch token.
Do not leave the variable unfilled.

Keep in mind that the default token provided may not work 100% of the time and is likely rate limited.

In order to get a new Musixmatch token, follow steps 1 - 5 with the guide here.


Acknowledgments and Credits


Developer

This project was developed by PureAspiration.

License

Distributed under the MIT License. See LICENSE for more information.