feat: AzuraCast / Custom Endpoint

[TychoWerner]

Please check existing knowledge before opening an issue

• I have checked the documentation
• I have searched through existing issues and discussions.

What Type?

Source

Name

AzuraCast

Website

https://www.azuracast.com/docs/developers/now-playing-data/#standard-now-playing-api

API Available?

Yes

Free To Use?

Yes

Willing to finance development?

None

Will you help implement it?

• I am willing to contribute code towards completing this feature
• I am willing to help test preview builds for this feature

Additional Context

Hi, for a radio station I monitor Now Playing data thru AzuraCast, and wish to Scrobble this to multiple places, this seems like a nice project to connect this. I can provide my own data to a custom endpoint but was unable to find it.

There are 2 ways to connect with AzuraCast, pull the data from the Now Playing API: https://www.azuracast.com/docs/developers/now-playing-data/#standard-now-playing-api

or get a HTTP POST request from AzuraCast,

https://azuracast.com/api

Thanks in advance and hope to hear from you!

[TychoWerner]

Available endpoint for testing: https://demo.azuracast.com/api/nowplaying

[FoxxMD]

I just started using azuracast about a month ago, great timing! I hadn't considered using the now playing endpoint for scrobbling, this is a great idea. I'll look into implementing a Source this coming week.

[TychoWerner]

Awesome! Sounds good Foxx, if there is something I can test let me know

[TychoWerner]

How are you standing against a general endpoint that can be used? @FoxxMD
I can write a wrapper API in something like Node-RED.

[FoxxMD]

My plan is to implement websockets polling with a fallback to the static json endpoint in the event WS cannot be established or kept open.

To detect listening automatically you will be able to specify how many listeners need to be seen to make the monitoring "active". Useful for fully-private stations where you are the only listener IE "monitorWhenListeners": 2 = start scrobbling if now playing API reports 2 or more listeners for the station.

I'll also implement a manual toggle for scrobbling so a user can initiate "active scrobbling" through the web dashboard or an API endpoint to MS.