@pqmcgill/wallpaper
    TypeScript icon, indicating that this package has built-in type declarations

    4.4.1 • Public • Published

    wallpaper Build Status Build status

    Get or set the desktop wallpaper

    Works on macOS 10.12+, Linux, and Windows 10+.

    Maintainer needed for the Linux part of the code. No new Linux-related changes will be accepted until someone with good Linux knowledge volunteers.

    Install

    $ npm install wallpaper
    

    Usage

    const wallpaper = require('wallpaper');
    
    (async () => {
    	await wallpaper.set('unicorn.jpg');
    
    	await wallpaper.get();
    	//=> '/Users/sindresorhus/unicorn.jpg'
    })();

    API

    .get(options?)

    Returns a Promise<string> with the path of the current desktop wallpaper.

    options

    Type: object

    screen (macOS only)

    Type: string | number
    Values: 'all', 'main', or the index of a screen from .screens()
    Default: 'main'

    The screen to get the wallpaper from.

    If you set 'all' then .get() will return a Promise<string[]>.

    .set(imagePath, options?)

    Returns a Promise.

    imagePath

    Type: string

    The path to the image to set as the desktop wallpaper.

    options

    Type: object

    screen (macOS only)

    Type: string | number
    Values: 'all', 'main', or the index of a screen from .screens() Default: 'all'

    The screen to set the wallpaper on.

    On Linux and Windows it's hard-coded to 'main'.

    scale (macOS only)

    Type: string
    Values: 'auto' | 'fill' | 'fit' | 'stretch' | 'center'
    Default: 'auto'

    Scaling method.

    .screens() (macOS only)

    Returns a Promise<string[]> with the available screens.

    (async () => {
    	await wallpaper.screens();
    	//=> ['Color LCD']
    })();

    Related

    Install

    npm i @pqmcgill/wallpaper

    DownloadsWeekly Downloads

    1

    Version

    4.4.1

    License

    MIT

    Unpacked Size

    11.4 MB

    Total Files

    24

    Last publish

    Collaborators

    • pqmcgill