mpolden / jarvis2

Awesome dashboard built with Flask and Mithril

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

JARVIS

Build Status

JARVIS is a dashboard framework designed to run on the Raspberry Pi.

It features live-updating widgets using server-sent events and can be easily extended to fit your needs.

Screenshots

Screenshot 1 Screenshot 2

Dependencies

JARVIS requires Python 3.6+ to run.

Install requirements:

pip install -r requirements.txt

For development it's recommended to use virtualenv.

Configuration

All configuration of widgets is done in a single Python source file. The configuration is specified by setting the JARVIS_SETTINGS environment variable.

A sample config (jarvis/config.py.sample) is provided. This file can be used as a starting point for your own configuration.

Copy jarvis/config.py.sample to jarvis/config.py and edit it to suit your needs.

Usage

After installing dependencies and creating a config file, the app can be started by running:

JARVIS_SETTINGS=config.py make run

To start the app in debug mode, use:

JARVIS_SETTINGS=config.py make debug

Run a job standalone and pretty-print output (useful for debugging):

JARVIS_SETTINGS=config.py make run-job

Create Google API credentials (required for calendar and gmail widget):

JARVIS_SETTINGS=config.py make google-api-auth

Create a new widget:

make widget

Create a new dashboard:

make dashboard

Widgets

See WIDGETS.md for documentation on available widgets.

Deployment

See INSTALL.md for a basic deployment guide.

License

Licensed under the MIT license. See the LICENSE file if you've never seen it before.

About

Awesome dashboard built with Flask and Mithril

License:MIT License


Languages

Language:Python 67.2%Language:JavaScript 19.9%Language:CSS 6.3%Language:HTML 4.1%Language:Jinja 1.3%Language:Makefile 1.2%