Vue d'ensemble du projet
TypeType est un ensemble de services et de bibliothèques construits indépendamment et réunis par la stack de déploiement centrale. Cette section s'adresse aux contributeurs, aux intégrateurs et aux exploitants qui ont besoin de comprendre quel dépôt possède un comportement et comment une requête traverse le système.
Si vous voulez seulement installer une instance, commencez par l'introduction à l'auto-hébergement. Si vous utilisez une instance existante, voir le guide utilisateur.
Carte du système
Le navigateur parle au conteneur web. Son nginx intégré sert l'application React et transmet le trafic d'API, de WebSocket et de lecture à TypeType-Server. Server est la limite application/API derrière cette passerelle web publique ; Token, Downloader, PostgreSQL, Dragonfly et Garage sont des services internes.
Dépôts publics
| Dépôt | Possède |
|---|---|
| TypeType | Stack Compose, nginx, installateur, mises à jour, retour arrière, coordination des versions et suivi central des issues |
| TypeType-Frontend | Routes React, interface, paramètres, parcours de compte et commandes de lecture |
| TypeType-Server | API HTTP, extraction, comptes, données privées des utilisateurs, sessions de lecture et intégrations |
| TypeType-Token | Jetons PO de YouTube, décodage du lecteur, métadonnées SABR, sous-titres et sessions de navigateur pour la connexion distante |
| TypeType-Downloader | Tâches de téléchargement persistantes, transfert des médias, multiplexage et artefacts |
| TypeType-Player | Chaîne Media Source Extensions du navigateur utilisée par le frontend |
| TypeType-RPC | Compagnon de bureau qui affiche votre lecture comme statut Discord Rich Presence |
| TypeType-Signals | Service de recommandations optionnel : les algorithmes d'accueil que chaque utilisateur choisit et règle |
| Docs-TypeType | Documentation pour les utilisateurs, les exploitants et le projet |
| TypeType-Video/.github | Profil de l'organisation et ressources publiques partagées |
Lisez le Guide des dépôts pour les points d'entrée dans le code, les vérifications locales, les licences et l'endroit où un changement a sa place.
Parcours importants
- Lecture et téléchargements explique SABR, le paquet Player, Token et les limites de Downloader.
- Branches et versions explique
dev,main, les images des composants, les épinglages de sous-modules et les canaux beta et stable. - Signals, le service de recommandations explique les algorithmes d'accueil optionnels et la place du service à côté de Server.
- Sources de la communauté recense les signalements et discussions qui ont amélioré à la fois TypeType et cette documentation.
Sources de vérité
Utilisez cet ordre quand la documentation et l'implémentation semblent se contredire :
- Le code et les tests du dépôt qui possède le comportement.
- Les fichiers Compose et d'installation actuels de la stack centrale, plus la configuration nginx intégrée au frontend.
- Les issues et les discussions centrales, pour les comportements connus, l'expérience des exploitants et les décisions.
- Ce site, pour le déroulé pris en charge.
Les changements de documentation sont vérifiés par rapport aux trois sources amont avant d'être présentés comme un comportement stable. Une issue ouverte est l'indice d'un problème, pas une spécification en soi ; c'est toujours le code du dépôt propriétaire qui décide de ce que fait la version actuelle.