chrome.wallpaper

Description: Use the chrome.wallpaper API to change the ChromeOS wallpaper.
Availability: Since Chrome 43.
Permissions: "wallpaper"

Important: This API works only on Chrome OS.

Manifest

You must declare the "wallpaper" permission in the app's manifest to use the wallpaper API. For example:

      {
        "name": "My extension",
        ...
        "permissions": [
          "wallpaper"
        ],
        ...
      }

Examples

For example, to set the wallpaper as the image at http://example.com/a_file.png, you can call chrome.wallpaper.setWallpaper this way:

      chrome.wallpaper.setWallpaper(
          {
            'url': 'http://example.com/a_file.jpg',
            'layout': 'CENTER_CROPPED',
            'filename': 'test_wallpaper'
          }, function() {});
      

Summary

Types
WallpaperLayout
Methods
setWallpaper chrome.wallpaper.setWallpaper(object details, function callback)

Types

WallpaperLayout

The supported wallpaper layouts.
Enum
"STRETCH", "CENTER", or "CENTER_CROPPED"

Methods

setWallpaper

chrome.wallpaper.setWallpaper(object details, function callback)

Sets wallpaper to the image at url or wallpaperData with the specified layout

Parameters
object details
binary (optional) data

The jpeg or png encoded wallpaper image as an ArrayBuffer.

string (optional) url

The URL of the wallpaper to be set (can be relative).

WallpaperLayout layout

The supported wallpaper layouts.

string filename

The file name of the saved wallpaper.

boolean (optional) thumbnail

True if a 128x60 thumbnail should be generated. Layout and ratio are not supported yet.

function callback

The callback parameter should be a function that looks like this:

function(binary thumbnail) {...};
binary (optional) thumbnail

The jpeg encoded wallpaper thumbnail. It is generated by resizing the wallpaper to 128x60.