Hack your Amazon Dash to run what you want.
Latest commit 489856d Nov 13, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Issue and execution help. Aug 1, 2018
amazon_dash Fix Typo Nov 12, 2018
docs Added community link. Sep 29, 2018
images Amazon-dash v1.3.0 release image. Sep 23, 2018
scripts Issue #29: version info Feb 21, 2018
.bumpversion.cfg Bump version: 1.3.0 → 1.3.1 Oct 21, 2018
.codeclimate.yml Codeclimate. Nov 17, 2016
.dockerignore Initial commit Aug 20, 2018
.gitignore Schema validation. Dec 10, 2017
.travis.yml Issue #59: Check Python 3.7 support (Python 3.7 unsupported on Travis). Jul 17, 2018
AUTHORS.rst Added Aaron Bach to AUTHORS file (PR #77). Aug 21, 2018
CONTRIBUTING.rst Added Python 3.7 support. Jul 18, 2018
Dockerfile Dockerfile to python:3.7-alpine Aug 23, 2018
HISTORY.rst Amazon-dash v2.0.0 disclaimer. Sep 23, 2018
LICENSE.txt New setup.py Nov 17, 2016
MANIFEST.in MANIFEST amazon_dash/install *.yml *.service Feb 11, 2018
Makefile Docs files and extra files. Jan 27, 2018
README.rst Develop travis shields. Oct 31, 2018
amazon-dash.png Amazon-dash v1.3.0 release image. Sep 23, 2018
common-requirements.txt Systemd install Feb 2, 2018
py2-requirements.txt ExecuteCmd tests Mar 2, 2018
py3-requirements.txt Update scapy Jun 4, 2018
requirements-dev.txt Fixed pyfakefs version Mar 8, 2018
setup.cfg Docs files and extra files. Jan 27, 2018
setup.py Issue #65: Older versions of setuptools do not support markers Jul 19, 2018
tox.ini Issue #59: Check Python 3.7 support Jul 17, 2018
travis_pypi_setup.py Docs files and extra files. Jan 27, 2018

README.rst

https://raw.githubusercontent.com/Nekmo/amazon-dash/master/amazon-dash.png


Latest Travis CI build status Latest PyPI version Python versions Code Climate Test coverage Requirements Status

DEVELOPMENT BRANCH: The current branch is a development version. Go to the stable release by clicking on the master branch.

Python Amazon Dash

Hack your Amazon Dash to run what you want. Without welders. For the entire family.

This program written in Python runs in daemon mode waiting for someone in the same network to press a configured Amazon Dash button. It is not necessary to know programming to use this program. Amazon-Dash executes commands by command line, calls a url and more. This program works well on a Raspberry PI or on computers with few resources.

  1. Install Amazon Dash:
$ sudo pip install amazon-dash  # and after:
$ sudo python -m amazon_dash.install

Also available on AUR. See other installation methods in the documentation.

  1. Use discovery mode to know the mac of your Dash (Run the program, and then press any button):
$ sudo amazon-dash discovery
  1. Edit config file (/etc/amazon-dash.yml):
# amazon-dash.yml
# ---------------
settings:
  delay: 10
devices:
  0C:47:C9:98:4A:12: # Command example
    name: Hero
    user: nekmo
    cmd: spotify
  AC:63:BE:75:1B:6F: # SSH example
    name: Tassimo
    cmd: door --open
    ssh: 192.168.1.23:2222
  AC:63:BE:67:B2:F1: # Url Webhook example
    name: Kit Kat
    url: 'http://domain.com/path/to/webhook'
    method: post
    content-type: json
    body: '{"mac": "AC:63:BE:67:B2:F1", "action": "toggleLight"}'
    confirmation: send-tg
  40:B4:CD:67:A2:E1: # Home Assistant example
    name: Fairy
    homeassistant: hassio.local
    event: toggle_kitchen_light
  18:74:2E:87:01:F2: # OpenHAB example
    name: Doritos
    openhab: 192.168.1.140
    item: open_door
    state: "ON"
    confirmation: send-pb
  44:65:0D:75:A7:B2: # IFTTT example
    name: Pompadour
    ifttt: cdxxx-_gEJ3wdU04yyyzzz
    event: pompadour_button
    data: {"value1": "Pompadour button"}
confirmations:
  send-tg:
    service: telegram
    token: '402642618:QwGDgiKE3LqdkNAtBkq0UEeBoDdpZYw8b4h'
    to: 24291592
    is_default: false
  send-pb:
    service: pushbullet
    token: 'o.BbbPYjJizbPr2gSWgXGmqNTt6T9Rew51'
    is_default: false

UPGRADE from previous versions

The following execution methods are supported with your Amazon Dash button with this program:

https://goo.gl/VqgMZJ https://goo.gl/a6TS7X https://goo.gl/zrjisq
System command Call url Homeassistant
https://goo.gl/Cq4bYC https://goo.gl/L7ng8k  
OpenHAB IFTTT  

Amazon-dash also allows you to send a confirmation after pressing a button. You will also receive a message in case of failure. Telegram and Pushbullet are supported.

For more information see the documentation of the configuration file.

  1. Run the daemon:

If you use a Systemd system (Debian 8+, Fedora 15+, Ubuntu 15.04+, Arch Linux 2012+, OpenSUSE 12.1+, and more) execute:

$ sudo systemctl start amazon-dash

To run Amazon-dash at startup:

$ sudo systemctl enable amazon-dash

To run Amazon-dash manually look at the documentation.

  1. Avoid making a purchase by pressing the button

This program detects when your button connects to the network to execute actions, but does not prevent the ordering. The easiest way to avoid making a purchase is to reconfigure the button using the Amazon instructions (by pressing the button for 5 seconds) but skipping the last configuration step (do not choose which product you want to associate with the button). If Amazon does not know what product you want, they can not charge anything on your credit card.

There are two more methods in the documentation.

Docker

Using Amazon Dash within docker is easy! First, pull the Docker image:

$ docker pull nekmo/amazon-dash:latest

Then, create a container and run Amazon Dash itself:

$ docker run -it --network=host \
             -v </full/path/path/to/amazon-dash.yml>:/config/amazon-dash.yml \
             nekmo/amazon-dash:latest \
             amazon-dash run --ignore-perms --root-allowed \
                             --config /config/amazon-dash.yml

Join the community

Do you need ideas on how to use Amazon Dash? See what the community does with this project. Some examples:

See all the examples in the community.