https://github.com/JaouherK/streamDeck-weatherPlugin
Popular Stream Deck plugin for Weather reporting
https://github.com/JaouherK/streamDeck-weatherPlugin
elgato elgato-stream-deck javascript multi-weather-provider openweather stream-deck weather weatherapi
Last synced: about 1 year ago
JSON representation
Popular Stream Deck plugin for Weather reporting
- Host: GitHub
- URL: https://github.com/JaouherK/streamDeck-weatherPlugin
- Owner: JaouherK
- License: gpl-3.0
- Created: 2021-04-17T03:20:59.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-09-04T01:41:54.000Z (almost 3 years ago)
- Last Synced: 2024-11-08T06:38:29.330Z (over 1 year ago)
- Topics: elgato, elgato-stream-deck, javascript, multi-weather-provider, openweather, stream-deck, weather, weatherapi
- Language: CSS
- Homepage: https://jaouherk.github.io/streamDeck-weatherPlugin/
- Size: 348 KB
- Stars: 48
- Watchers: 4
- Forks: 16
- Open Issues: 158
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Weather
[](https://github.com/JaouherK/streamDeck-weatherPlugin/releases/tag/v2.1.2)
`Weather` is a plugin that displays the weather condition as a picture image, the city name and the temperature of a given location. It is connected to multiple providers and needs an API Key to connect.
Possible providers:
- WeatherAPI
- OpenWeather
Optionally, you can choose the frequency of fetching updated data and the temperature unit ( Celsius or Fahrenheit).
# Button settings
The button is configured as follows:
- Title: Please do not set any value in order to display the temperature correctly
- Image: Please do not update picture in order to display the weather icon correctly
- Provider: the weather information provider: WeatherAPI or OpenWeather
- API key: your provider account key available in your account information on the associated provider website
- City Name: the city for which the information will be displayed on the button
- Temperature: the temperature unit ( Celsius or Fahrenheit)
- Fetch frequency: how often the data is updated (beware for free accounts the limits set by the provider)
- Display city name: Provides the possibility choose where to display the city name (also if we need to hide it)
- Round to nearest degree: Provides the possibility to show / hide digits after decimal point
- "Get my API key" button: to retrieve the key for your account
- "Report bug" button: to report a bug
# Features
- code written in Javascript
- cross-platform (macOS, Windows)
- Choice of Weather provider
- Choose temperature unit
- choose fetching frequency of the weather data
- Weather condition icon fit to display

# Installation
In the Release folder, you can find the file `com.jk.weather.streamDeckPlugin`. If you double-click this file on your machine, Stream Deck will install the plugin.
# Source code
The `Sources` folder contains the source code of the plugin.
Application main icon made by [Smashicons](https://www.flaticon.com/authors/smashicons) from [www.flaticon.com](https://www.flaticon.com/)