matteo/youtube-maze
matteo
/
youtube-maze
1
0
Fork 0
Code Issues Pull Requests Releases Activity

Update README

This commit is contained in:
Mattéo Delabre 2020-11-28 23:14:43 +01:00
parent 5456dcd898
commit 8a75f58f46
Signed by: matteo
GPG Key ID: AE3FBD02DC583ABB
1 changed files with 12 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
README.md
View File

@ -1,26 +1,29 @@
# YouTube Maze
À l’occasion du 1<sup>er</sup> avril 2017, le vulgarisateur français [e-penser](https://www.youtube.com/user/epenser1) a posté sur YouTube un réseau de vidéos interconnectées à la manière d’un labyrinthe. À chaque vidéo, le vidéaste nous laisse le choix d’en visionner deux autres, et nous met au défi de toutes les regarder pour parvenir à trouver une vidéo mystérieuse.
Some YouTube creators have made video “gamebooks” by creating videos in which viewers can make choices that influence the course of the narration.
This is generally implemented by breaking up the video into short and interlinked segments.
This project aims at automatically exploring those video mazes and creating a visual representation of the underlying network.
Ce dépôt contient le code utilisé pour générer [un graphe de dépendances de chaque vidéo vers celles liées](https://matteo.delab.re/projects/epenser-maze), permettant d’accéder directement à la vidéo mystérieuse.
[See it live →](https://youtube-maze.cloud.delab.re)
## Technologies
## How Does it Work?
* [JavaScript (ES6)](https://fr.wikipedia.org/wiki/JavaScript) : langage de programmation interprété.
* [Node.JS](https://fr.wikipedia.org/wiki/Node.js) : environnement d’exécution de JavaScript.
* [Graphviz](http://www.graphviz.org/) : outil pour visionner et générer des représentations de graphes.
The [algorithm](lib/explore.mjs) starts at the first video and explores the links recursively using a breadth-first search approach, keeping track of the links as it goes.
The [Graphviz](http://www.graphviz.org/) library is used to automatically layout the graph so that as few edges cross as possible.
## Générer le graphe
## Running Locally
Pour générer le graphe par vous-même, vous devez au préalable avoir installé Node.JS et Graphviz. Ensuite, lancez les commandes suivantes dans un terminal :
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 run build
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.