ronnieroller/media-roller repository overview

⁠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 transcoced as needed to produce a single mp4 file.

This is built on youtube-dl⁠ which has a list of supported sites⁠.

Note: This was written to run on a home network and wasn't originally written to be exposed to public traffic. Currently there's no auth. This might change and feel free to send a pull request, but right now, keep this on your internal network and do not expose it.

⁠Running

Make sure you have youtube-dl⁠ and FFmpeg⁠ installed then pull the repo and run:

./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 you have you server up, install this shortcut. Update the endpoint to your server address by editing the shortcut before running it.

https://www.icloud.com/shortcuts/2b9765fb5bf24509a4e83bc76c5c7409⁠

⁠Unraid

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

⁠Open Issues, missing features

• Conversions are slow, need to be sped up
• Needs to support auth
• Needs a better way to track downloaded media and manage it
• Add ablity to prefer certain quality or format