This app is a Python-based command-line interface that allows users to interact with the Spotify Web API. It enables you to retrieve your top songs and artists, and search for tracks and artists on Spotify.
- Get Top Songs and Artists: Easily access your favorite songs and artists based on your Spotify listening history. Similar to projects like Receiptify.
- Search Functionality: Search for tracks and artists directly from the command line.
Requires Python >= 3.12
-
Clone the repository:
git clone https://github.com/elianmanzueta/spotify-cli-app.git -
Navigate to the app directory:
cd spotify-cli-app -
Install dependencies:
pip install -r requirements.txt
python src/spotify_cli.py get-top-tracks
Options include:
- Limit
- Time range
python src/spotify_cli.py get-top-tracks --limit 5 --time-range short_term
python src/spotify_cli.py get-top-artists
Options include:
- Limit
- Time range
python src/spotify_cli.py get-top-artists --limit 6 --time-range long_term
python src/spotify_cli.py search --artist "Weezer"
python src/spotify_cli.py search --track "Buddy Holly"
Before using the app, you'll need to set up your Spotify API credentials.
Create a Spotify Developer account and create a new application.
Go to your app's settings and get the Client ID, Client Secret, and Redirect URI.
Add your Client ID, Client Secret, and Redirect URI to a .env file in the project root.
Distributed under the MIT License. See LICENSE for more information.