teamwin projects - twrp 2

2014/5/1 TeamWin Projects - TWRP 2.7 - | TeamWin

http://teamw.in/project/twrp2 1/17

TWRP 2.7YOU ARE HERE: HOME PROJECT TWRP2

Introduction:

Team Win Recovery Project 2.7, 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 AOSPrecovery and loading it with the standard recovery options, then added a lot of our own features. Its a fully touch driven user interface no more volume rocker or powerbuttons 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: 1EUshGGz6KdsRJioozqFmn4FHQk4z3GgxgTWRP Frequently Asked Questions (FAQ)

Phone look:

HOMETeamWin Projects

TWRP 2.7[1]

Introduction:

Team Win Recovery Project 2.7, or twrp2 for short, is a custom recovery built with easeof use and customization in mind. We started from the ground up by taking AOSPrecovery and loading it with the standard recovery options, then added a lot of our ownfeatures. Its a fully touch driven user interface no more volume rocker or powerbuttons to mash. The GUI is also fully XML driven and completely theme-able. You canchange just about every aspect of the look and feel.

Donate Bitcoins:1EUshGGz6KdsRJioozqFmn4FHQk4z3Ggxg [2]

TWRP Frequently Asked Questions (FAQ)[3]

Phone look:

Tablet look:



Tablet look:



What's new in 2.7.0.0:

Faster graphics rendering by disabling alpha blending on fully opaque objects thanks to TassadarAllow sideloading from /tmp on encrypted devicesCheck for a crypto footer before asking for a password to prevent user confusionAdditional checks for validity to auto generated backup namesText wrap in the console outputProper caps lock support in the keyboardMouse support via USB OTG for devices with a broken digitizerImprove scanning of storage locations for OpenRecoveryScriptHaptic feedback for buttons, keyboard, and vibration at the end of longer running actionsFixed ext4 wiping when no selinux contexts are defined for that partition (e.g. sd-ext)Update SuperSU to 1.93 and improve installation processAdded selinux contexts restoration to fix permissionsLoad RTC offset on Qualcomm devices to fix the date/time in recoveryUSB Mass Storage fixes Add SELinux support checkingAdd Disk Usage class to better handle excluded folders (e.g. Google Music cache)Add 4.4 AOSP decrypt supportAdd 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'town 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 needssome work. Help us help you.


Faster graphics rendering by disabling alpha blending on fully opaque objects thanksto TassadarAllow sideloading from /tmp on encrypted devicesCheck for a crypto footer before asking for a password to prevent user confusionAdditional checks for validity to auto generated backup namesText wrap in the console outputProper caps lock support in the keyboardMouse support via USB OTG for devices with a broken digitizerImprove scanning of storage locations for OpenRecoveryScriptHaptic feedback for buttons, keyboard, and vibration at the end of longer runningactionsFixed ext4 wiping when no selinux contexts are defined for that partition (e.g. sd-ext)Update SuperSU to 1.93 and improve installation processAdded selinux contexts restoration to fix permissionsLoad RTC offset on Qualcomm devices to fix the date/time in recoveryUSB Mass Storage fixes Add SELinux support checkingAdd Disk Usage class to better handle excluded folders (e.g. Google Music cache)Add 4.4 AOSP decrypt supportAdd some toolbox utilities to TWRP (namely to support SELinux functions notsupported in busybox)Various SELinux fixes and bug fixes

Note: 2.7 marks the first time that we are dropping support for older devices. We aredoing 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 kernelthat is included in the recovery image has to support writing SELinux contexts. We don'town most of the devices that we support so we depend on outside testers anddevelopers 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 cantell right away if your device will support 4.4 ROMs in 2.7. Boot TWRP and press theconsole button (the square-ish button either in the bottom middle or upper right) toview the console output. If it doesn't say "Full SELinux support" in the console, thenyour device still needs some work. Help us help you.




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


