TeamWin - TWRP

TWRP 3.5.0 Released

Thu, 31 Dec 2020 18:24:42 +0000

TWRP 3.5.0 is out now for most currently supported devices.

For this release we are breaking down new support for devices based on android trees and device compatibility. For Pie and earlier devices, they will be built out of the android-9.0 branch. For devices that are released with Android Version 10, they will be supported under the android-10 branch.

The separation became apparent when a lot of functionality was dropped in the android-10 release last year. The devices that are supported in Android 10 are from the tireless support of the following individuals over this period: - CaptainThrowback - Mauronofrio - AndroidableDroid - Noah Jacobson

You will notice a new version scheme. Devices that are built in the android-9 tree will be suffixed with 3.5.0_9. Devices built in the android-10 tree will be suffixed with 10 like 3.5.0_10. Each device tree update will have a final suffix for any updates made for the device like 3.5.0_10-1.

And finally myself, bigbiff has put in a lot of work over the past year while Dees_Troy is able to get back to helping us again with the Android-11 release. I have started a bringup for an Android-11 merge, and will be working on the Pixel 5 bringup. I hope the progression is shorter in 2021.

You can see the device builds under their respective Jenkins view at https://jenkins.twrp.me.

What's new in 3.5.0:

Android 9

Fix building in android-5.1 trees - CaptainThrowback
New QTI Haptics Support - AndroidableDroid
New TSPDriver Haptics Support - LameMonster82
Selinux restore issues - AndroidableDroid
OEM build fixes - Fighter19
More file extension support in Gui file selector - Mauronofrio
FBE Fixes - CaptainThrowback
Ozip Decryption - Mauronofrio
Don't use persist for recovery logs - bigbiff
Delay touch startup if necessary - bigbiff
Spanish translation Updates - R0rt1z2
Fix cache wiping on Slot A only devices - AndroidableDroid
Exclude dumpsys directory from backups - DarthJabba9
Gerrman translation Updates - 4ndyZ
HW Rotation during runtime (does not affect touch panel) - webgeek1234
API 24 fixes - AndroidableDroid
vold_decrypt error on unmount - CaptainThrowback
Multiuser - warn when users are not decrypted - noahajac
FDE encryption fixes - CaptainThrowback
Crypto state fixes - nebrassy
Chinese translation Updates - Whyle
Theme updates to match android-10 release: CaptainThrowback
Move TWRP App install to Advanced page - Dees_Troy
Update Russian Translation - f2065

Android 10

There have been so many changes to bring up Android-10. You can see the list of updates at Github

All the above Android-9 updates are included in these supported devices.

Notable mentions:

Omni 10 minimal support: CaptainThrowback
General Bringup: Bigbiff, Mauronofrio, AndroidableDroid, CaptainThrowback, ianmacd, DarthJabba9
Encryption support: Bigbiff, Mauronofrio, CaptainThrowback
Fastbootd support: Bigbiff
Install Support: Bigbiff, CaptainThrowback
Magisk Support: Bigbiff
Backuptool Support: Chaosmaster
Apex support: Bigbiff
Dynamic Partition Support: Bigbiff

Want to get notifications when we release new versions of TWRP? Install the TWRP app and select your device!

We need your help! The bulk of TWRP work is done by a handful of people on a volunteer basis. We have pushed most of our device files to our github and we have a gerrit instance. If you have the ability, please help us maintain our official devices and/or add your device to our official device list. Thanks in advance!

Head over to the devices page to find install instructions and download links.

TWRP 3.4.0-0 Released

Wed, 24 Jun 2020 13:21:42 +0000

TWRP 3.4.0-0 is out now for most currently supported devices.

What's new in 3.4.0-0:

System As Root (SAR)

Fix backup and restore using SAR - dianlujitao
System mount point - Chaosmaster
ORS - Chaosmaster
Zip install - Chaosmaster
system_root bind mount to /system - Chaosmaster
Autodetection of SAR - Chaosmaster

