Skip to content

0Keith/PaperNexus

Repository files navigation

PaperNexus Logo

PaperNexus

Because life's too short to right-click > "Set as desktop background" every day.

Latest Release License .NET 10 Windows


PaperNexus is an automated wallpaper rotation app for Windows that lives quietly in your system tray, fetching gorgeous wallpapers and cycling through them on your schedule. Set it, forget it, and enjoy a fresh desktop every time you glance at it.

What It Does

  • Fetches wallpapers automatically from online sources (Bing Daily, Spotlight, or any custom HTTP feed)
  • Rotates your desktop on a schedule — intervals (seconds to years) or full cron expressions
  • Runs silently in the system tray, minding its own business
  • Annotates wallpapers with optional title overlays (with auto-contrasting outline) so you know what you're looking at
  • Favorites & bans — heart a wallpaper to keep it around longer, or ban one you never want to see again
  • Gallery view — browse your wallpaper collection, set any as current, or manage favorites/bans
  • Updates itself in the background — no manual downloads required
  • Starts with Windows so your desktop is never boring, even on a Monday morning

Quick Start

  1. Grab the latest PaperNexus.exe from Releases
  2. Run it
  3. That's it. You're done. Go get a coffee.

PaperNexus will park itself in your system tray and start doing its thing. Right-click the tray icon for options:

Action What Happens
Open Settings Configure sources, schedules, and display options
Next Wallpaper Can't wait? Skip ahead immediately
Random Wallpaper Feeling spontaneous? Pick one at random
Exit Say goodbye (but why would you?)

Building From Source

# Clone the repo
git clone https://github.com/0Keith/PaperNexus.git
cd PaperNexus

# Restore & build
dotnet restore PaperNexus.sln
dotnet build PaperNexus.sln --configuration Release

# Run it
dotnet run --project PaperNexus

# Or publish a self-contained exe
dotnet publish PaperNexus/PaperNexus.csproj \
  -c Release -r win-x64 --self-contained true \
  -p:PublishSingleFile=true \
  -p:IncludeNativeLibrariesForSelfExtract=true \
  -p:PublishTrimmed=false

Requires .NET 10 SDK.

How It Works

  You ──────── "I want pretty wallpapers"
                        │
                        ▼
              ┌─────────────────┐
              │   PaperNexus    │
              │  (system tray)  │
              └────────┬────────┘
                       │
          ┌────────────┼────────────┐
          ▼            ▼            ▼
    ┌──────────┐ ┌──────────┐ ┌──────────┐
    │ Download │ │  Switch  │ │  Auto    │
    │ Service  │ │ Service  │ │  Update  │
    └────┬─────┘ └────┬─────┘ └────┬─────┘
         │            │            │
         ▼            ▼            ▼
    Fetch from    Rotate &     Check GitHub
    online feeds  set desktop  for new builds

Under the hood, PaperNexus uses scheduled background services to keep everything humming. Wallpapers are downloaded, optionally annotated, and set as your desktop background — all without you lifting a finger.

Tech Stack

Component Technology
Framework .NET 10.0
UI Avalonia UI 11.3
Architecture MVVM with CommunityToolkit.Mvvm
Image Processing SixLabors.ImageSharp
Scheduling Cronos + CronExpressionDescriptor
DI & Hosting Microsoft.Extensions.Hosting

FAQ

Q: Does it work on Mac/Linux? A: The UI framework (Avalonia) is cross-platform, but wallpaper-setting uses Windows APIs. So for now, Windows only. PRs welcome though!

Q: Will it eat my bandwidth? A: Nah. It downloads wallpapers on a schedule (default: once daily from Bing) and caches them locally. Sipping, not chugging.

Q: SmartScreen is yelling at me! A: The app is signed with a self-signed certificate. SmartScreen calms down after a few people download the same release. Click "More info" > "Run anyway" if you trust us (and you should, the code is right here).

Q: Can I add my own wallpaper sources? A: Yes! Open Settings, add any HTTP JSON feed URL, and configure the JPath expressions to point at the image URL and title fields. Go wild.

Q: It updated itself. Should I be concerned? A: Only if you're concerned about getting bug fixes and features automatically. Updates come straight from this GitHub repo's Releases page.

Contributing

Found a bug? Have a feature idea? Want to add Linux wallpaper support and become a hero?

  1. Fork the repo
  2. Create a branch (git checkout -b my-cool-feature)
  3. Make your changes
  4. Open a PR

License

See LICENSE for details.


Made for people who believe their desktop deserves better than the default Windows wallpaper.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors