Git Product home page Git Product logo

wttr.in's Introduction

This is a web frontend for a console weather application wego, using it as a backend. You can check it at

http://wttr.in

Usage

You can access the service from a shell or from a Web browser:

$ curl wttr.in
Weather for City: Paris, France

     \   /     Clear
      .-.      10 – 11 °C     
   ― (   ) ―   ↑ 11 km/h      
      `-’      10 km          
     /   \     0.0 mm         

You can specify the location, for that you want to get the weather information. If you omit the location name, you will get the information for you current location, based on your IP address.

$ curl wttr.in/London
$ curl wttr.in/Moscow

You can use 3-letters airport codes if you want to get the weather information about some airports:

$ curl wttr.in/muc      # Weather for IATA: muc, Munich International Airport, Germany
$ curl wttr.in/ham      # Weather for IATA: ham, Hamburg Airport, Germany

You can also use IP-addresses (direct) or domain names (prefixed with @) as a location specificator:

$ curl wttr.in/@github.com
$ curl wttr.in/@msu.ru

To get this information online, you can access the :help page:

$ curl wttr.in/:help

Installation

To install the program you need:

  1. Install external dependencies
  2. Install python dependencies used by the service
  3. Get WorldWeatherOnline API Key
  4. Configure wego
  5. Configure wttr.in
  6. Configure HTTP-frontend service

Install external dependencies

External requirements:

To install wego you must have golang installed. After that:

go get https://github.com/schachmat/wego
go install https://github.com/schachmat/wego

Install python dependencies

Python requirements:

  • Flask
  • geoip2
  • geopy
  • requests
  • gevent

You can install them using pip.

If virtualenv is used:

virtualenv ve
ve/bin/pip install -r requirements.txt
ve/bin/pip bin/srv.py

Also, you need to install the geoip2 database. You can use a free database GeoLite2, that can be downloaded from http://dev.maxmind.com/geoip/geoip2/geolite2/

Get WorldWeatherOnline key

To get the WorldWeatherOnline API key, you must register here:

https://developer.worldweatheronline.com/auth/register

Configure wego

After you have the key, configure wego:

$ cat ~/.wegorc 
{
    "APIKey": "00XXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "City": "London",
    "Numdays": 3,
    "Imperial": false,
    "Lang": "en"
}

The City parameter in ~/.wegorc is ignored.

Configure wttr.in

Configure the following environment variables specifing the path to the local wttr.in installation, to the GeoLite database and to the wego installation. For example:

WTTR_MYDIR = "/home/igor/wttr.in"
WTTR_GEOLITE = "/home/igor/wttr.in/GeoLite2-City.mmdb"
WTTR_WEGO = "/home/igor/go/bin/wego"

Configure HTTP-frontend service

Configure the web server, that will be used to access the service (if you want to use a web frontend; it's recommended):

server {
    listen [::]:80;
    server_name  wttr.in *.wttr.in;
    access_log  /var/log/nginx/wttr.in-access.log  main;
    error_log  /var/log/nginx/wttr.in-error.log;

    location /clouds_files { root /var/www/igor/; }
    location /clouds_images { root /var/www/igor/; }

    location / {
        proxy_pass         http://127.0.0.1:8002;

        proxy_set_header   Host             $host;
        proxy_set_header   X-Real-IP        $remote_addr;
        proxy_set_header   X-Forwarded-For  $remote_addr;

        client_max_body_size       10m;
        client_body_buffer_size    128k;

        proxy_connect_timeout      90;
        proxy_send_timeout         90;
        proxy_read_timeout         90;

        proxy_buffer_size          4k;
        proxy_buffers              4 32k;
        proxy_busy_buffers_size    64k;
        proxy_temp_file_write_size 64k;

        expires                    off;
    }
}

wttr.in's People

Contributors

aar0ntw avatar chubin avatar qbi avatar taueres avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.