https://github.com/rroller/media-roller

A self hosted server to download videos from social media with an iOS shortcut for on-click saving to camera roll
https://github.com/rroller/media-roller

ffmpeg golang media social-media youtube-dl

Last synced: 3 months ago
JSON representation

A self hosted server to download videos from social media with an iOS shortcut for on-click saving to camera roll

• Host: GitHub
• URL: https://github.com/rroller/media-roller
• Owner: rroller
• Created: 2020-02-03T03:05:45.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-10-21T03:40:38.000Z (3 months ago)
• Last Synced: 2024-10-22T02:56:32.290Z (3 months ago)
• Topics: ffmpeg, golang, media, social-media, youtube-dl
• Language: Go
• Homepage:
• Size: 165 KB
• Stars: 72
• Watchers: 7
• Forks: 10
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Media Roller

A mobile friendly tool for downloading videos from social media.

The backend is a Golang server that will take a URL (YouTube, Reddit, Twitter, etc),

download the video file, and return a URL to directly download the video. The video will be transcoded to produce a single mp4 file.

This is built on [yt-dlp](https://github.com/yt-dlp/yt-dlp). yt-dlp will auto update every 12 hours to make sure it's running the latest nightly build.

Note: This was written to run on a home network and should not be exposed to public traffic. There's no auth.

![Screenshot 1](https://i.imgur.com/lxwf1qU.png)

![Screenshot 2](https://i.imgur.com/TWAtM7k.png)

# Running

Make sure you have [yt-dlp](https://github.com/yt-dlp/yt-dlp) and [FFmpeg](https://github.com/FFmpeg/FFmpeg) installed then pull the repo and run:

```bash

./run.sh

```

Or for docker locally:

```bash

 ./docker-build.sh

 ./docker-run.sh

```

With Docker: `ronnieroller/media-roller:latest`.

See https://hub.docker.com/repository/docker/ronnieroller/media-roller

The files are saved to the /download directory which you can mount as needed.

# API

To download a video directly, use the API endpoint:

```

/api/download?url=SOME_URL

```

Create a bookmarklet, allowing one click downloads (From a PC):

```

javascript:(location.href="http://127.0.0.1:3000/fetch?url="+encodeURIComponent(location.href));

```

# Integrating with mobile

After you have your server up, install this shortcut. Update the endpoint to your server address by editing the shortcut before running it. 

https://www.icloud.com/shortcuts/d3b05b78eb434496ab28dd91e1c79615

# Unraid

media-roller is available in Unraid and can be found on the "Apps" tab by searching its name.