Unsplash logo

Unsplash

Search images or collections on Unsplash, download, copy or set them as wallpaper without leaving Raycast!
EGGSY eggsy
1,721 Installs
Share
Overview README

Commands 4

Search Images logo Search Images

Search images on Unsplash.

Search Collections logo Search Collections

Search collections on Unsplash.

Liked Images logo Liked Images

View your liked images on Unsplash.

Set Random Wallpaper logo Set Random Wallpaper

Set a random wallpaper from Unsplash.


Unsplash

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

Configuration

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)

FAQ


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, 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!