-
Notifications
You must be signed in to change notification settings - Fork 29
/
README-En.txt
155 lines (117 loc) · 6.52 KB
/
README-En.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
=======================================================
==== SpotlightDL v1.5.0 - By ORelio - Microzoom.fr ====
==== https://github.com/ORelio/Spotlight-Downloader ===
=======================================================
Thanks for dowloading SpotlightDL!
This program can retrieve Windows Spotlight images by requesting the Microsoft Spotlight API.
SpotlightDL can also define images as wallpaper and system-wide lockscreen image.
It is useful in the following use cases:
- Download the whole Spotlight library with maximum image resolution and metadata
- Define Spotlight images as wallpaper, not only on Windows 11 but also on previous versions
- Define Spotlight images as global lock screen on Windows 7/8/10/11, without ads on Windows 10/11
- Chain SpotlightDL with your own scripts and apps by taking advantage of the url mode
============
How to use
============
Extract the archive if not already extracted, then call SpotlightDownloader.exe from the command line.
If you are not used to the command prompt, a few Batch files are offered for your convenience:
spotlight-download-archive
This script downloads as much images as possible from the Spotlight API,
with maximum res and metadata. Please note that there is no actual way
of listing *all* images so SpotlightDownloader will make many API calls
to discover and download new images, and stop when no new images are
discovered. It may miss a few images but you should get most of them.
update-archive-and-wallpaper
This script calls once the Spotlight API and adds the result to the
Spotlight archive, then randomly defines a Spotlight image as wallpaper
This allows to gradually download images without hammering the Spotlight API.
update-archive-and-lockscreen
Same as update-archive-and-wallpaper but updates the system-wide lockscreen.
This script must be run as administrator as it replaces an image in the
Windows folder and clear the lockscreen cache to force a lockscreen refresh.
update-wallpaper
This script maintains a cache of several Spotlight pictures tailored to your screen
resolution and randomly defines a new Spotlight image as wallpaper. The cache allows
a few updates without Internet access, and oldest images are deleted from the cache.
update-lockscreen
Same as update-wallpaper but defines images as system-wide lockscreen
This script must be run as administrator as it replaces an image in the
Windows folder and clear the lockscreen cache to force a lockscreen refresh.
restore-lockscreen
This script restores the default lockscreen image.
This script must be run as administrator.
generate-manual
This script saves usage info as a text file for your convenience,
in order to help writing your own batch files or PowerShell scripts.
hide-console
This script launches another script without showing the console window.
Mostly useful if you plan to schedule an update script on logon.
The path passed as argument should not contain special characters.
===========================
Scheduling a batch script
===========================
If you wish to periodically update your wallpaper or lockscreen,
you can schedule one of the provided scripts by following these instructions:
= If you are not administrator =
= Startup shortcut method =
Use Win+R keyboard shortcut and specify:
%appdata%\Microsoft\Windows\Start Menu\Programs\Startup
Perform a right click inside the Startup folder > New > Shortcut
wscript "C:\Path\To\hide-console.vbs" "C:\Path\To\desired-script.bat"
Next > Type a meaningful name for that shortcut > Finish
The shortcut will launch on each logon and run the script.
Note: lockscreen-related scripts won't work with this method.
= If you are administrator =
= Task scheduler method =
Use Win+R and specify:
taskschd.msc
Click "Create a new task"
General tab
- Define the task name
- Check "Run with highest privileges" to run the script as admin (lockscreen...)
Triggers tab
- Click New and add a trigger: "At log on" or "On a schedule" for instance
Actions tab
- Click New, choose Start a program
- Program/Script: wscript
- Add arguments: "C:\Path\To\hide-console.vbs" "C:\Path\To\desired-script.bat"
Conditions tab
- You may want to uncheck "Start the task only if the computer is on AC power"
Settings tab
- If your task has a defined schedule, e.g. everyday at 10am but your computer
is powered off at 10am, the task will not run. You may want to enable the
"Run task as soon as possible after a sheduled start is missed" feature.
Click OK to save your task.
=====
FAQ
=====
Q: The lockscreen does not appear when I am logged on?
R: Make sure the image is also selected in your personal lock screen settings.
Q: How many images are downloaded when using default mode? (i.e. without using --single or --many)
R: Default mode downloads a list of images returned by a single API call: currently 4.
Q: Some images do not have a title or copyright in their metadata?
R: Those fields are not provided for all images by the Spotlight API.
Q: I do not want to have the image title inside my wallpaper or lockscreen. How to remove it?
R: Edit the batch file you want to use and remove --embed-meta inside the corresponding command.
Q: I would like to retrieve metadata/images for a specific language. How to do it?
R: Edit the batch file you want to use and add --locale en-US or any other locale code
Q: When downloading images using spotlight-download-archive.bat, I get very few images. Why?
R: This may be related to the current locale set on your computer. Try en-US as decribed above.
Q: How to download more images by trying all languages at once? I do not need image metadata.
R: Edit spotlight-download-archive.bat to replace --metadata with --all-locales in the download command.
Q: Does SpotlightDL consume bandwidth on networks that I defined as metered?
R: No. Batch files will reuse previously downloaded images, except spotlight-download-archive.
Q: How to enable image download on metered networks?
R: Edit the batch file you want to use and remove the whole line containing "check-metered.ps1"
Q: Images are 1080p even with --maxres option, how to get 4K images?
A: 4K resolution is only available via API v4, supported by SpotlightDL v1.5.0 or higher
=========
Credits
=========
The Spotlight Downloader program has been created using the following resources:
- Bing / Spotlight API by Microsoft Corporation
- Spotlight API studies by KoalaBR, Biswa96 & ORelio
- Agency FB font family by Microsoft Corporation (Logo)
+--------------------+
| © 2018-2024 ORelio |
+--------------------+