Skip to content

Latest commit

 

History

History
66 lines (46 loc) · 2.27 KB

README.rdoc

File metadata and controls

66 lines (46 loc) · 2.27 KB
Raw

IP World Map ↑

This tool can be used to visualize web access logfiles. It performs geo-location resolution on the IPs (using api.hostip.info) and can generate:

  • a fixed image

  • an animated image

  • a video

Installation ↑

gem install ip-world-map

Usage ↑

ip-world-map [options] logfile1 [logfile2] ...

Options ↑

    --version                    Display the version
-h, --help                       Display this help message
-v, --verbose                    Verbose output
    --map-filename VALUE         The image to use as background
    --resolution VALUE           (eg.: 640x480)
    --fps VALUE                  Animation frames per second (eg.: 25)
    --fill-dot-color VALUE       (eg.: red, 'rgb(255,0,0)', '#FF0000')
    --fill-dot-scale VALUE       (eg.: 10.0)
    --fill-dot-opacity VALUE     range 0.0-1.0 (eg.: 0.0, 0.5, 1.0)
    --fill-dot-lifetime VALUE    (eg.: 15)
    --time-slot VALUE            real life time visualized per video frame (eg.: 10secs, 1min, 99hours, 1day)
    --output-format VALUE        image format (e.g.: gif, jpg, png) or video format (avi, mpg, mp4)
    --[no-]animate               generate an image or a video

Examples ↑

Generate PNG image. That’s the default output.

ip-world-map /var/log/apache2/access.log*

Generate AVI video with 640x480 and 25fps (default settings).

ip-world-map --animate --output-format avi /var/log/apache2/access.log*

Supported platforms ↑

Tested with Ruby 1.8.7, 1.9.1 under *nix

Author ↑

René Scheibe

License ↑

Copyright © 2010-2011 René Scheibe <[email protected]>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.