Skip to content

fjnnng/wfwp

Repository files navigation

1. Introduction

wfwp is a wallpaper switcher for Windows. Using Wikimedia Commons as its wallpaper source, wfwp detects orientations and resolutions of your monitors, automatically selects suitable pictures from over 15,000 high-quality Featured Pictures, and change them as your wallpaper at a given frequency.

Other notable features include: supporting multiple monitors, blacklisting specific pictures or excluding specific categories of pictures, manually switching/un-switching over pictures, downloading original pictures or checking details of them, and HTTP proxy for people who have limited access to Wikipedia.

2. Screenshots

desktop

2.1 Menu

menublacklist

2.2 Settings

general

exclude

2.3 Multiple Monitors

If there are multiple monitors, a clickable "Which One?" box will appear when Switch, Undo, Blacklist, Original, or Details button is clicked:

whichone

Here is a real example:

photo

3. Things You Need to Know

  • wfwp chooses suitable pictures basing on the resolutions of your monitors. For example, if the resolution is 4K, that is, width = 3840, height = 2160 and ratio = 16:9, only pictures whose width >= 3840, height >= 2160 and 4:3 <= ratio <= 64:27 are capable, where their orientations are also considered. wfwp supports monitors whose long sides up to 6400 pixels, which covers 6K (6016*3384, e.g. Apple Pro Display XDR) and DQHD (5120*1440, Dual Quad HD).

  • wfwp caches pictures to ensure smooth switches. For each monitor, there is an independent limitation on its cache. Examples:

    • FHD (1920*1080): ~9MB FHD pictures resized from higher resolution ones;
    • QHD (2560*1440, aka 2K): ~16MB QHD pictures resized from higher resolution ones;
    • UHD (3840*2160, aka 4K): ~36MB UHD pictures resized from higher resolution ones.
  • wfwp is only tested on my Windows 11 and 10 and should work fine on both plateforms. The only potential limitations come from several PowerShell commands in support of proxy and checksum, while PowerShell 5.1 is pre-installed on all Windows 10, where the related commands are already supported.

4. Usage

4.1 Ordinary

Download the wfwp.exe from Releases and put it into a proper folder, where wfwp can generate configuration or other files and cache pictures. During the first run, it will download the database (resolved.dat, ~5MB) automatically after initial settings are saved. You can also manually download the database here and put it into the same folder before running wfwp.

If your network is limited to accessing GitHub or Wikipedia, a proxy has to be set up. You can then configure it in the wfwp settings menu (only HTTP proxies are supported), or in the settings of Windows. For the latter, wfwp follows the proxy settings of your system and performs better.

4.2 Advanced

If you have AutoHotkey (v1.1) installed, you can also run the wfwp.ahk directly or compile a wfwp.exe yourself (select wfwp.ico as icon manually). The only difference between the script file and the executable binary is that the former does not have the ability to update itself.

5. Things You May Want to Know

  • wfwp is written in AutoHotkey, a script language exclusive for Windows. At first, I just wanted to fix my wallpaper shortage situation caused by mistakenly deleting my library. I am not even an amateur programmer, but AutoHotkey is easy to get started. The scripts aimed at downloading pictures eventually grew into wfwp. When available, I will re-write it in a more suitable language to make it cross-platform.

  • wfwp selects pictures based on the resolved.dat, which has core information on all Featured Pictures. It can be generated by the script featured.ahk. Normally resolved.dat does not require frequent updates because of its large capacity, so I only gave wfwp the ability to get resolved.dat from GitHub, where I update it once a month. If there come situations requiring an up to date resolved.dat, it can be generated by manualy running featured.ahk.

  • Except for featured.ahk, there is another script called download.ahk, which can work with featured.ahk to achieve an expanded freedom of selecting and downloading Featured Pictures. Check here to learn more.

6. Icons and Legal Issues

Except for the wallpapers, which come from Wikimedia Commons, the icons used in wfwp are also from Wikimedia Commons:

wfwp.ico:        https://commons.wikimedia.org/static/favicon/commons.ico
online.png:      https://upload.wikimedia.org/wikipedia/commons/thumb/8/81/Wikimedia-logo.svg/256px-Wikimedia-logo.svg.png
offline.png:     https://upload.wikimedia.org/wikipedia/commons/thumb/8/8b/Wikimedia-logo_black.svg/256px-Wikimedia-logo_black.svg.png
placeholder.png: https://upload.wikimedia.org/wikipedia/commons/thumb/4/4a/Commons-logo.svg/720px-Commons-logo.svg.png

If there are any legal issues requiring further addressing, please let me know. Thank you.

About

A Wallpaper Changer for Windows Powered by Wikipedia (Wikimedia Commons Featured Pictures)

Resources

License

Stars

Watchers

Forks

Packages

No packages published