systemd units

OVOS runs as user services of the ovos user (lingering enabled, so they start at boot without login). Hardware/root concerns run as system services.

User units (systemctl --user …)

Unit	Role
ovos.service	umbrella target for the stack
ovos-messagebus.service	the message bus every component connects to
ovos-skills.service	skill loading and intent handling
ovos-audio.service	TTS playback and audio output
ovos-listener.service	microphone, wake word, STT
ovos-phal.service	platform/hardware abstraction (user side)
ovos-gui.service	GUI message bus (display optional)
ovos-ggwave.service	data-over-sound pairing
ovos-yaml-editor.service, ovos-skill-settings-ui.service	web config UIs
gmrender.service	DLNA renderer
ovos-librespot.service, ovos-spotifyd.service	Spotify (disabled by default)

System units (sudo systemctl …)

Unit	Role
ovos-admin-phal.service	root-level PHAL plugins (system python)
i2csound.service	I²C audio HAT detection at boot
autoconfigure_soundcard.service	default audio output selection
splashscreen.service	boot splash
ovos-reboot-signal.service, ovos-shutdown-signal.service	emit bus messages on reboot/shutdown

Handy commands

systemctl --user status ovos.service        # stack health at a glance
journalctl --user -u ovos-skills -e         # a service's log
systemctl --user restart ovos-listener      # after config changes