Skip to content
Parse web server log files and visualize the access creating a video showing the locations on a world map.
Find file
Failed to load latest commit information.
bin upgrade to version 1.0.1
lib fixed issue with class method
resources/maps removed some small maps (can be downscaled from a bigger one)
spec Merge remote-tracking branch 'remotes/origin/parallel_http'
.rspec updated Rakefile and migrated RSpec from 1.x to 2.x


IP World Map

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

  • a fixed image

  • an animated image

  • a video


gem install ip-world-map


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


    --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


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


René Scheibe


Copyright (C) 2010-2011 René Scheibe <>

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.

Something went wrong with that request. Please try again.