New here and just want it working? Watch the screen recording, follow the step-by-step, and check what each screen should look like.
› video · step-by-step · screenshots · troubleshooting · one-click downloads
① microG-RE first — then ② T YouTube. Both buttons go straight to the file.
-3DDC84?style=for-the-badge&logo=google-play&logoColor=white){kind=icon}
-FF1744?style=for-the-badge&logo=android&logoColor=white){kind=icon}
Install order matters: microG-RE pehle, phir T YouTube.
Android will ask you to allow "Install unknown apps" for your browser the first time.
T YouTube will not run without it — it cannot use Google Play Services.
Captions describe the current v1.1.0 build. The images are from the v1.0.0 era, so a few details on screen differ from what ships today.
Player — one frame that shows three working features at once: the download button, SponsorBlock, and Return-YouTube-Dislike.
The rebrand, caught in the act — both of these were taken on the v1.0.0 build, and both headers read T YouTube. On the base build this spot said "YouTube Pro", because the old name was baked into the app's header images.
Settings Toolbar reads T YouTube; the whole YT Pro patch menu is intact. |
Music tab Rebuilt in-app wordmark — T logo + “T YouTube” in the header. |
Downloader Quality picker, 144p → 4K@60. The filename opens with the real video title, a duplicate is auto-renamed to Title (1).mp4, and tapping the toolbar icon starts the download. |
Watch screen Playback, comments, music player. Fullscreen shows a small T YouTube mark in the control row. |
Shorts and the fullscreen watermark changed in v1.1.0 but are not in these images yet — see issue #1 and issue #5.
This is not a feature-addition fork. It is a cleanup and rebrand of YT Pro v59 — three deliberate changes, nothing else.
| # | Change | Details |
|---|---|---|
| 1 | Startup ad/promo popup removed | The mod fetches a remote JSON from a third-party server and pops an affiliate/promo dialog on every launch. Both code paths are stubbed to return-void at the entry point — no network request, no dialog, no background thread. |
| 2 | Full rebrand | Every YouTube Pro string replaced with T YouTube across all 82 locales, plus settings screens and the launcher label — and the in-app wordmark images (40 PNG/WebP assets across five densities) where the old name was baked into pixels, which no text search can find. Zero occurrences remain. |
| 3 | New icon set | Purpose-built launcher icon built to the official Android adaptive-icon spec. |
Not changed: the package name, version code, or any patch/feature logic. This build upgrades in place over the original and keeps your data, logins and watch history.
Shorts branding, the fullscreen watermark, and the download confirm button
are now the recommended stable build. Everything below was first shipped and
verified as the test-zversion-4 / test-v1.1.0 builds, then promoted
without rebuilding, so the checksum published here matches the build that
was actually tested.
| Fix | What changed |
|---|---|
| Shorts brand loop | The top-left Shorts back control cycles every 8 seconds: arrow -> 225 ms crossfade -> T YouTube -> 225 ms crossfade -> arrow. The whole 128x48 dp strip is one Back target and the title does not move. Root cause of the old stuck arrow: Shorts had two views with the same reel_back_button id - reel_player_back_button.xml (included by the non-video/survey pages) still shipped the plain quantum_ic_arrow_back_white_24 arrow, so findViewById() could hand the player that arrow instead of the loop. Both layouts now carry the loop, and onWindowFocusChanged restarts the AnimationDrawable once the view really has focus so it can no longer freeze on the opening arrow. |
| Download confirm button | Tapping the toolbar download icon actually starts the download. v1.0.1's proven checkSelectedDownload is restored byte for byte (verified with git diff - only 4 hunks) and gains the duplicate handling below. |
| Duplicate names | Downloading the same title again just works: the app saves Title (1).mp4 immediately with its own createUniqueFile() and starts downloading - no prompt, no extra tap, no overwrite. |
| Active downloads | Pending and Running downloads show an information dialog with only a Cancel button and are never overwritten. |
| Download filename | The dialog starts with the real video title. v1.0.1's FilenameUtils fix is kept (its inverted isEmpty() check used to replace every title with "download"). |
| Fullscreen watermark | A subtle 14 sp bold T YouTube wordmark (32 dp) anchored to the bottom of the control row, below the scrubber line. onVisibilityChanged hides it the instant the controls overlay hides - Android documents that callback as firing when the view or an ancestor changes visibility. It is in both bottom-control layouts, shows only in fullscreen while controls are visible, and is absent inline, in PiP and in Shorts. |
| Build marker | The About screen shows Play Store Version 21.20.402 (v1.1.0) so you can confirm the installed build. The app version stays 21.26.364. |
Download T YouTube v1.1.0 -
release notes, size and checksum.
Same package, version code and AOSP testkey signature as v1.0.1, so it
installs in place over v1.0.1 (or any test build) and keeps your data. Install
the APK as an update - do not uninstall the old app first.
Size: 222,584,140 bytes (212.3 MiB)
SHA-256: 337f55a17c8fdd1ae458a4ab9e76ca3bd1335c3865ca0bb5de055fd078496d5c
Rollback: install v1.0.1 over it. No data is lost.
Also in v1.1.0 (carried over from v1.0.1): the download crash on short titles stays fixed, downloads complete with unthrottled stream URLs, long-video seeking resumes at the selected quality, Shorts no longer stall, and dark theme is the default.
YouTube links (optional): see Open YouTube links in T YouTube. You can skip it; nothing else depends on it.
Full change log for every build, including the withdrawn test-fix-4: TEST-CHANGES.md.
Shorts/fullscreen branding specs: TEST-UI-BRIEF.md.
Optional convenience. Skip it if you prefer — links keep opening in the official YouTube app or your browser, exactly as before.
Android allows only one app per website. While the official YouTube app is
verified for youtube.com, T YouTube cannot take those links over silently —
Google already owns them. You hand them over once, in Android settings.
- Release the links from official YouTube — Android Settings → Apps →
YouTube → Open by default → turn off Open supported links (or
remove
youtube.comandm.youtube.comfrom the supported addresses). - Give them to T YouTube — Android Settings → Apps → T YouTube →
Open by default → Add link → tick
youtube.comandm.youtube.com→ Add. - Test — open a youtube.com link from your browser or a chat app; Android should offer or open T YouTube.
Menu names vary slightly by phone maker (Samsung, Xiaomi, Pixel): look for “Open by default”, “Default apps” or “Supported links” on the app info page. Undo step 1 the same way if you change your mind.
The previous icon was drawn at ~82 dp wide on a 108 dp canvas. Android only ever shows a 72 dp window of that canvas — so the neon ring was clipped by every launcher mask. It looked broken.
This one is built to spec:
Canvas 108 dp
Masked window 72 dp ← what the launcher actually shows
Safe zone 66 dp ← artwork is fitted inside this circle, always
Built and previewed against circle, squircle and rounded-square masks at all
five densities (mdpi → xxxhdpi), plus the legacy square bitmap and the
Android 13+ themed icon (previously still showing the YouTube play glyph).
| Android | 10.0 (API 29) or newer |
| Architecture | arm64-v8a, armeabi-v7a, x86, x86_64 — universal APK |
| Google Play Services | Not required — and must not be active. T YouTube runs on microG-RE, which cannot coexist with Google Play Services. |
| microG-RE | Required. A GmsCore fork — see below. |
| Free storage | ~350 MB (app + data) |
microG-RE is a GmsCore fork that supplies the Google Play Services APIs YouTube needs. T YouTube declares these in its manifest, and microG reads them to grant the app its identity:
app.revanced.android.gms.SPOOFED_PACKAGE_NAME = com.google.android.youtube
app.revanced.android.gms.SPOOFED_PACKAGE_SIGNATURE = 24bb24c0…
Grab it with the ① button above, or from the official releases — never from a random APK site:
https://github.com/MorpheApp/MicroG-RE/releases/latest
The universal
microg-*.apk(≈107 MB) works on every phone — that's what the button gives you. Slimmer per-ABI builds (-arm64-v8a,-armeabi-v7a, ≈42 MB) are also there if you want to save data.microG-RE is Apache-2.0 licensed and this repo links to it rather than re-hosting it.
Already using Google Play Services? It must be disabled/uninstalled first. microG will not install alongside it, and T YouTube will not work while Play Services is still active.
microG-RE Settings → Signature spoofing → enable for T YouTube
Without this the app installs but sign-in, playback and most API calls fail.
- Download
T-YouTube-v1.1.0.apkfrom the link at the top - Open it — allow "Install unknown apps" for your file manager/browser
- Tap Install
Android refuses to install an update signed with a different key. T YouTube
is signed with the same AOSP testkey certificate that YT Pro v59 uses, so it
installs directly over it — no uninstall, your data stays.
package com.gold.android.youtube
versionCode 2147483647
signature SHA-256 a40da80a59d170caa950cf15c18c454d47a39b26989d8b640ecd745ba71bf5dc
That message means a differently-signed copy of the same package is already installed. Common causes:
| Situation | What to do |
|---|---|
| A YT Pro build signed with a modder's own key | Uninstall it first ( clears app data) |
| A build signed with a random debug key | Uninstall it first |
Any other fork of com.gold.android.youtube |
Uninstall it first |
Reinstalling this build after that, and staying on this build for all future updates, avoids the problem entirely.
Can it run alongside the official YouTube?
Yes. T YouTube uses the package com.gold.android.youtube, while the official
YouTube is com.google.android.youtube. Different packages — both can be
installed side by side. In practice though, YouTube needs microG-RE and Play
Services cannot coexist with it, so you will usually want only one.
Does this remove in-video ads?
It removes the mod's own startup promo/affiliate popup. In-stream advertising is served by YouTube's servers and is a separate matter.
Why does it say "MicroG Not Installed"?
microG-RE is not running, or signature spoofing is off. Go back to Steps 1–2 above.
Can I update later without losing data?
Yes — as long as future updates keep the same signing key, Android treats them as an in-place update. Never re-sign with a random debug key; that is the single most common cause of the conflict error above.
Why was this signed with the AOSP test key?
Because that is the key the original YT Pro v59 is signed with, and Android
requires a matching key to install over an existing app. The AOSP testkey
certificate is a publicly published test certificate from the Android Open
Source Project — it is not a secret, and it grants no special privileges.
Is this safe?
It is a modified YouTube client. It is not distributed by, affiliated with, or endorsed by Google. See Legal.
| Property | Value |
|---|---|
| Package name | com.gold.android.youtube |
| Version name | 21.26.364 |
| Version code | 2147483647 |
| Min SDK | 29 (Android 10) |
| Target SDK | 37 |
| APK size | 222,566,961 bytes (212 MB) |
| Entry count | 16,827 |
| Signature scheme | APK Signature Scheme v3 |
| Signing certificate | AOSP testkey — CN=Android, O=Android, L=Mountain View, ST=California, C=US |
| Cert SHA-256 | a40da80a59d170caa950cf15c18c454d47a39b26989d8b640ecd745ba71bf5dc |
| Cert SHA-1 | 61ed377e85d386a8dfee6b864bd85b0bfaa5af81 |
# signature
apksigner verify --print-certs T-YouTube-v1.1.0.apk
# checksum
Get-FileHash T-YouTube-v1.1.0.apk -Algorithm SHA256SHA-256 for v1.1.0 (current stable)
337f55a17c8fdd1ae458a4ab9e76ca3bd1335c3865ca0bb5de055fd078496d5c
SHA-256 for v1.0.1 (previous stable)
71B0F782702129A0DDCC80EE0A7150F52FE0099671AB62692766B1C605EBE7FE
YT Pro v59 (original APK)
│
├─ apktool 2.9.3 d → decode to smali + res
│
├─ patch ① com.apksam.task.DevMsg.showMessage() → return-void
├─ patch ② com.sammods4h.task.DevMsg.show() → return-void
│ (both are the remote-config promo dialog entry points)
│
├─ patch ③ res/values*/strings.xml → 83 files, "YouTube Pro" → "T YouTube"
├─ patch ④ adaptive + legacy + themed icons rebuilt to spec
├─ patch ⑤ in-app action-bar logo → T mark
├─ patch ⑥ 40 wordmark PNG/WebP rebuilt (the app header still said
│ "YouTube Pro" because that text lives inside images)
│
├─ apktool 2.9.3 b → rebuild
├─ zipalign -p -f 4
└─ apksigner sign --ks testkey.p12 (AOSP testkey, scheme v3)
The rebuild was verified byte-identical across all 10 classes*.dex files
versus the known-good build, confirming the runtime patches survived reassembly.
@engrtarun
Issues and pull requests are welcome — especially translations, bug reports with logs, and icon refinements for other launcher shapes.
Please do not open issues for ad-blocking or account problems; those are server-side / microG-side concerns.
If T YouTube saved you a download or some time, a star genuinely helps - it is the only signal GitHub uses to rank a repository, and it is what this project has instead of ad revenue.
Why it matters
| Instead of | Try this |
|---|---|
| Nothing | Press Star - takes one click, costs nothing |
| Spreading a link that dies | Press Fork - you get your own copy to change freely |
| Reporting a bug later | Press Watch - you get notified when a new update ships |
Share it with one person who got stuck installing. That is worth more than a hundred stars: it is the difference between someone giving up and someone getting it working. The hardest part of this project is not the code, it is that nobody finds modified YouTube builds unless somebody tells them.
Star if it helped. Fork if you want to make it yours.
T YouTube is an unofficial, community-made modification of the YouTube Android client. It is not affiliated with, endorsed by, sponsored by, or otherwise connected to Google LLC or YouTube.
- "YouTube" is a trademark of Google LLC. The name is used here only to describe what this software is a modification of.
- The APK contains copyrighted Google code and is published for educational and interoperability purposes only.
- No source code is provided for the YouTube client itself. The original authors and copyright holders retain all rights to it.
- microG-RE is a separate project (a GmsCore fork, Apache-2.0) and is not bundled or redistributed here — you download it from MorpheApp/MicroG-RE.
- You are responsible for complying with the laws in your jurisdiction.
| YT Pro v59 | The base build this is forked from — the patch set, downloader and feature work are theirs |
| microG-RE | The Google Play Services replacement this runs on — MorpheApp/MicroG-RE |
| apktool | Used for decode / patch / rebuild — iBotPeaches/Apktool |
| Android Open Source Project | The testkey signing certificate is a publicly published AOSP test certificate |
| You | For the bug reports and translations |