Skip to content

Bennett-Wendorf/uplift-desk-controller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Stargazers Issues MIT License


Uplift Desk Controller

An unofficial Python library for control of Uplift standing desks over BLE.
Explore the docs »

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Contributing
  4. License
  5. Contact
  6. Acknowledgements

About The Project

I'll say it again. This is an UNOFFICIAL library for control of Uplift Desk standing desks over Bluetooth Low Energy (BLE). For this library to work, you must have the Uplift Bluetooth Adapter installed in a compatible desk. See their website for a better understanding of desk compatibility.

Unfortunately, like the app, this controller is a bit limited in what can be controlled. As of v1, controls include moving to standing preset, moving to sitting preset, raising the desk, and lowering the desk. The desk's bluetooth protocol does not allow using the presets on your desk's advanced keypad (if installed). In addition, I've done my best to reverse engineer the bluetooth service that Uplift uses (with the help of a few other open source projects. See Acknowledgements for details), but there are a few characteristics that are still unknown. If you'd like to help add more functionality, see the Contributing section below.

For now, it is also not possible to configure the desk settings such as name, presets, etc. through this controller. To use this project effectively, you'll want to first install the Uplift Desk app on iOS or Android and set up some of the basic settings (including sit and stand presets).

Note: When using this project, no other device can be connected to the desk or it will be undiscoverable. This means that the Uplift Desk app needs to be either disconnected or closed for this application to work.

Built With

This project is written in Python using the following libraries:

Each of their respective licenses apply to their binaries and their use in this project. Their licenses can be found at the links above.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

If you find an issue in existing code, feel free to use the above procedure to generate a change, or open an issue for me to fix it.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Bennett Wendorf - Website - bennett@bennettwendorf.dev

Project Link: https://pypi.org/project/uplift-desk

Acknowledgements

About

An unofficial Python library for control of Uplift standing desks over BLE.

Topics

Resources

License

Stars

Watchers

Forks

Languages