Raycast
The Frameleaf extension for Raycast searches the albums you choose and lets you open, copy or download a photo without leaving the keyboard. It works with Raycast on Mac and Windows, and only reads your library.
Install
Section titled “Install”The extension ships in the Frameleaf source, in integrations/raycast. With Node.js 22.22 or later:
- In that folder, run
npm ci. - Run
npm run dev. Raycast loads the extension, and it stays after you stop the command.
Connect your library
Section titled “Connect your library”- Open any Frameleaf command in Raycast.
- Enter your Library address, such as
https://photos.example.com. A home-network address such ashttp://192.168.1.20:2283also works. - Your browser opens Frameleaf. Sign in if asked, choose the albums Raycast may see, or Read my whole library, and choose Allow.
Raycast asks only to see and search your photos, videos and albums. To download originals too, turn on Original downloads (Ask to download originals) in the extension’s preferences before you connect.
At home, your server’s home-network address or your own HTTPS address works without a Frameleaf plan. Connecting through Frameleaf’s remote access needs a plan that includes it.
Commands
Section titled “Commands”- Search Photos: search the albums you allowed, for photos, videos or both.
- Browse Albums: open an album and look through it.
- Disconnect Library: end Raycast’s access and forget the sign-in.
On a photo:
| Action | Mac | Windows |
|---|---|---|
| Open in Frameleaf | Return | Enter |
| Copy image | ⌘ ⇧ C | Ctrl Shift C |
| Copy link | ⌘ ⇧ L | Ctrl Shift L |
| Download | ⌘ D | Ctrl D |
| Download Original | ⌘ ⇧ D | Ctrl Shift D |
| Reload | ⌘ R | Ctrl R |
Download saves a large JPEG to your Downloads folder, without location or camera details. Download Original saves the original file with its details. Neither overwrites a file that’s already there. A video downloads as a still picture.
If you turn on Original downloads after connecting, a photo shows Allow Original Downloads, which asks you in Frameleaf. Turning the preference off swaps the connection for one that can only see photos, so you sign in again.
Raycast fetches a preview only for the photo you’ve selected, and deletes previews when the command closes.
Client ID
Section titled “Client ID”The extension normally registers itself. If your administrator has turned that off, they register it once:
- Open Settings, then Who can sign in, then Sign-in methods. Under Registered apps, choose Set up an app.
- Under Name, choose Other and enter
Raycast. - In Sends you back to, enter
https://raycast.com/redirect?packageName=Extension. - Choose Create and share the App ID. Enter it as Client ID in the extension’s preferences.
| Raycast says | What to do |
|---|---|
| Library unavailable | Check the server is on and this computer can reach the address |
| Not connected | Choose Connect Again. Access was removed or ran out |
| This address now belongs to a different Library | The address now points at another server. Disconnect, then connect to it if you meant to |
Disconnect
Section titled “Disconnect”Run Disconnect Library. Raycast ends its access in Frameleaf and forgets the sign-in. If your server can’t be reached, Raycast tries again later; you can also remove Raycast in Frameleaf under Settings, then Your sign-in & privacy, then Connected apps. That’s also where you change the albums it may see. Files you downloaded stay on your computer.
The extension’s labels are in English. Setup help is in integrations/raycast/help in all eleven Frameleaf languages.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.