TWRP 2.8

Introduction:

 


 

Team Win Recovery Project 2.8, or twrp2 for short, is a custom recovery built with ease of use and customization in mind. We started from the ground up by taking AOSP recovery and loading it with the standard recovery options, then added a lot of our own features.  It’s a fully touch driven user interface – no more volume rocker or power buttons to mash.  The GUI is also fully XML driven and completely theme-able.  You can change just about every aspect of the look and feel.

Donate Bitcoins: 1EUshGGz6KdsRJioozqFmn4FHQk4z3Ggxg

TWRP Frequently Asked Questions (FAQ)

Phone look:

 

Tablet look:

What's new in 2.8.1.0:

  • MTP fixes and improvements - you can now copy zips to the root of storage - thanks to _that
  • TrueType Font support - optional as it takes up a decent amount of space so may not be available on all devices - thanks to Tassadar
  • Temperature support - thanks to bigbiff
  • Various other bugfixes and tweaks

What's new in 2.8.0.1:

  • Fix a bug that caused weird graphics and touch issues

What's new in 2.8.0.0:

  • Add MTP support to recovery thanks mostly to bigbiff with a little help from Dees_Troy
  • Add command line capabilities - you can now execute various TWRP features via adb instead of the touchscreen
  • Add support for color in the console and give error, warning, and highlight lines different colors
  • Track backup and restore progress based on file sizes to provide a much more accurate indication of progress
  • Improve handling of /misc thanks to mdmower
  • Improve setting of time on Qualcomm devices thanks to [NUT]
  • Allow using images on slidervalue GUI objects thanks to Tassadar
  • Allow using variables and addition and subtraction in variables for easier theming
  • Add support for 1440x2560, 280x280, and 320x320 resolutions and update 240x240
  • Allow ui.xml file to include additional xml files to help break up the theme and make TWRP easier to maintain
  • Other minor fixes and improvements

Over the course of the last year or so, bigbiff has worked to migrate various Java functions from Android's MTP implementation to bring you a fully C++ based MTP implementation that allows you to transfer files to both emulated storage and Micro SD cards. It's confirmed to work on various Nexus devices but we may have to make some changes on other devices to keep Windows happy. Windows is very picky about USB IDs and its drivers. We have tested it on Windows 7 and 8 as well as Ubuntu 14.04 Trusty. MTP is enabled by default, but we do toggle it off and on automatically during certain operations such as if you choose to wipe a storage partition. You can enable or disable MTP under the mount menu in TWRP. For more about what MTP is here.

Note: Due to a weird bug with our MTP setup, you cannot copy a zip file to the root of storage with Windows. You can change the .zip to something else like .txt and then copy it to the root and rename the file back to .zip once it's copied to the device. You can also copy the zip into any subfolder.

Command line support is also now available. You can perform various OpenRecoveryScript commands via the adb shell. Depending on what you are doing you may wish to do a "twrp set tw_mtp_enabled 0" and then reboot to prevent the MTP auto toggle from killing your adb interface. You can use this option to create and restore backups, wipe, install zips, and more. Via adb shell, type twrp followed by a space then enter the OpenRecoveryScript command and hit enter. Find more OpenRecoveryScript commands here.

 

What's new in 2.7.1.0:

  • Add GUI option to change or repair file systems on individual partitions. The change is destructive so backup your data including internal sdcard first. This option should make it a little easier to migrate a device from ext4 -> f2fs, for instance. You will find this option under Wipe -> Advanced Wipe, then select only one partition and then press the Repair or Change File System button. If a developer has added f2fs support for your device and we don't have it in TWRP, please contact me via PM to arrange for it to be added.
  • Various bugfixes to backup and restore
  • Improvements to USB storage handling
  • Added a class to search for files to make finding the correct brightness file automatic in most cases
  • Various other bugfixes and tweaks

