Skip to main content

CLI tool to control lower energy actuator systems (office desks) through bluetooth.

Project description

# Bluedesk

Connects to a low energy actuator system via bluetooth and allows remote control via command line or internal managed interface.

## Supported and Tested Desks

> Other devices may also work.

# Requirements

## Prepare bluepy system dependencies:

The code needs an executable bluepy-helper to be compiled from C source. This is done automatically if you use the recommended pip installation method (see below). Otherwise, you can rebuild it using the Makefile in the bluepy directory.

To install the current released version, on most Debian-based systems:

$ sudo apt-get install python-pip libglib2.0-dev

On Fedora do:

$ sudo dnf install python-pip glib2-devel

For Python 3, you may need to use pip3:

$ sudo apt-get install python3-pip libglib2.0-dev

# Installation

sudo pip install bluedesk

> To use the command without sudo run this command:

sudo setcap ‘cap_net_raw,cap_net_admin+eip’ /usr/local/lib/(python3.7 OR your version)/dist-packages/bluepy/bluepy-helper

> where python3.7 is relative to your current used version.

# CLI Usage

## HELP

$ bluedesk -h

usage: bluedesk [-h] {connect} …

Controls lower energy actuator systems (office desks) via bluetooth.

positional arguments: {connect}

optional arguments: -h, –help show this help message and exit

## Connect

$ bluedesk connect

Scanning … [?] Choice device: Desk 8721 [e4:d1:a7:xx:xx:xx] > Desk 8721 [e4:d1:a7:xx:xx:xx] None [02:c3:85:xx:xx:xx]

Device: e4:d1:a7:xx:xx:xx connected successfully.

> Note: After the desk is connected, the CLI tool should provide additional actions:

usage: bluedesk [-h] {connect,disconnect,up,down,move} …

Controls lower energy actuator systems (office desks) via bluetooth.

positional arguments: {connect,disconnect,up,down,move}

optional arguments: -h, –help show this help message and exit

## Move up and down

$ bluedesk up

OR

$ bluedesk down

## Move to a specific position

$ bluedesk move –to 50

> This command will move the desk to the 50% height

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Bluedesk-1.9.tar.gz (4.7 kB view details)

Uploaded Source

File details

Details for the file Bluedesk-1.9.tar.gz.

File metadata

  • Download URL: Bluedesk-1.9.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.5.1 requests-toolbelt/0.9.1 tqdm/4.37.0 CPython/3.7.5

File hashes

Hashes for Bluedesk-1.9.tar.gz
Algorithm Hash digest
SHA256 08cd257fda40440fb88397622afc4962d0f080bc32aaebb21c480a32538105da
MD5 979e7f94320a12be6d6d50907fdfd04f
BLAKE2b-256 1e3de142097d1d76addc695c1d4ad229cfffcbe8799c0677899d5a6ad9922977

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page