# DashBtn

DashBtn is a Docker service that intercepts Amazon Dash Button presses and triggers configurable home-automation tasks, letting homelab users repurpose unused buttons as wireless remote controls for self-hosted devices. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1562/dashbtn

## Description

DashBtn is a Docker service that intercepts Amazon Dash Button presses and triggers configurable home-automation tasks, letting homelab users repurpose unused buttons as wireless remote controls for self-hosted devices and services.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

24/100 (Low), based on 4 of 4 factors.
- Maintained: 0 (last commit 2417 days ago)
- Popular: 19 (8 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 85 (512 MB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/ninthwalker/dashbtn/
- Unraid: https://ca.unraid.net/apps/dashbtn-1ida4pi082p50y?q=DashBtn
- GitHub: https://github.com/ninthwalker/dashbtn

## Common questions

### Where should I stop when setting up a Dash Button in the Amazon app?

Configure the button in the Amazon app, but stop before selecting an item to purchase.

### How do I discover a Dash Button's MAC address?

Run docker exec -it dashbtn sh and then /config/dashbtn.py discover. Press the button, wait 10 seconds, stop with ctrl+c, and check dashbtn.log in the appdata folder.

### Which file do I edit to map a button to an action?

Edit dashbtn.py in the appdata directory to add the button's MAC address, a friendly name, and the script to execute.

### When do DashBtn configuration changes take effect?

Restart the Docker container after editing dashbtn.py or adding the automation scripts.

---
Source: Our Local Host (https://ourlocalhost.com/app/1562/dashbtn), the self-hosted and open-source app directory.
