Skip to main content
Help us improve Python packaging – donate today!

Client for the service

Project Description

This is the official client.

ondevice allows you to connect to all your devices from pretty much anywhere.


You can install the client via python’s pip command:

sudo pip3 install ondevice

Important: At the time of this writing ondevice connect doesn’t fully work in python2, so make sure you install ondevice in python3 (e.g. using the pip3 command (or similar).

Also make sure to install it as root.

After that you should be able to use it (note that you need an account on though).

$ ondevice help
USAGE: ondevice <command> [args]

- Device commands:
        Run the ondevice daemon
    service [add/rm] [args...]
        Manages services

- Client commands:
    connect <module> <dev> [svcName]
        Connects to a service on the specified device (shorthand: `:<module>`)
    dev <devName> props/set/rm [args]
        Fetch/Manage a device's information
        Displays detailed information on your devices

- Other commands:
    help [cmd]
        lists available commands or prints detailed help for one
        Lists installed modules
        Set up the API keys for communicating with the service

Key setup

After you’ve set up your account, you have to set up your API keys:

$ ondevice setup
User: ondevUser
API key: **********
INFO:root:Updated client key (user: 'ondevUser')

After that you’re good to go

Running the device daemon

simply run ondevice daemon

List your devices (on the client)

$ ondevice list|head
ID                   State      IP              Version    Name
ondevUser.abcdefg    offline       0.1dev11   Raspberry Pi
ondevUser.foobar123  online        0.1dev11   Home router

Connect to a device

$ ondevice ssh manuel@ondevUser.abcdefghi
manuel@ondevice:ondevUser.abcdefghi's password:
Linux raspberrypi 3.10.33+ #654 PREEMPT Fri Mar 7 16:32:08 GMT 2014 armv6l

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Last login: Mon Jul 25 17:08:43 2016 from localhost
manuel@raspberrypi ~ $

Device properties

For automation purposes, you can set custom properties for your devices.

$ ondevice device abcdefghi set foo=bar abc=123

$ ondevice device abcdefghi rm abc

$ ondevice device abcdefghi props

$ ondevice device abcdefghi set hello=world

Each invocation returns the resulting property list; You can query the list using ondevice device <devId> props

There’s currently one special property:

  • :title: set the device’s description (will be shown online and in ondevice list)


  • python (with pip; the full functionality is currently only available on Python 3, but the device side should work on python2 as well)
  • see requirements.txt for the actual list of python modules

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
ondevice-0.3.1.tar.gz (26.6 kB) Copy SHA256 hash SHA256 Source None Nov 16, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page