Advanced Topics: Integrations & Automation

MeTube can be integrated with various tools to make adding downloads even easier, from browser extensions to mobile shortcuts.

Important Note: For most of these integrations to work correctly, your MeTube instance must be accessible via HTTPS if you are adding URLs from an HTTPS page. This typically means running MeTube behind a reverse proxy.

Browser Extensions

Browser extensions allow you to right-click on videos or links and send them directly to your MeTube instance.

iOS Shortcut

An iOS shortcut created by rithask lets you send URLs to MeTube directly from Safari's share menu on an iPhone or iPad.

  • Installation:
    1. Download the shortcut from this iCloud link.
    2. When prompted, enter the full address of your MeTube instance (e.g., https://metube.example.com). This will be saved for future use.
  • Usage:
    1. While on a page with a video in Safari, tap the 'Share' button.
    2. Find and tap the 'MeTube' shortcut in the share sheet.

Bookmarklets

A bookmarklet is a bookmark saved in your web browser that contains JavaScript code instead of a URL. Clicking it will execute the code on the current page.

How to Create a Bookmarklet

  1. Create a new bookmark in your browser's bookmarks bar.
  2. For the name, enter something like "Send to MeTube".
  3. For the URL/Address, copy and paste one of the code snippets below.
  4. Important: Replace https://metube.domain.com in the snippet with the actual URL of your MeTube instance.

Chrome Bookmarklet (with alert notification)

javascript:!function(){xhr=new XMLHttpRequest();xhr.open("POST","https://metube.domain.com/add");xhr.withCredentials=true;xhr.send(JSON.stringify({"url":document.location.href,"quality":"best"}));xhr.onload=function(){if(xhr.status==200){alert("Sent to metube!")}else{alert("Send to metube failed. Check the javascript console for clues.")}}}();

Firefox Bookmarklet (with alert notification)

javascript:(function(){xhr=new XMLHttpRequest();xhr.open("POST","https://metube.domain.com/add");xhr.send(JSON.stringify({"url":document.location.href,"quality":"best"}));xhr.onload=function(){if(xhr.status==200){alert("Sent to metube!")}else{alert("Send to metube failed. Check the javascript console for clues.")}}})();

Bookmarklet with Toast Notification (Chrome)

This version shows a less intrusive notification overlay instead of an alert box.

javascript:!function(){function notify(msg){var sc=document.scrollingElement.scrollTop;var text=document.createElement('span');text.innerHTML=msg;var ts=text.style;ts.all='revert';ts.color='#000';ts.fontFamily='Verdana, sans-serif';ts.fontSize='15px';ts.backgroundColor='white';ts.padding='15px';ts.border='1px solid gainsboro';ts.boxShadow='3px 3px 10px';ts.zIndex='100';document.body.appendChild(text);ts.position='absolute';ts.top=50+sc+'px';ts.left=(window.innerWidth/2)-(text.offsetWidth/2)+'px';setTimeout(function(){text.style.visibility="hidden";},1500);}xhr=new XMLHttpRequest();xhr.open("POST","https://metube.domain.com/add");xhr.send(JSON.stringify({"url":document.location.href,"quality":"best"}));xhr.onload=function(){if(xhr.status==200){notify("Sent to metube!")}else{notify("Send to metube failed. Check the javascript console for clues.")}}}();

Raycast Extension

For users of the Raycast launcher on macOS, dotvhs has created an extension.

  • Installation: Find the MeTube extension on the Raycast Store.
  • Usage: The extension allows you to add videos to MeTube directly from the Raycast command bar.