31 lines
1.2 KiB
Markdown
31 lines
1.2 KiB
Markdown
# YouTube Maze
|
|
|
|
Some YouTube creators have made video-gamebooks during which viewers are invited to make choices that influence the course of the narration.
|
|
This is generally implemented by breaking up the video into short interlinked segments.
|
|
This tool automatically generates visual representations of the networks underlying such games.
|
|
|
|
[See it live →](https://youtube-maze.delab.re)
|
|
|
|
## How Does it Work?
|
|
|
|
The [exploration algorithm](lib/explore.mjs) automatically downloads metadata about each video from YouTube and then proceeds to a breadth-first search to generate a graph which is laid out using [Graphviz](http://www.graphviz.org).
|
|
Only the links in the end screens and in the in-video cards are considered for the exploration.
|
|
|
|
## Running Locally
|
|
|
|
You can also run the server locally, provided you have a working installation of Node.JS and Graphviz.
|
|
|
|
```
|
|
git clone https://forge.delab.re/matteo/youtube-maze.git
|
|
cd youtube-maze
|
|
npm install
|
|
npm start
|
|
```
|
|
|
|
If everything goes as planned, you should be able to access the server by opening `http://localhost:3000` in your browser.
|
|
|
|
## License
|
|
|
|
This software is made available under the MIT license.
|
|
[See the full license text →](LICENSE)
|