# How to Unlock 4K Quality with YTLite's YTUHD Integration: Complete Setup Guide

> Unlock 4K YouTube quality with YTLite's YTUHD integration. Follow our complete setup guide to enable high-definition streaming with simple steps.

- Repository: [Dan/YTLite](https://github.com/dayanch96/YTLite)
- Tags: how-to-guide
- Published: 2026-04-22

---

**YTLite bundles the YTUHD tweak to unlock 1440p and 2160p (4K) YouTube streams through a simple build-time flag and automatic preference integration.**

YTLite is a meta-tweak that aggregates multiple independent YouTube modifications for iOS into a single installable package. One of its most powerful optional components is **YTUHD**, a community-maintained tweak that removes YouTube's artificial resolution limits and exposes true 1440p (2K) and 2160p (4K) video streams. This guide explains exactly how YTLite's YTUHD integration works and how to enable it.

## How YTLite's YTUHD Integration Works

The integration operates across three distinct layers: build-time compilation, runtime packaging, and user-facing activation. Understanding each layer helps troubleshoot issues and confirms that YTLite is functioning as designed.

### Build-Time Inclusion via CI Workflow

YTLite uses GitHub Actions to conditionally compile YTUHD. The `enable_ytuhd` flag in [`.github/workflows/_build_tweaks.yml`](https://github.com/dayanch96/YTLite/blob/main/.github/workflows/_build_tweaks.yml) controls whether the YTUHD source is cloned and built.

```yaml

# .github/workflows/_build_tweaks.yml

- name: Clone YTUHD
  if: ${{ inputs.enable_ytuhd }}
  run: git clone --quiet --depth=1 https://github.com/Tonwalter888/YTUHD.git

- name: Build YTUHD
  if: ${{ inputs.enable_ytuhd }}
  run: |
    cd YTUHD && make clean package DEBUG=0 FINALPACKAGE=1
    mv packages/*.deb ../ytuhd.deb

```

When `enable_ytuhd` is `true`, the workflow executes both the **Clone YTUHD** and **Build YTUHD** steps, producing `ytuhd.deb` for later bundling.

### Runtime Packaging and Installation

The generated `ytuhd.deb` ships alongside the main YTLite payload. Installation methods like Sideloading or AltStore automatically install YTUHD when present—no additional device-side configuration required.

### User-Facing Activation in YouTube Settings

YTUHD adds its preferences under **Video quality preferences** in the YouTube app's Settings screen. YTLite's `Settings.x` (lines 188-212) creates this section, so YTUHD options appear automatically.

```

Settings → Video quality preferences → 2160p (4K)

```

## Step-by-Step: Enable YTUHD in Your YTLite Build

### Triggering the Build with YTUHD Enabled

Use the GitHub CLI to dispatch a workflow run with YTUHD activated:

```bash
gh workflow run build-tweaks.yml \
  -f enable_ytuhd=true \
  -f tweak_version=1.2.3

```

Replace `1.2.3` with your desired YTLite version tag.

### Verifying Installation on Device

After installing the built package:

1. Open the YouTube app
2. Navigate to **Settings → Video quality preferences**
3. Confirm **2160p (4K)** appears in the quality list

If 4K appears, YTUHD is active. Select it to unlock full-resolution playback on supported videos.

## Programmatic Control (Advanced)

For developers extending YTLite, the tweak's preference helper can toggle YTUHD settings:

```objc
// Enable 4K programmatically using YTLite's defaults helper
ytlSetBool(YES, @"ytuhdEnabled");

```

> **Note:** The actual preference key is managed internally by YTUHD. This example demonstrates YTLite's `ytlSetBool` helper pattern from `YTLite.x` (lines 14-34) for custom preference management.

## Key Files and References

| File | Purpose |
|------|---------|
| [`.github/workflows/_build_tweaks.yml`](https://github.com/dayanch96/YTLite/blob/main/.github/workflows/_build_tweaks.yml) | CI workflow controlling YTUHD clone/build steps |
| `Settings.x` (lines 188-212) | Creates Video quality preferences section |
| `YTLite.x` (lines 14-34) | Core tweak logic with preference helpers |
| [`README.md`](https://github.com/dayanch96/YTLite/blob/main/README.md) | Documents YTUHD functionality and location |

## Summary

- **YTLite's YTUHD integration** unlocks 1440p and 2160p YouTube streams through a build-time flag
- **Enable via CI**: Set `enable_ytuhd=true` in [`build-tweaks.yml`](https://github.com/dayanch96/YTLite/blob/main/build-tweaks.yml) workflow dispatch
- **Automatic installation**: `ytuhd.deb` bundles with YTLite and installs without device-side configuration
- **User activation**: 4K option appears in **Settings → Video quality preferences** once installed
- **Source locations**: Build logic in [`.github/workflows/_build_tweaks.yml`](https://github.com/dayanch96/YTLite/blob/main/.github/workflows/_build_tweaks.yml), preferences UI in `Settings.x`

## Frequently Asked Questions

### What is YTUHD and how does it differ from standard YouTube quality?

YTUHD is a community-maintained iOS tweak that removes YouTube's artificial resolution caps. While the stock YouTube app limits quality based on device type and arbitrary restrictions, YTUHD exposes the actual video streams available from YouTube's servers—including 1440p and 2160p formats—regardless of official device support.

### Do I need to manually install YTUHD separately from YTLite?

No. When YTLite is built with `enable_ytuhd=true`, the YTUHD tweak compiles into `ytuhd.deb` and bundles automatically with the main package. Installation methods like AltStore or Sideloading install both components simultaneously. You only need to enable the build flag during CI—no separate downloads or device-side installation steps required.

### Why don't I see the 4K option in my YouTube settings after installing?

First, verify your YTLite build was compiled with `enable_ytuhd=true` by checking the workflow logs. If YTUHD was built correctly, confirm you're looking in the right location: **Settings → Video quality preferences** (not the general video settings). Also note that 4K only appears for videos uploaded in 2160p—lower-resolution uploads won't show the option regardless of YTUHD installation.

### Can I toggle YTUHD on and off without reinstalling YTLite?

YTUHD's core functionality activates automatically when installed, but individual quality selections can be changed per-video through the standard YouTube quality picker. YTLite's `Settings.x` provides the preference framework where YTUHD options appear, but there is no global "disable YTUHD" toggle in the UI—full removal requires reinstalling YTLite without the `enable_ytuhd` build flag.