Skip to content

A Home Assistant integration to turn your vacuum into an audio player.

License

Notifications You must be signed in to change notification settings

definitio/ha-sox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SoX component for Home Assistant

hacs_badge

A Home Assistant integration to turn your vacuum into an audio player.

Installation

  • Install firmware for your Xiaomi (Roborock) vacuum - use pre-build firmware or build it yourself with --enable-sound-server option.
  • Install the integration to Home Assistant: use HACS or copy the contents of custom_components/sox/ to <your config dir>/custom_components/sox/.

Configuration

  • Add the following lines to your Home Assistant's configuration.yaml file:
media_player:
  - platform: sox
    name: sox
    host: <server hostname or IP address>
    port: 7777
  • Restart Home Assistant

Configuration Options

  • name: (string) (Optional)

    This is the name you would like to give to SoX media player.

    Default value: sox

  • host: (string) (Required)

    This is the hostname, domain name or IP address of your vacuum.

  • port: (string) (Optional)

    This is the port that the SoX player on your vacuum can be reached at.

    Default value: 7777

Useful links