Smergify

Shared Spotify playlists

Setup

Spotify App

• Create your own Spotify App here
• Add a Redirect URI to your app, for example http://localhost:8080
• You will need your app's Redirect URI, Client ID and Client Secret later for configuring the Server and Client

Server

• Setup your own server, for example a RaspberryPi

• If you use a RaspberryPi, you can run our configuration script to automatically:

  • Run a full upgrade
  • Install fail2ban to prevent brute-force attacks
  • Ask for password when using sudo
  • Enable SSH, change port and disable password login
  • Setup DuckDNS

• Install the required packages in requirements.txt

pip3 install -r requirements.txt

• Open config.yaml and insert your configuration

  • Client ID, Client Secret and Redirect URI of your previously created App
  • The name of your database file (Default: data.db). The file should be in the same folder as your script
  • The name of your log-file which is saved in logs
  • Minimum and desired playlist size (Amount of songs)

• Add a cronjob with crontab -e to automatically update all playlists for groups created with the client

# Runs every Sunday at 00:00
0 0 * * 7 python3 smergify.py

Client

• Install the required packages in requirements.txt

pip3 install -r requirements.txt

• Open config.yaml and insert your configuration

  • Client ID, Client Secret and Redirect URI of your previously created App
  • Username, hostname and port of your server
  • The path to your private key. Leave empty if not needed
  • Your server's password. Leave empty if not needed
  • The absolute path to the playlist groups on the server
  • The absolute path to the server bash script starting the script

Usage

Run python3 smergify.py on your client and follow the instructions.

Contributors

• Hacker Manuel
• Olczak Liliana
• Pertl Johannes