Git Product home page Git Product logo

neteasemusic-scrobbler's Introduction

NetEase Music Scrobbler

An API built with FastAPI to translate encrypted song information from NetEase Music and scrobble it to various services.

Requirements

  • Bare-metal: Python 3
  • Containerised: Docker

Usage

Using Docker Compose (Recommended)

  1. Clone the repository
git clone https://github.com/PorridgePi/NetEaseMusic-Scrobbler
  1. Copy .env.example to .env and fill in the required information
  2. Build the image and run the container
docker-compose up --build
  1. API up at http://localhost:8888

Using Docker

  1. Clone the repository
git clone https://github.com/PorridgePi/NetEaseMusic-Scrobbler
  1. Copy .env.example to .env and fill in the required information
  2. Build the image
docker build -t netease-music-scrobbler .
  1. Run the container
docker run -p 8888:80 --env-file .env netease-music-scrobbler
  1. API up at http://localhost:8888

Bare-metal Python

  1. Clone the repository
git clone https://github.com/PorridgePi/NetEaseMusic-Scrobbler
  1. Copy .env.example to .env and fill in the required information
  2. Set up a virtual environment
python -m venv venv
  1. Activate virtual environment
source venv/bin/activate
  1. Install dependencies
pip install -r requirements.txt
  1. Run the server
fastapi run app/main.py --port 8888
  1. API up at http://localhost:8888

API Endpoints

A general overview of the endpoints is available below.

Alternatively, uncomment this line in compose.yml:

    # - IS_FASTAPI_DEBUG=true`

Then, restart the container and visit http://localhost:8888/docs for a more interactive documentation page (thanks to FastAPI).

Scrobble

  • Method: POST
  • Path: /scrobble
  • JSON Body Structure:
Key Type Description
id Integer Song ID from NetEase Music

Encrypted Scrobble

  • Method: POST
  • Path: /encrypted_scrobble
  • JSON Body Structure:
Key Type Description
encrypted String Encrypted params parameter from NetEase Music API requests

neteasemusic-scrobbler's People

Contributors

porridgepi avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.