wallpaper

This is for extensions that provide wallpaper customization features on ChromeOS.

Examples:

• A "daily wallpaper" extension that sets a new wallpaper each day from a service like Bing or Unsplash.
• An extension that lets the user create a slideshow of their favorite photos as a wallpaper.
• A corporate branding extension that sets the company logo as the wallpaper on managed devices.

{
  "name": "My Daily Wallpaper",
  "version": "1.0",
  "manifest_version": 3,
  "permissions": [
    "wallpaper"
  ]
}

Why is it not risky?

This permission (only for ChromeOS) allows an extension to change your desktop wallpaper.

This is a safe, cosmetic permission. It cannot access your files or any personal data. The worst an extension could do is set an ugly wallpaper.

This example sets the wallpaper to a random image from an online source.

// background.js

chrome.action.onClicked.addListener(setRandomWallpaper);

async function setRandomWallpaper() {
  if (!chrome.wallpaper) {
    console.log('Wallpaper API is only available on ChromeOS.');
    return;
  }
  try {
    const imageUrl = 'https://picsum.photos/1920/1080';

    // First, fetch the image data as an ArrayBuffer
    const response = await fetch(imageUrl);
    const image_data = await response.arrayBuffer();

    // Now, set the wallpaper using that data
    await chrome.wallpaper.setWallpaper({
      data: image_data,
      layout: 'STRETCH',
      filename: 'random_wallpaper.jpg'
    });

    console.log('Wallpaper has been changed.');

  } catch (error) {
    console.error('Failed to set wallpaper:', error);
  }
}