Skip to content

Spots

A Python package that downloads music and video from a link or a search, with a command line tool, an API and a web screen on top.

One of my own projects, not client work.

Project showcase

The showcase installs Spots from PyPI, follows a sample search, and compares video resolutions and file sizes.

Music Happy Beats / Business Moves, Vol. 9 by Sascha Ende, edited (CC BY 4.0).

What it is

Spots takes a Spotify or YouTube link, or plain search words, and finds the same song across Spotify, Deezer and YouTube. It saves the song as an mp3 with its cover art, album, year and lyrics filled in, or saves the video at the resolution you pick.

It started as a Flask app with a React front end. I rebuilt the core as one installable library first, then put the command line tool, the API and the web screen back on top of it, so all three run the same code.

What it does

  • Installs with one pip command and runs from the terminal
  • Downloads single songs, playlists, albums and an artist’s tracks as tagged mp3 files
  • Lists every video resolution with its file size before you download
  • Web screen with one field for links or search words and a status on every row
  • Tells you which tracks had no match instead of skipping them silently
  • Keeps a history so nothing downloads twice

Built with

Python, Typer, Flask, yt-dlp, pytest, React, esbuild

More screens

  • Spots web screen showing one song with a table of video resolutions and file sizes
  • Spots web screen listing an album with a checkbox beside each track
  • Spots web screen showing five YouTube results for a search
  • Spots web screen with one search result opened to show its video resolutions
  • Spots start screen explaining the three kinds of input it accepts

Need something like this built for your business?