A performant remote command execution interface for the internet of things.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
assets
commands
html
static
.gitignore
LICENSE
README.md
config.json
pioneer.go

README.md

Pioneer

GitHub stars

Problem

Building your own IoT devices is fun and often helps you solve real world problems. Controlling them often involves writing small applications and scripts that execute certain functions. That's all great, but at some point you probably want to get away from using a command line interface to call all your amazing Python-/Bash-/Whatever-Scripts.

Meet Pioneer

A simple, reactive and secure web interface to call command line functions from everywhere, simple and intuitive!

Features

  • Single configuration file
  • Clean, modern user interface
  • User accounts
  • SSL encryption out of the box
  • One-time and toggle commands supported
  • Schedule your commands to run at certain times
  • Low performance requirements, runs perfectly on a Raspberry Pi
  • Batteries included, single binary deploy (plus config.json)!

Installation

Download the version matching your device/system below, create a file called config.json in the same directory (tip: copy and paste the example config from this repository to get the basic structure) and execute the binary! For best results, set it up so that the binary is executed at startup.

Alternatively, if you have a Go compiler installed you can just call go get -v -u github.com/PiMaker/Pioneer

Download

System type
darwin (32 bit)
darwin (64 bit)
linux (32 bit)
linux (64 bit)
linux (ARM v5)
linux (ARM v6) (Raspberry Pi 1)
linux (ARM v7) (Raspberry Pi 2+)
linux (ARM64)
linux (MISP64)
linux (MIPS64le)
Windows (32 bit)
Windows (64 bit)

Thanks XGo!

Configuration

Look at the file config.json in this repository's root folder for documentation and an example.

Screenshots

screenshot2 screenshot1

Note: To get the amazing htop background image, you have to use the live background feature. Don't ask me how exactly I set it up though, this was one of those "it's almost midnight I want to do something fun" ideas, it quickly turned into a garbled mess though (as one would expect).

TODO

  • Documentation
  • Testing

Note that this was started as a small side project, so the code is rather messy right now. It does work though, I've never had it crash on me after about half a year of continuous usage on a Raspberry Pi 2.

License

This project is licensed under the MIT License. Look at LICENSE for further details.