ovos-PHAL

ovos-PHAL is the Plugin-based Hardware Abstraction Layer for OpenVoiceOS. It runs as a service that loads PHAL plugins based on the environment, either from known configuration or from device fingerprinting. Each plugin connects a specific piece of hardware or a specific system feature to the OVOS messagebus.

A PHAL plugin can provide a hardware integration, such as a respeaker, mk1, or mk2 device. It can also provide a system integration, such as a network manager or the OVOS shell.

Install

pip install ovos_PHAL

Extra plugin sets install with the package:

pip install ovos_PHAL[linux]   # alsa, system, network-manager, wallpaper-manager
pip install ovos_PHAL[mac]     # ovos-phal-plugin-mac
pip install ovos_PHAL[mk1]     # ovos-PHAL-plugin-mk1
pip install ovos_PHAL[mk2]     # ovos-PHAL-plugin-hotkeys
pip install ovos_PHAL[mk2dev]  # ovos-PHAL-plugin-mk2-fan-control
pip install ovos_PHAL[extras]  # ipgeo, connectivity-events, oauth

Usage

Start the PHAL service from the command line:

ovos_PHAL

This reads the PHAL section of mycroft.conf and starts the plugins listed there:

{
  "PHAL": {
    "ovos-PHAL-plugin-display-manager-ipc": {"enabled": true},
    "ovos-PHAL-plugin-mk1": {"enabled": true}
  }
}

To run PHAL from Python, use ovos_PHAL.service.PHAL:

from ovos_PHAL.service import PHAL
from ovos_utils import wait_for_exit_signal

phal = PHAL()
phal.start()
wait_for_exit_signal()
phal.shutdown()

An admin variant that loads root-only plugins runs with the ovos_PHAL_admin command.

Related projects

OpenVoiceOS/ovos-PHAL-plugin-alsa: ALSA audio control
OpenVoiceOS/ovos-PHAL-plugin-system: system-level actions (reboot, shutdown, factory reset)
OpenVoiceOS/ovos-PHAL-plugin-network-manager: NetworkManager integration
OpenVoiceOS/ovos-PHAL-plugin-wallpaper-manager: wallpaper management for homescreens
OpenVoiceOS/ovos-PHAL-plugin-oauth: OAuth handling over the messagebus
OpenVoiceOS/ovos-PHAL-plugin-connectivity-events: connectivity change events
OpenVoiceOS/ovos-PHAL-plugin-ipgeo: IP-based geolocation
OpenVoiceOS/ovos-PHAL-plugin-mk1: mk1 device support
OpenVoiceOS/ovos-PHAL-plugin-hotkeys: key press to bus event mapping

License

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ovos_phal-0.3.0a1.tar.gz (9.9 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ovos_phal-0.3.0a1-py3-none-any.whl (11.1 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file ovos_phal-0.3.0a1.tar.gz.

File metadata

Download URL: ovos_phal-0.3.0a1.tar.gz
Upload date: Aug 11, 2026
Size: 9.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ovos_phal-0.3.0a1.tar.gz
Algorithm	Hash digest
SHA256	`c06220e2665bc95c5bb6acb1ff3a93de096a43dae48dabc3068af4ae914365f0`
MD5	`0d349c0b28c27e7724f8ae558a79da6f`
BLAKE2b-256	`4fcc585cb9c695734759b6dad5f21faf266b5c4f3216f11c634c6056c4561c5b`

See more details on using hashes here.

File details

Details for the file ovos_phal-0.3.0a1-py3-none-any.whl.

File metadata

Download URL: ovos_phal-0.3.0a1-py3-none-any.whl
Upload date: Aug 11, 2026
Size: 11.1 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ovos_phal-0.3.0a1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`cfa3cb3054045b64c377d08f86dc9248273e02ed06ee42d8da66bea60ce56194`
MD5	`8458dece4a058c024737ba21eab92535`
BLAKE2b-256	`60dc3fa7a554392c58bb0d813be0cf609cf0c1edff7c9925014a3baf332ca4c5`