How fotiterz/youtube-webos works
YouTube Ad-Free is a webOS TV YouTube app that injects enhancements into the YouTube experience. The principal workflow is the userscript loading feature modules; those modules adapt playback, navigation, requests, and the configuration UI. Player management provides a useful internal layer for observing video and playback state. The README documents additional capabilities whose individual implementations or wiring were not excerpted; those are represented by their exact source paths, with only documented or indexed relationships shown. Optional external SponsorBlock communication is explicit in the sampled code.
Main entry points: userScript.ts Userscript Entry · config.js User Configuration · ui.js Settings and Controls · sponsorblock.js SponsorBlock
Components 23
App Integration
- Userscript Entry
src/userScript.ts - Command Hooks
src/app_api/index.ts - Account Selection
src/auto-account-select.ts - Language Fix
src/lang-settings-fix.ts
Playback Features
- Ad Blocking
src/adblock.js - SponsorBlock
src/sponsorblock.js - Video Quality
src/video-quality.ts - Thumbnail Quality
src/thumbnail-quality.ts - Shorts Removal
src/shorts.js - Endscreen Removal
src/remove-endscreen.ts - Watch Enhancements
src/watch.js - Screensaver Fix
src/screensaver-fix.ts
TV Interface
- Settings and Controls
src/ui.js - Spatial Navigation
src/spatial-navigation-polyfill.js
Runtime Foundation
- User Configuration
src/config.js - Fetch Interception
src/hooks/fetch.ts - Player Manager
src/player_api/manager.ts - Player API Types
src/player_api/yt-api.ts - Player Helpers
src/player_api/helpers.ts - Typed Events
src/custom-event-target.ts
Other components
- TV Viewer
- YouTube Runtime
- SponsorBlock Service
Connections 35
- TV Viewer → Userscript Entry: uses app
README.md - Userscript Entry → Ad Blocking: loads
src/userScript.ts - Userscript Entry → Command Hooks: loads
src/userScript.ts - Userscript Entry → Account Selection: loads
src/userScript.ts - Userscript Entry → Language Fix: loads
src/userScript.ts - Userscript Entry → SponsorBlock: loads
src/userScript.ts - Userscript Entry → Video Quality: loads
src/userScript.ts - Userscript Entry → Thumbnail Quality: loads
src/userScript.ts - Userscript Entry → Shorts Removal: loads
src/userScript.ts - Userscript Entry → Endscreen Removal: loads
src/userScript.ts - Userscript Entry → Watch Enhancements: loads
src/userScript.ts - Userscript Entry → Screensaver Fix: loads
src/userScript.ts - Userscript Entry → Settings and Controls: loads
src/userScript.ts - Userscript Entry → Fetch Interception: loads
- Userscript Entry → User Configuration: loads
- Ad Blocking → User Configuration: reads settings
src/adblock.js - SponsorBlock → User Configuration: reads settings
src/sponsorblock.js - SponsorBlock → Settings and Controls: shows notice
src/sponsorblock.js - SponsorBlock → SponsorBlock Service: requests segments
src/sponsorblock.js - Video Quality → User Configuration: reads settings
src/video-quality.ts - Video Quality → Player Manager: uses manager
src/video-quality.ts - Video Quality → Settings and Controls: uses controls
src/video-quality.ts - Thumbnail Quality → User Configuration: reads settings
src/thumbnail-quality.ts - Shorts Removal → User Configuration: reads settings
src/shorts.js - Endscreen Removal → User Configuration: reads settings
src/remove-endscreen.ts - Watch Enhancements → User Configuration: reads settings
src/watch.js - Watch Enhancements → Player Helpers: uses helpers
src/watch.js - Screensaver Fix → Player Helpers: uses helpers
src/screensaver-fix.ts - Settings and Controls → User Configuration: reads and writes
src/ui.js - Settings and Controls → Spatial Navigation: loads navigation
src/ui.js - Command Hooks → YouTube Runtime: hooks commands
src/app_api/index.ts - Player Manager → Player Helpers: gets player
src/player_api/manager.ts - Player Manager → Typed Events: extends events
src/player_api/manager.ts - Player Manager → Player API Types: uses player types
src/player_api/manager.ts - Fetch Interception → Typed Events: dispatches events
src/hooks/fetch.ts