You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Switch to uv
* Use uv in test pypi upload
* Add "explicit" to testpypi
* Use hatchling for building
* Use uv for real pypi publish
* Rework usage/install
Copy file name to clipboardExpand all lines: README.md
+31-29Lines changed: 31 additions & 29 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,15 +25,17 @@
25
25
---
26
26
27
27
<!--ts-->
28
-
*[Demo](#Demo)
29
-
*[Installation](#Installation)
30
-
*[Dependencies](#dependencies)
31
-
*[Run with pipx](#run-with-pipx)
32
-
*[Installation from pip](#installation-from-pip)
33
-
*[Installation from AUR](#installation-from-aur)
34
-
*[Usage](#Usage)
35
-
*[Tips](#Tips)
36
-
*[Contributing](#Contributing)
28
+
29
+
*[Demo](#Demo)
30
+
*[Installation](#Installation)
31
+
*[Dependencies](#dependencies)
32
+
*[Run with pipx](#run-with-pipx)
33
+
*[Installation from pip](#installation-from-pip)
34
+
*[Installation from AUR](#installation-from-aur)
35
+
*[Usage](#Usage)
36
+
*[Tips](#Tips)
37
+
*[Contributing](#Contributing)
38
+
37
39
<!--te-->
38
40
39
41
---
@@ -45,54 +47,51 @@ RecoverPy is a powerful tool that leverages your system capabilities to recover
45
47
Unlike others, you can not only recover deleted files but also **overwritten** data.
46
48
47
49
Every block of your partition will be scanned. You can even find a string in binary files.
50
+
48
51
## Demo
49
52
50
53
<palign="center">
51
54
<img src="docs/assets/demo.gif">
52
55
</p>
53
56
54
-
## Installation
57
+
## Setup
55
58
56
59
:penguin: RecoverPy is currently only available on Linux systems.
57
60
:red_circle:**You must be root or use sudo**.
58
61
59
62
### Dependencies
60
63
61
-
**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.
64
+
**Mandatory:** To list and search through your partitions, recoverpy uses `grep`, `dd`, and `lsblk` commands. Although,
65
+
if you're running a major Linux distrucition these tools should already be installed.
62
66
63
67
**Optional:** To display real time grep progress, you can install `progress`.
You can **directly run recoverpy with pipx in an isolated environment** without installing it.
74
-
To install pipx, follow the [official documentation](https://pipxproject.github.io/pipx/installation/).
75
-
To run recoverpy with pipx, simply run:
79
+
`sudo uvx recoverpy`
80
+
81
+
### Run with pipx
76
82
77
83
`sudo pipx run recoverpy`
78
84
79
-
####Installation from pip
85
+
### Installation from pip
80
86
81
87
`python3 -m pip install recoverpy`
82
88
83
-
#### Installation from AUR
84
-
85
-
`yay -S python-recoverpy`
86
-
87
-
## Usage
88
-
89
-
```bash
90
-
python3 -m recoverpy
91
-
```
89
+
then run `sudo python3 -m recoverpy`
92
90
93
91
---
94
92
95
-
-**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.
93
+
-**Select the system partition** in which your file was. If you are out of luck, you can alternatively search in your
94
+
home partition, maybe your IDE, text editor, etc. made a backup at some point.
96
95
97
96
-**Type a text string to search**. See tips below for better results.
98
97
@@ -102,12 +101,14 @@ python3 -m recoverpy
102
101
103
102
- Once you have found your precious, **select `Open`**.
104
103
105
-
- 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.
104
+
- You can now either save this block individually or explore neighboring blocks for the remaining parts of the file. You
105
+
could then save it all in one file.
106
106
107
107
## Tips
108
108
109
109
- Always do backups! Yes, maybe too late...
110
-
-**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.
110
+
-**Unmount your partition before you do anything!** Although you can search with your partition still mounted, it is
111
+
highly recommended to unmount your partition to avoid any alteration to your file.
111
112
112
113
Regarding the searched string:
113
114
@@ -117,7 +118,8 @@ Regarding the searched string:
117
118
118
119
When you have found your file:
119
120
120
-
- 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.
121
+
- You might see multiple results. Your system often use different partion blocks to save successive versions of a file.
122
+
Make sure you've found the last version.
121
123
- Try exploring neighboring blocks to be sure to save your whole file.
0 commit comments