1mapscroller(6x) XScreenSaver manual mapscroller(6x)
2
6 mapscroller - a slowly-scrolling map of a random place on Earth.
7
9 mapscroller [-display host:display.screen] [-visual visual] [-window]
10 [-root] [-delay number] [-speed number] [-duration seconds] [-map-level
11 number] [-url-template URL] [-origin LAT/LON] [-no-titles] [-no-arrow]
12 [-fps]
13
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 The Earth is very big, and full of Things.
19 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
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 -window Draw on a newly-created window. This is the default.
32 -root Draw on the root window.
34 -delay number
36 Per-frame delay, in microseconds. Default: 30000 (0.03 sec‐
37 onds).
38 -speed number
40 Scrolling speed. 2.0 means twice as fast, 0.5 means half as
41 fast.
42 -duration seconds
44 When in one of the random modes, re-select the map position ev‐
45 ery N seconds. Default 20 minutes.
46 -map-level number
48 Larger numbers are zoomed in more. 5 - 18, default 15.
49 -url-template URL
51 The map tile server to use. Default: Open Street Map. You can
52 find others here:
53 https://wiki.openstreetmap.org/wiki/Tiles#Servers
55 -origin location
57 "Random" means a fully random location somewhere on Earth, ex‐
58 cluding the oceans.
59 "Random-city" means to select from a built-in list of several
61 hundred major cities. This is the default.
62 Otherwise, this must be a latitude/longitude pair, as floats.
64 -titles | -no-titles
66 Whether to show the current coordinates in the upper left. De‐
67 fault true.
68 -arrow | -no-arrow
70 Whether to show a directional arrow in the middle of the
71 screen. Default true.
72 -fps | -no-fps
74 Whether to show a frames-per-second display at the bottom of
75 the screen.
76
78 The map tile images are loaded from the network and cached on disk. Up
79 to 20MB of them are retained. Depending on your operating system, the
80 cache directory will be one of:
81 $HOME/.cache/xscreensaver/mapscroller/
83 $HOME/tmp/.xscreensaver-mapscroller/
84 $HOME/.xscreensaver-mapscroller.cache/
85 $HOME/Library/Caches/org.jwz.xscreensaver.mapscroller/
86
88 Some parts of the world are boring.
89
91 DISPLAY to get the default host and display number.
92 XENVIRONMENT
94 to get the name of a resource file that overrides the global
95 resources stored in the RESOURCE_MANAGER property.
96 HTTP_PROXY, HTTPS_PROXY, http_proxy, or https_proxy
98 to get the default proxy host and port.
99
101 X(1), xscreensaver(1), https://www.openstreetmap.org/
102
104 Copyright © 2022 by Jamie Zawinski. Permission to use, copy, modify,
105 distribute, and sell this software and its documentation for any pur‐
106 pose is hereby granted without fee, provided that the above copyright
107 notice appear in all copies and that both that copyright notice and
108 this permission notice appear in supporting documentation. No repre‐
109 sentations are made about the suitability of this software for any pur‐
110 pose. It is provided "as is" without express or implied warranty.
111 OpenStreetMap map data is © OpenStreetMap contributors under the Open
113 Database License.
114
116 Jamie Zawinski.
117X Version 11 6.04-1.fc36 (06-Jun-2022) mapscroller(6x)