https://github.com/lincolncox29/wallpaperlite-cli
Set desktop wallpaper using VLC
https://github.com/lincolncox29/wallpaperlite-cli
c customization microsoft software vlc vlc-libvlc vlc-media-player wallpaper wallpaper-app wallpaper-changer wallpaper-engine-software wallpaperengine-download walpaperapp windows-10 windows-11 windows-app windows-desktop
Last synced: about 1 month ago
JSON representation
Set desktop wallpaper using VLC
- Host: GitHub
- URL: https://github.com/lincolncox29/wallpaperlite-cli
- Owner: LincolnCox29
- License: agpl-3.0
- Created: 2025-07-31T05:48:58.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-08-08T13:25:04.000Z (2 months ago)
- Last Synced: 2025-08-08T15:19:15.384Z (2 months ago)
- Topics: c, customization, microsoft, software, vlc, vlc-libvlc, vlc-media-player, wallpaper, wallpaper-app, wallpaper-changer, wallpaper-engine-software, wallpaperengine-download, walpaperapp, windows-10, windows-11, windows-app, windows-desktop
- Language: C
- Homepage:
- Size: 31.6 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WallpaperLite-CLI
**Set videos as your Windows desktop wallpaper** using VLC's lightweight engine. Perfect for animated backgrounds with minimal resource usage.
```ascii
██╗ ██╗██████╗ ██╗
██║ ██║██╔══██╗██║
██║ █╗ ██║██████╔╝██║
██║███╗██║██╔═══╝ ██║
╚███╔███╔╝██║ ███████╗
╚══╝╚══╝ ╚═╝ ╚══════╝
```
## 🎦 UI Version
- https://github.com/MHSPlay/Wallpaper-Lite
- By [LincolCox29](https://github.com/LincolnCox29) and [MHSPlay](https://github.com/MHSPlay)
## 📌 Features
- Hardware-accelerated video playback (DXVA2)
- Seamless desktop integration via `WorkerW` injection
- Loop playback with audio disabled
- Windows 10/11 support
- <300 LOC core implementation
## ⚙️ Requirements
- **Windows 10/11** (Build 22h2+)
- Video file in supported format (MP4, Webm, etc.)
## 🚀 Installation
1. Download latest release
2. Extract `wallpaperLite-CLI.exe` and `VLCmin` folder to same directory
3. Run via command line:
```bash
wallpaperLite-CLI.exe C:\path\to\your\video.mp4
```
## 🔧 Building
### Method 1 (recommended)
1. Clone this repo
```bash
git clone https://github.com/LincolnCox29/WallpaperLite-CLI
```
2. Run auto_builder.bat
### Method 2 (with CMake)
1. Clone this repo
```bash
git clone https://github.com/LincolnCox29/WallpaperLite-CLI
```
2. Create build folder in repo dir
```bash
mkdir build
cd build
```
3. Build with CMake
```
cmake -A Win32 ..
cmake --build . --config Release
```
## 🛠 Technical Implementation
```mermaid
graph LR
A[CLI Launch] --> B[Find WorkerW]
B --> C[Load VLCmin DLLs]
C --> D[Initialize VLC Player]
D --> E[Attach to Desktop]
E --> F[Video Playback]
```
Key components:
- **WorkerW injection** for desktop integration
- **Dynamic VLC loading** via `LoadLibrary()`
- **HWND attachment** to desktop window
- **Minimal VLC runtime** (~15MB)
## 🐛 Known Limitations
- No volume control (audio disabled)
- Requires console window to remain open
- Single monitor support only
- No playback controls