Isn’t there any way to store the token? I heard Xbox is using OAuth. I read somewhere that UC is planning to support this because they plan to integrate Spotify which needs this as well. I don’t know how OAuth works but maybe its not yet possible with the remote.
xbox does use OAuth which is what i used, the token is saved in a config.json file, but if the integration is off etc the token expire, i couldnt figure out how to keep alive etc. the problem start when too long pass and the token expire (remote reboot example). but that being said, i just wanted to build this and i have lot more to learn about OAuth structure to make it better
new version out which fixes recent issues.
This is a noob question, but how do I go from your Github repository to a docker on Unraid? I only know how to install docker containers from the Unraid Community App within Unraid. My coding skills are basically zero. Any help is appreciated.
Docker must be created with the docker-compose.yaml. Unraid user seem to advise to use Portainer for this task.
Ralf
There is also a Docker compose plugin for Unraid but I would use the base Python 3.11 image and put everything from the Docker file into a script or into the post arguments.
Is there a reason why you don’t wantonto run it on the remote itself? This is way easier.
The Github page says docker install is recommended.
I think that’s a mistake. Usually it’s the easiest way to install it on the remote. Especially if you have no clue on how to use Docker or only used Unraid templates before.
Correct. Xbox was my first integration built, I did not knew much at all as it was my first Dev attempt when I started and got the remote. I’ll revamp the readme. The uploaded tar.gz is much easier
Major update request 3.0.0 which combine both media player and remote entity among other enhancements. Please note : due to the massive code change you will need to completely redo your activities and any button mapping. And you may completely remove the seperate xbox live integration which is now combined into this one.
This also has the same issue I reported on the 3.0.0 update of the Xbox Live integration.
Going to the login URL on 3.0.0 gives me a page at Microsoft with the following text “You have reached a page that is not normally shown. Microsoft will never ask you to copy or share this URL.” When I paste the redirect URL it doesn’t work.
That page is expected, it works with no issues for me. Share logs. Also now, recently there was an Xbox update to the console that reverted the setting. Go back to yes console, untick the remote play setting, retick it and go to power options, make sure it’s set to sleep and not power off. I had to do it.
I tested the integration and it worked with no issues.
But I definitely needed to do the settings on the console
Redoing the remote play settings fixed it! Thanks! Both the media and remote side seems to be working fine.
That’s awesome!
1 Like
Having connection issues here as well. Initially got the same as above (secret Microsoft page and a redirect URL that didn’t work). Toggled remote play off and on, and tried again, but now getting “Driver not connected. Failed to connect to host: Connection refused (os error 111)”
Deleted integration and reinstalled, tried everything I can think of.
Logs:
2025-11-17 17:04:36.659150 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,655 - ucapi.api - DEBUG - [('127.0.0.1', 36626)] ->: {'kind': 'resp', 'req_id': 5, 'code': 200, 'msg': <WsMsgEvents.DRIVER_VERSION: 'driver_version'>, 'msg_data': {'name': 'Xbox Integration', 'version': {'api': '0.3.1', 'driver': '3.0.0'}}}
2025-11-17 17:04:36.655316 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,653 - ucapi.api - DEBUG - [('127.0.0.1', 36626)] <-: {"id":5,"kind":"req","msg":"get_driver_version"}
2025-11-17 17:04:36.649653 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,647 - ucapi.api - DEBUG - [('127.0.0.1', 36626)] ->: {'kind': 'resp', 'req_id': 0, 'code': 200, 'msg': <WsMessages.AUTHENTICATION: 'authentication'>, 'msg_data': {}}
2025-11-17 17:04:36.646805 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,644 - ucapi.api - INFO - WS: Client added: ('127.0.0.1', 36626)
2025-11-17 17:04:36.642632 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,641 - websockets.server - INFO - connection open
2025-11-17 17:04:36.410476 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,408 - websockets.server - INFO - server listening on 127.0.0.1:9003
2025-11-17 17:04:36.402563 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,401 - __main__ - INFO - Driver is up and discoverable.
2025-11-17 17:04:36.401283 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,400 - uc_intg_xbox.config - INFO - Configuration file not found or is invalid.
2025-11-17 17:04:36.399356 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,398 - ucapi.api - INFO - Driver is up: uc-intg-xbox, version: 3.0.0, api: 0.3.1, listening on: 127.0.0.1:9003
2025-11-17 17:04:36.396048 +00:00 custom-intg-uc-intg-xbox INFO 2025-11-17 17:04:36,394 - __main__ - INFO - Starting Xbox Integration Driver...
logs are cropped, they dont say much.
make sure xbox is not set to power off and set to sleep, make sure at least for inital connection console is on. make sure remote and xbox on the same network, also redownload the tar.gz, this error usually mean bad download for the tar.gz, try to download using a different browser, reboot remote, re upload new tar.gz and try again.
Ah sorry the logs were formatted, just drag the cursor on them and scroll right 
I had already tried all the things you suggested….except to redownload the tar.gz…..which has fixed it!
Thank you so much!
glad its working now.
1 Like
new version up with enhancements for state detection
1 Like
Hi, thanks for putting together this integration. I’m having some trouble getting it to work. It installs okay and I was able to set it up no problem but when I try and actually execute the command it doesn’t turn on. It throws an error when it attempts to power on the Xbox. I’ve reset the remote settings, I’ve made sure set to sleep mode not powred off and I’ve made sure I have the latest integration downloaded and setup having removed the earlier integration and still no luck. Is there a specific power command I should be using from the xbox remote options? I think I’ve tried them all but may have missed one.
Thanks!