https://github.com/christian-fei/my-yt
A clean and minimal youtube frontend, without all the ads and whistles
https://github.com/christian-fei/my-yt
Last synced: 25 days ago
JSON representation
A clean and minimal youtube frontend, without all the ads and whistles
- Host: GitHub
- URL: https://github.com/christian-fei/my-yt
- Owner: christian-fei
- Created: 2025-02-08T19:02:46.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-03-15T16:31:13.000Z (about 1 month ago)
- Last Synced: 2025-03-15T16:35:57.645Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 1 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- starred - christian-fei/my-yt - A clean and minimal youtube frontend, without all the ads and whistles (JavaScript)
README
# my-yt
A clean and minimal youtube frontend supported by yt-dlp, and optionally your local AI model, to make your youtube experience local, mindful and succint.
## Features
- Channel management/Subscriptions
- Download videos from YouTube, using `yt-dlp` behind the scenes
- Ignore videos you don't want to watch
- Remove sponsors automatically thanks to SponsorBlock
- Offline media playback
- Disable clickbait thumbnails
- Play videos in background
- Summarize video content using your local AI model
- Native Picture-in-Picture support
- No dependencies (except for `nano-spawn`, which itself has no transient deps)
- HTML/CSS only, no JS frameworks on client/server side
- Subtitles using `` element and WebVTT API
- Host it in your home network to playback videos on all your devices
- Just JSON files for persistence, stupid simple management and backup
[Check out the todo list](https://github.com/christian-fei/my-yt/issues/5)
> Application runs on http://localhost:3000
## Installation (node.js)
```bash
git clone https://github.com/christian-fei/my-yt.git
cd my-yt
npm i
# install yt-dlp, https://github.com/yt-dlp/yt-dlp
# install ffmpeg, https://ffmpeg.org/
npm start
```
## Installation (docker)
```bash
git clone https://github.com/christian-fei/my-yt.git
cd my-yt
docker compose up --build -d
```
or
```bash
docker run -p 3000:3000 -v /path/to/your/data/folder/for/persistence:/app/data christianfei/my-yt:latest
# ok calm down, here is an actual example command to copy-n-paste, jeez
docker run -d -p 3000:3000 -v $HOME/my-yt-data:/app/data christianfei/my-yt:latest
```
## Environment variables for LLM integration
The default values are
```
AI_MODEL meta-llama-3.1-8b-instruct
AI_HOST http://127.0.0.1:1234
AI_ENDPOINT /v1/chat/completions
AI_APIKEY
```
Simply set the env variables to your needs, by following the format above (e.g. url starting with "http", no ending slash, AI_ENDPOINT with leading slash and path)
## Why?
- wanted to get back my chronological feed, instead of a "algorithmically curated" one
- no distractions
- no clickbait thumbnails (using `mq2` instead of `mqdefault` thumbnail, thanks @drcheap)
- no comments
- no related videos, or any algorithmically determined videos pushed in your face
- no sponsors, thanks to SponsorBlock
- just videos and a clean UI
- wanted to dabble with [Server-sent Events](https://github.com/christian-fei/my-yt/blob/main/lib/sse.js)
- wanted to try integrate the so much hyped AI in a personal project
- wanted to try out `yt-dlp`
- wanted to experiment with the HTML5 [``](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/track) element and [WebVTT API](https://developer.mozilla.org/en-US/docs/Web/API/WebVTT_API)
- feedback was awesome on [HackerNews](https://news.ycombinator.com/item?id=43373242), so here we are
- I am even paying for YouTube Premium, so it's not a matter of money, but a matter of control over my attention and enhanced offline experience
## Project
Here are some links to help you understand the project better:
### [server.js](https://github.com/christian-fei/my-yt/blob/main/lib/server.js)
Bare HTTP server
Handles SSE for client updates
Implements HTTP Ranged requests for video playback
### [llm.js](https://github.com/christian-fei/my-yt/blob/main/lib/llm.js)
Makes requests using the chat completions API of LMStudio.
### [sse.js](https://github.com/christian-fei/my-yt/blob/main/lib/sse.js)
Utility functions for Server-sent events
### [subtitles-summary.js](https://github.com/christian-fei/my-yt/blob/main/lib/subtitles-summary.js)
Summarizes video transcript using LMStudio API
### [youtube.js](https://github.com/christian-fei/my-yt/blob/main/lib/youtube.js)
yt-dlp wrapper to download videos, get channel videos and video information and transcript
### [repository.js](https://github.com/christian-fei/my-yt/blob/main/lib/repository.js)
Handles persistence of video information (set video as downloaded, summary, ignored, upserting videos, etc.)
### [client](https://github.com/christian-fei/my-yt/tree/main/client)
dependency less, bare HTML5, CSS3 and JS for a basic frontend
Handles SSE updates, interacting with the API