Digest

fix creation of digests for sub-partitions (was bugfix applied to many devices since last year) - Bigbiff

Encryption

ext4Crypt Wrapped Key Update - Peter Cai
Fix upgrading encryption key if export fails - Peter Cai
Fix wrapped key support for devices without metadata partition - mauronofrio
Don't skip decryption when using block map file in order to write to /data in ORS - CaptainThrowback
FDE - Decrypt master key first - AndroidableDroid
vold_decrypt - set Android version and patch level automatically - CaptainThrowback
Set wrapped decrypt support by twrp flag - Peter Cai
Don't try wrapped support unless needed - mauronofrio
restore ext4 policy on /data/cache - Bigbiff
multiuser decryption - Noah Jacobson
FDE retry - AndroidableDroid

TWRP App

unmount system after checking for app - Bigbiff

Prebuilt updates -

android.hardware.confirmationui@1.0 - cryptomilk

Compilation Fixes:

TW_EXFAT_FUSE compilation fixes - Bigbiff
libuuid - cryptomilk
'system/etc/ld.config.txt' not found error - Martin Dünkelmann

Language Updates:

Portugal - Vasco Machado
Dutch - Ian Macdonald
Turkish - Fatih Fırıncı
Localisation of Backup_Tar: Ian Macdonald

ld.config.txt

updates for 8.x trees - CaptainThrowback
fix search path for /sbin - CaptainThrowback
/sbin should come first in search path - Ian Macdonald

General Bugs

Fix persistent log storage - SyberHexen
Compress Persistent Logs - Bigbiff
FB2PNG compilation errors - Bigbiff
exclude per_boot from backups - Darth9
Unmount all directories that point to same block device - AndroidableDroid
Blank screen fixes - Sean hoyt
Toolbox is default on android-9+ - mauronofrio

Cleanup -

Typo fix in comment - VDavid003
newlines in ext4crypt - CaptainThrowback
TW_OEM_BUILD compilation issue - Patrick Zacharias
Fix Dependency requirements - Dees_Troy
Fix Symbolic links for BB and Toolbox - Dees_Troy

Bootloader Message

cleanup - Alessandro Astone
add configurable offsets

Error Cleanup

uevent errors and decryption error - mauronofrio
using copy_file to copy files from /etc - CaptainThrowback
ueventd access to /acct - early directory creation in init - cryptomilk

Haptics

TSP Driver - LameMonster82
QTI Input - AndroidableDroid

update_engine

read all asserts - Hernán Castañón

Resetprop

Add Resetprop from Magisk - CaptainThrowback & mauronofrio
compile from source - Chaosmaster
fix for android-7 and earlier - Chaosmaster
cleanup for spaces in properties - AndroidableDroid

Properties

Add Property override - Chaosmaster

Backuptool

mount system and vendor for A/B installs for backuptool - Chaosmaster

twrpTar

fix backup freezes when pigz and openaes are used - Fabrice Bellet

Zip Installs

Info for A/B zip installing to inactive slot - Chaosmaster
Reboot to system button now allows to be rebooted to different partitions after zip install
progressbar rework - Chaosmaster

Magisk updates

update binaries from source - AndroidableDroid

A/B Updater Zip Template

rewrite A/B installer zip from scratch using a new generic template and latest magiskboot - osm0sis
installer zip support for recovery_a/recovery_b partition ramdisks on newer 2SI SAR A/B devices - osm0sis
generate installer zips for all prod A/B devices - bigbiff
improve installer zip dump/write speed and add more error catching - arter97 & osm0sis

OZIP Encryption Support

add OZIP encryption - mauronofrio

File Selector

Support for more extensions in File Selector - mauronofrio

Want to get notifications when we release new versions of TWRP? Install the TWRP app and select your device!

Head over to the devices page to find install instructions and download links.

Unofficial TWRP Downloads

Fri, 01 May 2020 10:30:00 +0000

