Autoremote

Licence Gem Version Dependency Status Gem Downloads Code Climate Inline docs

A library that makes it easier to interact with your other autoremote devices.
This project incudes both a library and an executable that uses the library.

Devices are saved with sqlite3 in ~/.autoremote/devices.db

If you don't know how to get your personal key follow this link
Since version 0.1.0 you can use the goo.gl url instead of the key when adding devices.

Installation

$ gem install autoremote

Usage

Executable

$ autoremote add NAME KEY|URL        Save device
$ autoremote remove NAME             Removes device
$ autoremote delete NAME             Same as above
$ autoremote list [WITHKEY]          Lists all devices. Displays keys if WITHKEY equals to true, t, yes, y, ja, j or 1
$ autoremote message NAME MESSAGE    Send a message to a device
$ autoremote register NAME HOST      Register this computer to the device

Library

require 'autoremote'

# Adding devices can be done either with the key
AutoRemote.add_device( name, "A VERY LONG STRING OF CHARACTERS" )
# Or with your 'goo.gl' address
AutoRemote.add_device( name, "http://goo.gl/XXXXXX" )

# Removes a device
AutoRemote.remove_device( name )

# List all saved devices
AutoRemote.list

# Get a specific device
AutoRemote.get_device( name )

# Send a message to a device
# The parameter device can either be a Device object or the name of the device
AutoRemote.send_message( device, message )

# Register on the device.
# This has the same effect as following the guide on http://joaoapps.com/autoremote/linux/)
# device can either be a Device object or the name of the device
# host can be either a hostname or ip-address, but they have to be public (i.e. reachable from the internet)
AutoRemote.register_on_device( device, host )

Contributing

  1. Fork it ( https://github.com/AltonV/autoremote/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request