SPIT - Spotipy Playlist Import Tool

     _____ _____  __ _____ 
    |   __|     ||  |_   _|
    |__   |   __||  | | |
    |_____|__|   |__| |_|

Description

SPIT (Spotify Playlist Import Tool) is a command-line interface (CLI) tool designed to interact with the Spotify Web API to manage and analyze your Spotify music data. It allows users to fetch their most listened songs, liked songs, followed artists, and playlists directly from their Spotify accounts.

What It Does

Fetch Data: Retrieves data such as liked songs, followed artists, and user playlists using the Spotify Web API.
Data Analysis: Provides basic analysis and display of fetched data, such as listing the most listened and liked songs.
Data Export: Allows users to save fetched data into JSON or CSV formats for further use or analysis.

Built With

Python: The core programming language used.
Spotipy: A lightweight Python library for the Spotify Web API.
Pandas: For data manipulation and analysis.
Seaborn: Used for data visualization (though not directly utilized in the main functionality).

Setup & Requirements

Prerequisites

Python 3.x
Pip (Python package installer)

Installation

Clone the repository:

git clone https://github.com/yourusername/SPIT.git

Navigate to the cloned directory:
```
cd SPIT
```
Install required Python packages:
```
pip install -r requirements.txt
```

Usage

To start using SPIT, follow these steps:

Set up your Spotify API credentials in a .env file (client ID, client secret, and redirect URI).
Run the script:
```
python main_spit.py
```
Follow the on-screen prompts to fetch and manage your Spotify data.
When prompted for spotify login on w browser, remember to copy and paste the redirected 404 url from the browser back into the CLI

Potential Roadmap

Extended Data Analysis Features: Incorporate more complex data analysis capabilities.
Social Sharing Features: Add options to share playlists and favorite tracks on social media.
GUI Implementation: Develop a graphical user interface for easier interaction.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

Acknowledgements

Spotipy - Spotify Web API Python library
Pandas - Data analysis library
Seaborn - Statistical data visualization

Thank you to all the contributors who spend time and effort making SPIT better!

SirJAKfromSpace/spit_bot