Initial SELinux support (only a few devices, need testers so come by IRC if your device doesn't have it and needs it)Initial support for f2fs file system formatting (Moto X)Update SuperSU install for 4.3 ROMsFixed a permissions bug on files created during backupFixed a bug that caused TWRP to not wait for compressed backups to finish causing 0 byte files and md5sums to not matchFixed decryption of encrypted data so that both TouchWiz and AOSP decryption are possibleIgnore lost+found folder during backup and size calculationsVarious other minor bug fixes and tweaks


Special Note: If you are running a custom theme, some of the changes in 2.6.0.0 will likely not be visible with your custom theme.

Can encrypt a backup to prevent theft of private data from your backup filesUpdated graphics / icon courtesy of shiftUpdated exFAT to latest commitsFixed a problem with Samsung TouchWiz decryptionUpdate SuperSU binaryFixed saving of backup partitions listFixed saving of last used zip install folderFixed backup of datadata on devices that use a separate partition for datadataFixed some issues with the advanced wipe list (android_secure, can now wipe internal storage on data/media deivces and wipe data on the advanced list no longerformats the entire data partition)Fixed some problems with partitioning a SD cardVarious other bug fixes and tweaks

Notes about encrypted backups:Why encrypt your backups? -- Most people store their backups on the device. Any app that has permission to access storage could potentially read your backup files and try toharvest 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'reusing is probably not strong enough for enterprise level security, but should be strong enough to make it significantly difficult to get to your data.

Encryption is using OpenAES which uses AES 128-bit cbc encryption. If you happen to use a longer password (over 16 characters) then the encryption strength improves to 192or 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 CPUintensive and can be fairly slow even when we spread the workload over multiple cores even on the latest high-end devices. To ensure that encrypted backups don't takeforever, we don't encrypt any other partitions besides /data and in /data we don't encrypt /data/app (or other app related directories where apks are stored) and we don'tencrypt dalvik cache.


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

your device still needs some work. Help us help you.


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


Initial SELinux support (only a few devices, need testers so come by IRC if yourdevice doesn't have it and needs it)Initial support for f2fs file system formatting (Moto X)Update SuperSU install for 4.3 ROMsFixed a permissions bug on files created during backupFixed a bug that caused TWRP to not wait for compressed backups to finish causing 0byte files and md5sums to not matchFixed decryption of encrypted data so that both TouchWiz and AOSP decryption arepossibleIgnore lost+found folder during backup and size calculationsVarious other minor bug fixes and tweaks


Special Note: If you are running a custom theme, some of the changes in 2.6.0.0 willlikely not be visible with your custom theme.

Can encrypt a backup to prevent theft of private data from your backup filesUpdated graphics / icon courtesy of shiftUpdated exFAT to latest commitsFixed a problem with Samsung TouchWiz decryptionUpdate SuperSU binaryFixed saving of backup partitions listFixed saving of last used zip install folderFixed backup of datadata on devices that use a separate partition for datadataFixed some issues with the advanced wipe list (android_secure, can now wipe



Added scrollable partition lists for mount, backup, restore, wipe, and storage selectionAdd new SliderValue GUI element for selecting brightness and screen timeout (thanks to Tassadar)Re-work AOSP and TWRP code to improve license compatibility between GPL and ApacheAdded official theme for 1080x1920 portrait devices (HTC DNA, HTC Butterfly, Oppo Find 5, Sony Xperia Z, etc)Fixed a problem with directory permissions on split archive backupsFixed a problem with md5 verification of backupsAdded a search function to libtar (thanks to kokotas)Improve handling of XML errors (fix permissions)Fixed handling of subpartitionsImprovements to recovery.fstab flagsFixed a problem with decryption not being able to locate the decryption key in some situations


Added another libtar hardlink workaround to fix restore of some backups (usually related to Ubuntu Touch)More fixes for the file selectorSwitched from using busybox md5sum to a direct C function callFixed capturing the exit status of tar based backups/restore - TWRP will display that there was an error if there was one againUpdate exFAT to latest commitsAdded a build flag to disable using the ioctl for screen blanking


Fixed 2 bugs related to restore, one dealing with mknod failures (by bigbiff) and one dealing with restoring hardlinks (by Dees_Troy)NOTE: If your backups weren't restoring correctly in earlier 2.4.x versions they should restore correctly now. Hopefully you didn't delete those backups. If you're stillhaving problems, run the restore, go to advanced and copy log, then give us the log. Complaints without logs will be rightfully ignored.Added a scroll bar to file selectors and listboxes courtesy of TassadarAdded libblkid for more accurate detection of file systems and can now detect exFAT properly thanks to bigbiffAdded a screen dim effect 2 seconds before screen off on some devicesFinally fixed file selector crash (one of the joys of working with multi-threaded software)Fixed loading of screen timeout setting during startupImprovements and bugfixes to screen timeout codeFixed persistence of the 24 hour / military time setting


Add screen timeout - screen will turn off automatically after 60 seconds, saves battery and prevents screen burn-in especially on AMOLED devicesAdd a brightness setting (requires device specific setup and only some devices have been added)Add a root checker and offer to install SuperSU if the device isn't already rootedAdd a write buffer to libtar backups, significant improvements to speeds when backing up to exFAT target, minor improvements for other file systemsCheck and offer to fix root permissions if brokenAdd 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 cycleAdd support for some MTK6xxx devicesChange libtar to vfork to help prevent memory problemsAdd a "clicked" effect to most buttons, file selector, and listboxImprove timezone listbox to be more like file selector (per pixel kinetic scrolling, etc)Remove some no longer used settings (Forced MD5 sum on zips, size checking on image backups)Other minor bugfixes and improvements

Fixed some issues with the advanced wipe list (android_secure, can now wipeinternal storage on data/media deivces and wipe data on the advanced list no longerformats the entire data partition)Fixed some problems with partitioning a SD cardVarious other bug fixes and tweaks

Notes about encrypted backups:Why encrypt your backups? -- Most people store their backups on the device. Any appthat has permission to access storage could potentially read your backup files and try toharvest your data. Encrypted backups also provide an added layer of security if you moveyour backups to other storage devices or to the cloud. The encryption that we're using isprobably not strong enough for enterprise level security, but should be strong enough tomake it significantly difficult to get to your data.

Encryption is using OpenAES[4] which uses AES 128-bit cbc encryption. If you happen touse a longer password (over 16 characters) then the encryption strength improves to 192or 256 bits. Do not forget your password. If you forget your password you will be unableto restore your backup. We don't encrypt the entire backup. Encryption is very CPUintensive and can be fairly slow even when we spread the workload over multiple coreseven on the latest high-end devices. To ensure that encrypted backups don't takeforever, we don't encrypt any other partitions besides /data and in /data we don'tencrypt /data/app (or other app related directories where apks are stored) and we don'tencrypt dalvik cache.


Special Note: If you are running a custom theme, the changes in 2.5.0.0 will likely notbe compatible with your theme.

Added scrollable partition lists for mount, backup, restore, wipe, and storageselectionAdd new SliderValue GUI element for selecting brightness and screen timeout(thanks to Tassadar)Re-work AOSP and TWRP code to improve license compatibility between GPL andApacheAdded official theme for 1080x1920 portrait devices (HTC DNA, HTC Butterfly, OppoFind 5, Sony Xperia Z, etc)Fixed a problem with directory permissions on split archive backupsFixed a problem with md5 verification of backups




Fixed a problem with mkdosfs that formatted sdcards to 2GBFixed 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 have prevented unmountingBackups will now store a copy of the backup log after the backup is completed (only if backup is successful)


Using libtar instead of busybox's tar for better control over tar file creation and 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)Improvements to OpenRecoveryScript including displaying a proper GUI while the script is runningAdded wipe cache and dalvik after ADB SideloadReplaced many system calls with their native C counterpartsFixed bugs in file manager where it would display an empty list after moving or deleting a folderFixed AOSP recovery commands to run after decryption on encrypted devicesImprovements for building TWRP in CM10.1Other minor bugfixes and improvements


Fix renaming backups with a space in the nameAdd decrypt button to mount page if you cancel decryption during startupAdded ignore blkid flagFixed handling of MTD partitions during mountFixed some keyboard mapping issues on 800x1280 layout


Fixes / enhancements to handle the multiple user setup introduced by Android 4.2 (see notes)Fixed a bug with deleting a backup with a space in the nameAdded highlights on keyboard key presses


Unmount system after boot to prevent some status 7 symlink failed errors on zip installUSB Mass Storage code improvementsBetter handling of mounting storage during boot for some devicesFixed a problem with sizes of images (boot & recovery) after resetting defaultsFixed size errors during backup for some devices on recovery, etc.Fixed a problem with restoring backups when multiple archives were present


Rebased onto AOSP Jelly Bean source codeRewrote backup, restore, wipe, and mount code in C++ classes for easier maintenance going forwardNOTE: backups from prior versions of TWRP are still compatible with 2.3ADB sideload functionality from AOSP is included in 2.3, see this link for more infoRe-wrote fix permissions entirely in C++ and runs in a few seconds instead of a few minutes (thanks to bigbiff)

Fixed a problem with md5 verification of backupsAdded a search function to libtar (thanks to kokotas)Improve handling of XML errors (fix permissions)Fixed handling of subpartitionsImprovements to recovery.fstab flagsFixed a problem with decryption not being able to locate the decryption key in somesituations


Added another libtar hardlink workaround to fix restore of some backups (usuallyrelated to Ubuntu Touch)More fixes for the file selectorSwitched from using busybox md5sum to a direct C function callFixed capturing the exit status of tar based backups/restore - TWRP will display thatthere was an error if there was one againUpdate exFAT to latest commitsAdded a build flag to disable using the ioctl for screen blanking


Fixed 2 bugs related to restore, one dealing with mknod failures (by bigbiff) and onedealing with restoring hardlinks (by Dees_Troy)NOTE: If your backups weren't restoring correctly in earlier 2.4.x versions theyshould restore correctly now. Hopefully you didn't delete those backups. If you'restill having problems, run the restore, go to advanced and copy log, then give us thelog. Complaints without logs will be rightfully ignored.Added a scroll bar to file selectors and listboxes courtesy of TassadarAdded libblkid for more accurate detection of file systems and can now detect exFATproperly thanks to bigbiffAdded a screen dim effect 2 seconds before screen off on some devicesFinally fixed file selector crash (one of the joys of working with multi-threadedsoftware)Fixed loading of screen timeout setting during startupImprovements and bugfixes to screen timeout codeFixed persistence of the 24 hour / military time setting



Improvements to zip finding in OpenRecoveryScript (should be a lot fewer GooManager automation issues)Faster boot timesAdded charging indicator while in recovery (only updates once every 60 seconds)

While this update may not bring a host of new must-have features, this update is a significant re-write of much of the core TWRP code. AOSP Jelly Bean recovery source movedto mostly C++ code and now all of the "TWRP" code is fully rewritten into C++ as well. Now that we've laid this groundwork, we're in a much better position to pull in futureAOSP 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-dateupdate-binary. This API change should not be a problem on newer devices, but older devices will probably encounter several zips that need to be updated. If needed, you cantry using this update-binary that was compiled with current sources. It goes in your zip file in the META-INF/com/google/android folder. If you're getting a status error 2 duringzip install, then an outdated update binary is almost certainly to blame.


Significantly improved sd-ext handling (ext partitions on sdcards)Changes to kinetic scrolling in file selectorsFixed a problem with using periods in backup namesFixed problems in XML layouts with mounting system and USB storageFixed a problem with unmounting a partition before formatting during restoreAdd Jelly Bean decrypt supportUpdated 320x480 theme to match others (thanks to Llewelyn)Improve "symlinking" of /data/media to either /sdcard or /emmcAdded sanitizing of device IDs for invalid characters (thanks to bigbiff)Fixed free space calculation when switching backup devices on /data/media devicesFixed a problem with using OpenRecoveryScript to create a backup without providing a backup name

What's new in 2.2.0:

On-screen keyboard in recovery! -- supports long press, backspace repeat, and swipe left deletes everything left of the cursorName new backups and rename existing backupsRename files and folders in the file managerPseudo-terminal emulatorSupport decrypting an encrypted data partition on Galaxy Nexus (enter password using keyboard)Backup archive splitting -- allows backup and restore of data partitions larger than 2GBSimplified XML layout support between resolutionsAdded dual storage selection radio buttons to zip install, backup, and restore pagesImproved zip install compatibilityUpdated update-binary source codeNumerous small bug fixes and improvements

What's new in 2.1.1 and 2.1.2:


Add screen timeout - screen will turn off automatically after 60 seconds, savesbattery and prevents screen burn-in especially on AMOLED devicesAdd a brightness setting (requires device specific setup and only some devices havebeen added)

Add a root checker and offer to install SuperSU[5] if the device isn't already rootedAdd a write buffer to libtar backups, significant improvements to speeds whenbacking up to exFAT target, minor improvements for other file systemsCheck and offer to fix root permissions if brokenAdd 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 cycleAdd support for some MTK6xxx devicesChange libtar to vfork to help prevent memory problemsAdd a "clicked" effect to most buttons, file selector, and listboxImprove timezone listbox to be more like file selector (per pixel kinetic scrolling, etc)Remove some no longer used settings (Forced MD5 sum on zips, size checking onimage backups)Other minor bugfixes and improvements


Fixed a problem with mkdosfs that formatted sdcards to 2GBFixed 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 mayhave prevented unmountingBackups will now store a copy of the backup log after the backup is completed (only ifbackup is successful)


Using libtar instead of busybox's tar for better control over tar file creation andbreaking 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 andexternal storage (special thanks to a3955269 for figuring it out)



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 features. It is recommended that you remove your customtheme before installing 2.1.1

Per-pixel kinetic scrolling in file selectors (this will be ported to the console and listbox in a future version)Updated stock themes to a unified ICS-look - thanks to racks for providing the new look!Fixed some problems with the implementation of HTC DumlockFixed some device-specific problems on Nook Color and Kindle FireFixed a bug that caused a crash and restart of recovery when rebooting system right after a zip installFixed the size calculation of a backup and the size of /data on Galaxy Nexus2.1.2 (ONLY for Galaxy Nexus) - fixed a bug in the 720x1280 XML layout that prevented restoring a backup

What's new in 2.1:

Note: If you have a custom theme installed from 2.0, your theme will need to be updated to see the new features. Itis recommended that you remove your custom theme before installing 2.1

Zip queuing as seen in TWRP 1.1.x is backDual storage capable (backup, restore, and install zips from internal or external storage - you choose)Slider control (swipe to confirm most actions aka swipe to wipe)Lockscreen (with slider to unlock)Basic file manager (copy, move, delete, and chmod any file)Added support for devices with /data/media (most Honeycomb tablets, new ICS devices like Galaxy Nexus)Displays sizes of each partition in the backup menuAdded listbox GUI element (currently used for listing time zones)Updated stock XML layouts to be more consistent and easier to port to different resolutionsXML layout files are significantly smallerPartitions available backup are more accurate for some devicesRemoved unneeded error messages (/misc errors, unable to stat sd-ext, etc.)Fixed a bug with blkid detection codeFixed bug where a blank line was inserted between every line of text during zip installsFixed a bug during zip installs where an invalid zip would cause TWRP to get stuck in the zip installAdded setting for themers to toggle simulation mode to make theming easierNew devices added - Galaxy Nexus GSM & CDMA (preview only, manual install), Acer Iconia Tab A500, HTC Vivid, Motorola DefyAdded support for .jpg images in the theme engineChanged images for stock tablet theme - makes tablet builds about 500KB smallerRemoved unneeded non-GUI images from GUI - makes all builds about 100KB smaller

In addition to the above new features, TWRP 2.x features a scripting engine that allows an app to send commands to the recovery for We call this scripting engine OpenRecoveryScript. This engine will be put to use immediately in the GooManager app. GooManager will be able to install recoveries automaticallyfor most supported devices. The app will also let you choose to install multiple zips from within Android, wipe cache & dalvik, and run a backup. You can find more informationon how your app can use OpenRecoveryScript on this page.

GooManager has a great setup for ROM makers that will notify users automatically when there's an update to their ROM. Combined with the to update their software similar to a normal "OTA" update from their carrier in a simple, seamless install process. The makes it easy for ROM makers to upload new ROMs and provides free, fast hosting for developers. The GooManager app will also continue to remain free.

Key Features:

external storage (special thanks to a3955269 for figuring it out)Improvements to OpenRecoveryScript including displaying a proper GUI while thescript is runningAdded wipe cache and dalvik after ADB SideloadReplaced many system calls with their native C counterpartsFixed bugs in file manager where it would display an empty list after moving ordeleting a folderFixed AOSP recovery commands to run after decryption on encrypted devicesImprovements for building TWRP in CM10.1Other minor bugfixes and improvements


Fix renaming backups with a space in the nameAdd decrypt button to mount page if you cancel decryption during startupAdded ignore blkid flagFixed handling of MTD partitions during mountFixed some keyboard mapping issues on 800x1280 layout


Fixes / enhancements to handle the multiple user setup introduced by Android 4.2

(see notes[6])Fixed a bug with deleting a backup with a space in the nameAdded highlights on keyboard key presses


Unmount system after boot to prevent some status 7 symlink failed errors on zipinstallUSB Mass Storage code improvementsBetter handling of mounting storage during boot for some devicesFixed a problem with sizes of images (boot & recovery) after resetting defaultsFixed size errors during backup for some devices on recovery, etc.Fixed a problem with restoring backups when multiple archives were present




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

Theming:

InformationonTWRP2Theming

Special Thanks To:

Core twrp 2 development team: agrabren, Dees_Troy, ViViDboarder, and AssassinsLamentToastcfh for his underappreciated dedication to the communitys0up 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 eyeballerAmon_RA - for his great RecoveryKoush - for his dedication to the community and ClockworkModFor all the help with devices and testing Akmzero, arif-ali, Evil_DevNull, gus6464, Jesusice, _jmz_, NxtGenCowboy, ohshaith55, Pyrostic, [R], and RootzwikiAs always thank you to the Team's supporters and the Android Community.

Changelog:

2011-12-17 - v2.0.0

Initial release of twrp 2Full GUI touchscreen with buttons and XML engineFixed sdcard free space checkingFixed bugs with MD5 zip file checkingNow check more places for a serial numberToo 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)


Rebased onto AOSP Jelly Bean source codeRewrote backup, restore, wipe, and mount code in C++ classes for easiermaintenance going forwardNOTE: 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 moreinfoRe-wrote fix permissions entirely in C++ and runs in a few seconds instead of a fewminutes (thanks to bigbiff)Improvements to zip finding in OpenRecoveryScript (should be a lot fewerGooManager automation issues)Faster boot timesAdded charging indicator while in recovery (only updates once every 60 seconds)

While this update may not bring a host of new must-have features, this update is asignificant re-write of much of the core TWRP code. AOSP Jelly Bean recovery sourcemoved to mostly C++ code and now all of the "TWRP" code is fully rewritten into C++ aswell. Now that we've laid this groundwork, we're in a much better position to pull infuture 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 3instead of 2. Some zips may no longer work if the developer is using an out-of-dateupdate-binary. This API change should not be a problem on newer devices, but olderdevices will probably encounter several zips that need to be updated. If needed, you can

try using this update-binary[8] that was compiled with current sources. It goes in yourzip file in the META-INF/com/google/android folder. If you're getting a status error 2during zip install, then an outdated update binary is almost certainly to blame.


Significantly improved sd-ext handling (ext partitions on sdcards)Changes to kinetic scrolling in file selectorsFixed a problem with using periods in backup namesFixed problems in XML layouts with mounting system and USB storageFixed a problem with unmounting a partition before formatting during restoreAdd Jelly Bean decrypt supportUpdated 320x480 theme to match others (thanks to Llewelyn)



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 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!

Rootzwiki and hereXDAAndroid Creative SyndicateAndroid PoliceGood and EvoA Boy and his AndroidHello AndroidDroidDogAndroidWorld.itDroid TweakEngadget and here

Updated 320x480 theme to match others (thanks to Llewelyn)Improve "symlinking" of /data/media to either /sdcard or /emmcAdded sanitizing of device IDs for invalid characters (thanks to bigbiff)Fixed free space calculation when switching backup devices on /data/media devicesFixed a problem with using OpenRecoveryScript to create a backup without providinga backup name

What's new in 2.2.0:

On-screen keyboard in recovery! -- supports long press, backspace repeat, and swipeleft deletes everything left of the cursorName new backups and rename existing backupsRename files and folders in the file managerPseudo-terminal emulatorSupport decrypting an encrypted data partition on Galaxy Nexus (enter passwordusing keyboard)Backup archive splitting -- allows backup and restore of data partitions larger than2GBSimplified XML layout support between resolutionsAdded dual storage selection radio buttons to zip install, backup, and restore pagesImproved zip install compatibilityUpdated update-binary source codeNumerous small bug fixes and improvements

What's new in 2.1.1 and 2.1.2:

Note: If you have a custom theme installed from 2.0 or 2.1.0, yourtheme will need to be updated to see the new features. It isrecommended that you remove your custom theme beforeinstalling 2.1.1

Per-pixel kinetic scrolling in file selectors (this will be ported to the console andlistbox in a future version)Updated stock themes to a unified ICS-look - thanks to racks for providing the newlook!Fixed some problems with the implementation of HTC DumlockFixed some device-specific problems on Nook Color and Kindle Fire



Fixed some device-specific problems on Nook Color and Kindle FireFixed a bug that caused a crash and restart of recovery when rebooting system rightafter a zip installFixed the size calculation of a backup and the size of /data on Galaxy Nexus2.1.2 (ONLY for Galaxy Nexus) - fixed a bug in the 720x1280 XML layout thatprevented restoring a backup

What's new in 2.1:

Note: If you have a custom theme installed from 2.0, your themewill need to be updated to see the new features. It is recommendedthat you remove your custom theme before installing 2.1

Zip queuing as seen in TWRP 1.1.x is backDual storage capable (backup, restore, and install zips from internal or externalstorage - you choose)Slider control (swipe to confirm most actions aka swipe to wipe)Lockscreen (with slider to unlock)Basic file manager (copy, move, delete, and chmod any file)Added support for devices with /data/media (most Honeycomb tablets, new ICSdevices like Galaxy Nexus)Displays sizes of each partition in the backup menuAdded listbox GUI element (currently used for listing time zones)Updated stock XML layouts to be more consistent and easier to port to differentresolutionsXML layout files are significantly smallerPartitions available backup are more accurate for some devicesRemoved unneeded error messages (/misc errors, unable to stat sd-ext, etc.)Fixed a bug with blkid detection codeFixed bug where a blank line was inserted between every line of text during zipinstallsFixed a bug during zip installs where an invalid zip would cause TWRP to get stuckin the zip installAdded setting for themers to toggle simulation mode to make theming easierNew devices added - Galaxy Nexus GSM & CDMA (preview only, manual install),Acer Iconia Tab A500, HTC Vivid, Motorola DefyAdded support for .jpg images in the theme engineChanged images for stock tablet theme - makes tablet builds about 500KB smaller



Changed images for stock tablet theme - makes tablet builds about 500KB smallerRemoved unneeded non-GUI images from GUI - makes all builds about 100KBsmaller

In addition to the above new features, TWRP 2.x features a scripting engine that allowsan app to send commands to the recovery for the recovery to perform during startup. Wecall this scripting engine OpenRecoveryScript. This engine will be put to use

immediately in the GooManager app[9]. GooManager will be able to install recoveriesautomatically for most supported devices. The app will also let you choose to installmultiple zips from within Android, wipe cache & dalvik, and run a backup. You can find

more information on how your app can use OpenRecoveryScript on this page[10].

GooManager has a great setup for ROM makers that will notify users automatically whenthere's an update to their ROM. Combined with the recovery support, this allows usersto update their software similar to a normal "OTA" update from their carrier in a simple,

seamless install process. The goo.im[11] website has a fantastic developer portal thatmakes it easy for ROM makers to upload new ROMs and provides free, fast hosting fordevelopers. The GooManager app will also continue to remain free.

Key Features:

Ability to save custom recovery settingsTouchscreen driven with real buttons and drag-to-scrollXML-based GUI that allows full customization of the layout true theming!Settings are saved to the sdcard and persist through rebootsAbility to choose which partitions to back up and which to restoreAbility to choose to compress backups now with pigz (multi-core processor supportfor faster compression times.

Theming:

Information on TWRP 2 Theming[12]

Special Thanks To:



Core twrp 2 development team: agrabren, Dees_Troy, ViViDboarder, andAssassinsLamentToastcfh for his underappreciated dedication to the communitys0up 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 eyeballerAmon_RA - for his great RecoveryKoush - for his dedication to the community and ClockworkModFor all the help with devices and testing Akmzero, arif-ali, Evil_DevNull, gus6464,Jesusice, _jmz_, NxtGenCowboy, ohshaith55, Pyrostic, [R], and RootzwikiAs always thank you to the Team's supporters and the Android Community.

Changelog:

2011-12-17 - v2.0.0

Initial release of twrp 2Full GUI touchscreen with buttons and XML engineFixed sdcard free space checkingFixed bugs with MD5 zip file checkingNow check more places for a serial numberToo 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 specificdirections 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[13] (mirror[14]).

Known Issues (affects all devces):

Zip files that install more data than free space is available will crash or hang recovery



1. http://teamw.in/project/twrp2

2. bitcoin:1EUshGGz6KdsRJioozqFmn4FHQk4z3Ggxg?label=twrp

3. http://teamw.in/twrpfaq

4. https://code.google.com/p/openaes/

5. https://play.google.com/store/apps/details?id=eu.chainfire.supersu&hl=en

6. http://teamw.in/androidmultiuser

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

Source Code:

GitHub[15]

How to Compile TWRP from Source[16]

How to Submit a Code Change for TWRP using Gerrit[17]If you have made your own twrpbuild for an unsupported device, please let us know. We might add your build to the listof unofficial builds. Bear in mind that we are working hard to add more devices and wemay add your device to our official build list later.

Support:

Click here for live support[18] or join us in #twrp on FreenodeIRC servers

TWRP 2.x in the News:

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



7. http://teamw.in/ADBSideload

8. http://techerrata.com/file/twrp2/utilities/update-binary

9. https://market.android.com/details?id=com.s0up.goomanager

10. http://www.teamw.in/OpenRecoveryScript

11. http://goo.im/

12. http://www.teamw.in/project/twrp2themers

13. http://techerrata.com/browse/twrp2

14. http://goo.im/devs/OpenRecovery/

15. https://github.com/TeamWin/Team-Win-Recovery-Project

16. http://rootzwiki.com/topic/23903-how-to-compile-twrp-from-source/

17. http://teamw.in/twrp2-gerrit

18. http://webchat.freenode.net/?channels=twrp

teamwin projects - twrp 2

Documents

recovery project

custom recovery

recovery image

teamwin projects twrp

keyboardmouse support

tablet look

selinux functions

standard recovery options