Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nstechbytes/lpv
A Python-based application to set a video as your Windows desktop wallpaper. This project leverages PyQt5, ffpyplayer, and the Windows API to provide a seamless experience of playing videos directly on your desktop background.
https://github.com/nstechbytes/lpv
automation desktop-customization ffplay multimedia pillow pyqt5 python video videowallpaper window windows winreg
Last synced: 23 days ago
JSON representation
A Python-based application to set a video as your Windows desktop wallpaper. This project leverages PyQt5, ffpyplayer, and the Windows API to provide a seamless experience of playing videos directly on your desktop background.
- Host: GitHub
- URL: https://github.com/nstechbytes/lpv
- Owner: NSTechBytes
- License: apache-2.0
- Created: 2024-09-23T10:09:06.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-09-23T10:15:39.000Z (3 months ago)
- Last Synced: 2024-10-29T14:49:26.073Z (about 2 months ago)
- Topics: automation, desktop-customization, ffplay, multimedia, pillow, pyqt5, python, video, videowallpaper, window, windows, winreg
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LPV - Live Video Wallpaper
A Python-based application to set a video as your Windows desktop wallpaper. This project leverages PyQt5, ffpyplayer, and the Windows API to provide a seamless experience of playing videos directly on your desktop background.
## Features
- **Live Video Wallpaper**: Play a video as your desktop background.
- **Command Interface**: Control playback via command-line input (play, pause, volume control, frame rate adjustments, etc.).
- **Auto Looping**: Videos automatically loop when they reach the end.
- **Volume and Frame Rate Control**: Dynamically adjust video volume and frame rate through commands.
- **Wallpaper Restoration**: Automatically restores the original wallpaper when the video stops or the application exits.
## Requirements
- Python 3.x
- PyQt5
- ffpyplayer
- Pillow (PIL)
- Windows OS (uses Windows APIs and registry to set and restore wallpapers)
## Installation
1. Clone the repository:
```bash
git clone https://github.com/NSTechBytes/Lpv.git
```
2. Install the required Python packages:
```bash
pip install -r requirements.txt
```
3. Ensure you are running on a Windows environment since this project uses the Windows API to manage wallpapers.
## Usage
To run the application and set a video as wallpaper:
```bash
python lpv.py
```
### Available Commands
Once the application is running, you can use the following commands via stdin to control playback:
- **play**: Resume video playback and restore audio.
- **pause**: Pause video playback and mute audio.
- **volume ``**: Adjust the volume (e.g., `volume 0.5` sets the volume to 50%).
- **frames ``**: Adjust the frame rate (e.g., `frames 30` sets the playback to 30 fps).
- **remove**: Remove the video wallpaper and restore the original wallpaper.
- **exit**: Exit the application and restore the original wallpaper.
### Example
To set a video located at `C:\Videos\myvideo.mp4` as your wallpaper, run:
```bash
python lpv.py "C:\Videos\myvideo.mp4"
```
Once the application is running, you can control playback by typing commands in the terminal, like:
```bash
play
pause
volume 0.8
frames 60
remove
exit
```
## How It Works
- The script uses **PyQt5** to create a windowless desktop overlay that displays the video.
- **ffpyplayer** handles video playback, while **Pillow** processes video frames for rendering as QPixmap images.
- The app interacts with the Windows **WorkerW** window to set the video beneath the icons on the desktop.
- Commands can be issued through stdin to control the video playback, including play, pause, volume, and frame rate adjustments.
- When the app exits, the original desktop wallpaper is restored automatically.
## Contributing
If you’d like to contribute to this project, feel free to open issues or submit pull requests. Any contributions are welcome!
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.