Introduction
CommandRun is a browser extension to allow executing native commands.
CommandRun is typically used in Kiosk environments where it's desired to run a restricted set of commands from a locked-down browser. These commands may include reboot, or start a flash drive.
The list of websites and commands are configurable.
Configuration
User Preferences
The user can override the default list using normal extension preferences in about:addons.
Set the allowed sites, and the allowed commands.
Administrator Policies
The administrator can override the policies in policies.json
{
"policies": {
"3rdparty": {
"Extensions": {
"commandrun@banapple.de": {
"allowed_commands": [ "/usr/bin/maybe" ],
"permitted_sites": [ "example.net", "example.com" ]
}
}
}
}
}
Build
You can build CommandRun from this source by running 'make all'. To build CommandRun with different defaults, try:
Requirements for Compilation
sed. Basically sed is used as a precompiler for macro expansion.
Suggested (but not required) for Compilation
- pylint
- closure-compiler
These tools are used to do python and javascript checking, so they are suggested when modifying the source. They are not required to build.
Install
User
The extension can be installed per user using the browser add-on preferences.
If you choose to do this, you'll have to install the App manifest in ~/.mozilla/native-messaging-hosts/ and edit commandrun.json to point to the path for the binary yourself.
System
You can install the extension system-wide. This will also install the native app.
History
The XUL add-on was written by Achim Abeling achimabeling@web.de
For more information, go to https://github.com/berenddeschouwer/commandrun