https://github.com/matopeto/kindle-weather-dashboard

https://github.com/matopeto/kindle-weather-dashboard

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/matopeto/kindle-weather-dashboard
• Owner: matopeto
• Created: 2017-02-05T14:36:22.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-08-28T11:00:44.000Z (3 months ago)
• Last Synced: 2024-08-28T12:24:25.069Z (3 months ago)
• Language: HTML
• Size: 983 KB
• Stars: 190
• Watchers: 8
• Forks: 36
• Open Issues: 7
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# kindle-weather-dashboard

Simple webpage with weahter informations.

# Try it!

Go to: http://kindle.hrincar.eu/weather/ and that's it!

or you can install it at own server and customize.

_Please, if you use this website, generate your free OWM token (see: https://openweathermap.org/api for more info), because the default token can be blocked and changed at any time and the weather forecast can stop working._

## Features

* **current weather and temperature**

* **forecast for next 12 hours**, in landscape mode for **15 hours**

* **sunrise and sunset**

* **Moon phase**

## Options

* **portrait and landscape mode**

* **landscape mode on Paperwhite!!** see configuration

* configurable place, units, language

* automatic night mode

* tested on **Kindle 3/4/5, Paperwhite 3, iPad Air**, *maybe works on other kindles and devices*,

Weather and forecast source: https://openweathermap.org/

Icons source: https://github.com/erikflowers/weather-icons



# How to install

1. clone or download repository

2. set your location and others in `config.js`

3. upload to your server, or simply create local (e.g with php: `php -S 192.168.0.1:80 -t .`)

4. disable screensaver on your Kindle:

  * press search button (or keyboard button on Kindle 4) on homescreen and type: `;debugOn` and press enter on keyboard

  * press search button (or keyboard button on Kindle 4) again and type: `~disableScreensaver` and press enter on keyboard. (On kindle Paperwhite type: `~ds` - with new firmware may by not possible but see this [instructions](https://github.com/matopeto/kindle-weather-dashboard/issues/16) for solution)

5. launch your browser and go to url of your server

6. Dashboard don't need connection to your server (you can shutdown local server now) Dashboard calls api directly.

## Configuration

### with config.js

create config.js file from config.js.sample and set variables:

* `api_locParams` - query parameters to set location (e.g. `lat=50&lon=14`, or `q=Paris`)

* `api_appId` - set your `API KEY (appId)` from http://openweathermap.org/appid

* `api_lang` - output language (e.g. `en`)

* `api_units` - units (e.g. `metric`, `imperial`)

* or you can set all parameters with `api_params` varialble (e.g. `q=Prague&appid=YOUR_API_KEY&lang=sk&units=metric`

* `rotation` - set rotation (on Kindle Paperwhite) `ll` for left landscape, `lr` for right landscape and `up` for upside down

* `night_mode` - `auto` - by sunrise and sunset, `on` - always on, `HH-HH` (`22-06`) interval from-to, `off` or `null` for disabling.

* `refreshTime` - refresh rate in miliseconds (default is 30 minutes)

* `utcOffset` - if not set it is determined by location, `local` - local machine UTC offset, or custom UTC offset. (Because kindle doesn't report correct local time. You may need to change the value after winter/summer time changed)

* `tempType` - use `feelsLike` to shows feels like temperatures

See more: http://openweathermap.org/current and http://openweathermap.org/forecast5

### with url query parameters

* `appId` sets the appId

* `city` sets city, (e.g. `city=Paris`)

* `lat`, `lon` sets location (e.g. `lat=50&lon=14`)

* `lang` and `units` for lang and units :)

* `rotation` sets the rotation :)

* `utcOffset` sets utc offset

* `tempType` sets temperature type (actual or feels like)

Examples:

* Dashboard for Prague, metrics slovak language: `http://YOUR_URL/?city=Prague&lang=sk&units=metric&appId=YOUR_API_KEY`

* Dashboard for given gps, metric, default language: `https://YOUR_URL/?lat=50&lon=14&units=metric&appId=YOUR_API_KEY`

## Screenshots

### Kindle 4



### Kindle Paperwhite 3



### Real devices