Recover overwritten or deleted data.
RecoverPy
RecoverPy is a powerful tool that leverages your system capabilities to recover lost files.
Unlike others, you can not only recover deleted files but also overwritten data.
Every block of your partition will be scanned. You can even find a string in binary files.
Demo
Installation
:penguin: RecoverPy is currently only available on Linux systems.
:arrow_right: Dependancies
Mandatory: To list and search through your partitions, recoverpy uses grep, dd, and lsblk commands. Although, if you're running a major Linux distrucition these tools should already be installed.
Optional: To display real time grep progress, you can install progress.
To install all dependencies:
- Debian-like:
apt install grep coreutils util-linux progress - Arch:
pacman -S grep coreutils util-linux progress - Fedora:
dnf install grep coreutils util-linux progress
:arrow_right: Installation from pip
python3 -m pip install recoverpy
Usage
python3 -m recoverpy
:red_circle: You must be root or use sudo.
:one: Select the system partition in which your file was. If you are out of luck, you can alternatively search in your home partition, maybe your IDE, text editor, etc. made a backup at some point.
:two: Type a text string to search. See tips below for better results.
:three: Start search, Results will appear in the left-hand box.
:four: Select a result.
:five: Once you have found your precious, select Open.
:six: You can now either save this block individually or explore neighboring blocks for the remaining parts of the file. You could then save it all in one file.
Tips
- Always do backups! Yes, maybe too late...
- Unmount your partition before you do anything! Although you can search with your partition still mounted, it is highly recommended to unmount your partition to avoid any alteration to your file.
Regarding the searched string:
- Be concise, find something that could be unique to your file.
- Stay simple, your string is escaped but exotic characters may affect your results.
- Try to remember the last edit you have made to your file.
When you have found your file:
- You might see multiple results. Your system often use different partion blocks to save successive versions of a file. Make sure you've found the last version.
- Try exploring neighboring blocks to be sure to save your whole file.
Contributing
Thank you for considering contributing to RecoverPy. Any request, bug report or PR are welcome. Please read the contributing guide.
1 maintainer
Release files for recoverpy 2.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| recoverpy-2.0.1.tar.gz | 28.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| recoverpy-2.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 62.7 kB
Release files / recoverpy-2.0.1.tar.gz
| Download URL | recoverpy-2.0.1.tar.gz |
|---|---|
| Size | 28.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
94dcdf8bfaf8af2293cef4323cd90994ca58ea4f2988fe8ff4c8103e953e66f0
|
|
BLAKE2b-256 checksum How to use checksums |
f69521459c0544fa5e6b5ab8bc6d4bb9db938ede0f34da9a0f192a74e11c6e47
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.3.2 CPython/3.10.6 Linux/5.15.0-1033-azure
|
Release files / recoverpy-2.0.1-py3-none-any.whl
| Download URL | recoverpy-2.0.1-py3-none-any.whl |
|---|---|
| Size | 34.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
01b969c693b8ef3188aa4d825a3daeacd73321baa32d0c8b4814409c5634a899
|
|
BLAKE2b-256 checksum How to use checksums |
e0a987f395f085c6926421028346f9bfb347cf981ed8c58bbe62455c05fee5bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.3.2 CPython/3.10.6 Linux/5.15.0-1033-azure
|
