Star growth

Today—

This week—

This month—

Repository activity

Activity history will appear here once this repo has been tracked for a couple of days.

Embed badge

Show this repository's current trending rank in your README.

Markdown for your README

[![Trending on Repoburst](https://www.repoburst.com/api/badge/iamjhe08/VidGrab)](https://www.repoburst.com/repo/iamjhe08/VidGrab)

README

VidGrab

A video downloader for iPhone. Paste a link, pick a quality, done. Or open the built-in browser, play a video, and tap the Download button that pops up on it.

I made this because I wanted something simple that just works on my phone, without jailbreak tweaks or a pile of extra packages to install.

Made by T4MAG0 · github.com/iamjhe08

What it can do

Download from YouTube and lots of other sites, up to 4K when the site has it
Browse sites inside the app and grab whatever video is playing
Ad blocker in the browser
Run up to 10 downloads at the same time
Saves videos as MP4 so they play right away and can go into Photos
Save just the sound as MP3 or M4A
Keeps YouTube videos in their original language instead of a dubbed track
Favorites you can add, rename and rearrange
Clear the cache by hand or automatically every time the app opens
A "Fix playback" button for videos that won't play properly

Install

Go to the Releases page and download the latest VidGrab.ipa.
Install it with TrollStore, or any sideloading app you already use.

Works on iOS 15 and newer. No jailbreak needed.

Credits

VidGrab wouldn't exist without yt-dlp. It's the engine that does the real work of finding and downloading videos from all these sites. Huge thanks to the yt-dlp developers and everyone who keeps it working as sites change. If a site breaks, VidGrab can update yt-dlp from Settings, so fixes from their team reach you quickly.

Also used:

FFmpeg for joining video and sound and converting files (LGPL 2.1 or later)
LAME for MP3 (LGPL)
Python for iOS by BeeWare, which lets yt-dlp run on iPhone (PSF License)
certifi, requests, urllib3, idna, charset-normalizer and websockets (Python packages yt-dlp relies on)
Ad-block filter lists from uBlock Origin Lite (GPLv3) and Peter Lowe's list (free for non-commercial use)

Building it yourself

You'll need Theos (iOS 16.5 SDK) on Linux or macOS, plus:

BeeWare's Python.xcframework (3.14), with ios-arm64/Python.framework copied into vendor/ios-arm64
FFmpeg 7.1.1 and LAME 3.100 built as static iOS libraries
yt-dlp and its Python packages installed into an app_packages folder

Set the paths at the top of Makefile and assemble.py, then:

make FINALPACKAGE=1
python3 assemble.py

You'll get VidGrab.ipa in the project folder.

License

GPL v3, see LICENSE. The libraries listed above keep their own licenses.

Please only download videos you're allowed to save, and respect each site's rules.