Add REST API for remote playback control

[Gonzoe79]

Summary

Adds an opt-in REST API that allows external clients to control playback, manage the queue, and browse recommendations remotely.

Endpoints

• POST /api/v1/playback/play|pause|toggle|next|previous|stop|pip
• POST /api/v1/playback/seek?positionMs={ms}
• GET /api/v1/playbackstate
• GET /api/v1/queue
• POST /api/v1/queue/items?videoUrl={url}&shuffle={bool}
• GET /api/v1/recommendations

Security

• REST API Disabled by default
• Basic HTTP authentication (configurable username/password)
• Configurable port (default: 8090)

API Documentation

See openapi.yaml in the ./docs.

Notes

• Adds gson dependency for JSON serialization

[Gonzoe79]

Hi @yuliskov ,
i removed some noise from the commit and pulled the latest changes.
happy to hear your feedback

best regards

[yuliskov]

Got it. Thanks

[akshaynexus]

ah damn didnt see this before i ended up making my own rest api adition to smart tube

Ill probably clean up my branch and open a pr,i have a few extra changes and features i added for better control/discovery

[visualglitch91]

@akshaynexus @Gonzoe79 i was literally about to implement this as well since the lounge api is not very reliable, only thing missing here for me is a "play next" endpoint since the queue on puts the item at the end of the queue

[akshaynexus]

@akshaynexus @Gonzoe79 i was literally about to implement this as well since the lounge api is not very reliable, only thing missing here for me is a "play next" endpoint since the queue on puts the item at the end of the queue

Do check the pr I opened and see if that fits most of your requirements ,if not do comment and I'll add it to the pr

[Gonzoe79]

@yuliskov
where you already able to have a look at the PR?

theres another PR from @akshaynexus (#5896) that go in the same direction. maybe we should unify things... but i think we would need some feedback from you.

[yuliskov]

I can't estimate a date yet. I'm working on higher-priority tasks right now.