xmobar-wttr 0.0.dev4

An external xmobar plugin for customizable weather info!

xmobar_wttr is a command-line program which fetches weather info from wttr.in and applies direct formatting to be used by xmobar. Different from already available plugins, it can easily be configured to use any kind of combination of numbers, icons, and colors.

In the commands list your xmobarrc, add something along the lines of

Run Com "xmobar_wttr" ["-c ~/.config/xmobar/xmobar_wttr.yml"] "wttr" 9000

Prerequisites

This program mainly uses following python3 modules

• requests
• pyyaml

Furthermore, the program uses weather icons from https://github.com/erikflowers/weather-icons. Install them directly from the website, using an AUR helper such as

yay -S ttf-weather-icons

or by other means.

Install

pip install xmobar-wttr

For installing from source, clone the repository, and run

cd xmobar_wttr
python setup.py install

or create a virtual environment with

pipenv install
pipenv install -e .

To activate the virtual environment run

pipenv shell

or start every command with pipenv run.

Usage

usage: xmobar_wttr [-h] [-c <path>] [-l <loc>] [-f <format>] [-o <path>] [-s <section>] [-p <par-list> [<par-list> ...]] [-v]

optional arguments:
  -h, --help            show this help message and exit
  -c <path>, --config <path>
			Path to the config file
  -l <loc>, --location <loc>
			Location for which to pull information.
  -f <format>, --format <format>
			Format template for xmobarrc
  -o <path>, --output <path>
			Path to the output file
  -s <section>, --section <section>
			Section in the yaml file to be parsed
  -p <par-list> [<par-list> ...], --pars <par-list> [<par-list> ...]
			Select parameters to be fetched from wttr.in
			excluded parameters are not available in xmobar template format
  -v, --verbose         Run program in verbose mode

Configuration

xmobar_wttr works with both command-line arguments as well as YAML configuration files (the first takes precedence over the latter). To set your desired defaults edit the configuration file xmobar_wttr.yml and place it in either

• ~/.config/xmobar_wttr/xmobar_wttr.yml
• ~/.config/xmobar/xmobar_wttr.yml
• ~/.xmobar_wttr/xmobar_wttr.yml
• ~/.xmobar_wttr.yml

Notation

Notation	Description
%[par]	parameter value
%g[par]	render parameter only as icon
%G[par]	prefix icon to parameter value
.u	append units of previous parameter

Format map	Result
<2:…>	…
{#dedede:…}	…
\\…	\x…