Download and watch videos easily on iOS

Chompy wraps youtube-dl in an API, allowing ad-free downloading and streaming on devices that can't run youtube-dl directly, such as iOS.

1. Build & Install via Docker. Sorry, we don't have images published on DockerHub yet.
   • You'll want to set the /downloads volume
2. Install the associated shortcut and set your hostname.
3. Trigger a download by sharing a video URL to the shortcut. You can exit while the shortcut is downloading, but you won't be automatically redirected when the download completes.

You can see all the videos downloaded by visiting /videos

The default format for downloaded videos is mp4, at resolutions up to 1080p. You can see the format string in downloader/options.go.

Set the format for a download by setting the format request parameter. Details on format strings in youtube-dl docs. For instance:

http -v post localhost:8000/download url="https://www.youtube.com/watch?v=L5emxkKNf9Y" format='worstvideo'

Dependencies: ffmpeg and youtube-dl. API examples use HTTPie

Run the app

go run ./cmd/chompy

Download something exciting

http -v post localhost:8000/download url="https://www.youtube.com/watch?v=L5emxkKNf9Y"

HTTP/1.1 200 OK
Content-Length: 168
Content-Type: application/json; charset=UTF-8
Date: Thu, 24 Dec 2020 23:40:11 GMT

{
    "filename": "How to Protect Your Shopping Trolley From Improvised Explosives.mp4",
    "path": "/videos/How to Protect Your Shopping Trolley From Improvised Explosives.mp4"
}

Then play it

http 'localhost:8000/videos/How to Protect Your Shopping Trolley From Improvised Explosives.mp4'
HTTP/1.1 200 OK
Accept-Ranges: bytes
Content-Length: 34311123
Content-Type: video/mp4

docker build -t chompy .

docker run -p 8000:8000 chompy