olback / perif

Application to check battery, control lightning and sidetone on your peripherals!

Perif

An application to control lightning, sidetone and check battery status on your peripherals.

OS/Arch	Status
Linux/amd64

Install

Before you install Perif, make sure you have installed:

• meson
• ninja
• Rust (cargo)

If you do not want/need support for bluetooth devices, you can choose to not include the bluetooth udev rules by passing -Dbluetooth=false to meson build.

git clone https://github.com/olback/perif && cd perif
cargo build --release --all
./target/release/gen-rules
meson _mbuild
sudo ninja -C _mbuild install

Uninstall

sudo ninja -C _mbuild uninstall

Does your device not show up?

If your device is supported, but does not show up? Please open an issue, make sure to include make, model, vid and pid. If your device is not yet supported by Perif, you can add it by following the steps here.

Inspiration

This project is inspired by Sapd/HeadsetControl.

perif's Issues

Remove obsolete settings

Merge udev rules to two files

1. List of all supported devices
2. "Catch-all" for bluetooth devices

Add devices from sapd/HeadsetControl

Make packages

• Debian/Ubuntu/... (.deb)
• Arch (PKGBUILD)

Use hidraw instead of libusb

• Update feature for hidapi in libperif
• Update udev rules

CI

Low battery notifiaction