NAME

       mapscroller - a slowly-scrolling map of a random place on Earth.

SYNOPSIS

       mapscroller  [--display  host:display.screen]  [--visual visual] [--window] [--root] [--window-id number]
       [--delay  number]  [--speed  number]  [--duration  seconds]  [--map-level  number]  [--url-template  URL]
       [--origin LAT/LON] [--no-titles] [--no-arrow] [--fps]

DESCRIPTION

       A  slowly-scrolling map of a random place on Earth.  The map images are loaded from openstreetmap.org, or
       any compatible service.

       The Earth is very big, and full of Things.

       As you ponder these maps, remember that traffic always expands to fill all available lanes, every car  is
       a  policy  failure, and the concept of "jaywalking" was invented for profit by auto industry lobbyists in
       the 1920s.

OPTIONS

       --visual visual
               Specify which visual to use.  Legal values are the name of a  visual  class,  or  the  id  number
               (decimal or hex) of a specific visual.

       --window
               Draw on a newly-created window.  This is the default.

       --root  Draw on the root window.

       --window-id number
               Draw on the specified window.

       --delay number
               Per-frame delay, in microseconds.  Default: 30000 (0.03 seconds).

       --speed number
               Scrolling speed.  2.0 means twice as fast, 0.5 means half as fast.

       --duration seconds
               When in one of the random modes, re-select the map position every N seconds.  Default 20 minutes.

       --map-level number
               Larger numbers are zoomed in more. 5 - 18, default 15.

       --url-template URL
               The map tile server to use. Default: Open Street Map.  You can find others here:

               https://wiki.openstreetmap.org/wiki/Tiles#Servers

       --origin location
               "Random" means a fully random location somewhere on Earth, excluding the oceans.

               "Random-city"  means to select from a built-in list of several hundred major cities.  This is the
               default.

               Otherwise, this must be a latitude/longitude pair, as floats.

       --titles | --no-titles
               Whether to show the current coordinates in the upper left.  Default true.

       --arrow | --no-arrow
               Whether to show a directional arrow in the middle of the screen.  Default true.

       --fps | --no-fps
               Whether to show a frames-per-second display at the bottom of the screen.

FILES

       The map tile images are loaded from the network and cached on disk. Up to  20MB  of  them  are  retained.
       Depending on your operating system, the cache directory will be one of:

               $HOME/.cache/xscreensaver/mapscroller/
               $HOME/tmp/.xscreensaver-mapscroller/
               $HOME/.xscreensaver-mapscroller.cache/
               $HOME/Library/Caches/org.jwz.xscreensaver.mapscroller/

BUGS

       Some parts of the world are boring.

ENVIRONMENT

       DISPLAY to get the default host and display number.

       XENVIRONMENT
               to  get  the  name  of  a  resource  file  that  overrides  the  global  resources  stored in the
               RESOURCE_MANAGER property.

       XSCREENSAVER_WINDOW
               The window ID to use with --root.

       HTTP_PROXY, HTTPS_PROXY, http_proxy, or https_proxy
           to get the default proxy host and port.

SEE ALSO

       X(1), xscreensaver(1), https://www.openstreetmap.org/

COPYRIGHT

       Copyright © 2022 by Jamie Zawinski.  Permission to use, copy, modify, distribute, and sell this  software
       and  its  documentation  for any purpose is hereby granted without fee, provided that the above copyright
       notice appear in all copies and that both that copyright notice and  this  permission  notice  appear  in
       supporting  documentation.   No  representations  are made about the suitability of this software for any
       purpose.  It is provided "as is" without express or implied warranty.

       OpenStreetMap map data is © OpenStreetMap contributors under the Open Database License.

AUTHOR

       Jamie Zawinski.