Extension Icon


Search images or collections on Unsplash, download, copy or set them as wallpaper without leaving Raycast!
7,010 Installs


A Raycast extension that lets you communicate with Unsplash's API and gives you access to some functions.


You will need some additional steps to install this plugin.

  • Unsplash API key, you can get one from here (only the "Public access" permission is enough)
  • Install the extension from Raycast Store
  • Type Unsplash to display all available options
  • Choose one and fill in the blanks with the details
    • Access Key: Your Unsplash API key (required)
    • Username: Username of the person you want to list likes of.
    • Orientation: The orientation of the images on results. (Default: all)
    • Download Size: The sizes when downloading, copying, and saving image to disk. (Default: full)
    • Custom Collections: The collection IDs you want to get random images out of while setting a random wallpaper. The list should be comma & space seperated as in ID1, ID2, ID3, etc.. (Default: 4324303, 8647859, 298137, 2476111, 1065976, 3430431, 1114848, 2063295, 9389477, 932210)
    • Include Default Collections: When you set custom collections, you can choose to include the default collections as well. (Default: no)
    • Wallpaper Path: The folder to store wallpapers. (Default: ~/Library/Application Support/com.raycast.macos/extensions/unsplash/)


Q: Why does it ask for a permission when setting a desktop wallpaper?

A: If you haven't granted Raycast the permission to change your desktop wallpaper, this extension will ask for it once.

Q: Where does it save the downloaded images?

A: It uses your Application Support directory as default, which should be at ~/Library/Application Support/com.raycast.macos/extensions/unsplash/.

Q: I set "Download Size" option to a different value but it's always downloading the same images!

A: Well, if Unsplash doesn't return an image URL for the value you selected, or if it returns the same image for all values, the extension simply downloads it. If it's not found, extension will fallback to another value.

Q: Couldn't set the wallpaper using "Set Random Wallpaper" because I rejected the permission request!

A: If you accidentally rejected the initial permission request window, or didn't realize it was from this extension, you'll have to go to your System Preferences > Security & Privacy > Privacy > Automation and grant/tick the System Events permission to Raycast.

More? Feel free to create an issue!