Documentation

1Overview & Installation

Wallpaper Sync is a lightweight, system-tray utility built with Electron for Windows. It rotates wallpapers from your local cache based on scheduled intervals, or automatically synchronizes a shared catalog from a central web database.

To get started, install the latest compiled executable from our homepage. On launch, the application registers in the Windows tray. Right-click the tray icon or open the double-click dashboard to customize folder sources.

2AI Metadata & Junction Collection Mapping

Our system runs a **Generate Once, Search Locally** pipeline. When an admin uploads a wallpaper, the Vercel API sends the image to Gemini to perform automatic indexing:

• Many-to-Many Collections: Wallpapers are matched to multiple collections using a flexible junction table (wallpaper_collections). The matching engine scores candidates based on keyword profiles and weights (collection_keywords), allowing wallpapers to cross-reference multiple groupings cleanly.
• Visual Style & Mood: Classifies visual styling attributes (e.g. Minimalist, 3D Render, Cyberpunk) and mood expressions to support deep tag filtering.
• Dominant Colors: Extracts color families (e.g., Blue, Dark) automatically, storing them directly on the wallpaper record.
• Confidence Metrics: Logs AI confidence scores and generation timestamps to manage automated migrations.

3Offline-First Fuzzy Search

During client sync, the desktop app downloads categories, collections, tags, and AI attributes to a local cache file (`local_metadata.json`).

Fuzzy matching algorithms analyze search queries against the wallpaper original filename, style keywords, primary colors, category names, collection titles, and tag lists. This means search matches happen instantaneously without internet connectivity.

4Troubleshooting & Registry Fallbacks

In cases where user administrative locks prevent the primary bindings from changing the background, Wallpaper Sync activates its registry fallback layer:

The application writes the file path directly to the Windows registry control panel key and restarts the Windows Shell (explorer.exe) in the background to force reload the desktop window without interrupting other programs.

5Technical Admin Tools & Bulk Updates

The Next.js management portal supports bulk operations for library scaling:

Administrators can select multiple wallpapers in a grid layout to execute batch metadata modifications, mapping them to collections or toggling tags simultaneously. Real-time visual progress feedback (progress bar indicators) has also been added to ensure visibility during large multi-image uploads.