Introduction:
Team Win Recovery Project or TWRP 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.
Key Features:
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)
Onscreen keyboard
Easy selection of internal/external storage
In addition to the above new features, TWRP features a scripting engine that allows an app to send commands to the recovery for the recovery to perform during startup. We call this scripting engine OpenRecoveryScript. The app will also let you choose to install multiple zips from within Android, wipe, and run a backup.
We are looking for other talented developers, themers, and device maintainers if they are interested in helping with a free, open source project.
Source Code:
GitHub - https://github.com/TeamWin/android_bootable_recovery
Gerrit Instance - http://gerrit.twrp.me
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 official builds.
Device Config - https://github.com/TeamWin/android_device_oneplus_cheeseburger_dumpling
Kernel - https://gitlab.com/faoliveira78/android_kernel_oneplus_msm8998
Downloads:
Latest Official release:
https://twrp.me/oneplus/oneplus5-5t.html
Release Date: 04/04/2024
- Unified build (standard/dynamic)
- Compatible with Android 14 and below (A13, A12)
- New kernel 4.14.314
- Compatibility with Roms with keymaster 3 and 4 (e.g. Evox 8.4 and 8.5)
- Removal of additional entries from "super" partitions for backup on ROMs with non-dynamic partitions.
- Data formatting will not force the use of f2fs on the /data partition, on roms that have both options.
- Updated with the latest patches merged into the a12.1 branch
WARNING: Do not use TWRP12 for Roms <= A11, if you are on the stock Rom or other custom Roms <= A11 and want to keep the encryption, use TWRP9 or the unofficial TWRP11.
Bugs:
- It doesn't decrypt data from previous versions of Android (<=A11), if any screen lock is used (pin/password/pattern).
If you find any bugs, please send logs:
adb logcat -d > logcat.log
adb pull /tmp/recovery.log
adb pull /tmp/recovery.log
Code:
* If you want to test these recoveries
fastboot boot twrp-3.7.1_12-1-cheeseburger_dumpling.img
* If you want to use then
fastboot flash recovery twrp-3.7.1_12-1-cheeseburger_dumpling
Troubleshooting
Backup/Restore: Please follow this guide:
https://xdaforums.com/t/recovery-tw...er-dumpling-06-jul-2022.4351795/post-87118487
* If you get the message "Failed to mount '/metadata' (invalid argument)" during backup or any other recovery action. Go to the "Wipe" menu, press "Advanced", select "Metadata" and confirm with a swipe to the right
* To correctly install ROMs with dynamic partitioning, please follow the guide in this post.
https://xdaforums.com/t/recovery-tw...ger-dumpling-22-04-2023.4351795/post-88449043
* Cannot decrypt after upgrading from an A11 Rom to an A12 (Thanks to leoinj)
* Unable to format data after performing an upgrade to an A13 ROM or for any other reason:
1 - In the Settings check the option "Use rm -rf instead of formatting"
2 - Go to Wipe menu -> Format data -> confirm "yes"
3 - Reboot to recovery
4 - Go to Settings and uncheck the option "use rm -rf...", if it is selected;
5 - Go to Wipe menu -> Format data -> confirm "yes" again
6 - If everything is ok, reboot to System.
Or go to terminal (Advanced -> Terminal) and type umount /dev/block/sda13
exit the terminal and you should be able to format your data normally.
Support: https://twrp.zulipchat.com/#narrow/stream/290973-support-device/topic/OnePlus.205.2F5T
Thanks and Credits:
- TWRP Team
- LineageOS Team
- robertogl
- ad1tyas1ngh
- 0xCAFEBABE
- xLexip
- Ssmiles for Themes mods
Created: 24/10/2021
Last Updated 04/04/2024
http://twrp.me
Unofficial Builds and Sources
A12.1 - 3.7.0-5-dyn (11/10/2023)
twrp-3.7.0_12-5-dyn-cheeseburger_dumpling.img
- Changelog: First A14 decryption compatible build.
Support for both dynamic and non-dynamic partitions.
Bugs:
- You may not be able to install Mindthegapps on a non-dynamic rom, but other Gapps will work.
A12.1 - 3.7.0-4.14-dyn (13/09/2023)
https://sourceforge.net/projects/op...2-4.14-dyn-cheeseburger_dumpling.img/download
Changelog: Latest 4.14.284 kernel from @robertogl at https://github.com/roberto-sartori-gl/4.14-kernel-oneplus-prebuilt
A12.1 - 3.7.0-3.1-dyn (30/04/2023)
https://sourceforge.net/projects/op5-5t/files/Android-12/TWRP/twrp-3.7.0_12-3.1-dyn-cheeseburger_dumpling.img/download
Changelog: Supports dynamic partitions, fastbootd works.
Sources:
5/5T DT - cheeseburger_dumpling/tree/android-12.1
A12.1 - 3.7.0-4.14 (22/04/2023)
https://sourceforge.net/projects/op5-5t/files/Android-12/TWRP/twrp-3.7.0_12-4.14-cheeseburger_dumpling.img/download
Changelog: Switch to @robertogl 4.14 kernel https://github.com/roberto-sartori-gl/4.14-kernel-oneplus-prebuilt 4.14 kernel
Sources:
5/5T DT - cheeseburger_dumpling/tree/android-12.1
A12.1 - 3.7.0-3-dyn (22/04/2023)
https://sourceforge.net/projects/op...0_12-3-dyn-cheeseburger_dumpling.img/download
Changelog: Supports dynamic partitions.
Bugs: Fastbootd doesn't work.
A12.1 - 3.7.0-2 (12/12/2022) - Unofficial
https://sourceforge.net/projects/op...3.7.0_12-2-cheeseburger_dumpling.img/download
Changelog: Fixed the 'ro.build.date' prop, the recovery will consider the same date as the Rom that is installed on the device for this prop, Thanks to @robertogl
Furthermore the unofficial build contains two fixes that change the TWRP source code and that will only be in the official version when they are merged, these bugs don't happen on all devices
- Fix for Format data: https://gerrit.twrp.me/c/android_bootable_recovery/+/5917 and https://gerrit.twrp.me/c/android_bootable_recovery/+/6120
- Fix for Change TWRP folder on decrypted devices (DFE or F2FS): https://gerrit.twrp.me/c/android_bootable_recovery/+/6106
A12.1 - 3.7.0-1 (20/10/2022)
5/5T -https://sourceforge.net/projects/op...3.7.0_12-1-cheeseburger_dumpling.img/download
Changelog:
- Fix for Format data;
- Fix for Change TWRP folder on decrypted devices (DFE or F2FS).
A12.1 - Test release 3.6.2-v8 (05/08/2022)
5/5T - twrp_op5_op5t_3.6.2_12.1-test-v8.img
Changelog:
- Fix "Error parsing XML file"
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-7#post-87250553
A12 - 3.6.2.-test-v7 (04/08/2022)
5/5T - twrp_op5_op5t_3.6.2_12.1-test-v7.img
Changelog:
- Fixed not being able to install Firmware
- Latest merged commits of gerrit on branch A12 (from 07/07/22 to 04/08/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-7#post-87242379
A12 - 3.6.2.-test-v6 (06/07/2022)
5/5T - twrp_op5_op5t_3.6.2_12.1-test-v6.img
Changelog:
- Fix Backup/Restore encrypted data
- Saved settings will remain
- Latest merged commits of gerrit on branch A12 (from 20/06/22 to 06/07/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-4#post-87118427
A12 - 3.6.2.-test-v5 (19/06/2022)
5/5T - twrp_op5_op5t_3.6.2_12.1-test-v5.img
Changelog:
- Fixed A12 data decryption
- Fixed F2FS data support
- Fixed ADB access
- Latest merged commits of gerrit on branch A12 (from 05/06/22 to 19/06/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-3#post-87045683
A12 - 3.6.2.-test-v4 (04/06/2022)
5/5T- twrp_op5_op5t_3.6.2_12.1-test-v4.img
Changelog:
- Latest merged commits of gerrit on branch A12 (from 30/05/22 to 04/06/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86986633
A12 - 3.6.2.-test-v3 (29/05/2022)
5/5T- twrp_op5_op5t_3.6.1_12.1-test-v3.img
Changelog:
- 3.6.2 release
- Latest merged commits of gerrit on branch A12 (from 02/05/22 to 29/05/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86959299
A12 - 3.6.1.-test-v2 (01/05/2022)
5/5T- twrp_op5_op5t_3.6.1_12.1-test-v2.img
Changelog:
- Latest merged commits of gerrit on branch A12 (from 13/03/22 to 01/05/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86827375
A12 - 3.6.1.-test-v1 (29/04/2022)
5/5T- twrp_op5_op5t_3.6.1_12.1-test.img
Changelog: Initial release
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86818577
A11 - Last update 3.6.2-v2 (06/07/2022)
5/5T - twrp_cheeseburger_dumpling_3.6.2_11-v2.img
Changelog:
- Fix Backup/Restore encrypted data
- Fix ADB access
- Latest merged commits of gerrit on branch A11 (from 30/05/22 to 06/07/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-4#post-87118427
A11 - 3.6.2-v1 (29/05/2022)
5/5T - twrp_cheeseburger_dumpling_3.6.2_11-v1.img
Changelog:
- 3.6.2 release
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86959299
A11 - 3.6.1-v2 (01/05/2022)
5/5T - twrp_cheeseburger_dumpling_3.6.1_11-v2.img
Changelog:
- Latest merged commits of gerrit on branch A11 (from 13/03/22 to 01/05/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86827375
A11 - 3.6.1-v1 (12/03/2022)
5/5T - twrp_cheeseburger_dumpling_3.6.1_11-v1.img
Changelog:
- 3.6.1 release
https://xdaforums.com/t/recovery-tw...r-dumpling-05-aug-2022.4351795/#post-86566915
A11 - 3.6.0-v1 (26/11/2021)
5/5T - twrp_cheeseburger_dumpling_3.6.0_11-v1.img
Changelog:
- 3.6.0 release
- unified version
https://xdaforums.com/t/recovery-tw...r-dumpling-05-aug-2022.4351795/#post-86018799
A11 - 3.5.2-v2 (12/11/2021)
5 (cheesburger) - twrp_cheeseburger_3.5.2-11-v2.img
5T (dumpling) - twrp_dumpling_3.5.2-11-v2.img
Changelog:
- Fixed Full wipe and format data
- Latest merged commits of gerrit on branch A11 (from 25/10/21 to 12/11/21)
https://xdaforums.com/t/recovery-tw...r-dumpling-05-aug-2022.4351795/#post-85933403
A11 - 3.5.2-v1 (24/10/2021)
5 (cheesburger) - twrp_cheeseburger_3.5.2-11-v1.img
5T (dumpling) - twrp_dumpling_3.5.2-11-v1.img
Changelog:
- Initial release
A10 - Last update (06/11/2021)
5 (cheesburger) - twrp_cheeseburger_3.5.2-10.img
5T (dumpling) - twrp_dumpling_3.5.2-10.img
Changelog:
- Fixed Full wipe and format data
https://xdaforums.com/t/recovery-tw...r-dumpling-05-aug-2022.4351795/#post-85904627
A10 - 3.5.2-v1 (24/10/2021)
5 (cheeseburger) - twrp-3.5.2_10_LOS-cheeseburger.img
5T (dumpling) - twrp_dumpling_3.5.2-10.img
Changelog:
- Initial release
twrp-3.7.0_12-5-dyn-cheeseburger_dumpling.img
- Changelog: First A14 decryption compatible build.
Support for both dynamic and non-dynamic partitions.
Bugs:
- You may not be able to install Mindthegapps on a non-dynamic rom, but other Gapps will work.
A12.1 - 3.7.0-4.14-dyn (13/09/2023)
https://sourceforge.net/projects/op...2-4.14-dyn-cheeseburger_dumpling.img/download
Changelog: Latest 4.14.284 kernel from @robertogl at https://github.com/roberto-sartori-gl/4.14-kernel-oneplus-prebuilt
A12.1 - 3.7.0-3.1-dyn (30/04/2023)
https://sourceforge.net/projects/op5-5t/files/Android-12/TWRP/twrp-3.7.0_12-3.1-dyn-cheeseburger_dumpling.img/download
Changelog: Supports dynamic partitions, fastbootd works.
Sources:
5/5T DT - cheeseburger_dumpling/tree/android-12.1
A12.1 - 3.7.0-4.14 (22/04/2023)
https://sourceforge.net/projects/op5-5t/files/Android-12/TWRP/twrp-3.7.0_12-4.14-cheeseburger_dumpling.img/download
Changelog: Switch to @robertogl 4.14 kernel https://github.com/roberto-sartori-gl/4.14-kernel-oneplus-prebuilt 4.14 kernel
Sources:
5/5T DT - cheeseburger_dumpling/tree/android-12.1
A12.1 - 3.7.0-3-dyn (22/04/2023)
https://sourceforge.net/projects/op...0_12-3-dyn-cheeseburger_dumpling.img/download
Changelog: Supports dynamic partitions.
Bugs: Fastbootd doesn't work.
A12.1 - 3.7.0-2 (12/12/2022) - Unofficial
https://sourceforge.net/projects/op...3.7.0_12-2-cheeseburger_dumpling.img/download
Changelog: Fixed the 'ro.build.date' prop, the recovery will consider the same date as the Rom that is installed on the device for this prop, Thanks to @robertogl
Furthermore the unofficial build contains two fixes that change the TWRP source code and that will only be in the official version when they are merged, these bugs don't happen on all devices
- Fix for Format data: https://gerrit.twrp.me/c/android_bootable_recovery/+/5917 and https://gerrit.twrp.me/c/android_bootable_recovery/+/6120
- Fix for Change TWRP folder on decrypted devices (DFE or F2FS): https://gerrit.twrp.me/c/android_bootable_recovery/+/6106
A12.1 - 3.7.0-1 (20/10/2022)
5/5T -https://sourceforge.net/projects/op...3.7.0_12-1-cheeseburger_dumpling.img/download
Changelog:
- Fix for Format data;
- Fix for Change TWRP folder on decrypted devices (DFE or F2FS).
A12.1 - Test release 3.6.2-v8 (05/08/2022)
5/5T - twrp_op5_op5t_3.6.2_12.1-test-v8.img
Changelog:
- Fix "Error parsing XML file"
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-7#post-87250553
A12 - 3.6.2.-test-v7 (04/08/2022)
5/5T - twrp_op5_op5t_3.6.2_12.1-test-v7.img
Changelog:
- Fixed not being able to install Firmware
- Latest merged commits of gerrit on branch A12 (from 07/07/22 to 04/08/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-7#post-87242379
A12 - 3.6.2.-test-v6 (06/07/2022)
5/5T - twrp_op5_op5t_3.6.2_12.1-test-v6.img
Changelog:
- Fix Backup/Restore encrypted data
- Saved settings will remain
- Latest merged commits of gerrit on branch A12 (from 20/06/22 to 06/07/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-4#post-87118427
A12 - 3.6.2.-test-v5 (19/06/2022)
5/5T - twrp_op5_op5t_3.6.2_12.1-test-v5.img
Changelog:
- Fixed A12 data decryption
- Fixed F2FS data support
- Fixed ADB access
- Latest merged commits of gerrit on branch A12 (from 05/06/22 to 19/06/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-3#post-87045683
A12 - 3.6.2.-test-v4 (04/06/2022)
5/5T- twrp_op5_op5t_3.6.2_12.1-test-v4.img
Changelog:
- Latest merged commits of gerrit on branch A12 (from 30/05/22 to 04/06/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86986633
A12 - 3.6.2.-test-v3 (29/05/2022)
5/5T- twrp_op5_op5t_3.6.1_12.1-test-v3.img
Changelog:
- 3.6.2 release
- Latest merged commits of gerrit on branch A12 (from 02/05/22 to 29/05/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86959299
A12 - 3.6.1.-test-v2 (01/05/2022)
5/5T- twrp_op5_op5t_3.6.1_12.1-test-v2.img
Changelog:
- Latest merged commits of gerrit on branch A12 (from 13/03/22 to 01/05/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86827375
A12 - 3.6.1.-test-v1 (29/04/2022)
5/5T- twrp_op5_op5t_3.6.1_12.1-test.img
Changelog: Initial release
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86818577
A11 - Last update 3.6.2-v2 (06/07/2022)
5/5T - twrp_cheeseburger_dumpling_3.6.2_11-v2.img
Changelog:
- Fix Backup/Restore encrypted data
- Fix ADB access
- Latest merged commits of gerrit on branch A11 (from 30/05/22 to 06/07/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-4#post-87118427
A11 - 3.6.2-v1 (29/05/2022)
5/5T - twrp_cheeseburger_dumpling_3.6.2_11-v1.img
Changelog:
- 3.6.2 release
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86959299
A11 - 3.6.1-v2 (01/05/2022)
5/5T - twrp_cheeseburger_dumpling_3.6.1_11-v2.img
Changelog:
- Latest merged commits of gerrit on branch A11 (from 13/03/22 to 01/05/22)
https://xdaforums.com/t/recovery-tw...ling-05-aug-2022.4351795/page-2#post-86827375
A11 - 3.6.1-v1 (12/03/2022)
5/5T - twrp_cheeseburger_dumpling_3.6.1_11-v1.img
Changelog:
- 3.6.1 release
https://xdaforums.com/t/recovery-tw...r-dumpling-05-aug-2022.4351795/#post-86566915
A11 - 3.6.0-v1 (26/11/2021)
5/5T - twrp_cheeseburger_dumpling_3.6.0_11-v1.img
Changelog:
- 3.6.0 release
- unified version
https://xdaforums.com/t/recovery-tw...r-dumpling-05-aug-2022.4351795/#post-86018799
A11 - 3.5.2-v2 (12/11/2021)
5 (cheesburger) - twrp_cheeseburger_3.5.2-11-v2.img
5T (dumpling) - twrp_dumpling_3.5.2-11-v2.img
Changelog:
- Fixed Full wipe and format data
- Latest merged commits of gerrit on branch A11 (from 25/10/21 to 12/11/21)
https://xdaforums.com/t/recovery-tw...r-dumpling-05-aug-2022.4351795/#post-85933403
A11 - 3.5.2-v1 (24/10/2021)
5 (cheesburger) - twrp_cheeseburger_3.5.2-11-v1.img
5T (dumpling) - twrp_dumpling_3.5.2-11-v1.img
Changelog:
- Initial release
A10 - Last update (06/11/2021)
5 (cheesburger) - twrp_cheeseburger_3.5.2-10.img
5T (dumpling) - twrp_dumpling_3.5.2-10.img
Changelog:
- Fixed Full wipe and format data
https://xdaforums.com/t/recovery-tw...r-dumpling-05-aug-2022.4351795/#post-85904627
A10 - 3.5.2-v1 (24/10/2021)
5 (cheeseburger) - twrp-3.5.2_10_LOS-cheeseburger.img
5T (dumpling) - twrp_dumpling_3.5.2-10.img
Changelog:
- Initial release
Sources A11:
TWRP - https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp/tree/twrp-11
5/5T DT - cheeseburger_dumpling/tree/android-11
Kernel - https://github.com/xLexip/android_kernel_oneplus_msm8998 (from version A11 3.61.-v2)
Sources A12.1:
TWRP - https://github.com/minimal-manifest-twrp/platform_manifest_twrp_aosp
5/5T DT - cheeseburger_dumpling/tree/android-12.1
Kernel - https://github.com/xLexip/android_kernel_oneplus_msm8998
Cheeseburger DT - Cheeseburger/tree/android-11
Dumpling DT -Dumpling/tree/android-11
Kernel - https://github.com/LineageOS/android_kernel_oneplus_msm8998 (up to version A11 3.61.-v1)
Sources A10: (deprecated)
TWRP - https://github.com/minimal-manifest-twrp/platform_manifest_twrp_omni
Cheeseburger DT - Cheeseburger/tree/android-10
Dumpling DT - Dumpling/tree/android-10
Kernel - https://github.com/LineageOS/android_kernel_oneplus_msm8998
Dumpling DT -Dumpling/tree/android-11
Kernel - https://github.com/LineageOS/android_kernel_oneplus_msm8998 (up to version A11 3.61.-v1)
Sources A10: (deprecated)
TWRP - https://github.com/minimal-manifest-twrp/platform_manifest_twrp_omni
Cheeseburger DT - Cheeseburger/tree/android-10
Dumpling DT - Dumpling/tree/android-10
Kernel - https://github.com/LineageOS/android_kernel_oneplus_msm8998
Last edited: