{"id":22069685,"url":"https://github.com/faithvoid/script.cortanacompanion","last_synced_at":"2026-04-20T14:01:48.200Z","repository":{"id":264184407,"uuid":"892622861","full_name":"faithvoid/script.cortanacompanion","owner":"faithvoid","description":"A remote SH1106/SSD1306 display script for XBMC4Xbox using a Raspberry Pi, designed as an alternative to hard LCD mods.","archived":false,"fork":false,"pushed_at":"2024-12-12T01:05:11.000Z","size":101,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-22T13:59:56.814Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/faithvoid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":"videogirl95","open_collective":null,"ko_fi":"videogirl95","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-11-22T13:14:54.000Z","updated_at":"2024-12-12T01:05:15.000Z","dependencies_parsed_at":"2024-11-30T20:11:57.752Z","dependency_job_id":"5d3c1486-e431-4769-95a9-4c25610b20c9","html_url":"https://github.com/faithvoid/script.cortanacompanion","commit_stats":null,"previous_names":["faithvoid/script.xbmcdisplay","faithvoid/script.cortanacompanion"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/faithvoid/script.cortanacompanion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faithvoid%2Fscript.cortanacompanion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faithvoid%2Fscript.cortanacompanion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faithvoid%2Fscript.cortanacompanion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faithvoid%2Fscript.cortanacompanion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faithvoid","download_url":"https://codeload.github.com/faithvoid/script.cortanacompanion/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faithvoid%2Fscript.cortanacompanion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32050451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-30T20:11:49.561Z","updated_at":"2026-04-20T14:01:48.158Z","avatar_url":"https://github.com/faithvoid.png","language":"Python","funding_links":["https://patreon.com/videogirl95","https://ko-fi.com/videogirl95"],"categories":[],"sub_categories":[],"readme":"# Cortana Companion\nA remote SH1106/SSD1306 display script for XBMC4Xbox using a Raspberry Pi, designed to emulate the front LCD/OLED screen of a hardmodded Xbox for softmodded units. \n\n![Cortana Companion running on a Pi Zero W](https://github.com/user-attachments/assets/3a22c738-d332-4a33-b841-3ec1ceb503a3)\n\n\n## Requirements:\n- Any Raspberry Pi model with a GPIO interface, with python3, python3-rpi.gpio \u0026 python3-luma.oled installed.\n- Either an SH1106 (recommended) or SSD1306 display (requires a line or two of modification to work)\n- An Xbox running some variation of XBMC4Xbox (XBMC4Gamers and XBMC-Emustation should work just fine).\n- A solid internet connection on your Raspberry Pi and your Xbox (ideally connected directly to your Pi using [Cortana Wireless!](https://github.com/faithvoid/script.cortanawireless)) \n- Python 2.7 on XBMC4Xbox, Python 3+ for Raspberry Pi.\n\n## Raspberry Pi Instructions:\n- Enter the line down below in your Pi's terminal after setting up your distro of choice!\n- ``` curl -sL https://raw.githubusercontent.com/faithvoid/script.cortanacompanion/refs/heads/main/install.sh | bash ```\n\n## Xbox Instructions:\n- Extract CortanaCompanion into Q:\\scripts\\CortanaCompanion\n- Modify the IP address section in \"stats.py\" to point to the IP address of your Raspberry Pi\n- Launch \"default.py\" from the Scripts manager in XBMC and select \"Start Cortana Companion\", and select \"Stop Cortana Companion\" to stop the script.\n- You should immediately start seeing stats on your Raspberry Pi display! Note that this does nothing outside of XBMC, so that means when you're in-game your system stats won't update until you boot into XBMC again!\n\n## Customization:\nCortana Companion supports a wide array of customization options, as it's a parser for XBMC InfoLabels. Let's say you want to replace the \"Playing\" screen with BIOS information. Open raspberry.py, add the \"BIOS\" value to \"last_values\" if it's not already there, replace \"Playing: {track}\" in the display_info section with \"BIOS: {bios}\", scroll to and insert \"bios = last_values[\"BIOS\"]\" under \"# Extract the updated values\" and \"bios\" into both \"display info(bios, memory, etc)\" functions if it doesn't exist already.\n\nNext, open \"stats.py\", add \"bios_version = xbmc.getInfoLabel(\"system.bios\")\" under \"def get_system_info()\" if it doesn't exist already, \" \"bios_version\": bios_version, \" between the return {} statements underneath that, then add \"BIOS: {bios_version}\" to the \"message =\" field if it doesn't exist already.\n\nIf all is said and done, you should see BIOS information instead of Now Playing information upon the next script launch!\n\n## Bugs:\n- Some songs return symbols that cause the title/track names to bug out and not appear or spam errors in the log. \n- You tell me.\n\n## TODO: \n- Fix \"Storage\" command (currently returns total HDD space instead of total **FREE** HDD space.)\n- Add scrolling to \"Playing\" section.\n- Set up key buttons to function with XBMC (play / pause / stop? or shutdown / restart / reboot?)\n- Clean up code further\n- Explain the customization section better.\n- [Integrate multi-page support like in my other script, PiHOLED.](https://github.com/faithvoid/PiHOLED). Default page will be system staps, then moving the joystick will select either Music or Movie information.\n- [Integrate with Cortana Wireless to also function as a network adapter for the original Xbox.](https://github.com/faithvoid/script.cortanawireless)\n- \n# Why?\nI just think it's neat. :) As someone using a 1.6 softmod I love how the LCD on hardmods looks and wanted to replicate something for softmod users to place on/around their Xbox with no hardware modification required.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaithvoid%2Fscript.cortanacompanion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaithvoid%2Fscript.cortanacompanion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaithvoid%2Fscript.cortanacompanion/lists"}