Spotlight-Downloader - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #golang #rust #deep-learning #docker #windows #security #mcp #ios #openai #open-source

Spotlight-Downloader

(★ 287)

Download Windows Spotlight images and apply them to wallpaper or lockscreen.

파일 탐색기

최종 버전 다운로드 (.zip)

- banner.png
- banner.svg
- batch-script-example.png
- logo.png
- logo.svg
- check-metered.ps1
- generate-manual.bat
- hide-console.vbs
- restore-lockscreen.bat
- spotlight-download-archive.bat
- update-archive-and-lockscreen-all-users.bat
- update-archive-and-lockscreen.bat
- update-archive-and-wallpaper.bat
- update-lockscreen-all-users.bat
- update-lockscreen.bat
- update-wallpaper.bat
- delete-task.bat
- register-task.bat
- task-part1.xml
- task-part2.xml
- task-part3.xml
- - ArgumentParser.cs
  - ParsedArguments.cs
- - AssemblyInfo.cs
- - v3.json
  - v4.json
- .editorconfig
- app.manifest
- Locales.cs
- LockScreenHelper.cs
- Program.cs
- SpotlightApi.cs
- SpotlightDownloader.csproj
- SpotlightDownloader.csproj.user
- SpotlightImage.cs
- WallpaperHelper.cs
.gitignore
dotnet-publish.bat
LockScreenAPI.md
README-En.txt
README-Fr.txt
README.md
SpotlightAPI.md
SpotlightDownloader.sln

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/ORelio/Spotlight-Downloader

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd Spotlight-Downloader

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. .NET

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
.NET SDK dotnet 명령어를 쓰기 위한 SDK입니다.

dotnet restore

프로젝트에 필요한 패키지를 내려받습니다.

dotnet run

프로젝트를 빌드하고 바로 실행합니다.

✅ dotnet run 실행 후 터미널에 나타나는 안내 메시지나 주소를 확인하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![SpotlightDL](https://raw.githubusercontent.com/ORelio/Spotlight-Downloader/master/Images/logo.png)

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** most of the Spotlight library with maximum image resolution and metadata
 - Define Spotlight images as **ad-less** lockscreen or wallpaper
 - Chain SpotlightDL with your own scripts and apps using the **url mode**

# Download

Have a look at the [releases section](https://github.com/ORelio/Spotlight-Downloader/releases) to get a build. There are two major versions:

* v1.x.x for Windows 7 and greater, Mac and Linux (.NET 4)
* v2.x.x for Windows 10 and greater (.NET 9)

> [!NOTE]
> The only difference between both versions, besides OS support, is how LockScreen support is implemented for Windows 8 and greater. v1.x does that by manipulating system files, while v2.x does it using proper APIs. See [LockScreenAPI.md](LockScreenAPI.md).

# How to use

## Portable App from File Explorer (Windows)

A few Batch files are offered for ease of use for common tasks.

Download the [Zip Release](https://github.com/ORelio/Spotlight-Downloader/releases), extract it and double click on a script to launch the desired task:

![Screenshot: Launching Spotlight Batch file from File Explorer](https://raw.githubusercontent.com/ORelio/Spotlight-Downloader/master/Images/batch-script-example.png)

- `spotlight-download-archive`: Download many images to a SpotlightArchive folder
 - `update-archive-and-wallpaper`: Feed the Archive and use one image for your wallpaper
 - `update-archive-and-lockscreen`: Feed the Archive and use one image for your lockscreen
 - `update-archive-and-lockscreen-all-users`: Same, but system-wide (*)
 - `update-wallpaper`: Randomize desktop wallpaper (using a fixed-size cache)
 - `update-lockscreen`: Randomize your lockscreen (using a fixed-size cache)
 - `update-lockscreen-all-users`: Same, but system-wide (*)
 - `restore-lockscreen`: Restore default system-wide lockscreen
 - `generate-manual`: Generate a text file with command-line usage

_(*) Requires Administrator Privileges, and at least Pro edition (Home edition not supported)._

If you wish to periodically launch one of these scripts, please refer to the [User Manual](README-En.txt).

## Lockscreen Install Program (Windows)

Download the [Lockscreen Setup](https://github.com/ORelio/Spotlight-Downloader/releases) and install it. Your Lock Screen will be replaced with ad-free Spotlight images. It will also be set system-wide if supported by your Windows edition.

If you no longer need it, you can uninstall it from [App & features](https://support.microsoft.com/en-us/windows/uninstall-or-remove-apps-and-programs-in-windows-4b55f974-2cc6-2d2b-d092-5905080eaf98) like other programs.

## From the command-line (Windows)

Simply call `SpotlightDownloader.exe` from the Windows command prompt and see usage.

## Using Mono (Mac/Linux)

**For now, please use versions numbered v1.x.x for Mac and Linux.**

The `download` and `url` modes should also work on Mac/Linux using the Mono framework:

* On Mac: https://www.mono-project.com/download/stable/#download-mac
* On Linux: `sudo apt install mono-runtime`

Then, from a terminal:

```bash
mono SpotlightDownloader.exe
```
Example: Downloading Spotlight Archive:

```bash
mkdir SpotlightArchive
mono SpotlightDownloader.exe download --many --maxres --metadata --outdir SpotlightArchive
```

If you get TLS errors using Mono, try running `mozroots --import --ask-remove` once to install TLS root certificates on your computer.

If Mono crashes, try installing `mono-complete` instead of `mono-runtime`. Use at least Mono v4.0.

# How it works

## Spotlight API

By analyzing network traffic originating from Windows 10/11, it was possible to determine how to downloads images.

See [SpotlightAPI.md](SpotlightAPI.md) for details about the Spotlight API endpoints.

## Lock screen

See [LockScreenAPI.md](LockScreenAPI.md) for details about the Lockscreen API.

# License

SpotlightDL is provided under [CDDL-1.0](http://opensource.org/licenses/CDDL-1.0) ([Why?](http://qstuff.blogspot.fr/2007/04/why-cddl.html)).

Basically, you can use it or its source for any project, free or commercial, but if you improve it or fix issues,
the license requires you to contribute back by submitting a pull request with your improved version of the code.
Also, credit must be given to the original project, and license notices may not be removed from the code.