Update README
- Currently supported configuration - Update GUI to-do and progress
This commit is contained in:
parent
7d75c0943e
commit
b559463d09
53
README.md
53
README.md
@ -3,7 +3,7 @@
|
|||||||
Minimal weather widget for your desktop updates using the [OpenWeatherMap](https://openweathermap.org) API.
|
Minimal weather widget for your desktop updates using the [OpenWeatherMap](https://openweathermap.org) API.
|
||||||
|
|
||||||
## Status
|
## Status
|
||||||
⚠️ Work in progress - not ready for general use.
|
⚠️ Work in progress - not ready for regular use.
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
The widget reads configuration from:
|
The widget reads configuration from:
|
||||||
@ -15,13 +15,33 @@ The widget reads configuration from:
|
|||||||
Example:
|
Example:
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
[general]
|
# General configs section
|
||||||
api_version = "free_2.5" # Other APIs are WIP
|
[general]
|
||||||
|
# API version.
|
||||||
|
# Available options: "free_2.5" (default), "onecall_3.0" (WIP)
|
||||||
|
# Other APIs are WIP
|
||||||
|
api_version = "free_2.5"
|
||||||
|
|
||||||
|
# Path to cache file.
|
||||||
|
# Default: ~/.cache/candydesktop/owm_widget.json
|
||||||
|
cache_file = "/path/to/file"
|
||||||
|
|
||||||
|
# Query parameters section
|
||||||
[query_params]
|
[query_params]
|
||||||
api_key = "your_api_key_here" # Get a free API key from https://openweathermap.org
|
# API key.
|
||||||
city_id = "your_city_id_here" # Find it in the url of your city at https://openweathermap.org/find?
|
# Get a free API key from https://openweathermap.org
|
||||||
units = "metric"
|
api_key = "your_api_key_here"
|
||||||
|
|
||||||
|
# Location parameters.
|
||||||
|
# One of these must be specified: `city_name`, `city_id`, `lat` + `lon` pair, or `zip`
|
||||||
|
# `lat=` must always be paired with `lon=`
|
||||||
|
# Find your city id in the url of your city at https://openweathermap.org/find?
|
||||||
|
city_id = "5391959" # Example: San Francisco, US
|
||||||
|
|
||||||
|
# Measurement units: `standard` (Kelvin, default), `imperial` (Fahrenheit), `metric` (Celcius)
|
||||||
|
units = "metric"
|
||||||
|
|
||||||
|
# Language. Default: "en" (English)
|
||||||
lang = "en"
|
lang = "en"
|
||||||
````
|
````
|
||||||
⚠️ WIP - Full configuration format will be released later.
|
⚠️ WIP - Full configuration format will be released later.
|
||||||
@ -38,14 +58,29 @@ lang = "en"
|
|||||||
- [x] TOML configuration file
|
- [x] TOML configuration file
|
||||||
- [x] Fetch and parse current weather data from OWM
|
- [x] Fetch and parse current weather data from OWM
|
||||||
- [ ] Weather forecast query
|
- [ ] Weather forecast query
|
||||||
- [ ] Complete library
|
- [ ] Complete library crate [(WIP)](https://git.candifloss.cc/candifloss/OpenWeatherMapSDK)
|
||||||
- [ ] Complete configuration
|
- [ ] Complete configuration
|
||||||
- [ ] CLI args
|
- [ ] CLI args
|
||||||
- [ ] GUI - ~~[iced](https://book.iced.rs/)~~ [Slint](https://docs.slint.dev/latest/docs/slint/)
|
- [ ] GUI - ~~[iced](https://book.iced.rs/)~~ [Slint](https://docs.slint.dev/latest/docs/slint/)
|
||||||
|
- Weather info:
|
||||||
|
- [x] Cureent weather
|
||||||
|
- [ ] Forecast
|
||||||
|
- [ ] Alerts and details
|
||||||
|
- Platforms:
|
||||||
|
- [x] X11
|
||||||
|
- [ ] Wayland
|
||||||
|
- Tested on:
|
||||||
|
- [LeftWM](https://github.com/leftwm/leftwm)
|
||||||
|
- Ubuntu/Gnome on xorg
|
||||||
- [ ] Icons
|
- [ ] Icons
|
||||||
- [ ] Support One Call API 3.0
|
- [ ] Support One Call API 3.0
|
||||||
|
- Components:
|
||||||
|
- [x] Daemon
|
||||||
|
- [x] GUI widget
|
||||||
|
- [ ] TUI client
|
||||||
|
- [ ] CLI client
|
||||||
|
|
||||||
# Low-probability To-do
|
## Low-probability To-do
|
||||||
|
|
||||||
- [ ] Historical weather query
|
- [ ] Historical weather query
|
||||||
- [ ] Weather maps
|
- [ ] Weather maps
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user