Mobile Share Setup

한국어

Mobile sharing sends a URL directly from your phone to the youtube-dl-nas instance running on your NAS. GitHub Pages only hosts this guide and the import files; it never receives your NAS address, ID, password, token, or shared URL.

Android On HTTPS

1. Open your HTTPS youtube-dl-nas address in Chrome.
2. Sign in and accept the terms.
3. Choose Install app or Add to Home screen from Chrome’s menu.
4. In YouTube, tap Share, then choose youtube-dl NAS.

The installed PWA receives the shared URL. In dashboard Options, choose Best, Compatible MP4, 1080p, 720p, MP3, M4A, Opus, or Ask every time as this device’s mobile share default. Ask mode opens the composer with the URL filled in; the other profiles queue it immediately. If your login expired, sign in and the same flow continues without exposing the shared URL in the redirect.

Playlist and channel shares always open the composer so Playlist Guard can require an explicit First 10 or All items scope.

Android On Local HTTP

Use the open-source HTTP Shortcuts app because Android cannot install a local HTTP site as a PWA.

1. Install HTTP Shortcuts.
2. Import the youtube-dl-nas template, or download the ZIP file and import it manually.
3. Open the imported youtube-dl NAS category and run 1. Configure NAS once.
4. Enter the full NAS address, normal dashboard ID, password, and default profile. For example, use http://192.168.0.20:8080 and best.
5. Share a URL and select Download to NAS. The saved settings are reused without asking again.

The REST API token is optional. The default template uses the same ID and password as the dashboard.

The shortcut accepts Best, Compatible MP4, 1080p, 720p, MP3, M4A, or Opus as a saved default. It checks both the Android share title and text. If the device omits the URL from that data, it opens a URL input as a fallback. Incomplete configuration stops before any network request is made.

iPhone And iPad

The signed Smart Share v2 Shortcut uses the normal dashboard ID and password. Download Download to NAS.shortcut and open it in Shortcuts.

1. During import, enter the NAS base URL without a trailing slash, such as http://192.168.0.20:8080.
2. Enter the normal dashboard ID and password.
3. Enter best, compatible-mp4, 1080p, 720p, audio-mp3, audio-m4a, audio-opus, or ask as the default profile.
4. Choose Add Shortcut. You do not need to edit any actions.
5. In YouTube or Safari, tap Share, then choose Download to NAS.

Routine shares use the saved profile without another prompt. ask opens a compact profile menu. Pure playlists and channels ask for First 10 or All items, and YouTube links with a timestamp ask whether to download the full video or start from that position. Running the Shortcut manually opens a URL field when no Share Sheet input exists.

The Shortcut first asks your NAS to inspect the shared text, then sends the resolved request directly to the NAS:

{
  "url": "First URL in Shortcut Input",
  "resolution": "best",
  "playlist_mode": "single",
  "section_mode": "full",
  "id": "YOUR_ID",
  "pw": "YOUR_PASSWORD",
  "client": "ios-shortcut",
  "client_version": "2.1"
}

The result states whether the item was added, was already queued, or already exists on the NAS, and includes its queue position when available. The file is exported for installation by anyone and signed through Apple’s Shortcuts tooling. It contains placeholders only; no real NAS address or credentials are included.

Outside Your Home Network

Do not expose the plain HTTP port directly to the internet. Connect through a VPN such as Tailscale, or use an HTTPS reverse proxy on the NAS. Set COOKIE_SECURE=true when the dashboard is served exclusively through HTTPS.