Skip to content

Latest commit

 

History

History
67 lines (44 loc) · 2.36 KB

README.md

File metadata and controls

67 lines (44 loc) · 2.36 KB

Spiteify 😈 🎵

Spiteify is a web application that uses the Spotify API to recommend songs that you're likely to hate! Whether you're looking to torture your ears or annoy your friends, Spiteify has got you covered. 🔥

Live Usage

Check out the live webapp at https://spiteify.com Live webpage currently down for development.

Features

  • Hate-based Recommendations: Spiteify uses advanced algorithms and the Spotify API to analyze your music preferences and recommend songs that are the polar opposite of what you like. 🎶💔
  • Customizable Hate Levels: Adjust the "hate" slider to control how much you want to despise the recommended songs. 😡
  • Shareable Hate Playlists: Create and share playlists of your most hated songs with your friends (or enemies). 👬👫
  • Spotify Integration: Seamlessly connect your Spotify account to get personalized hate recommendations. 🔗

Getting Started

To run Spiteify locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/GrahamKowalski/spiteify.git
  2. Install dependencies:

    cd spiteify
    npm install
  3. Set up your Spotify API credentials by creating a .env file in the project root with the following variables:

    SPOTIFY_CLIENT_ID=your_client_id
    SPOTIFY_CLIENT_SECRET=your_client_secret
    
  4. Start the development server:

    npm run dev
  5. Open http://localhost:3000 in your browser to see the app running. 🚀

Contributing

Contributions are welcome! If you'd like to contribute to Spiteify, please follow these steps: 🤝

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and commit them with descriptive messages.
  4. Push your changes to your forked repository.
  5. Submit a pull request to the main repository.

License

Spiteify is released under the MIT License. 📜

Acknowledgments

  • Spotify API - The powerful API that powers Spiteify's hate recommendations. 🎧
  • Next.js - The React framework used for building the Spiteify web application. ⚛️
  • Tailwind CSS - The utility-first CSS framework used for styling Spiteify. 💅