Generate stunning 1920×1080 wallpapers from any album artwork — powered by the iTunes Search API.
Album Art Wallpaper Generator is a fully client-side web app built with React and Vite.
Search for any song, album, or artist via the iTunes API, select a result, and instantly generate a wallpaper tailored to your screen format — no backend, no account required.
- iTunes Search API — typed responses with safe fallbacks for artwork resolution (
1000x1000bb→600x600bb→ original) - Canvas-based wallpaper generation
- Blurred and cropped artwork as background
- Dark overlay with gradient for readability
- Centered cover art with rounded corners and subtle drop shadow
- Device format presets — Desktop, Laptop, iPhone, Google Pixel, Android, Tablet
- Real-time blur control — adjust blur strength with a live preview update
- Optional metadata overlay — show or hide album title and artist under the cover
- Promise-based image loading — timeout and abort support for resilient fetching
- One-click PNG download of the generated wallpaper
- Responsive UI with loading and error states
| Search | Result | Wallpaper |
|---|---|---|
| Type an artist or album | Browse iTunes results | Download your wallpaper |
- Node.js ≥ 18
- npm ≥ 9
npm install
npm run devThe app will be available at http://localhost:5173.
| Command | Description |
|---|---|
npm run dev |
Start the development server |
npm run build |
Build for production |
npm run typecheck |
Run TypeScript type checking |
npm run lint |
Lint the codebase with ESLint |
npm run test |
Run the test suite with Vitest |
npm run test:coverage |
Generate a coverage report |
- Search — queries the iTunes Search API and parses the response with full TypeScript types.
- Select — choose a result; the app resolves the best available artwork URL.
- Generate — a
<canvas>renders the wallpaper:- The artwork is drawn, blurred, and cropped to fill the background.
- A dark overlay and gradient are applied for contrast.
- The original cover is composited at the center with rounded corners and a shadow.
- Download — the canvas is exported as a PNG file.
- React 18
- Vite
- TypeScript
- Vitest + Testing Library
- iTunes Search API (public, no key required)
Made by William Perret
Website · GitHub · LinkedIn · Instagram · Buy Me a Coffee
MIT — feel free to use, modify, and distribute.