{"id":21081671,"url":"https://github.com/openvoiceos/ovos-gui","last_synced_at":"2025-08-09T19:32:43.427Z","repository":{"id":104838554,"uuid":"433865660","full_name":"OpenVoiceOS/ovos-gui","owner":"OpenVoiceOS","description":"ovos-core metapackage for gui daemon","archived":false,"fork":false,"pushed_at":"2025-04-07T08:34:54.000Z","size":289,"stargazers_count":2,"open_issues_count":10,"forks_count":3,"subscribers_count":7,"default_branch":"dev","last_synced_at":"2025-04-21T22:22:31.839Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenVoiceOS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2021-12-01T14:45:06.000Z","updated_at":"2025-01-19T02:16:21.000Z","dependencies_parsed_at":"2023-05-28T15:15:13.212Z","dependency_job_id":"7c1bef7b-e288-4a75-b660-e94853967e2a","html_url":"https://github.com/OpenVoiceOS/ovos-gui","commit_stats":null,"previous_names":[],"tags_count":54,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-gui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-gui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-gui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-gui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenVoiceOS","download_url":"https://codeload.github.com/OpenVoiceOS/ovos-gui/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254496435,"owners_count":22080710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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-19T20:09:58.022Z","updated_at":"2025-05-16T08:33:08.588Z","avatar_url":"https://github.com/OpenVoiceOS.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OVOS GUI MessageBus\n\nGUI messagebus service, manages GUI state and implements the [gui protocol](./protocol.md)\n\nGUI clients (the application that actually draws the GUI) connect to this service\n\n\n# Configuration\n\nunder mycroft.conf\n\n```javascript\n{\n  \"gui\": {\n    // Override: SYSTEM (set by specific enclosures)\n    // Uncomment or add \"idle_display_skill\" to set initial homescreen\n    // \"idle_display_skill\": \"skill-ovos-homescreen.openvoiceos\",\n\n    // Extensions are plugins that provide additional GUI platform support for specific devices\n    // eg, if using ovos-shell you should set extension to \"ovos-gui-plugin-shell-companion\"\n    \"extension\": \"generic\",\n\n    // Default generic extension can provide homescreen functionality if enabled\n    \"generic\": {\n        \"homescreen_supported\": false\n    },\n    \n    // Optionally specify a default qt version for connected clients that don't report it\n    // NOTE: currently only QT5 clients exist\n    \"default_qt_version\": 5\n  },\n  \n  // The GUI messagebus websocket.  Once port is created per connected GUI\n  \"gui_websocket\": {\n    \"host\": \"0.0.0.0\",\n    \"base_port\": 18181,\n    \"route\": \"/gui\",\n    \"ssl\": false\n  }\n}\n```\n\n# Plugins\n\nplugins provide platform specific GUI functionality, such as determining when to show a homescreen or close a window\n\nyou should usually not need any of these unless instructed to install it from a GUI client application\n\n- https://github.com/OpenVoiceOS/ovos-gui-plugin-shell-companion\n- https://github.com/OpenVoiceOS/ovos-gui-plugin-mobile\n- https://github.com/OpenVoiceOS/ovos-gui-plugin-plasmoid\n- https://github.com/OpenVoiceOS/ovos-gui-plugin-bigscreen\n\n\n# Limitations\n\ngui resources files are populated under `~/.cache/mycrot/ovos-gui` by skills and other OVOS components and are expectd to be accessible by GUI client applications\n\nThis means GUI clients are expected to be running under the same machine or implement their own access to the resource files (resolving page names to uris is the client app responsibility)\n\n\u003e TODO: new repository with the removed GUI file server, serve files from `~/.cache/mycrot/ovos-gui` to be handled by client apps\n\nIn case of containers a shared volume should be mounted between ovos-gui, skills and gui client apps\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvoiceos%2Fovos-gui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenvoiceos%2Fovos-gui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvoiceos%2Fovos-gui/lists"}