TeamWin Projects - TWRP 2

2014/5/1

Te a mW in Pr oje c ts - TW RP 2.7 - | Te a mW in

TeamWin Projects YOU ARE HERE: HOME » » PROJECT » » TWRP2

TWRP 2.7[1]

TWRP 2.7

Introduction: Team Win Recovery Project 2.7, or twrp2 for short, is a custom recovery built with ease of use use and customization customization in mind. We started from the ground up by taking AOSP recovery and loading it with the standard recovery re covery options, then w added a lot ofanour own atiion in m Team Te am Win Recovery Project P roject 2.7, 2. 7, or twrp2 for short, is a custom recovery built with ith ease of use and d cu customizat features. feat ures.and It’sloading a fully touch user interface – then no more rocker rocker or recovery rec overy it with thedriven standard recovery options, added volume a lot of our own f or eatu eat upower res.. It’s a res

fully touch dr fu drii

buttonssto TheThe GUI GUI is also ful ly XML driven drive n anddriven completely can change change about every as spe button buttons tomash. mash. is fully also fully fully XML andtheme-able. completely completel yYou theme-able. theme-abl e.just You canevery a

change just about every aspect of the look and feel.

Donate Bitcoins: [2] 1EUshGGz6KdsRJioozqFmn4FHQk4z3Ggxg TWRP Frequently Fr equently Asked Questions Questions (FAQ) TWRP Frequently Asked Questions (FAQ)[3]

Phone look:

Phone Phon e look: Tablet look:

http://te a mw.in/pr oje c t/twr p2

1/17

2014/5/1

TeamWin Projects - TWRP 2.7 - | TeamWin

Tablet look:

http://teamw.in/project/twrp2

2/17

2014/5/1


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. sdext) Update SuperSU to 1.93 and improve installation process Faster graphics rendering by disabling alpha b lending on fully opaque obje cts thanks to Tassad ar

Added selinux contexts restoration to fix permissions Allow sideloading from /tmp on encrypted devices

Load RTCforoffset onfooter Qualcomm devices fix the to date/time in recovery Check a crypto before asking for atopassword prevent user confusion checks for validity auto generated backup names USBAdditional Mass Storage fixes AddtoSELinux support checking Text wrap in the console output

Add Disk Usage class to better handle excluded folders (e.g. Google Music cache) Proper caps lock support in the keyboard

AddMouse 4.4 AOSP support supportdecrypt via USB OTG for devices with a broken digitizer scanning of storage locations for(namely OpenRecoveryScript AddImprove some toolbox utilities to TWRP to support SELinux functions not Haptic feedba ck for buttons, ke yboard, and vibration at the e nd of longer running actions

supported in busybox)

Fixed ext4 wiping when no selinux contexts are defined for that partition (e.g. sd-ext)

Various SELinux fixes fixes Update SuperSU to 1.93and and bug improve installation process Added selinux contexts restoration to fix permissions Load RTC offset on Qualcomm devices to fix the date/time in recovery

Note: 2.7 marks the first time that we are dropping support for older devices. We are USB Mass Storage fixes Add SELinux support checking

doing this because thetoSELinux support needed to(e.g. install 4.4Music Kit Kat ROMs. The nonAdd Disk Usageof class better handle excluded folders Google cache) 4.4 support TWRP Add parts ofAOSP the decrypt recovery image have to be built in at least a 4.1 tree and the kernel Add some toolbox utilities to TWRP (namely to support SELinux functions not supported in busybox)

that is included in the recovery image has to support writing SELinux contexts. We don't Various SELinux fixes and bug fixes

own most of the devices that we support so we depend on outside testers and Note: 2 .7 marks the first time that we are dropping support for older devices. We are doing this because of the SELin

developers to help us update devices. In many cases we can't find someone readily.

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

