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] [--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
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
32 Draw on a newly-created window. This is the default.
33 --root Draw on the root window.
35 --window-id number
37 Draw on the specified window.
38 --delay number
40 Per-frame delay, in microseconds. Default: 30000 (0.03 sec‐
41 onds).
42 --speed number
44 Scrolling speed. 2.0 means twice as fast, 0.5 means half as
45 fast.
46 --duration seconds
48 When in one of the random modes, re-select the map position ev‐
49 ery N seconds. Default 20 minutes.
50 --map-level number
52 Larger numbers are zoomed in more. 5 - 18, default 15.
53 --url-template URL
55 The map tile server to use. Default: Open Street Map. You can
56 find others here:
57 https://wiki.openstreetmap.org/wiki/Tiles#Servers
59 --origin location
61 "Random" means a fully random location somewhere on Earth, ex‐
62 cluding the oceans.
63 "Random-city" means to select from a built-in list of several
65 hundred major cities. This is the default.
66 Otherwise, this must be a latitude/longitude pair, as floats.
68 --titles | --no-titles
70 Whether to show the current coordinates in the upper left. De‐
71 fault true.
72 --arrow | --no-arrow
74 Whether to show a directional arrow in the middle of the
75 screen. Default true.
76 --fps | --no-fps
78 Whether to show a frames-per-second display at the bottom of
79 the screen.
80
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 $HOME/.cache/xscreensaver/mapscroller/
87 $HOME/tmp/.xscreensaver-mapscroller/
88 $HOME/.xscreensaver-mapscroller.cache/
89 $HOME/Library/Caches/org.jwz.xscreensaver.mapscroller/
90
92 Some parts of the world are boring.
93
95 DISPLAY to get the default host and display number.
96 XENVIRONMENT
98 to get the name of a resource file that overrides the global
99 resources stored in the RESOURCE_MANAGER property.
100 XSCREENSAVER_WINDOW
102 The window ID to use with --root.
103 HTTP_PROXY, HTTPS_PROXY, http_proxy, or https_proxy
105 to get the default proxy host and port.
106
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 OpenStreetMap map data is © OpenStreetMap contributors under the Open
120 Database License.
121
123 Jamie Zawinski.
124X Version 11 6.08-1.fc39 (17-Oct-2023) mapscroller(6x)