https://github.com/luanrt/ump-inspector
Inspect and decode YouTube UMP requests in the browser.
https://github.com/luanrt/ump-inspector
googlevideo innertube ump
Last synced: 3 months ago
JSON representation
Inspect and decode YouTube UMP requests in the browser.
- Host: GitHub
- URL: https://github.com/luanrt/ump-inspector
- Owner: LuanRT
- License: mit
- Created: 2025-09-23T23:47:54.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-04T12:28:06.000Z (8 months ago)
- Last Synced: 2025-10-04T14:31:23.043Z (8 months ago)
- Topics: googlevideo, innertube, ump
- Language: TypeScript
- Homepage:
- Size: 93.8 KB
- Stars: 16
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ump-inspector
A browser extension for inspecting and debugging UMP requests on YouTube. It hooks into the response processing to provide decoded, human-readable info into the UMP parts as well as request payloads.
## Screenshots
## Installation
To install this extension, you need to load it as an unpacked extension in a Chromium-based browser.
1. Download the latest `ump-inspector-vX.X.X.zip` from the [releases page](https://github.com/LuanRT/ump-inspector/releases).
2. Unzip the downloaded file.
3. Open your browser and navigate to the extensions page (e.g., `chrome://extensions`, `edge://extensions`, or `about:addons` for Mozilla-based browsers).
4. Enable "Developer mode".
5. Click on "Load unpacked" and select the directory where you unzipped the files.
## Building from Source
If you want to build the extension from the source code, follow these steps:
1. Clone the repository:
```sh
git clone https://github.com/LuanRT/ump-inspector.git
cd ump-inspector
```
2. Install the dependencies:
```sh
npm install
```
3. Build the project:
```sh
npm run build
```
This will create a `dist` directory containing the bundled extension files.
4. Follow the steps in the [Installation](#installation) section, but select the root directory of the project instead of the unzipped release folder.
## Usage
After installation, simply navigate to any YouTube page that plays a video. Open your browser's **Developer Tools** (F12 or Ctrl+Shift+I) and select the **Console** tab. The extension will automatically log the decoded payloads and UMP parts as they are received and processed.
## License
Distributed under the [MIT](./LICENSE) License.