Skip to content

Commit

Permalink
Added installation documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
mscharl committed Jul 30, 2019
1 parent 31c23b7 commit cfe1610
Show file tree
Hide file tree
Showing 2 changed files with 30 additions and 1 deletion.
31 changes: 30 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,31 @@
# EdgeRouter Throughput
> A MagicMirror² Module to show the Interface throughput of an Ubiquity EdgeRouter

A MagicMirror² Module to show the interface throughput of an Ubiquity EdgeRouter.

The Module uses SSH to connect to the router and reads the network throughput from `/sbin/ifstat`.

![Example of the Module](assets/MMM-edgerouter.gif)

## Installation

1. Clone the Repo into your MagicMirror modules folder `git clone git@github.com:mscharl/MMM-edgerouter-throughput.git`
2. Install some node dependencies `cd MMM-edgerouter-throughput && npm install --production`
3. [Configure](#configuration) and enjoy

## Configuration

| Property | Type | Required | Default | Description |
|---------------------|-----------|:--------:|---------------|---------------------------------------------------|
| `gateway` | `string` | ✔︎ | | The IP Address of your EdgeRouter |
| `username` | `string` | ✔︎ | | The username of your EdgeRouter with SSH access. |
| `password` | `string` | ✔︎ | | The password of your EdgeRouter with SSH access. |
| `interface` | `string` | ✔︎ | | The interface to display on the mirror. |
| `title` | `string` | | `undefined` | An optional title to display on the mirror. |
| `showInterfaceName` | `boolean` | | `false` | Whether to show the name of the interface or not. |

## Compatibility

I developed this module based on my EdgeRouter X with nothing additionally installed.

I can't guarantee that it will work on other devices.
But I guess it should work, as long as it's possible to connect via SSH and the `ifstat` command is available under `/sbin`.
Binary file added assets/MMM-edgerouter.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit cfe1610

Please sign in to comment.