1mapscroller(6x)               XScreenSaver manual              mapscroller(6x)
2
3
4

NAME

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

SYNOPSIS

9       mapscroller  [--display  host:display.screen] [--visual visual] [--win‐
10       dow] [--root] [--window-id number] [--delay  number]  [--speed  number]
11       [--duration  seconds] [--map-level number] [--url-template URL] [--ori‐
12       gin LAT/LON] [--no-titles] [--no-arrow] [--fps]
13

DESCRIPTION

15       A slowly-scrolling map of a random place on Earth.  The map images  are
16       loaded from openstreetmap.org, or any compatible service.
17
18       The Earth is very big, and full of Things.
19
20       As  you ponder these maps, remember that traffic always expands to fill
21       all available lanes, every car is a policy failure, and the concept  of
22       "jaywalking"  was invented for profit by auto industry lobbyists in the
23       1920s.
24

OPTIONS

26       --visual visual
27               Specify which visual to use.  Legal values are the  name  of  a
28               visual  class,  or the id number (decimal or hex) of a specific
29               visual.
30
31       --window
32               Draw on a newly-created window.  This is the default.
33
34       --root  Draw on the root window.
35
36       --window-id number
37               Draw on the specified window.
38
39       --delay number
40               Per-frame delay, in microseconds.  Default:  30000  (0.03  sec‐
41               onds).
42
43       --speed number
44               Scrolling  speed.   2.0  means twice as fast, 0.5 means half as
45               fast.
46
47       --duration seconds
48               When in one of the random modes, re-select the map position ev‐
49               ery N seconds.  Default 20 minutes.
50
51       --map-level number
52               Larger numbers are zoomed in more. 5 - 18, default 15.
53
54       --url-template URL
55               The  map tile server to use. Default: Open Street Map.  You can
56               find others here:
57
58               https://wiki.openstreetmap.org/wiki/Tiles#Servers
59
60       --origin location
61               "Random" means a fully random location somewhere on Earth,  ex‐
62               cluding the oceans.
63
64               "Random-city"  means  to select from a built-in list of several
65               hundred major cities.  This is the default.
66
67               Otherwise, this must be a latitude/longitude pair, as floats.
68
69       --titles | --no-titles
70               Whether to show the current coordinates in the upper left.  De‐
71               fault true.
72
73       --arrow | --no-arrow
74               Whether  to  show  a  directional  arrow  in  the middle of the
75               screen.  Default true.
76
77       --fps | --no-fps
78               Whether to show a frames-per-second display at  the  bottom  of
79               the screen.
80

FILES

82       The  map tile images are loaded from the network and cached on disk. Up
83       to 20MB of them are retained.  Depending on your operating system,  the
84       cache directory will be one of:
85
86               $HOME/.cache/xscreensaver/mapscroller/
87               $HOME/tmp/.xscreensaver-mapscroller/
88               $HOME/.xscreensaver-mapscroller.cache/
89               $HOME/Library/Caches/org.jwz.xscreensaver.mapscroller/
90

BUGS

92       Some parts of the world are boring.
93

ENVIRONMENT

95       DISPLAY to get the default host and display number.
96
97       XENVIRONMENT
98               to  get  the  name of a resource file that overrides the global
99               resources stored in the RESOURCE_MANAGER property.
100
101       XSCREENSAVER_WINDOW
102               The window ID to use with --root.
103
104       HTTP_PROXY, HTTPS_PROXY, http_proxy, or https_proxy
105           to get the default proxy host and port.
106

SEE ALSO

108       X(1), xscreensaver(1), https://www.openstreetmap.org/
109
111       Copyright © 2022 by Jamie Zawinski.  Permission to use,  copy,  modify,
112       distribute,  and  sell this software and its documentation for any pur‐
113       pose is hereby granted without fee, provided that the  above  copyright
114       notice  appear  in  all  copies and that both that copyright notice and
115       this permission notice appear in supporting documentation.   No  repre‐
116       sentations are made about the suitability of this software for any pur‐
117       pose.  It is provided "as is" without express or implied warranty.
118
119       OpenStreetMap map data is © OpenStreetMap contributors under  the  Open
120       Database License.
121

AUTHOR

123       Jamie Zawinski.
124
125
126
127X Version 11               6.08-1.fc39 (17-Oct-2023)           mapscroller(6x)
Impressum