Skip to content

fosterbarnes/ytPlusYTweaks

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

472 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YouTube Plus with added plugins and fixes.

v20.10.4 is strongly recommended for proper compatibility

This project focuses on bundling YouTube Plus with YTweaks and other various tweaks.

When building the app, the latest patches to YouTube Plus, YTweaks, theos and all other included tweaks are cloned and built from source. All tweaks are then injected into your IPA. If you follow either build tutorial, you'll automatically end up with the latest tweaks and patches.

YTweaks added settings:

  • Force Fullscreen Direction (Button): Choose Off, Left, Right, or Portrait for the fullscreen button.
  • Force Fullscreen Direction (Gesture): Choose Off, Left, Right, or Portrait for the swipe-up gesture. Independent of the button setting.
  • Disable floating miniplayer: Restores the old miniplayer by disabling the floating miniplayer.
  • Virtual fullscreen bezels: Adds invisible touch-safe zones on black bars to prevent accidental taps and skips.
  • Fix Casting - Attempts to fix casting by changing some A/B flags. Only works on v20.10.4 or lower.
  • Hide AI Summaries: Attempts to block/hide AI summaries below videos in the home feed.
  • Fake Brightness: Lowers apparent brightness below the system minimum. Works best on OLED devices.
  • Schedule Fake Brightness (Night Mode): Automatically applies fake brightness during a set time range.

Added tweaks:

Original repo: https://github.com/dayanch96/YTLite

How to build a YTPlusYTweaks app

If you just need to build the YouTube app without much fuss, use GitHub actions. Actions are easy to set up, but slow to run.

If you plan on testing, adding tweaks that aren't integrated with this repo, making changes, or building very frequently, build locally. Building locally on your computer takes a bit of setup initially, but is much quicker than actions after setup.

GitHub Actions

Note

If this your first time, complete following steps before starting:

  1. Fork this repository using the fork button on the top right
  2. On your forked repository, go to Repository Settings > Actions, enable Read and Write permissions.
