Skip to content

cx051/YouTube-App

Repository files navigation

YouTubeApp

Version Platform Electron License Status powered by Ghostery


🎬 Overview

YouTubeApp is a lightweight Electron-based desktop client designed for a fast, clean, and distraction-free YouTube experience.

It uses comprehensive filter-list based ad blocking to ensure minimal interruptions and optimal playback.

App Screenshot


v2.0.0 is currently the most stable release. Ad-blocking functionality and overall performance are only guaranteed for this version and later. Versions prior to v2.0.0 may have inconsistent or degraded ad-blocking behavior and are not recommended for use.

✨ Features

  • 🧭 Clean, minimal UI with custom window controls
  • 🛡️ Advanced ad-blocking (Ghostery, uBlock, and Brave filters)
  • ⚡ Persistent caching for fast startup (~50ms)
  • 🧹 One-click browsing data cleanup
  • 🔍 Zoom controls
  • 🔒 Privacy-focused design

🧠 Architecture

🔹 Ad-Blocking System

  • Filter Engine

    • Powered by @ghostery/adblocker-electron
    • Uses EasyList, EasyPrivacy, uBlock, and Brave filters

⚡ Caching System

  • Binary cache stored in user data directory
  • First run: ~1.5s initialization
  • Subsequent runs: ~50ms startup

🔄 Execution Flow

Initialize Adblock Engine
        ↓
Load from Cache (if available)
        ↓
Attach to Electron Session
        ↓
Load YouTube

⚙️ Performance

  • Reduced startup latency via caching
  • Singleton-style adblocker design
  • Minimal runtime overhead

🧰 Tech Stack

  • Electron
  • @ghostery/adblocker-electron
  • uBlock Origin filter lists
  • Vanilla JS, HTML, CSS

📦 Installation

sudo dpkg -i youtube*.deb

Tested on: Ubuntu 22.04 LTS+


📁 Project Structure

YouTubeApp/
├── assets/
├── scripts/
├── main.js
├── preload.js
├── index.html
├── adblocker.js
└── package.json

⚠️ Known Limitations

  • Depends on YouTube’s frontend (can break with updates)
  • Ad-blocking may require adjustments over time
  • Limited cross-platform support
  • Not production-focused

Disclaimer

This is a personal project intended for experimentation and individual use. Long-term maintenance and compatibility are not guaranteed. This project is an independent application and is not affiliated with, endorsed by, or associated with Google LLC or any of its subsidiaries, including YouTube.


👤 Author

Made with ❤️ by cx051


📜 License

ISC License