Come to #twrp on Freenode if you want helpon bring your device to date. canupdate devices. own most of the devices that we support so we to depend outside testers and up developers to You help us #twrp on Freenode you want to help your device up to in date. You can tell right and away press if your the device will support tell right away if ifyour device willbring support 4.4 ROMs 2.7. Boot TWRP (the square-ish button either in the bottom middle or upper right) to view the console output. If it doesn't say "Full SELi

console button (the square-ish button either in the bottom middle or upper right) to some work. Help us help you.

view the console output. If it doesn't say "Full SELinux support" in the console, then http://teamw.in/project/twrp2

3/17

2014/5/1

.


.

Proper backup and restore of SELinux contexts (thanks to Tassadar) Pull in some ROM information for backup name generation What's new in 2.6.3.0: Merge all recent patches from AOSP b ringing TWRP up to date with Android 4 .3 Add 12 00x1920 theme (thanks to Tassadar)

Proper backup and restore of SELinux contexts (thanks to Tassadar) A few other fixes and tweaks Pull in some ROM information for backup name generation Merge all recent patches from AOSP bringing TWRP up to date with Android 4.3 Add 1200x1920 theme (thanks to Tassadar)

Initial SELinux support (only a few devices, need testers so come by IRC if your device doesn't have it and need

A few other fixes tweaks Initial support forand f2fs file system formatting (Moto X) Update SuperSU install for 4.3 ROMs

Fixed a p ermissions bug on files created during backup Fixed a b ug that caused TWRP to not wait for compressed b ackups to finish causing 0 byte files and md5sums

What's new in 2.6.1.0: Fixed decryption of encrypted data so that both TouchWiz and AOSP d ecryption are possible Ignore lost+found folder during backup and size calculations

Initial SELinux support (onlyand a few devices, need testers so come by IRC if your Various other minor bug fixes tweaks device doesn't have it and needs it) Initial support for f2fs file system formatting (Moto X) Update 4.3 ROMs Special Note:SuperSU If you are install running for a custom theme, some of the changes in 2.6.0. 0 will likely not be visible with your cus Fixed a permissions bug on files created during backup

Can encrypt a backup to prevent theft of private data from your backup files

Fixed a buggraphics that caused TWRP to not wait for compressed backups to finish causing 0 Updated / icon courtesy of shift exFAT to latest commits byteUpdated files and md5sums to not match Fixed a problem with Samsung TouchWiz decryption

Fixed decryption of encrypted data so that both TouchWiz and AOSP decryption are Update SuperSU binary

possible Fixed saving of backup partitions list Fixedlost+found saving of lastfolder used zip install backup folder Ignore during and size calculations Fixed backup of datadata on devices that use a separate partition for datadata

Various other minor bug fixes and tweaks

Fixed some issues with the advanced wipe list (android_secure, ca n now wipe internal storage on data/media formats the entire da ta partition) Fixed some problems with partitioning a SD card

Various other b ug fixes and tweaks What's new in 2.6.0.0: Notes about encrypted backups: Special Note: If you are running a custom theme, some of the changes in 2.6.0.0 will Why encrypt your backups? -- Most people store their backups on the d evice. Any app likely not be visible with your custom theme.

that has permission to access

harvest your data. Encrypted backups also provide an added layer of security if you move your backups to other stor using is encrypt probably not strong enough for enterprise level security, but from shouldyour be strong enough Can a backup to prevent theft of private data backup filesto make it significantly

Updated graphics / icon courtesy of shift

Encryption is using OpenAES which uses AES 1 28-b it cbc encryption. If you happen to use a longer pa ssword (over 16

exFAT to latest commits or Updated 256 bits. Do not forget your password. If you forget your password you will be unable to restore your backup. We intensive can be fairly slow even when we spread the workload over multiple cores e ven on the latest high-end d Fixedand a problem with Samsung TouchWiz decryption forever, we don't encrypt any other partitions besides /data and in /data we don't encrypt /data/app (or other app r

Update SuperSU binary

encrypt dalvik cache.

Fixed saving of backup partitions list Fixed saving of last used zip install folder Fixed backup of datadata on devices that use a separate partition for datadata

Special Note: If you are running a custom theme, the changes in 2.5.0.0 will likely not be compatible with your theme. http://teamw.in/project/twrp2

4/17

2014/5/1


_

,

Added scrollable partition lists for mount, backup, restore, wipe, and storage se lection

internal storage on data/media deivces and wipe data thetimeout advanced listtono longer Add new SliderValue GUI eleme nt for selecting brightness and on screen (thanks Tassad ar) Re-work anddata TWRPpartition) code to improve license compatibility between GPL and Apache formats theAOSP entire Added official theme for 1080x1920 portrait devices (HTC DNA, HTC Butterfly, Oppo Find 5, Sony Xperia Z, et

Fixed some problems with partitioning a SD card

Fixed a problem with directory permissions on split archive backups

Various bugwith fixes and tweaks of backups Fixed other a p roblem md5 verification Added a search function to libtar (thanks to kokotas) Improve handling of XML errors (fix permissions)

Notes about encrypted backups: Fixed handling of subpartitions

Why encrypt your backups? -- Most people store their backups on the device. Any app Improvements to recovery.fstab flags Fixed a problem to with decryption not being able to locate theread decryption key in some situations that has permission access storage could potentially your backup files and try to

harvest your data. Encrypted backups also provide an added layer of security if you move your backups to other storage devices or to the cloud. The encryption that we' re using is Added hardlink fix restore of some related to Ubuntu probably notanother stronglibtar enough for workaround enterprisetolevel security, butbackups should(usually be strong enough to Touch) fixes for the file selector make itMore significantly difficult to get to your data.

Switched from using busybox md5sum to a direct C function call Fixed cap turing the exit status of tar base d backups/restore - TWRP will display that there was an error if ther

UpdateisexFAT latest commits [4] which uses AES 128-bit cbc encryption. If you happen to Encryption usingtoOpenAES Added a build flag to disable using the ioctl for screen blanking

use a longer password (over 16 characters) then the encryption strength improves to 192 or 256 bits. Do not forget your password. If you forget your password you will be unable to restore your backup. We don't encrypt the entire backup. Encryption is very CPU Fixed 2 bugs related to restore, one dealing with mknod failures (by bigbiff) and one dealing with restoring har

intensive and can be fairly slow even when we spread the workload over multiple cores

NOTE: If your ba ckups weren't re storing correctly in earlier 2.4.x versions they should restore correctly now. H

even on the latest high-end devices. ensure that encrypted don't take having problems, run the restore, goTo to advanced a nd copy log, thenbackups give us the log. Complaints without logs w a scroll bar to file selectors listboxes besides courtesy of Tassadar forever,Added we don't encrypt any otherand partitions /data and in /data we don't Added libblkid for more accurate d etection of file systems and can now detect exFAT prope rly thanks to bigbif

encrypt /data/app (or other app related directories where apks are stored) and we don't Added a screen dim effect 2 seconds before screen off on some devices

encryptFinally dalvik cache. fixed file selector crash (one of the joys of working with multi-threaded software) Fixed loading of screen timeout setting during startup Improvements and bugfixes to screen timeout code Fixed persistence of the 24 hour / military time setting

What's new in 2.5.0.0:

Special Note: If you are running a custom theme, the changes in 2.5.0.0 will likely not Add screen timeout screen will turn off automatically after 60 seconds, saves battery and prevents screen bu be compatible with your- theme. Add a brightness setting (requires device specific setup and only some devices have been added)

Added partition for SuperSU if mount, backup, wipe, and storage Add scrollable a root checker and offerlists to install the devicerestore, isn't already rooted Add a write buffer to libtar backups, significant improvements to speeds when backing up to exFAT target, mi selection Check and offer to fix root permissions if broken

AddAdd new SliderValue GUI element for selecting brightness and screen timeout a n option for a 24 hour clock display instead of AM/PM (aka military time) (thanks Tassadar) Move to stock recovery reflash check to occur during the reboot cycle Add support some MTK6xxx devices Re-work AOSPforand TWRP code to improve license compatibility between GPL and Change libtar to vfork to help prevent memory p roblems

Apache Add a "clicked" effect to most buttons, file selector, and listbox Added official theme for to 1080x1920 devices (HTC DNA, HTC etc) Butterfly, Oppo Improve timezone listbox be more likeportrait file selector (per pixel kinetic scrolling, Remove some no longer used settings (Forced Find 5, Sony Xperia Z, etc)

MD5 sum on zips, size checking on image b ackups)

Other minor bugfixes and improvements

Fixed a problem with directory permissions on split archive backups Fixed a roblem with md5 verification of backu s http://teamw.in/project/twrp2

5/17

2014/5/1


Improvements to zip finding in OpenRecoveryScript (should be a lot fewer GooManager automation issues)

What's new 2.4.2.0: Faster bootin times

Added charging indicator while in recovery (only updates once eve ry 60 seconds)

Add screen timeout - screen will turn off automatically after 60 seconds, saves battery and prevents screen burn-in especially on AMOLED devices

While this update may not bring a host of new must-have features, this update is a significant re-write of much of the

Add a C++ brightness (requires device setupinto and only some devices have to mostly code andsetting now all of the "TWRP" code isspecific fully rewritten C++ as well. Now that we've laid this groun AOSP re covery updates a s well as implementing more great new features. been added)

[5]

Add a root checker and offer install SuperSU ifuses the recovery device API isn't alreadyofrooted Since TWRP 2.3 is based on AOSP jellyto bean sources, TWRP now 3 instead 2. Some zips may no l update-b API change should not be asignificant problem on improvements newer devices, butto older devices will probably encounte Add ainary. writeThis buffer to libtar backups, speeds when try using this update-binary that was compiled with current sources. It goes in your zip file in the META-INF/com/goo

backing up to exFAT target, minor improvements for other file systems

zip install, then an outdated update binary is almost certainly to blame.

Check and offer to fix root permissions if broken

Add an option for a 24 hour clock display instead of AM/PM (aka military time) Move stock recovery reflash check to occur during the reboot cycle Significantly improved sd-ext handling (ext partitions on sdcards)

Add support for some MTK6xxx devices

Changes to kinetic scrolling in file selectors

Change to vfork help prevent memory problems Fixedlibtar a problem with to using periods in backup names AddFixed a "clicked" effect to layouts most buttons, file selector, andUSB listbox problems in XML with mounting system and storage Fixed atimezone problem with unmounting a partition before formatting during restorescrolling, etc) Improve listbox to be more like file selector (per pixel kinetic Add Jelly Bean decrypt support Remove some no longer used settings (Forced MD5 sum on zips, size checking on Updated 320x480 theme to match others (thanks to Llewelyn)

image backups)

Improve "symlinking" of /data/media to either /sdcard or /emmc

Other minor bugfixes and improvements Added sanitizing of device IDs for invalid characters (thanks to bigbiff) Fixed free space calculation when switching backup devices on /data/media devices Fixed a problem with using OpenRecoveryScript to c reate a backup without providing a backup name

What's new in 2.4.1.0: Fixed a problem with mkdosfs that formatted sdcards to 2GB Fixed handoff between vfat and exFAT on devices where blkid didn't detect vfat (fixes some issues with mounting sdcards) Fixed problems with changing working directory on MD5 creation/checking that may On-screen keyboard in recovery! -- supports long press, backspace repeat, and swipe left deletes everything have prevented unmounting Name new backups and rename existing backups Rename filesnow a nd store foldersaincopy the file Backups will ofmanager the backup log after the backup is completed (only if Pseudo-terminal emulator

backup is successful) Support decrypting an encrypted da ta pa rtition on Galaxy Ne xus (enter password

using keyboard)

Backup a rchive splitting -- allows backup a nd restore of data p artitions larger than 2GB Simplified XML layout support between resolutions Added dual storage selection radio buttons to zip install, backup, and restore pages

What's new in 2.4.0.0: Improved zip install compatibility

Updated update-binary source code

Using libtar small instead busybox's tar for better control over tar file creation and Numerous bugof fixes and improvements breaking the 2GB barrier that busybox imposes (thanks to bigbiff) Support for exFAT formatted sdcards (also thanks to bigbiff) Support for decrypting Samsung TouchWiz encrypted devices including internal and external storage (special thanks to a3955269 for figuring it out) http://teamw.in/project/twrp2

7/17

2014/5/1


Note: If you have a custom theme installed from 2.0 or 2.1.0, your theme will need to be updated to see the new feat

Improvements to OpenRecoveryScript including displaying a proper GUI while the

theme be fore installing 2.1.1

script is running

Per-pixel kinetic scrolling in file selectors (this will be ported to the console and listbox in a future version)

Added wipe cache and dalvik after ADB Sideload

Updated stock themes to a unified ICS-look - thanks to racks for providing the new look!

Replaced many system calls their native C counterparts Fixed some problems with the with implementation of HTC Dumlock

Fixed some Nook Color and Kindle Fire list after moving or Fixed bugs indevice-specific file managerproblems where itonwould display an empty Fixed a b ug that caused a cra sh and restart of recovery when rebooting system right after a zip install

deleting a folder

Fixed the size calculation of a backup and the size of /data on Galaxy Nexus

Fixed AOSP recovery toarun onlayout encrypted devicesrestoring a backup 2.1.2 (ONLY for Galaxycommands Nexus) - fixed bugafter in the decryption 720x1280 XML that prevented Improvements for building TWRP in CM10.1 Other minor bugfixes and improvements

What's new in 2.3.3.0: queuing as seen in with TWRP a 1.1.x is back Fix Zip renaming backups space in the name storage capable (backup, restore, a nd install zips from internal or external storage AddDual decrypt button to mount page if you cancel decryption during startup

you choose)

Slider control (swipe to confirm most actions aka swipe to wipe)

Added ignore(with blkid flag Lockscreen slider to unlock)

Basic file manager (copy,partitions move, delete, and chmod any file) Fixed handling of MTD during mount Added support for devices with /data/media (most Honeycomb tablets, new ICS devices like Galaxy Nexus) Fixed some keyboard mapping issues on 800x1280 layout Displays sizes of each partition in the backup menu

Added listbox GUI element (currently used for listing time zones) Updated stock XML layouts to be more consistent and easier to port to different resolutions XML layout files are significantly smaller What's new in 2.3.2.0: Partitions available backup are more accurate for some devices Removed unneeded error messages (/misc errors, unable to stat sd-ext, etc.)

Fixes / enhancements to handle the multiple user setup introduced by Android 4.2 Fixed a bug with blkid detection code [6]where bug a blank line was inserted between every line of text during zip installs (seeFixed notes ) Fixed a bug during zip installs where an invalid zip would cause TWRP to get stuck in the zip install

Fixed a bug with deleting a backup with a space in the name

Added setting for themers to toggle simulation mode to make theming easier

Added on-keyboard keyGSM presses New highlights devices added Galaxy Nexus & CDMA (preview only, manual install), Acer Iconia Tab A500, HTC Vi Added support for .jpg images in the theme engine Changed images for stock tablet theme - makes tablet builds about 500KB smaller Removed unneeded non-GUI images from GUI - makes all builds about 100KB smaller

What's new in 2.3.1.0:

In add ition to the above new features, TWRP 2.x features a scripting engine that allows an app to send commands to t We call this scripting engine OpenRecoveryScript. This engine will be put to use immediately in the GooManager app.

Unmount system after boot to prevent some status 7 symlink failed errors on zip

for most supported devices. The app will also let you choose to install multiple zips from within Android, wipe cache on install how your app can use OpenRecoveryScript on this page.

USB Mass Storage code improvements Better handling of mounting storage during boot for some devices GooManager has a great setup for ROM makers that will notify users automatically when there' s an upda te to their RO

Fixed a problem with sizes of images (boot & recovery) after resetting defaults

to update their software similar to a normal "OTA" update from their carrier in a simple, se amless install process. The

Fixed sizefor errors duringtobackup for some devices on free, recovery, etc. for developers. The GooManager makes it easy ROM makers upload new ROMs and provides fast hosting Fixed a problem with restoring backups when multiple archives were present

http://teamw.in/project/twrp2

8/17

2014/5/1


Ability to save recovery settings What's new in custom 2.3.0.0:

Touchscreen driven with real buttons and drag-to-scroll XML-based GUI that allows full customization of the layout – true theming!

Rebased onto AOSP Jelly Bean source code

Settings are saved to the sd card and persist through reboots

Rewrote wipe,toand mount C++ classes for easier Ability backup, to choose restore, which partitions back up and code which in to restore Ability to choose to compress maintenance going forward backups – now with pigz (multi-core processor support for faster compression ti

NOTE: backups from prior versions of TWRP are still compatible with 2.3 ADB sideload functionality from AOSP is included in 2.3, see this link[7] for more info Information 2 Theming Re-wrote on fix TWRP permissions entirely in C++ and runs in a few seconds instead of a few minutes (thanks to bigbiff) Improvements to zip finding in OpenRecoveryScript (should be a lot fewer GooManager automation issues) Coreboot twrp times 2 development team: agrabren, Dees_Troy, ViViDboarder, and AssassinsLament Faster Toastcfh – for his underappreciated dedication to the community

Added charging indicator while in recovery (only updates once every 60 seconds) s0up and kevank for their hard work on the web side of things.

The rest of Te am Win: shift, onicrom, netarchy, kevank, myndwire, bigbiff, d kelle4, shinzul, spiicytuna, and e ye Amon_RA - formay his great ecovery While this update not Rbring a host of new must-have features, this update is a Koush - for his dedication to the community and ClockworkMod

significant re-write of much of the core TWRP code. AOSP Jelly Bean recovery source

For all the help with devices and testing Akmzero, arif-ali, Evil_DevNull, gus6464, Jesusice, _jmz_, NxtGenCow

movedAs toalways mostly C++you code and nowsupporters all of theand "TWRP" codeCommunity. is fully rewritten into C++ as thank to the Team's the Android well. Now that we've laid this groundwork, we're in a much better position to pull in future AOSP recovery updates as well as implementing more great new features. Since TWRP 2.3 is based on AOSP jelly bean sources, TWRP now uses recovery API 3 instead of 2. Some zips may no longer work if the developer is using an out-of-date Initial release of twrp 2 update-binary. This API change should not be a problem on newer devices, but older Full GUI touchscreen with buttons and XML engine

devicesFixed will sdcard probably encounter several zips that need to be updated. If needed, you can free space checking [8] that Fixed bugs with MD5 zip file checking try using this update-binary was compiled with current sources. It goes in your Now check more places for a serial number

zip fileToo in the META-INF/com/google/android folder. If you're getting a status error 2 many fixes versus twrp 1.1. 1 to list during zip install, then an outdated update binary is almost certainly to blame.

What's new All official de vices in are 2.2.2.0: listed at the top of this pa ge. Visit the device p age for spe cific directions and downloads. If you don't see your de vice listed, don'thandling worry! We'll(ext be add ing more de soon. Significantly improved sd-ext partitions onvices sdcards)

Changes to kinetic in here (mirror). file selectors Previous versions of TWRP scrolling can be found Fixed a problem with using periods in backup names Fixed problems in XML layouts with mounting system and USB storage Fixed a problem with unmounting a partition before formatting during restore AddZip Jelly decrypt filesBean that install moresupport da ta than free space http://teamw.in/project/twrp2

is available will crash or hang recovery (AOSP issue) 9/17

TeamWin Projects - TWRP 2

Recommend Documents