How to Batch Download 4K Wallpapers from Wallhaven Using Python

1. Introduction

When you need a high‑resolution wallpaper, searching on typical sites often yields low‑quality images or copyrighted 4K wallpapers that are hard to obtain.

2. Project Goal

Fetch 4K wallpapers from Wallhaven and download them in bulk to a local folder.

3. Required Tools and Libraries

Software: PyCharm. Python libraries: requests, lxml, fake_useragent, time.

4. Project Analysis

Observe that the page parameter in the Wallhaven search URL increments with each page; replace it with a variable and iterate using a for‑loop to request multiple pages.

5. Implementation Details

Define a class wallhaven with __init__ storing the URL template, and a main method. Use UserAgent from fake_useragent to generate random headers.

import requests
from lxml import etree
from fake_useragent import UserAgent
import time

class wallhaven(object):
    def __init__(self):
        self.url = "https://wallhaven.cc/search?q=id%3A65348&page={}"
    def main(self):
        pass

if __name__ == '__main__':
    imageSpider = wallhaven()
    imageSpider.main()

Prompt the user for start and end pages, loop through each page, format the URL, request the page, parse the HTML with etree to extract image links, then request each image and save it to ./图/ (or a custom path). Add time.sleep(1.4) to avoid being blocked.

ua = UserAgent(verify_ssl=False)
for i in range(1, 50):
    self.headers = {'User-Agent': ua.random}

startPage = int(input("起始页:"))
endPage = int(input("终止页:"))
for page in range(startPage, endPage + 1):
    url = self.url.format(page)
    # request, parse, download...

6. Result Demonstration

Running the script prints download progress in the console, saves the images, and the saved files retain their 4K resolution.

7. Summary

Avoid excessive crawling to prevent server overload.

The script demonstrates a Python web crawler that downloads Wallhaven 4K wallpapers.

Downloading may be slow; adjust the save path if needed.

Feel free to explore Wallhaven manually and adapt the script to your needs.