https://github.com/soft/buttons

buttons is a small progressive web app that allows users to execute commands from a predetermined set on the server.
https://github.com/soft/buttons

home-automation mobile-first pwa

Last synced: about 2 months ago
JSON representation

buttons is a small progressive web app that allows users to execute commands from a predetermined set on the server.

• Host: GitHub
• URL: https://github.com/soft/buttons
• Owner: Soft
• License: mit
• Created: 2020-09-20T09:41:55.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-09-20T16:26:29.000Z (over 5 years ago)
• Last Synced: 2025-01-28T04:29:09.425Z (over 1 year ago)
• Topics: home-automation, mobile-first, pwa
• Language: Rust
• Homepage:
• Size: 37.1 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# buttons

[![Build Status](https://travis-ci.org/Soft/buttons.svg?branch=master)](https://travis-ci.org/Soft/buttons)

[![GitHub release](https://img.shields.io/github/release/Soft/buttons.svg)](https://github.com/Soft/buttons/releases)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)



`buttons` is a small progressive web app that allows users to execute commands

from a predetermined set on the server. `buttons` exposes a simple mobile-first

web UI with a button for each command. Tapping a button will cause the

associated command to be executed.

⚠ **Important** ⚠: You should obviously think carefully about what commands are

safe to expose. While the set of exposed commands is fully static and there is

no possibility for users to pass additional input to them, you should still

consider placing limits on who can access the web server.

## Installation

Pre-built binaries can be downloaded from [GitHub

Releases](https://github.com/Soft/buttons/releases). These should work on any

64-bit Linux system.

### Usage

```

buttons 0.1.0

button service

USAGE:

    buttons 

FLAGS:

    -h, --help       Prints help information

    -V, --version    Prints version information

ARGS:

        Configuration file path

```

## Configuration

``` toml

address = "0.0.0.0:8080"

title = "Actions"

[[buttons]]

label = "Hello World"

command = "echo 'Hello World'"

[[buttons]]

label = "Toggle music"

command = "playerctl play-pause"

```