drake044 / playlist-randomizer

A CLI tool that randomizes songs in a playlist for Spotify. Key Features: Connect to music services' APIs (e.g., Spotify API). Shuffle songs and create randomized playlists.
1 stars 2 forks source link
hacktoberfest

Music Playlist Randomizer

Hacktoberfest Contributions Welcome

Welcome to the Music Playlist Randomizer project! This tool helps you create random playlists from your music library.

Features

Getting Started

Prerequisites

Installation

  1. Fork the Repository

    Click on the "Fork" button at the top right of this repository to create your own copy.

  2. Clone Your Fork

    git clone https://github.com/your-username/music-playlist-randomizer.git
    cd music-playlist-randomizer
  3. Create a Spotify Developer Account

  4. Configure Environment Variables

    Create a .env file in the root directory and add your Spotify credentials:

    SPOTIPY_CLIENT_ID='your-client-id'
    SPOTIPY_CLIENT_SECRET='your-client-secret'
    SPOTIPY_REDIRECT_URI='http://localhost:8080/callback/'
  5. Set Up Virtual Environment and Install Dependencies

    Create a virtual environment and install the necessary modules from requirements.txt:

    python3 -m venv venv
    source venv/bin/activate  # On Windows use `venv\Scripts\activate`
    pip install -r requirements.txt

Running the Script

After configuring the environment variables, run the main script:

python3 main.py

Contributing

We welcome all types of contributions—whether you're fixing a bug, improving documentation, or adding new features. Please read our contributing guidelines for more details.

License

Thank you for checking this out! Happy Hacktoberfest!