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

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 controls whether the YTUHD source is cloned and built.

# .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:

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:

// 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	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	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 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, 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}