Troubleshooting

"Could not download video"

This usually means the video couldn't be extracted from the post. Try these steps:

1. Check if the video is available - Some videos may be deleted or restricted
2. Copy the link and try again - Copy the post URL and run TVDL from the Shortcuts app
3. Update TVDL - You may be using an outdated version. See How to Update
4. Try again later - Sometimes platforms have temporary issues

"Network error"

This means TVDL couldn't connect to our servers:

1. Check your internet connection - Make sure you're connected to WiFi or have cellular data
2. Try again on a different network - Some networks may block our servers
3. Disable VPN - VPNs can sometimes interfere with downloads
4. Wait and retry - Our servers may be temporarily busy

"No video found"

The post may not contain a downloadable video:

1. Verify there's a video - Some posts only have images or GIFs
2. Try the direct link - Copy the post URL and paste it when running TVDL

"Shortcuts doesn't have permission to run scripts"

1. Open Settings > Shortcuts
2. Enable Allow Running Scripts
3. Also enable Private Sharing if prompted
4. Try running TVDL again

"TVDL can't save to Photos"

1. Open Settings > Privacy & Security > Photos
2. Find Shortcuts in the list
3. Change permission to Add Photos Only or Full Access
4. Try running TVDL again

"Network access denied"

1. Open Settings > Shortcuts
2. Make sure Allow Sharing Large Amounts of Data is enabled
3. Try running TVDL again

If TVDL doesn't appear when you tap Share:

1. Edit your Share Sheet - Tap Edit Actions at the bottom of the Share Sheet
2. Enable TVDL - Find TVDL in the list and toggle it on
3. Move TVDL up - Drag it higher in the list so it's easier to find
4. Restart your device - Sometimes a restart helps refresh the Share Sheet

"An error occurred while running the shortcut"

1. Delete and reinstall - Remove the shortcut and download it again from tvdl.app
2. Check for updates - Make sure you have the latest version
3. Restart Shortcuts - Force close the Shortcuts app and reopen it
4. Restart your device - A restart can fix many issues

"This shortcut cannot be opened"

The shortcut file may be corrupted:

1. Delete the shortcut from your library
2. Clear your browser cache
3. Download a fresh copy from tvdl.app

Low quality video

By default, TVDL tries to get the highest quality available. If you're getting low quality:

1. Check the original - Some videos are uploaded in low quality
2. Select quality manually - When prompted, choose a higher resolution
3. Consider Pro - TVDL Pro includes Max-Q for maximum quality downloads

Video has no audio

This is rare but can happen with some platform-specific issues:

1. Check the original - Some videos don't have audio
2. Try downloading again - It may be a temporary extraction issue
3. Report the issue - Contact us with the video link so we can investigate

TVDL 4.1 and TVDL Pro 5.1 both run unchanged on iOS 27, so the shortcut itself needs no update. A major iOS update can still reset a couple of things on your device.

"TVDL vanished from the Share Sheet"

This is the most common thing people report after a major update.

1. Open the Shortcuts app and find TVDL
2. Tap the ... on the TVDL card, then tap the details or info button
3. Make sure Show in Share Sheet is turned on
4. Restart your iPhone, then open the Share Sheet again

The TVDL Not Showing in Share Sheet section above has the full walkthrough if it still does not appear.

"It asked for permissions again"

This is normal. A major iOS update can clear the permissions you granted before.

1. Run TVDL once and tap Allow for scripts, Photos, and network access, just like the first run
2. See Getting Started for what each prompt is asking for

"Downloads fail only since the update"

1. Restart your iPhone - this clears most post-update oddities
2. Delete and re-add the shortcut - remove TVDL, then add a fresh copy from your download link. See How to Update
3. Contact us - send us a message and include your iOS version

For the full rundown of what iOS 27 changed and what it did not, read TVDL works on iOS 27.

If none of these solutions work:

1. Check our status page - There may be a known issue we're working on
2. Update to the latest version - See How to Update
3. Contact support - Send us a message with details about the issue

When contacting support, please include:

• Your TVDL version
• The platform and post you're trying to download from
• Any error messages you see
• Your device and iOS/macOS version