Skip to content
/ idasen Public
forked from newAM/idasen

Python API and CLI for the ikea IDÅSEN desk.

License

Notifications You must be signed in to change notification settings

emansom/idasen

 
 

Repository files navigation

idasen

PyPi Version Build Status Documentation Status Black

The IDÅSEN is an electric sitting standing desk with a Linak controller sold by ikea.

The position of the desk can controlled by a physical switch on the desk or via bluetooth using an phone app.

This is a command line interface written in python to control the Idasen via bluetooth from a desktop computer.

Set Up

Prerequisites

The desk should be connected to the computer.

Install

python3 -m pip install --upgrade idasen

Configuration

Configuration that is not expected to change frequently can be provided via a YAML configuration file located at ~/.config/idasen/idasen.yaml.

You can use this command to initialize a new configuartion file:

idasen init
mac_address: AA:AA:AA:AA:AA:AA
positions:
    sit: 0.75
    stand: 1.1

Configuartion options:

  • mac_address - The MAC address of the desk. This is required.
  • positions - A dictionary of positions with values of desk height from the floor in meters, sit and stand are provided as examples.

The program will try to discover the device address. The device needs to be in 'discover' mode for this to work.

If discovery fails the device MAC addresses can be found using blueoothctl and bluetooth adapter names can be found with hcitool dev on linux.

If the device has not yet been paired, this can be accomplished with:

idasen pair

Again, the device will need to be in 'discover' mode for this to work.

Usage

Command Line

To print the current desk height:

idasen height

To monitor for changes to height:

idasen monitor

To save the current height as the sitting position:

idasen save sit

To delete the saved sitting position:

idasen delete sit

Assuming the config file is populated to move the desk to sitting position:

idasen sit

systemd user timer

It can be useful to setup a systemd user timer to trigger idasen [sit|stand] periodically.

See the contrib/systemd folder for examples.

Community

Related projects and packaging:

About

Python API and CLI for the ikea IDÅSEN desk.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%