Skip to main content

Provide temperature information to i3blocks based on geolocated IP address

Project description

This blocklet provides temperature information for the i3blocks status bar often used in the i3 window manager. It attempts to determine your location based on your IP address using the API. Based on the location it retrieves weather information from the free API.


i3geoweather is a pure Python 3 program. No attempt to make it compatible with Python 2 has been or will be made. It is time to switch!


The easiest way to install i3geoweather is to use pip:

$ pip install i3geoweather

Depending on your system you may need to call pip3 instead of pip


i3geoweather depends on the Python requests library. i3geoweather output uses FontAwesome for its output. You should download the free FontAwesome zip file and copy fontawesome-webfont.ttf to your ~/.fonts/ directory.


i3geoweather runs a daemon process in the background (if started with the -d option) and periodically updates weather information by writing to ~/.i3geoweather/i3geoweather.txt.

Start i3geoweather from your i3 configuration file:

exec_always i3geoweather -d

You may need to use the full path to i3geoweather, e.g., for an installation with pip install –user …:

exec_always ~/.local/bin/i3geoweather -d

A typical i3blocks.conf entry may look like this:

command=inotifywait -qq -e delete_self ~/.i3geoweather/i3geoweather.txt && cat ~/.i3geoweather/i3geoweather.txt

Command line options:

  • -d or –daemon run as background process

  • -l or –location force a location by specifying a comma separated latitude/longitude pair, e.g., -l “50.0126, 7.996”. North and east are positive.

  • -r or –restart restart background process

  • -s or –stop stop running background process

  • -v increase verbosity of logging to ~/.i3geoweather/i3geoweather.log. Can be used up to three times. Using -v twice logs informational messages. Debugging output is produced when -v is used three times.


Jörg Dietrich


Development takes place on GitHub. Please report any bugs as an issue in the GitHub issue tracker.


i3geoweather is released under an MIT license. See LICENCE.txt

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

i3geoweather-1.1.2.tar.gz (8.1 kB view hashes)

Uploaded source

Built Distribution

i3geoweather-1.1.2-py3-none-any.whl (8.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page