RepoTale Tell a tale

Any repo, mapped and filmed.

Paste a GitHub repository, a pull request or any website. See how it is built, where to start reading and what a change can break, each claim linked to the line behind it. Then watch it as a narrated film.

Press Enter. The code is read in your browser, straight from GitHub. Nothing is uploaded and nothing is run.

Live site, private repository, or rate limit?

If the project runs somewhere its GitHub page does not mention, give its address and the film will show its pages.

A fine-grained token with read-only access to contents lifts the limit from 60 to 5,000 requests an hour. It stays in this tab's memory and is sent only to api.github.com.

Reading many website pages? A free key from jina.ai lifts the limit of 20 pages a minute. It stays in this tab and goes only to r.jina.ai.

RepoTale, drawn by RepoTale

Watch one it made

A minute on the ky HTTP client and the expressjs.com website, rendered, scored and narrated by RepoTale in your browser. Pick a voice.

Stills from real films

expressjs.com, filmed from its link. The camera found the headline on its own and the narration reads the page’s first sentence.
A film frame: the ky HTTP client seen from above, five subsystems as cards joined by arrows that carry their import counts.
sindresorhus/ky from above: five subsystems, one arrow per pair, each with its real import count.
A film frame: ky's Utils subsystem opened, its files inside and the subsystems it talks to as single boxes above and below.
Then it opens the busiest subsystem: its own files inside, its neighbours folded into single boxes.
A film frame: a second expressjs.com page scrolled to its detail, with its caption.
Every page of a website gets its own scene, read from the live page.

How it works

First, read the whole tree

One request lists every file at the latest commit. Up to 220 source files are then read from GitHub's raw host, preferring code near the top of the tree over tests and vendored folders.

Read the film out loud as it plays

A neural voice made in your browser, four to choose from. Each scene lasts as long as its sentence.

Burn captions into every frame

For people watching with the sound off, in the player and in the downloaded video.

Put test files on the map

Tests are counted either way; this only draws them.

Draw imports that point backward

A backward import goes against the flow from callers to foundations.

Tell the tale of

It reads the repository you name, then opens the film at the top of this page.