It has recently come to our attention that there are sites that publish "unofficial TWRP" images. These are versions of TWRP that are being distributed out of our authority based on forks and internal unpublished sources from people not associated with our site. Unfortunately we don't have a lot of time to police these sites and images. Some are forks of our project that are not forwarding back patches to our gerrit site, or they just cherry-pick open commits and release them before the patchsets can be vetted and merged to the baseline. Some sites just scrape images from our download sites and post them as their own.

We try to pride ourselves on the security and established chain of repudiation by using GPG signatures and publishing SHA2 hashes to show the images haven't been modified from the original build on our jenkins server. Our jenkins build logs are able to be seen by anyone wanting to verify how their image was built. Our sites are using Let's Encrypt for end-to-end TLS encryption. We are not serving any pages or images outside of this TLS end-to-end encryption.

We are receiving much community support but unfortunately the aforementioned unofficial versions of TWRP can never meet any type of veracity from TeamWin. Please consider your security before installing any unofficial TWRP to your device.

TWRP Repository On Gerrit Moved

Tue, 10 Dec 2019 19:09:23 +0000

We are moving the TWRP repository from OmniRom Gerrit to TWRP Gerrit retaining the android_bootable_recovery project name. If you have any open Change Requests on OmniRom Gerrit and would like to see them reviewed, please cherry-pick and push them to the repository on TWRP Gerrit.

Original project URL

New project URL

Thanks for all your continued support to the TWRP OSS Project.

TWRP and Android 10

Wed, 23 Oct 2019 09:39:42 +0000

Please note that this post is primary related to TWRP and the Pixel 3 and 4 and devices that may ship in the future that ship with Android 10 as their original version of Android. Older non-Pixel devices that shipped with older versions of Android and receive upgrades to Android 10 are not affected.

Long story short, TWRP support for Android 10 is going to take a while.

Android 10 brings about the largest changes to the way AOSP implements recovery since Google shifted recovery from C to C++ when they moved from Android 4.0 to 4.1 more than 7 years ago. A lot of components in AOSP recovery were moved into subfolders, which makes merging the latest changes into TWRP more time consuming. At least on the Pixel 3, the ramdisk that we use for recovery is now handling part of normal boot in addition to recovery, so we're not sure what the best way will be to go about replacing recovery without affecting the ability to boot up normally. In addition, the way Google is building the ramdisk on the Pixel 3 is a lot different than the past. In the past, the executable binaries in the ramdisk were built as static binaries with no linked libraries. TWRP has almost always been built with separate linked libraries. The new dynamically linked stock ramdisk will make it harder for us to slip TWRP into the ramdisk.

Once we get TWRP compiling with the new changes from 10, we have some additional items that need consideration. As mentioned above, the stock ramdisk is using dynamic linking. Unlike TWRP, the stock ramdisk places the executables and libraries in the usual locations inside a /system folder. Normally TWRP leaves /system alone so that we can mount the system partition to its usual location of /system. If we leave things the way they are on the Pixel 3, mounting the system partition gets tricky. A lot of custom zips depend on mounting the system partition to /system.

Android 10 also introduces a new dynamic partitioning system. Instead of having a dedicated system partition and a dedicated vendor partition, etc. Android 10 uses a super partition. I like to think of the super partition as a partition that contains a bunch of smaller partitions. One of the side effects of this dynamic partition system is that Google has chosen to use a form of the ext4 file system that is for all intents and purposes, read-only. This choice means that even if you wanted to, you can't easily mount and modify the system partition. We haven't really discussed this with other developers yet, but it may impact your ability to do things like install Gapps. In addition, the dynamic partition model means that eventually, we should probably provide you, the user, some GUI driven tools in TWRP to allow you to manage the dynamic partitions that are on the super partition.

On top of all of the above, I, Dees_Troy, am the one who usually handles merges of new versions of Android. My wife is currently pregnant with our fourth child. I am quite busy with my growing family and the need to find a bigger house, so my time for working on TWRP right now is somewhat limited. So, I guess please be patient, or feel free to download the TWRP source code and make the needed changes yourself.

