WEave

Main interface demonstration

---

WEave (formerly WE Workshop Manager) is a Python/PyQt6 desktop application that allows you to easily download, install, and manage wallpapers from Steam Workshop for Wallpaper Engine without needing to run the Steam client.

In development 3.0 - migration to Tauri (React) + Rust or PyWebView

🔑 Key Features:

• 🌐 Browse Steam Workshop and download wallpapers with one click
• 🗂️ Manage installed wallpapers (apply, remove, extract .pkg files, etc.)
• 📊 Download wallpapers by list of IDs and/or URLs
• 🎯 Track download/extraction status of wallpapers
• ⚜️ Themes + Full customization of the background of the main UI elements
• 🔧 Pages load faster than in the browser
• 🌍 Multilingual support
• 🔰 Many other features

---

Related Project

WE Installer Extension — a browser extension that adds a quick install button directly on Steam Workshop pages.

---

Note

• Wallpapers are downloaded to the default WE folder, similar to a regular installation
• The first login may take a while, please wait while the system account is logging in
• Workshop download speed depends on your internet connection speed, as well as Steam server availability
• If the app doesn't show "specific" content in Workshop, it means the system account hasn't logged in for some reason. You need to log into any Steam account (without Steam Guard and with the content settings you need) in the app settings (General).
• If wallpapers don't load - try selecting another account from the list in settings (Account).

Warning

• The app uses public accounts to download from the workshop
• The app does not modify the original Wallpaper Engine or Steam client

---

🚀 Installation

Important

To run from source (Option 2):

• Install Python 3.14+
• Install .NET 8 Desktop Runtime

For packaged version (Option 1):

• Only the .NET 8 Desktop Runtime mentioned above

📦 Option 1: Packaged PyInstaller version

Download the latest version from the Releases section

All dependencies are already built in, just unzip the archive to a convenient location and run WEave.exe

---

💻 Option 2: Running from source code

1. Clone the repository

git clone https://github.com/psyattack/WEave.git
cd WEave

2. Install Python dependencies

pip install -r requirements.txt

3. Download required components

Component	Where to place
DepotDownloader	plugins/DepotDownloader/
RePKG	plugins/RePKG/

4. Run the application

python main.py

Running without console window:
Use run_without_console.bat to launch the application without displaying a console window

---

📁 Project Structure

WEave/
├── bootstrap/              # Application initialization
├── domain/                 # Models and data structures
├── services/               # Application services
├── infrastructure/         # Integrations and external logic
├── ui/                     # Interface
├── shared/                 # Common utilities
├── localization/           # Translations
├── plugins/                # External tools (downloaded separately)
├── main.py                 # Entry point
└── requirements.txt        # Python dependencies

---

🙏 Acknowledgments

This project uses the following open resources and tools:

• DepotDownloader — workshop downloader
• RePKG — .pkg file unpacker tool
• WallpaperEngineWorkshopDownloader — for providing accounts to download from workshop
• icons8 — free icons for the interface

---

📜 License

This project is licensed under the MIT license.

---

👁️‍🗨️ Known Issues

• Incorrect window state return after pre-minimizing
• White dialogs when clearing filters
• PyInstaller --onefile breaks restart, if building from source build in --onedir (~500mb)

---

📋 TODO & Support

• Themes
• Login via personal Steam account (For use with Steam failed 50 and similar)
• Autostart
• Tray + silent mode
• Original WE functions (Preset editor, creating playlists, profiles, etc.)
• Automatic updates
• Interface optimization for different screen sizes and formats + window resize capability

If you have any problems or suggestions for improvement — create an Issue in the repository.

---