README.md

ChorusAPI

ChorusAPI is wrapper for the chorus.fightthe.pw REST API. Available with async usage.

Basic API Usage

Importing the module:

import chorusapi

Get Latest Songs:

chorusapi.latest(10)

Get Total Songs Count:

choursapi.count()

Get Random Songs:

chorusapi.random()

Download Song(s):

song = chorusapi.latest()
chorusapi.download(song, savedir='./library')

Basic Song Search:

chorusapi.search(query='metallica')

Advanced Song Search:

from chorusapi import DiffultyType, AdvancedSearch

...

adv_search = AdvancedSearch(artist='born of osiris', tier_guitar='gt1', diff_guitar=[DifficultyType.EASY, DifficultyType.EXPERT])
chorus.search(query=adv_search)

Async API Usage

import chorusapi
...

chorus = chorusapi.Async()
await chorus.random()
await chorus.search(query='megadeth')
await chorus.count()
await chorus.latest()
await chorus.download(...)