KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

tipatch

★ 76 Open GitHub ↗

A patcher for TWRP to backup internal storage/emulated SD card contents (photos, downloads, videos, etc).

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Tipatch

[![API](https://img.shields.io/badge/API-21%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=21)
[![GitHub release](https://img.shields.io/github/release/kdrag0n/tipatch.svg?style=flat)](https://github.com/kdrag0n/tipatch/releases)
[![Release downloads](https://img.shields.io/github/downloads/kdrag0n/tipatch/total.svg?style=flat)](https://github.com/kdrag0n/tipatch/releases)
[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://opensource.org/licenses/MIT)

Tipatch patches TWRP to backup contents of internal storage (the emulated SD card at /sdcard) as part of **Data**, thus preventing data loss. Internal storage typically includes items such as photos, videos, downloads, game data, and other assorted files. [Website](https://khronodragon.com/projects/tipatch/)

## Why?
TWRP Data backups do not include Internal Storage, which is the emulated SD card that stores your photos, videos, downloads, and more. This means that in the event you transfer phones or completely wipe data, all of that is gone! Eventual data loss is inevitable here.

I decided to make this tool after encountering data loss multiple times because of the issue. To make it accessible to all users, I made it an app instead of only a command-line computer program.

## Effects
 - `Data (incl. storage)` instead of `Data (excl. storage)` on Backup screen
 - `Backups of Data include...` instead of `Backups of Data do not include...` when stating backup
 - Bigger calculated Data size on Backup screen
 - Internal storage being restored when restoring the backup

**__Side effect__: wiping Data *WILL* also wipe internal storage!**

If you use a theme, or a language other than English, the text **will not** change. Revert to the default theme and/or temporarily change the language back to English to confirm this. Don't worry, this is only a cosmetic effect.

Restoring backups taken with a patched TWRP (i.e. those that include internal storage) does **not** require a patched recovery.

## Will it work for *device name*?
The app supports patching the currently installed recovery in-place on rooted devices. It has been confirmed to work on Exynos, Snapdragon, Kirin, and MediaTek devices.

If you are **not rooted** or your device is not supported by in-place patching, don't worry. It also supports patching an image and saving the result as an image.

## Help, something broke!
If you used in-place patching and your recovery doesn't boot anymore, tap `Restore backup` in the action menu.

If you don't want internal storage to be backed up anymore, tap `Undo patch` in the action menu instead of `Patch`.

For other issues or feedback, you can post on the [XDA thread](https://forum.xda-developers.com/android/apps-games/app-twrp-tipatch-backup-internal-t3831217), find me on [Telegram](https://t.me/kdrag0n) or [e-mail](mailto:kdrag0n@pm.me) me.

## How does it *really* work?
It simply changes TWRP to ignore `/data/.twrp` instead of `/data/media`, where internal storage resides.

The core logic is written in C++, loaded as a native library by the app. The app handles I/O, while the C++ code does the heavy lifting and actual patching, in-memory. I chose to do this in C++ instead of Kotlin because of memory usage and speed concerns.

Since users are likely to get impatient waiting for the ramdisk compression to finish, I implemented parallel gzip that uses up to 4 cores at once to finish the compression faster. It's limited at 4 to prevent overloading the device and saturating memory bandwidth, thus making the process slower. LZMA compression is done in Java and is not optimized because of the minority of devices with LZMA compressed ramdisks.

Unfortunately, I was not able to have the C++ piece directly read from a file descriptor obtained from Kotlin because in file patching mode, it is possible to refer to files that may be stored anywhere - Google Drive, other apps, etc. This was a major loss in terms of memory consumption during patching.

tipatch

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README