Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/coah80/yoink/llms.txt

Use this file to discover all available pages before exploring further.

Yoink ships as a Progressive Web App (PWA), which means you can add it to your phone’s home screen and use it just like a native app. The most useful consequence of this is the share sheet integration: instead of switching to Yoink, pasting a URL, and tapping download, you can hit the share button inside YouTube, TikTok, Instagram, or any other app and send the link straight to Yoink in one tap. No App Store. No Play Store. No extra setup on the server — the PWA manifest is served automatically from your Yoink URL.

​
Why install the PWA?

Share sheet integration

Send URLs directly from any app using your phone’s native share menu. Yoink appears as a share target alongside Messages, Notes, and other apps.

Standalone experience

Runs without browser chrome — no address bar, no tabs. Looks and feels like a native app with Yoink’s dark purple theme.

Home screen shortcut

Launch Yoink instantly from your home screen. The icon uses the full-resolution 512×512 maskable icon, adapting to your device’s icon shape.

App shortcuts

Long-press the home screen icon to jump directly to Download, Convert, or Compress without opening the main screen first.

​
Install on iOS (Safari)

Safari is required for PWA installation on iOS — other browsers on iOS do not support Add to Home Screen with full PWA capabilities.
1

Open Yoink in Safari

Navigate to your Yoink URL (e.g. https://yoink.example.com) in Safari on your iPhone or iPad.
2

Tap the Share button

Tap the Share icon at the bottom of the screen — it looks like a box with an arrow pointing upward.
3

Tap Add to Home Screen

Scroll through the share sheet actions and tap Add to Home Screen.
4

Confirm the name and add

iOS pre-fills the name as yoink. Tap Add in the top-right corner. The icon appears on your home screen immediately.
After adding to your home screen, Yoink will show up in the iOS share sheet for any app that shares URLs (Safari, YouTube, TikTok, Instagram, X, Reddit, etc.). It may take a moment to appear in the list on the first install.

​
Install on Android (Chrome)

1

Open Yoink in Chrome

Navigate to your Yoink URL in Chrome on your Android device.
2

Open the browser menu

Tap the ⋮ (three-dot) menu in the top-right corner of Chrome.
3

Tap Add to Home Screen or Install app

Depending on your version of Chrome you will see either Add to Home Screen or Install app. Tap it.Chrome may also show an Install banner or prompt at the bottom of the screen automatically — you can tap that instead.
4

Confirm the install

Tap Install (or Add) on the confirmation dialog. The Yoink icon appears on your home screen and in your app drawer.

​
Using the share sheet

Once Yoink is installed, sharing a link to it takes just two taps from any app:
1

Find a video you want to download

Open YouTube, TikTok, Instagram, X, Reddit, or any other app and find the content you want.
2

Tap the share button inside the app

Every app has its own share icon — usually an arrow, a paper plane, or the word “Share”. Tap it to open the native share sheet.
3

Select Yoink from the share sheet

Scroll through the list of apps until you see yoink, then tap it. Yoink opens and the URL is pre-filled in the download box.
4

Choose your format and download

Pick your output format, set any options, and tap Download. You can close Yoink immediately — the download continues in the background on the server.
On iOS, you can drag Yoink to the top row of your share sheet so it always appears without scrolling. Long-press any share sheet icon and tap More → Edit to reorder your favorites.

​
Manifest details

The PWA manifest served by Yoink is configured as follows: 
{
  "name": "yoink.tools",
  "short_name": "yoink",
  "description": "Download videos and audio from YouTube and other sites",
  "start_url": "/",
  "display": "standalone",
  "background_color": "#0a0a0f",
  "theme_color": "#8b5cf6",
  "orientation": "portrait-primary",
  "icons": [
    { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any maskable" },
    { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any maskable" }
  ],
  "share_target": {
    "action": "/share",
    "method": "GET",
    "params": { "url": "url", "text": "text", "title": "title" }
  },
  "categories": ["utilities", "entertainment"],
  "shortcuts": [
    { "name": "Download Video", "url": "/", "description": "Download a video" },
    { "name": "Convert",        "url": "/convert", "description": "Convert media files" },
    { "name": "Compress",       "url": "/compress", "description": "Compress videos" }
  ]
}
The share_target registration is what makes Yoink appear in the native share sheet. When another app shares a URL, the browser passes it to Yoink’s /share route as a url query parameter and the UI pre-populates the download field automatically. The maskable icon purpose tells Android to allow the system to crop and shape the icon to match the device’s icon style (circle, squircle, teardrop, etc.).

Build docs developers (and LLMs) love

Get started for freeTalk to us