> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinata Raycast Extension

<img style={{ width: '100%', borderRadius: '0.5rem'}} src="https://docs.mypinata.cloud/ipfs/bafybeiajqxwq7jmohjqlyfax2ywni7fhaixiru5nnvlosmgzwazg7cumxy" />

If you happen to use [Raycast](https://raycast.com), a MacOS tool for boosting your productivity, Pinata has an extension you can download from the Extension Store!

<iframe width="600" height="400" src="https://www.youtube.com/embed/cW6OBFSDA34?si=sG6faDwIqTPGhdBR" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen style={{ width: '100%', borderRadius: '0.5rem' }} />

## Getting Started

In order to use this extension you will need a Pinata API Key JWT and a Dedicated Gateway, which are both included on the free plan! Here is a guide on making your API key, and here is where you can find your Dedicated Gateway domain.

You will also need to install Raycast to your computer which you can do by visit [Raycast](https://raycast.com).

Next visit the [Pinata Extension](https://raycast.com/pinata/pinata) store page and click "Install Extension" in the top right.

<img style={{ width: '100%', borderRadius: '0.5rem'}} src="https://docs.mypinata.cloud/ipfs/bafybeihahtwtq6wr3r6w7a63q4adwg3lw7w3yimgmwmqz4r32h6sbs62ue" />

Once installed you can try running it, and it should prompt you to add some details before using the extension. Paste in your Pinata API Key JWT from earlier, as well as the domain for your Dedicated Gateway. It should be in the format of `https://mygateway.mypinata.cloud`.

<img style={{ width: '100%', borderRadius: '0.5rem'}} src="https://docs.mypinata.cloud/ipfs/bafybeihgyphsddtnvfnx72ztmnolysnoltvvi6g7zvkjtgo3vft2jb3f7y" />

## Uploading Files

To upload a file simply open Raycast and start tying "upload file" and you should see the Pinata command to upload. You can either upload a file or a folder! After selecting you can select the file and give it a name, then use `Command + Enter` to upload it.

<img style={{ width: '100%', borderRadius: '0.5rem'}} src="https://docs.mypinata.cloud/ipfs/bafybeibzgtru5w7t4arqo3ybcwy5xs322nxlmp4pjmyc7ejswwq5tph6f4" />

## Listing Files

You can also list your most recent files by opening Raycast and typing "list files." This will return your most recent files where you can search for a CID or file name in particular, as well as:

* Open the file in your web browser with `enter`
* Copy the CID for the file with `Command + Enter`

<img style={{ width: '100%', borderRadius: '0.5rem'}} src="https://docs.mypinata.cloud/ipfs/bafybeif5l5sr4wfqqox4otad3tno4gfnebgurqeddirpi4354humdpasoi" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.