https://github.com/andgineer/docker-amazon-dash-button-hack

Amazon Dash Button hack in Docker for Synology
https://github.com/andgineer/docker-amazon-dash-button-hack

amazon-dash-button docker google-sheets python

Last synced: about 2 months ago
JSON representation

Amazon Dash Button hack in Docker for Synology

• Host: GitHub
• URL: https://github.com/andgineer/docker-amazon-dash-button-hack
• Owner: andgineer
• Created: 2017-04-05T07:18:49.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2025-01-15T05:25:16.000Z (3 months ago)
• Last Synced: 2025-01-15T07:24:43.046Z (3 months ago)
• Topics: amazon-dash-button, docker, google-sheets, python
• Language: Python
• Homepage: http://masterandrey.com/posts/en/amazon_dash_button/
• Size: 3.54 MB
• Stars: 11
• Watchers: 3
• Forks: 8
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![Build Status](https://github.com/andgineer/docker-amazon-dash-button-hack/workflows/ci/badge.svg)](https://github.com/andgineer/docker-amazon-dash-button-hack/actions)

[![Coverage](https://raw.githubusercontent.com/andgineer/docker-amazon-dash-button-hack/python-coverage-comment-action-data/badge.svg)](https://htmlpreview.github.io/?https://github.com/andgineer/docker-amazon-dash-button-hack/blob/python-coverage-comment-action-data/htmlcov/index.html)

[![Docker Automated build](https://img.shields.io/docker/image-size/andgineer/amazon-dash-button-hack)](https://hub.docker.com/r/andgineer/amazon-dash-button-hack)

This is a [Docker Hub container](https://hub.docker.com/r/andgineer/amazon-dash-button-hack)

for the [Amazon Dash Button hack](https://sorokin.engineer/posts/en/amazon_dash_button_hack.html).

It sniffs the network to intercept Amazon Button communications with Amazon,

thereby detecting button presses.

It can write to Google Sheets, Google Calendar and fire event in [IFTTT](https://ifttt.com).

I use it on my [Synology](https://www.synology.com) for

[IoT calendar](https://sorokin.engineer/posts/en/iot_calendar_synology.html).

To run the container on Linux:

```

docker run \

    --net host \

    -it \

    --rm \

    -v $PWD/../amazon-dash-private:/amazon-dash-private:ro \

    andgineer/amazon-dash-button-hack

```

In folder `../amazone-dash-private` you should have:

* settings [`settings.json`](https://andgineer.github.io/docker-amazon-dash-button-hack/settings/)

* buttons list `buttons.json`

* `amazon-dash-hack.json` with google API credentials [Google Sheets](https://console.developers.google.com/start/api?id=sheets.googleapis.com), [Google Calendar](https://console.developers.google.com/start/api?id=calendar)

* `ifttt-key.json` with [Maker Webhook key](https://ifttt.com/services/maker_webhooks/settings)

[Examples of this files](https://github.com/andgineer/docker-amazon-dash-button-hack/tree/master/amazon-dash-private).

See details in [User manual](https://sorokin.engineer/posts/en/amazon_dash_button_hack_install.html).

## MacOS and Windows

You cannot sniff network from Docker containers running on MacOS and Windows because they do not run

docker demon natively but use Virtual Machine to run it.

So to debug on MacOS and Windows:

    . ./activate.sh

    sudo python src/amazon_dash.py

## Developers

We use `collections.abc` so min Python3.10

[API docs](https://andgineer.github.io/docker-amazon-dash-button-hack/docstrings/)

# Scripts

To see list of scripts:

    make help

## Coverage report

* [Codecov](https://app.codecov.io/gh/andgineer/docker-amazon-dash-button-hack/tree/master/src)

* [Coveralls](https://coveralls.io/github/andgineer/docker-amazon-dash-button-hack)