How to build YTPlusYTweaks app
  1. Fork this repo if you haven't already. Sync if your branch is out of date.
  2. Go to the "Actions" tab of your new repo.
  3. Select "Build YTPlusYTweaks".
  4. Click "Run workflow".
  5. Select bundled tweaks.
  6. Prepare & upload base .ipa
    • Prepare a decrypted .ipa file (version 20.10.4 or earlier for Fix Casting to work).
      We cannot provide this file due to legal reasons.

    • Upload the decrypted IPA to a file hosting service (e.g., litterbox.catbox.moe or Dropbox).
      You can't skip this step, copy/pasting a link from a decrypt IPA site will not work.

    • Paste the direct download link to the decrypted IPA into the provided field.
      NOTE: Make sure to provide a direct download link to the file, not a webpage. Otherwise, the process will fail.

  7. Click "Run workflow".
  8. Screenshot 15
  9. Wait for the build to finish. You can download the YouTube Plus app from the releases section of your forked repo. (If you can't find the releases section, go to your forked repo and add /releases to the URL, i.e., github.com/user/YTPlusYTweaks/releases.)

  10. Additional workflow options:

    • The version of YTLite to use:
      Input a release tag from dayanch96/YTLite/tags
      Example: 5.2b3 or v5.2b4

    • iOS SDK Version:
      16.5 should be used for older devices, 18.6 can be used for newer devices
      Example: 16.5

    • Inject pre-built DEB(s):
      User-provided DEBs can be downloaded and injected alongside other tweaks. Either provide comma-separated direct download links to .deb files OR a direct download link to zipped .deb files
      .deb example: https://litter.catbox.moe/1.deb, https://litter.catbox.moe/2.deb
      .zip example: https://litter.catbox.moe/debs.zip

    • App Name:
      Display name for the app on the homescreen
      Example: YTPlusYTweaks

    • BundleID:
      Unique identifier assigned to every application. Change if you want to have multiple installs of YouTube
      Example: com.google.ios.youtube2

How to build .debs
  1. Fork this repo if you haven't already. Sync if your branch is out of date.
  2. Go to the "Actions" tab of your new repo.
  3. Select "Build .deb packages".
  4. Click "Run workflow".
  5. Select tweaks.
  6. Click "Run workflow".
  7. Screenshot 10
  8. Wait for the build to finish. You can download the YouTube Plus app from the releases section of your forked repo. (If you can't find the releases section, go to your forked repo and add /releases to the URL, i.e., github.com/user/YTPlusYTweaks/releases.)

Local (Tested on macOS 15 Sequoia)

How to build locally on your machine
  1. Install brew and git if not already present, then clone this repo to download the required build scripts:
if ! command -v brew &> /dev/null; then
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
else
    echo "Homebrew already installed."
fi

brew install git
cd "$HOME/Desktop"
git clone --filter=blob:none --no-checkout https://github.com/fosterbarnes/ytPlusYTweaks
cd ytPlusYTweaks || exit
git sparse-checkout init --no-cone
git sparse-checkout set \
    'deb/*' \
    'ipa/*' \
    'build.sh' \
    'buildDependencies.sh' \
    'README.md'
git checkout main
  1. Run the build dependencies script
./buildDependencies.sh
  1. Run the build script to build your app

Option A: Place a decrypted IPA into 'ytPlusYTweaks/ipa'. Build with default included tweaks.

./build.sh

Option B: Use a direct link to an IPA. Build with default included tweaks.

./build.sh -ipa <URL> 

Option C: Build with your own debs from 'ytPlusYTweaks/deb'

./build.sh -myDebs

To list all options:

./build.sh -h
Usage: ./build.sh [options]

Default (no flags): builds using the IPA in the ipa/ directory, integrating all default integrated tweaks.
By default, all tweaks are cloned and built from source. Use '--myDebs' to use your local files in the deb/ directory.

Options:
    -ipa <URL>                          Download IPA from URL to ipa/ before building
    -myDebs, -md                        Use existing .deb files in deb/ 
    -sdk <version>                      iOS SDK version: 16.5, 17.5, or 18.6 (default: 16.5)
    -ytPlusVersion, -ytpv <version>     Version of YTPlus tweak (default: auto-detect latest)
    -displayName, -dn <name>            App display name (default: YouTube)
    -bundleID, -bid <id>                Bundle ID (default: com.google.ios.youtube)
    -test                               Quickly change display name and bundle ID when testing
                                        Display Name: YTest | Bundle ID: com.google.ios.youtube2
    -help, -h                           Show this help message

Examples:
    ./build.sh
    ./build.sh --ipa https://example.com/youtube.ipa
    ./build.sh --myDebs
    ./build.sh --sdk 17.5 --displayName "YT"

Table of Contents

Screenshots

Screenshot 1 Screenshot 2 Screenshot 3
More screenshots
Screenshot 4 Screenshot 5 Screenshot 6
Screenshot 7 Screenshot 8 Screenshot 9

Issues, Bugs & Feature Requests

Fill out an issue form with the applicable option selected and fill out all required info.

FAQ

Supported Versions

  • Recommended: 20.10.4
  • Latest confirmed: 21.26.4
  • Date tested: 7/3/26
  • YouTube Plus: 5.2.1

Tweak Integration Details

YouPiP

YouPiP is a tweak developed by PoomSmart that enables the native Picture-in-Picture feature for videos in the iOS YouTube app.

YouPiP preferences are available in the YouTube settings.

Source code and additional information are available in PoomSmart's GitHub repository.

YTUHD

YTUHD is a tweak developed by PoomSmart that unlocks 1440p (2K) and 2160p (4K) resolutions in the iOS YouTube app. Forked by Tonwalter888 to fix some issues when using the tweak while sideloading

YTUHD preferences are available in the Video quality preferences section under YouTube settings.

Source code and additional information are available in PoomSmart's GitHub repository.

Return YouTube Dislikes

Return YouTube Dislikes is a tweak developed by PoomSmart that brings back dislikes on the YouTube app.

Return YouTube Dislikes preferences are available in the YouTube settings.

Source code and additional information are available in PoomSmart's GitHub repository.

YouQuality

YouQuality is a tweak developed by PoomSmart that allows to view and change video quality directly from the video overlay.

YouQuality can be enabled in the Video overlay section under YouTube settings.

Source code and additional information are available in PoomSmart's GitHub repository.

DontEatMyContent

DontEatMyContent is a tweak developed by therealFoxster that prevents the Notch/Dynamic Island from munching on 2:1 video content in the iOS YouTube app.

DontEatMyContent preferences are available in the YouTube settings.

Source code and additional information are available in therealFoxster's GitHub repository.

YTABConfig

YTABConfig is a tweak developed by PoomSmart that configures A/B settings in the iOS YouTube app.

YTABConfig preferences are available in the YouTube settings.

Source code and additional information are available in PoomSmart's GitHub repository.

YTIcons

YTIcons is a tweak developed by PoomSmart that displays all usable icons in the iOS YouTube app.

YTIcons are available in the YouTube settings.

Source code and additional information are available in PoomSmart's GitHub repository.

YTweaks

YTweaks is a tweak developed by fosterbarnes that adds a few extra settings like "Fullscreen to Right" and "Fullscreen to Left"

YTweaks preferences are available in the YouTube settings.

Source code and additional information are available in fosterbarnes's GitHub repository.

YouGroupSettings

YouGroupSettings is a tweak developed by PoomSmart that allows custom settings (made by tweaks) to be displayed when the grouped settings experiment is active. Forked by FosterBarnes to support YTweaks

Source code and additional information are available in fosterbarnes's GitHub repository.

Gonerino

Gonerino is a tweak developed by castdrian that lets you block certain content from your home feed. Forked by FosterBarnes as YGonerino with a v1.3.3 fix for home feed blocking.

Source code and additional information are available in fosterbarnes's GitHub repository.

AutoFLEX

AutoFLEX is a tweak developed by pwnless that injects the FLEX in-app debugger into sideloaded apps.

Source code and additional information are available in pwnless's GitHub repository.

YouMute

Mutes/unmutes videos on iOS YouTube app faster. Developed by PoomSmart

Source code and additional information are available in PoomSmart's GitHub repository.

YouSpeed

Views/changes video speed in iOS YouTube app faster. Developed by PoomSmart

Source code and additional information are available in PoomSmart's GitHub repository.

YouGetCaption

Adds a player button to enable/disable looping on the current video. Developed by bhackel

Source code and additional information are available in bhackel's GitHub repository.

YouLoop

Views and copies captions from YouTube videos. Developed by PoomSmart

Source code and additional information are available in PoomSmart's GitHub repository.

YouFixPlaybackIssues

Fixes the notorious playback issue by presenting to YouTube servers as an Oculus Quest, bypassing the iOS sideload check. Developed by AppropriateNet2928 with the help of Tonwalter888

Source code and additional information are available in AppropriateNet2928's GitHub repository.

Credits

Thank you to everyone that made this project possible! This project would not exist without the existing tools made by these developers. I really appreciate your work :)

dayanch96 - YTLite

PoomSmart - YouPiP, YTUHD, Return YouTube Dislikes, YouQuality, YTABConfig, YTIcons, YouGroupSettings, YouMute, YouSpeed, YouGetCaption

therealFoxster - DontEatMyContent

castdrian - Gonerino

pwnless - AutoFLEX

theos - theos, SDKs

Tonwalter888 - YTUHD, SDKs, YouFixPlaybackIssues

bhackel - YouLoop

AppropriateNet2928 - YouFixPlaybackIssues

Join the Telegram channel for more info

https://t.me/+eMTckUjVWWsxOGZh

About

Build YouTube Plus (YTLite) with optional integrated tweaks

Resources

License

Stars

108 stars

Watchers

2 watching

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors

Languages

  • Shell 100.0%