What's new in 2.7.0.0:

  • Faster graphics rendering by disabling alpha blending on fully opaque objects thanks to Tassadar
  • Allow sideloading from /tmp on encrypted devices
  • Check for a crypto footer before asking for a password to prevent user confusion
  • Additional checks for validity to auto generated backup names
  • Text wrap in the console output
  • Proper caps lock support in the keyboard
  • Mouse support via USB OTG for devices with a broken digitizer
  • Improve scanning of storage locations for OpenRecoveryScript
  • Haptic feedback for buttons, keyboard, and vibration at the end of longer running actions
  • Fixed ext4 wiping when no selinux contexts are defined for that partition (e.g. sd-ext)
  • Update SuperSU to 1.93 and improve installation process
  • Added selinux contexts restoration to fix permissions
  • Load RTC offset on Qualcomm devices to fix the date/time in recovery
  • USB Mass Storage fixes Add SELinux support checking
  • Add Disk Usage class to better handle excluded folders (e.g. Google Music cache)
  • Add 4.4 AOSP decrypt support
  • Add some toolbox utilities to TWRP (namely to support SELinux functions not supported in busybox)
  • Various SELinux fixes and bug fixes

Note: 2.7 marks the first time that we are dropping support for older devices. We are doing this because of the SELinux support needed to install 4.4 Kit Kat ROMs. The non-TWRP parts of the recovery image have to be built in at least a 4.1 tree and the kernel that is included in the recovery image has to support writing SELinux contexts. We don't own most of the devices that we support so we depend on outside testers and developers to help us update devices. In many cases we can't find someone readily. Come to #twrp on Freenode if you want to help bring your device up to date. You can tell right away if your device will support 4.4 ROMs in 2.7. Boot TWRP and press the console button (the square-ish button either in the bottom middle or upper right) to view the console output. If it doesn't say "Full SELinux support" in the console, then your device still needs some work. Help us help you.

Key Features:


  • Ability to save custom recovery settings
  • Touchscreen driven with real buttons and drag-to-scroll
  • XML-based GUI that allows full customization of the layout – true theming!
  • Settings are saved to the sdcard and persist through reboots
  • Ability to choose which partitions to back up and which to restore
  • Ability to choose to compress backups – now with pigz (multi-core processor support for faster compression times.

Theming:


Information on TWRP 2 Theming

Special Thanks To:


  • Core twrp 2 development team: agrabren, Dees_Troy, ViViDboarder, and AssassinsLament
  • Toastcfh – for his underappreciated dedication to the community
  • s0up and kevank for their hard work on the web side of things.
  • The rest of Team Win: shift, onicrom, netarchy, kevank, myndwire, bigbiff, dkelle4, shinzul, spiicytuna, and eyeballer
  • Amon_RA - for his great Recovery
  • Koush - for his dedication to the community and ClockworkMod
  • For all the help with devices and testing Akmzero, arif-ali, Evil_DevNull, gus6464, Jesusice, _jmz_, NxtGenCowboy, ohshaith55, Pyrostic, [R], and Rootzwiki
  • As always thank you to the Team's supporters and the Android Community.

Changelog:


2011-12-17 - v2.0.0

  • Initial release of twrp 2
  • Full GUI touchscreen with buttons and XML engine
  • Fixed sdcard free space checking
  • Fixed bugs with MD5 zip file checking
  • Now check more places for a serial number
  • Too many fixes versus twrp 1.1.1 to list

Officially Supported Devices:


All official devices are listed at the top of this page. Visit the device page for specific directions and downloads.

If you don't see your device listed, don't worry! We'll be adding more devices soon.

Previous versions of TWRP can be found here (mirror).

Known Issues (affects all devces):


  • Zip files that install more data than free space is available will crash or hang recovery (AOSP issue)

Source Code:


GitHub

How to Compile TWRP from Source

How to Submit a Code Change for TWRP using Gerrit

If you have made your own twrp build for an unsupported device, please let us know. We might add your build to the list of unofficial builds. Bear in mind that we are working hard to add more devices and we may add your device to our official build list later.

Support:


Click here for live support or join us in #twrp on Freenode IRC servers

TWRP 2.x in the News:


Feel free to contact us for a press kit, interviews, more images, or any questions!