https://github.com/noahc3/spoofy

Playlist randomizer for Spotify with weighted algorithms.
https://github.com/noahc3/spoofy

Last synced: about 2 months ago
JSON representation

Playlist randomizer for Spotify with weighted algorithms.

• Host: GitHub
• URL: https://github.com/noahc3/spoofy
• Owner: noahc3
• License: agpl-3.0
• Created: 2022-02-20T06:39:17.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-04-17T04:06:47.000Z (about 4 years ago)
• Last Synced: 2025-03-21T01:14:39.983Z (about 1 year ago)
• Language: JavaScript
• Size: 1.53 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


    

        

    





    

    



Spoofy is a web app you can use to apply a permanent shuffle to your Spotify playlists. The tool gives you the option to do a fully random shuffle, or to shuffle while spacing apart songs by the same artist.

The website uses the official Spotify REST API to perform playlist shuffles. To use Spoofy, head over to [https://spoofy.noahc3.ml](https://spoofy.noahc3.ml), login with your Spotify account and start shuffling!

## Build & Run Locally

The frontend is a Node.js project built with ReactJS, you can launch into debug mode with the command `npm start`. You can build the static output with `npm run build`.

The backend server is written in C# using ASP.NET 6.0 and can be easily build by opening the solution in Visual Studio 2022 and building as usual, or using the `dotnet build` command.

### Required configuration for backend server

The backend server requires Spotify application credentials to interact with the Spotify API. Please see the [Spotify developer quick start guide](https://developer.spotify.com/documentation/web-api/quick-start/) for information on how to setup an app with Spotify and get your client ID and client secret. You will need to configure the following redirect URIs in the Spotify developer dashboard for you app:

* Frontend: `http://localhost:3000/callback`

* Swagger/OpenAPI: `http://localhost:5003/swagger/oauth2-redirect.html`

The backend server also needs a 128bit key to encrypt and store the users authentication token within their browser. You should generate a random 16 character ASCII string for this purpose.

**Development Mode**

Set your configuration settings using dotnet user secrets. Run these commands in the backend solution directory:

```

dotnet user-secrets init

dotnet user-secrets set "Spotify:ClientID" [clientid]

dotnet user-secrets set "Spotify:ClientSecret" [clientsecret]

dotnet user-secrets set "Spotify:AuthDataKey" [authdatakey]

```

**Production Deployment**

Set your configuration settings in `appsettings.json` in a top level `Spotify` object property

```

{

    ...

    "Spotify": {

        "ClientID": "{clientid}",

        "ClientSecret": "{clientsecret}",

        "AuthDataKey": "{authdatakey}"

    },

    ...

}