Bing Wallpaper Client (BWC)

A lightweight CLI tool that automatically downloads and sets Bing's daily image as your desktop wallpaper. Built using VBScript, PowerShell and C#, BWC runs silently in the background to keep your desktop fresh with high-quality imagery from around the world.

Important

• Not affiliated with Microsoft or Bing.
• Support for Linux is under development.
• If you're using Windows 7, make sure to update to the latest version via Legacy Update.

Table of Contents

• Features
• Why BWC?
• System Requirements
• Installation
• Usage
• Configuration
• Scheduled Task
• Project Structure
• Installation Structure
• License

Features

• Automatic Daily Updates: Downloads and sets Bing's image of the day as your wallpaper
• Multi-Region Support: Choose from 150+ Bing markets worldwide to get region-specific images
• Smart Image Management: Configurable image retention with automatic cleanup of old wallpapers
• Scheduled Task: Runs automatically via Windows Task Scheduler
• Lightweight: Pure VBScript implementation with minimal resource usage (~100 KB)
• Zero Background Processes: Only runs when scheduled, no constant RAM usage
• No Dependencies: Works on Windows 7 and later without additional software
• Silent Operation: Runs in the background without interrupting your workflow

Why BWC?

Feature	BWC	Official Bing Wallpaper App
Size	~100 KB	200+ MB
Telemetry	None	Yes
Background Process	None	Always running
RAM Usage	0 MB (when idle)	50-100 MB constantly
Customization	Full control via config	Limited
Market Selection	150+ markets, changeable	Locked to system locale
Image Retention	Configurable (Unlimited / 1-1000 images)	Fixed

System Requirements

• Windows 7 or later
• PowerShell 2.0 or later
• Internet connection

Quick Start

Step 1: Download

• Download the latest release from here
• Extract the ZIP file to your desktop (e.g., C:\Users\YourName\Desktop\bwc)

Step 2: Open PowerShell

• Press Win + R, type powershell, and press Enter
• Or search for "PowerShell" in the Start menu

Step 3: Navigate to Installation Folder

cd "$HOME\Desktop\bwc"

Step 4: Run Installer

# Allow script execution for this session
Set-ExecutionPolicy Bypass -Scope Process -Force

# Run the installer
.\installer.ps1

What Installer Does?

The installer automatically:

• Compiles SetWallpaper.exe
• Copies application files to %LOCALAPPDATA%\BingWallpaperClient
• Creates Windows scheduled task for automatic updates
• Adds bwc command to your PATH
• Saves your configuration preferences

Advanced Options

Skip Compilation (use existing SetWallpaper.exe):

.\installer.ps1 -SkipCompile

Uninstall BWC:

.\installer.ps1 -Action uninstall

Usage

Check status and configuration:

bwc status

Manually apply wallpaper:

bwc apply

Open configuration file:

bwc config

View help or installation version:

bwc help
bwc version

Uninstall BWC:

bwc uninstall

Configuration

Configuration is stored in %LOCALAPPDATA%\BingWallpaperClient\config.json. You can modify settings by editing this file or reinstalling the application.

Available configuration options:

• Market: Bing market code (e.g., "en-US", "de-DE", "ja-JP")
• DownloadPath: Directory where images are saved
• MaxImages: Maximum number of images to retain
• KeepAllImages: Whether to keep all downloaded images
• ChangeDesktop: Enable/disable automatic wallpaper changes
• EnableLogging: Enable logging (for troubleshooting)

Scheduled Task

The installer creates a scheduled task (BingWallpaperSync) that runs:

• Daily at 9:00 AM (local time)
• At user logon
• When network connects (after 1 minute delay)

Project Structure

BingWallpaperClient/
├── installer/
│   ├── Common.ps1              # Common installer utilities
│   ├── Configuration.ps1       # Interactive configuration setup
│   ├── FileOperations.ps1      # File copy and management
│   └── TaskScheduler.ps1       # Windows Task Scheduler 
├── src/
    ├── core/
    │   ├── ConfigManager.vbs   # Configuration management
    │   ├── ImageDownloader.vbs # Bing image download logic
    │   ├── SystemUtils.vbs     # System utilities and logging
    │   └── WallpaperCore.vbs   # Wallpaper setting functionality
    ├── lib/
    │   └── JSON.vbs            # JSON parser for VBScript
    ├── BingWallpaperClient.vbs # Main application entry point
├── installer.ps1               # Main installer script
├── markets.json                # Supported Bing markets configuration
├── README.md                   # Project documentation
├── SetWallpaper.cs             # C# wallpaper setter
└── SetWallpaper.exe            # Compiled wallpaper setter

Installation Structure

After installation, BWC creates the following directory structure:

%LOCALAPPDATA%\BingWallpaperClient\
├── core\                       # Core application scripts
├── installer\                  # Installer scripts
├── lib\                        # Library scripts
├── BingWallpaperClient.vbs     # Main application entry point
├── bwc.cmd                     # Command-line wrapper
├── config.json                 # User configuration
├── installer.ps1               # Main installer script
├── markets.json                # Supported Bing markets
├── SetWallpaper.exe            # Compiled wallpaper setter

%USERPROFILE%\Pictures\BingWallpapers\
└── *.jpg                       # Downloaded wallpaper images

License

This project is licensed under the MIT License - see the LICENSE file for details.