How to Use

TVDL makes downloading videos simple. Just share a video to the shortcut and it handles the rest.

Using the Share Sheet (Recommended)

The easiest way to use TVDL is through the Share Sheet:

Step 1: Find a Video

Open your social media app (X, Bluesky, Mastodon, etc.) and find a video you want to download.

Step 2: Tap Share

Tap the Share button on the post. On X, this is the share icon at the bottom of a tweet. On Bluesky and Mastodon, look for the share or more options menu.

Step 3: Select TVDL

In the Share Sheet, scroll through the actions and tap TVDL.

If you don't see TVDL, tap Edit Actions at the bottom and enable it.

Step 4: Choose Quality (Optional)

Some videos offer multiple quality options. If prompted, select your preferred resolution.

Step 5: Done!

The video will download and save to your Photos library. You'll see a confirmation when it's complete.

Running from the Shortcuts App

You can also run TVDL directly from the Shortcuts app:

Open the Shortcuts app
Find and tap the TVDL shortcut
Paste a video URL when prompted, or the shortcut will use your clipboard
Wait for the download to complete

Supported Platforms

TVDL 4.1 supports all major platforms in one shortcut:

X (Twitter) posts with videos
Thread videos
Quoted tweets with videos
Animated GIFs
Bluesky posts with videos
Mastodon posts with videos
Additional platforms added regularly

Tips for Best Results

Copy the Link First

If the Share Sheet isn't working, try copying the post link first, then running TVDL from the Shortcuts app. The shortcut will automatically use the URL from your clipboard.

Check Your Connection

Downloads require a stable internet connection. If a download fails, try again on WiFi.

Keep TVDL Updated

We regularly update TVDL to fix issues and add new features. Check How to Update to make sure you have the latest version.

Troubleshooting

"No video found" - Make sure the post actually contains a video, not just an image
Download fails - Check our Troubleshooting Guide for common issues
TVDL not in Share Sheet - See the Getting Started guide to enable it