TWRP 3.3.1-0 Released

Wed, 22 May 2019 09:39:42 +0000

TWRP 3.3.1-0 is out now for most currently supported devices.

What's new in 3.3.1-0:

* Fix selinux issues during formatting - dianlujitao
* Various fixes for toybox and toolbox builds - CaptainThrowback and bigbiff
* Flash both A and B partitions when installing a recovery ramdisk - Dees_Troy
* Add option to uninstall TWRP app from /system - Dees_Troy
* Create digest for subpartitions - bigbiff

Want to get notifications when we release new versions of TWRP? Install the TWRP app and select your device!

Head over to the devices page to find install instructions and download links.

TWRP 3.3.0-0 Released

Mon, 15 Apr 2019 09:39:42 +0000

TWRP 3.3.0-0 is out now for most currently supported devices.

What's new in 3.3.0-0:

* Merge AOSP 9.0 r3 (Dees_Troy)
* Use ANDROID_ROOT variable instead of hard coding to /system (CaptainThrowback)
* Decrypt FBE on 9.0 and metadata decrypt (Dees_Troy)
* vold decrypt updates (CaptainThrowback and nijel8)
* Support vibration on LED class devices (notsyncing)
* Metadata decrypt support for Pixel 3 (Dees_Troy)
* Support rotating the display via build flag (vladimiroltean)
* Reboot to EDL mode button (mauronofrio)
* Support MTP on FFS devices (bigbiff)
* Update FDE decrypt to support keymaster 3 and 4 (Dees_Troy)
* Detect mkfs.f2fs version to properly format on f2fs partitions (Dees_Troy)
* Allow TWRP to use md5 and sha256 checksums for zip installs (bigbiff)
* TWRP can use /data/cache/recovery and /persist/cache/recovery on AB devices with no cache partition (bigbiff)
* Switch part of advanced menus in TWRP to use a listbox of options (Dees_Troy)
* Use magiskboot to allow repacking boot images for installing TWRP (Dees_Troy with thanks to topjohnwu of course)

Want to get notifications when we release new versions of TWRP? Install the TWRP app and select your device!

Head over to the devices page to find install instructions and download links.

TWRP 3.2.3-0 Released

Mon, 06 Aug 2018 09:39:42 +0000

TWRP 3.2.3-0 is out now for most currently supported devices.

What's new in 3.2.3-0:

* Fix automatic installing of OTA zips on encrypted devices
* Remove SuperSU from TWRP
* Support both md5 and md5sum file extensions when doing MD5 checking for zip files

Want to get notifications when we release new versions of TWRP? Install the TWRP app and select your device!

You can track the progress of builds here

Head over to the devices page to find install instructions and download links.

TWRP 3.2.2-0 Released

Sun, 01 Jul 2018 09:39:42 +0000

TWRP 3.2.2-0 is out now for most currently supported devices.

What's new in 3.2.2-0:

* adb backup fixes
* OTA style update zips will now install automatically without prompting for decrypt
* minor tweaks to handling date/time on Qualcomm devices
* updates to some language translations

Want to get notifications when we release new versions of TWRP? Install the TWRP app and select your device!

You can track the progress of builds here

Head over to the devices page to find install instructions and download links.

TWRP 3.2.1-0 Released

Sat, 09 Dec 2017 09:39:42 +0000

TWRP 3.2.1-0 is out now for most currently supported devices.

What's new in 3.2.1-0:

* minui fixes (cryptomilk)
* Better android-8.0 compatibility in ROM trees (Dees_Troy)
* Fix missing library in android-8.0 (nkk71)
* Fix inconsistent SDCard naming (DevUt)
* Default to TWRP restore instead of adb backup restore to fix restore on fresh TWRP boot (jlask)

Want to get notifications when we release new versions of TWRP? Install the TWRP app and select your device!

You can track the progress of builds here

Head over to the devices page to find install instructions and download links.