sindresorhus/wallpaper
Manage the desktop wallpaper observed · 2026-08-28
Health v2 · maintenance only
79/100
- Activity 78
- Release rhythm 68
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-02. Adoption (stars, forks) is never an input.
- gap_med: 39
- age_days: 4170
- days_rel: 136
- days_push: 136
- n_releases_24m: 2
Adoption not part of the score
1093 stars · 93 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
A Node.js library for getting and setting the desktop wallpaper programmatically on macOS, Linux, and Windows. It provides a promise-based API to read the current wallpaper path, set image files, and set solid color wallpapers (macOS only) across multiple screens.
Use cases
- change desktop wallpaper from a node script
- get the current desktop background image path
- set wallpaper on all monitors programmatically
- rotate wallpapers on a schedule
- set a solid color desktop background
- build a wallpaper switcher app
When to choose
- you need to programmatically get or set the desktop wallpaper in Node.js
- you want cross-platform support across macOS, Linux, and Windows
- you need per-screen wallpaper control on macOS
When to avoid
- you need dynamic wallpapers like websites, video, or WebGL backgrounds
- you need reliable Linux support, which currently lacks a maintainer
- you are not working in a Node.js/JavaScript environment
Facets
library · maturity active
gui file-system image-processing desktop-applications cross-platform windows desktop-wallpaper npm-package promise-api multi-monitor automation macos linux nodejs
2 sources
- readme: https://github.com/sindresorhus/wallpaper · fetched 2026-08-28 · b4bb7870ddfc
- registry_npm: https://registry.npmjs.org/wallpaper · fetched 2026-08-29 · 2f97530a0f09
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| sindresorhus/wallpaper | main | 79 |
For agents
markdown · JSON · MCP: product_card(name="sindresorhus/wallpaper")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem