# mrxsin/youtubehideads architecture

> Architecture diagram of the GitHub repository mrxsin/youtubehideads, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mrxsin/youtubehideads
- Repository: https://github.com/mrxsin/youtubehideads

## Overview

YouTube Hide Ads is an Xposed module for YouTube and YouTube Music. Its documented workflow is that the framework loads the module in the target app, XAX performs hooks and settings/networking work, and Brainfuck policies make feature decisions. The README documents broad capabilities but no source excerpts were provided, so feature-to-runtime links rely on that documentation rather than inspected calls; implementation paths for several capabilities therefore point to the documented XAX entry file.

Main entry points: [`source/xax/youtubehideads.xax`](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax) (XAX module), [`source/brainfuck/ads/player/suppress_video_slot.bf`](https://github.com/mrxsin/youtubehideads/blob/main/source/brainfuck/ads/player/suppress_video_slot.bf) (Ad policies), [`source/brainfuck/sponsorblock/sponsor_skip_pipeline.bf`](https://github.com/mrxsin/youtubehideads/blob/main/source/brainfuck/sponsorblock/sponsor_skip_pipeline.bf) (Skip policy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_xax["XAX module<br/>[youtubehideads.xax]"]
  node_bfads["Ad policies"]
  node_sponsorpolicy["Skip policy"]
end

subgraph group_youtube["YouTube Features"]
  node_ytads["Ad hiding<br/>[youtubehideads.xax]"]
  node_sponsor["SponsorBlock<br/>[youtubehideads.xax]"]
  node_player["Player controls<br/>[youtubehideads.xax]"]
  node_gestures["Player gestures<br/>[youtubehideads.xax]"]
  node_feed["Feed controls<br/>[youtubehideads.xax]"]
  node_shorts["Shorts controls<br/>[youtubehideads.xax]"]
  node_blacklist["Channel blacklist<br/>[youtubehideads.xax]"]
end

subgraph group_music["Music Features"]
  node_musicads["Music ad hiding<br/>[youtubehideads.xax]"]
  node_musicpremium["Premium controls<br/>[youtubehideads.xax]"]
  node_musicbackground["Background playback<br/>[youtubehideads.xax]"]
  node_audio["Audio mode<br/>[youtubehideads.xax]"]
  node_downloads["Downloads<br/>[youtubehideads.xax]"]
end

subgraph group_services["External Services"]
  node_sponsorservice["SponsorBlock API"]
  node_dislike["Dislike service"]
  node_dearrow["DeArrow"]
end

node_user(("App user"))
node_ytapp["YouTube"]
node_musicapp["YouTube Music"]
node_framework["Xposed framework"]

node_user -->|"uses"| node_ytapp
node_user -->|"uses"| node_musicapp
node_framework -->|"loads"| node_xax
node_ytapp -->|"hosts hooks"| node_xax
node_musicapp -->|"hosts hooks"| node_xax
node_xax -->|"applies decisions"| node_bfads
node_xax -->|"applies decisions"| node_sponsorpolicy
node_xax -->|"implements"| node_ytads
node_xax -->|"implements"| node_sponsor
node_xax -->|"implements"| node_player
node_xax -->|"implements"| node_gestures
node_xax -->|"implements"| node_feed
node_xax -->|"implements"| node_shorts
node_xax -->|"implements"| node_blacklist
node_xax -->|"implements"| node_musicads
node_xax -->|"implements"| node_musicpremium
node_xax -->|"implements"| node_musicbackground
node_xax -->|"implements"| node_audio
node_xax -->|"implements"| node_downloads
node_xax -.->|"requests segments"| node_sponsorservice
node_xax -.->|"requests counts"| node_dislike
node_xax -.->|"requests thumbnails"| node_dearrow

click node_xax "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_bfads "https://github.com/mrxsin/youtubehideads/blob/main/source/brainfuck/ads/player/suppress_video_slot.bf"
click node_sponsorpolicy "https://github.com/mrxsin/youtubehideads/blob/main/source/brainfuck/sponsorblock/sponsor_skip_pipeline.bf"
click node_ytads "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_sponsor "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_player "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_gestures "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_feed "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_shorts "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_blacklist "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_musicads "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_musicpremium "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_musicbackground "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_audio "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"
click node_downloads "https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_xax,node_bfads,node_sponsorpolicy,node_user toneBlue
class node_ytads,node_sponsor,node_player,node_gestures,node_feed,node_shorts,node_blacklist toneAmber
class node_musicads,node_musicpremium,node_musicbackground,node_audio,node_downloads toneMint
class node_sponsorservice,node_dislike,node_dearrow toneRose
class node_ytapp,node_musicapp,node_framework toneIndigo
```

## Components

### Runtime

- [XAX module](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Ad policies](https://github.com/mrxsin/youtubehideads/blob/main/source/brainfuck/ads/player/suppress_video_slot.bf): `source/brainfuck/ads/player/suppress_video_slot.bf`
- [Skip policy](https://github.com/mrxsin/youtubehideads/blob/main/source/brainfuck/sponsorblock/sponsor_skip_pipeline.bf): `source/brainfuck/sponsorblock/sponsor_skip_pipeline.bf`

### YouTube Features

- [Ad hiding](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [SponsorBlock](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Player controls](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Player gestures](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Feed controls](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Shorts controls](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Channel blacklist](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`

### Music Features

- [Music ad hiding](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Premium controls](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Background playback](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Audio mode](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`
- [Downloads](https://github.com/mrxsin/youtubehideads/blob/main/source/xax/youtubehideads.xax): `source/xax/youtubehideads.xax`

### External Services

- **SponsorBlock API**
- **Dislike service**
- **DeArrow**

### Other components

- **App user**
- **YouTube**
- **YouTube Music**
- **Xposed framework**

## Connections

- App user → YouTube: uses (evidence: `README.md`)
- App user → YouTube Music: uses (evidence: `README.md`)
- Xposed framework → XAX module: loads (evidence: `README.md`)
- YouTube → XAX module: hosts hooks (evidence: `README.md`)
- YouTube Music → XAX module: hosts hooks (evidence: `README.md`)
- XAX module → Ad policies: applies decisions (evidence: `README.md`)
- XAX module → Skip policy: applies decisions (evidence: `README.md`)
- XAX module → Ad hiding: implements (evidence: `README.md`)
- XAX module → SponsorBlock: implements (evidence: `README.md`)
- XAX module → Player controls: implements (evidence: `README.md`)
- XAX module → Player gestures: implements (evidence: `README.md`)
- XAX module → Feed controls: implements (evidence: `README.md`)
- XAX module → Shorts controls: implements (evidence: `README.md`)
- XAX module → Channel blacklist: implements (evidence: `README.md`)
- XAX module → Music ad hiding: implements (evidence: `README.md`)
- XAX module → Premium controls: implements (evidence: `README.md`)
- XAX module → Background playback: implements (evidence: `README.md`)
- XAX module → Audio mode: implements (evidence: `README.md`)
- XAX module → Downloads: implements (evidence: `README.md`)
- XAX module → SponsorBlock API: requests segments
- XAX module → Dislike service: requests counts
- XAX module → DeArrow: requests thumbnails
