How paperhammer/virtualpaper works
VirtualPaper is a Windows wallpaper manager and creator. Its user-facing workflow is to browse or import wallpaper assets, preview and customize them, then apply them to the desktop; the README documents still, animated, video, and interactive formats, real-time effects, and parallax. The product also includes an independent screen saver, lock-screen background setting, and AI style-transfer and upscaling features. The source index and tree support the named implementation areas, but many feature-specific call paths were not excerpted, so uncertain connections are omitted or dashed.
Main entry points: App.xaml.cs Desktop UI · LibraryContentsViewModel.cs Library browsing · PreviewWithWeb.xaml.cs Wallpaper preview · IntelligentViewModel.cs AI tools
Components 22
App and control
- Desktop UI
src/VirtualPaper.UI/App.xaml.cs - Wallpaper core
src/VirtualPaper/App.xaml.cs - User settings
src/VirtualPaper.Models/Cores/Settings.cs - Monitor management
src/VirtualPaper/Cores/Monitor/MonitorManager.cs - Named-pipe API
src/VirtualPaper.Grpc.Client/MonitorManagerClient.cs
Wallpaper library
- Wallpaper metadata
src/VirtualPaper.Models/Cores/WpBasicData.cs - Library index
src/VirtualPaper.WpSettingsPanel/Utils/WallpaperIndexService.cs - Library browsing
src/VirtualPaper.WpSettingsPanel/ViewModels/LibraryContentsViewModel.cs - File selection
src/VirtualPaper.Common/Utils/Storage/WindowsStoragePickers.cs
Playback and rendering
- Wallpaper preview
src/VirtualPaper.PlayerWeb.Core/WebView/Windows/PreviewWithWeb.xaml.cs - Web wallpaper player
src/VirtualPaper.PlayerWeb/Program.cs - Effect rendering
src/VirtualPaper.Shader/Core/EffectApplier.cs - 3D parallax
src/VirtualPaper.PlayerWeb.Core/PLAYER_Web/js/3d_depth/run.js
Image creation
- Still-image editor
src/StaticImg/Views/Components/InkCanvas.xaml.cs - Image effects
src/StaticImg/Utils/EffectMap.cs - Image export
src/StaticImg/Models/SerializableData/StaticImgDesignFileUtil.IO.cs - AI tools
src/VirtualPaper.IntelligentPanel/ViewModels/IntelligentViewModel.cs - Style transfer
src/VirtualPaper.ML/StyleTransfer/AdaIn.cs - Super resolution
src/VirtualPaper.ML/SuperResolution/Realesrgan.cs
Product extensions
- Screen saver
src/VirtualPaper.ScreenSaver/App.xaml.cs - Lock-screen background
src/VirtualPaper.WpSettingsPanel/ViewModels/ScreenSaverViewModel.cs
Other components
- User
Connections 24
- User → Desktop UI: manages wallpapers
- Desktop UI → Library browsing: opens library
src/VirtualPaper.UI/App.xaml.cs - Library browsing → Library index: queries index
src/VirtualPaper.WpSettingsPanel/Utils/WallpaperIndexService.cs - Library browsing → File selection: selects files
- Library browsing → Wallpaper metadata: uses metadata
- Desktop UI → Wallpaper preview: previews wallpaper
- Wallpaper preview → Web wallpaper player: launches player
src/VirtualPaper.PlayerWeb.Core/WebView/Windows/PreviewWithWeb.xaml.cs - Web wallpaper player → 3D parallax: runs parallax
- Wallpaper preview → Effect rendering: customizes effects
- Desktop UI → Wallpaper core: controls runtime
- Wallpaper core → Monitor management: manages displays
src/VirtualPaper/App.xaml.cs - Named-pipe API → Monitor management: requests monitor data
src/VirtualPaper.Grpc.Client/MonitorManagerClient.cs - Wallpaper core → User settings: loads settings
src/VirtualPaper/App.xaml.cs - User → Still-image editor: creates artwork
- Still-image editor → Image effects: applies effects
- Still-image editor → Image export: exports image
- User → AI tools: requests enhancement
- AI tools → Style transfer: transfers style
- AI tools → Super resolution: upscales image
- User → Screen saver: runs screen saver
- User → Lock-screen background: sets background
- User → Wallpaper preview: previews live effects
- User → 3D parallax: uses mouse parallax
- User → AI tools: enhances wallpaper