Third-Party Apps

You can use Awoo with a few outside tools to quickly upload files from your computer. This page covers the apps we officially support and how to get them set up.

ShareX

ShareX is a free uploader app for Windows. Once it's connected to Awoo, anything you send through ShareX — screenshots, documents, videos, clipboard contents — goes straight to your Awoo library, and the short link is copied to your clipboard.

Get set up

The easiest way is to use our setup tool:

→ sharex.awoo.studio

It'll walk you through three short steps:

1. Paste an API token. You can create one from your account settings. When you make the token, tick File write and Short write — the setup tool will let you know if anything's missing.
2. Pick your preferences.
   • Domain — which short URL you'd like your links to use (for example awoo.gg or awoo.download).
   • Name — what you'd like this uploader to be called inside ShareX.
   • Tags (optional) — any tags you'd like Awoo to automatically add to every file uploaded through ShareX (for example sharex, screenshot, document).
3. Download the config file and open it. ShareX will ask if you'd like to install it — say yes, then set Awoo as your default image, text, and file uploader in ShareX's settings.

That's it! You can now take a screenshot or share a file through ShareX, and the link will be in your clipboard a moment later.

What can I upload?

• Up to 100 MB per file. If you try to share something bigger than that, the upload won't go through.
• Uploads also count toward your Awoo storage allowance. If an upload would take you over your plan's limit, it won't be saved — you'll need to free up some space or upgrade your plan before trying again.

Running into trouble?

"Token is missing required scope" The API token you're using doesn't have the right permissions. Head back to your token settings, create a new token with both File write and Short write ticked, and use that one instead.

"Invalid domain" The short URL domain in your ShareX config isn't one Awoo supports. The quickest fix is to regenerate the config with the setup tool and reinstall it in ShareX.

The short link gives a "Not found" page when I click it This usually happens if the config was edited by hand and the domains don't match up anymore. Regenerating the config with the setup tool will sort it out.

Upload fails with "Service unavailable" or nothing happens First, try regenerating your token and config — it's the fastest way to rule out a typo. If that doesn't help, get in touch and we'll take a look.

Prefer to set it up yourself?

If you'd rather configure ShareX manually without using the setup tool, you can. Open ShareX → Destinations → Custom uploader settings, add a new uploader, and fill it in like this:

Field	Value
Method	POST
Request URL	https://api.awoo.studio/api/v1/files/?domain=<your-domain>
Headers	Authorization: token <your-token>
Body	Multipart form data
File form name	file
URL	https://<your-domain>/{json:short}
Deletion URL	https://api.awoo.studio/api/v1/files/{json:id}
Error message	{json:error}

Replace <your-domain> with the Awoo short URL host you'd like to use (e.g. awoo.gg) and <your-token> with an API token that has File write and Short write permissions. If you'd like Awoo to automatically tag your uploads, add &tags=tag1,tag2 to the end of the Request URL.