diff --git a/README.md b/README.md index effb820..59493ed 100644 --- a/README.md +++ b/README.md @@ -15,28 +15,7 @@ KV-Tube removes distractions, tracking, and ads from the YouTube watching experi ## 🛠️ Architecture Data Flow -```mermaid -graph TD - User["User Browser"] - Server["KV-Tube Server (Flask)"] - YTDLP["yt-dlp Core"] - YTFetcher["YTFetcher Lib"] - YouTube["YouTube V3 API / HTML"] - - User -- "1. Search / Watch Request" --> Server - Server -- "2. Extract Video Metadata" --> YTDLP - YTDLP -- "3. Network Requests (Cookies Optional)" --> YouTube - YouTube -- "4. Raw Video/Audio Streams" --> YTDLP - YTDLP -- "5. Stream URL / Metadata" --> Server - - subgraph TranscriptSystem ["Transcript System (Deferred)"] - Server -.-> YTFetcher - YTFetcher -.-> YouTube - YTFetcher -- "No Transcript (429)" -.-> Server - end - - Server -- "6. Render HTML / Stream Proxy" --> User -``` +![Architecture Data Flow](https://mermaid.ink/img/Z3JhcGggVEQKICAgIFVzZXJbIlVzZXIgQnJvd3NlciJdCiAgICBTZXJ2ZXJbIktWLVR1YmUgU2VydmVyIChGbGFzaykiXQogICAgWVRETFBbInl0LWRscCBDb3JlIl0KICAgIFlURmV0Y2hlclsiWVRGZXRjaGVyIExpYiJdCiAgICBZb3VUdWJlWyJZb3VUdWJlIFYzIEFQSSAvIEhUTUwiXQoKICAgIFVzZXIgLS0gIjEuIFNlYXJjaCAvIFdhdGNoIFJlcXVlc3QiIC0tPiBTZXJ2ZXIKICAgIFNlcnZlciAtLSAiMi4gRXh0cmFjdCBWaWRlbyBNZXRhZGF0YSIgLS0+IFlURExQCiAgICBZVERMUCAtLSAiMy4gTmV0d29yayBSZXF1ZXN0cyAoQ29va2llcyBPcHRpb25hbCkiIC0tPiBZb3VUdWJlCiAgICBZb3VUdWJlIC0tICI0LiBSYXcgVmlkZW8vQXVkaW8gU3RyZWFtcyIgLS0+IFlURExQCiAgICBZVERMUCAtLSAiNS4gU3RyZWFtIFVSTCAvIE1ldGFkYXRhIiAtLT4gU2VydmVyCiAgICAKICAgIHN1YmdyYXBoIFRyYW5zY3JpcHRTeXN0ZW0gWyJUcmFuc2NyaXB0IFN5c3RlbSAoRGVmZXJyZWQpIl0KICAgICAgICBTZXJ2ZXIgLS4tPiBZVEZldGNoZXIKICAgICAgICBZVEZldGNoZXIgLS4tPiBZb3VUdWJlCiAgICAgICAgWVRGZXRjaGVyIC0tICJObyBUcmFuc2NyaXB0ICg0MjkpIiAtLi0+IFNlcnZlcgogICAgZW5kCgogICAgU2VydmVyIC0tICI2LiBSZW5kZXIgSFRNTCAvIFN0cmVhbSBQcm94eSIgLS0+IFVzZXI=) ## 🔧 Installation & Usage