whatisgithub

What is mattdownloader?

matthewnet/mattdownloader — explained in plain English

Analysis updated 2026-05-18

20Audience · vibe coderComplexity · 2/5LicenseSetup · moderate

In one sentence

A GitHub Actions template that downloads files on GitHub's servers so the MattDownloader Android app can fetch them later.

Mindmap

mindmap
  root((MattDownloader Relay))
    What it does
      Downloads via GitHub Actions
      Stores files in fork
      App fetches later
    Setup
      Fork repo
      Enable Actions
      Create scoped token
    Workflows
      download-split
      delete-job
      cleanup-expired-jobs
    Tech stack
      GitHub Actions
      YAML
    Audience
      Android app users
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Relay slow or blocked phone downloads through a GitHub Actions runner instead of downloading directly.

USE CASE 2

Fork the template to a personal GitHub account to give the MattDownloader app a private, controlled download backend.

USE CASE 3

Automatically split large downloaded files into chunks the GitHub API can store and serve.

What is it built with?

GitHub ActionsYAML

How does it compare?

matthewnet/mattdownloaderaaronz345/athena-personal-academic-pageabolix/xplex
Stars202020
LanguageJavaScriptGo
Setup difficultymoderatemoderatehard
Complexity2/52/53/5
Audiencevibe coderresearcherops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires forking the repo, enabling Actions, and generating a scoped GitHub token before the app works.

MIT License: use, copy, and modify freely, including for commercial purposes, as long as the copyright notice is kept.

So what is it?

MattDownloader GitHub Relay is a GitHub Actions template that helps an Android app called MattDownloader fetch files more reliably. Instead of downloading a file straight to a phone, the workflow runs the download on a GitHub server, saves the result inside a fork of this template under a jobs folder, and lets the app pick it up from there later. The idea came from another project and is meant as a stable relay for times when direct phone downloads are slow, blocked, or unreliable. This repository only contains the workflow files and setup instructions. There is no mobile app source code here and no APK stored in the repository, the APK has to be downloaded separately from the Releases page. To use it, a person forks the repository, ideally with a separate GitHub account rather than their main one, since all forking, workflow runs, and downloaded files will live under whichever account is used. After forking, they turn on GitHub Actions for the fork, install the MattDownloader app, and create a fine-grained personal access token scoped only to that fork, with read-only access to contents and read and write access to Actions. That token and the fork's address are then entered into the app. Once set up, giving the app a file link makes it trigger the workflow on the fork, wait for a manifest file to appear, and then download the prepared file from GitHub. Large files are split into chunks of about 95 megabytes so the GitHub API can handle them. There are also workflows for deleting a finished job and for cleaning up old job folders automatically. The README recommends using a limited-scope token rather than one with broad account access, since that reduces what could go wrong if the token were exposed. The project is released under the MIT License and includes optional cryptocurrency donation addresses for anyone who finds the template useful.

Copy-paste prompts

Prompt 1
Walk me through forking this repository and enabling GitHub Actions on my fork.
Prompt 2
Help me create a fine-grained GitHub token scoped only to my MattDownloader fork.
Prompt 3
Explain what the manifest.json file does and how the app reads it after a download job finishes.
Prompt 4
What is the difference between the single and chunked download modes in this workflow?

Frequently asked questions

What is mattdownloader?

A GitHub Actions template that downloads files on GitHub's servers so the MattDownloader Android app can fetch them later.

What license does mattdownloader use?

MIT License: use, copy, and modify freely, including for commercial purposes, as long as the copyright notice is kept.

How hard is mattdownloader to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mattdownloader for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.