Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

ovos-PHAL-plugin-system

This PHAL plugin gives OpenVoiceOS commands to control the host system. It handles NTP sync, SSH, reboot, shutdown, factory reset, and language configuration through bus events. The plugin does not yet define a dbus interface.

Install

pip install ovos-PHAL-plugin-system

Config

This plugin can run as an admin plugin. An admin plugin runs as root. To enable it, add this to mycroft.conf:

{
"PHAL": {
    "admin": {
        "ovos-PHAL-plugin-system": {"enabled": true}
    }
}
}

If you omit this config, the plugin runs as the regular user. In that case, you need a polkit policy that allows systemctl without sudo. This policy is not yet implemented.

Usage

The plugin listens for these bus events and reacts to each one:

self.bus.on("system.ntp.sync", self.handle_ntp_sync_request)
self.bus.on("system.ssh.status", self.handle_ssh_status)
self.bus.on("system.ssh.enable", self.handle_ssh_enable_request)
self.bus.on("system.ssh.disable", self.handle_ssh_disable_request)
self.bus.on("system.reboot", self.handle_reboot_request)
self.bus.on("system.shutdown", self.handle_shutdown_request)
self.bus.on("system.factory.reset", self.handle_factory_reset_request)
self.bus.on("system.factory.reset.register", self.handle_reset_register)
self.bus.on("system.configure.language", self.handle_configure_language_request)
self.bus.on("system.mycroft.service.restart", self.handle_mycroft_restart_request)

Related projects

License

Apache-2.0

Metadata

Release files for ovos-PHAL-plugin-system 1.3.8a3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ovos-PHAL-plugin-system 1.3.8a3
File Size Uploaded
ovos_phal_plugin_system-1.3.8a3.tar.gz 11.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ovos-PHAL-plugin-system 1.3.8a3
File Interpreter ABI Platform
ovos_phal_plugin_system-1.3.8a3-py3-none-any.whl Python 3 none any Details

Total release size: 21.9 kB

Release files / ovos_phal_plugin_system-1.3.8a3.tar.gz

Download URL ovos_phal_plugin_system-1.3.8a3.tar.gz
Size 11.3 kB
Tags Source
SHA-256 checksum
How to use checksums
63d8e0cf6300e0c1d1d250abfced4761922a39ffc5cf8fce42059ff242127b2b
BLAKE2b-256 checksum
How to use checksums
f7c918957ba5210ab563128848f495eab83525c14060143fe92287cbce4315d8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / ovos_phal_plugin_system-1.3.8a3-py3-none-any.whl

Download URL ovos_phal_plugin_system-1.3.8a3-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f3ab4c80f8df187da0ead33e5cda4ac13620ca4001318c036bdabbe27b59a794
BLAKE2b-256 checksum
How to use checksums
cf70e939e827762772b3f28bdd305c57fc64b70ddc25b36d9d2eb5e95711abbf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

1.3.8a3 This release

2 release files

1.3.4

2 release files

1.3.3

2 release files

1.3.2

2 release files

1.2.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.1.0

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page