Skip to content

Bluetooth

signals

device-added: (address: string)
device-removed: (address: string)

properties

enabled: boolean: writable
devices: Device[]
connected-devices: Device[]

methods

toggle: () => void
getDevice: (address: string) => Device

Device

properties

address: string
battery-level: number
battery-percentage: number
connected: boolean
icon-name: string
alias: string
name: string
trusted: boolean
paired: boolean

methods

setConnection: (connect: boolean) => void

Example Widgets

const bluetooth = await Service.import('bluetooth')

const connectedList = Widget.Box({
    setup: self => self.hook(bluetooth, self => {
        self.children = bluetooth.connected_devices
            .map(({ icon_name, name }) => Widget.Box([
                Widget.Icon(icon_name + '-symbolic'),
                Widget.Label(name),
            ]));

        self.visible = bluetooth.connected_devices.length > 0;
    }, 'notify::connected-devices'),
})

const indicator = Widget.Icon({
    icon: bluetooth.bind('enabled').as(on =>
        `bluetooth-${on ? 'active' : 'disabled'}-symbolic`),
})