# PabloLec/RecoverPy

Interactively find and recover deleted or :point_right: overwritten :point_left: files from your terminal

Repository: https://github.com/PabloLec/RecoverPy
Canonical: https://ross.abutalabs.com/products/recoverpy
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: python3, tui, data, recovery, cybersecurity, python, cli, console, terminal, linux, search-interface, macos, pentesting, search, files, tool, hacking, textual, forensics, data-recovery
Last push: 2026-08-03T13:43:54+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 58, longevity 100
- inputs: {"age_days": 2016, "days_push": 30, "days_rel": 200, "gap_med": 70, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1785, forks 90 (observed 2026-08-28T04:05:36.045536+00:00)

## What it is
RecoverPy is a Python TUI tool that scans raw partitions and disk images for byte patterns to locate and recover deleted or overwritten files. It lets users inspect matching disk blocks, navigate adjacent blocks, and save recoverable content directly from the terminal.

## Use cases
- recover deleted files from a linux partition
- find overwritten file fragments by searching for a string on disk
- forensic analysis of raw block devices
- recover a config file after accidental deletion
- search a disk image for a specific byte pattern
- extract data from blocks before they are reused

## When to choose
- you know a distinctive string contained in the lost file
- you need block-level inspection rather than filesystem-based recovery
- you want an interactive terminal workflow on Linux
- the deleted file's metadata is gone but blocks may still exist

## When to avoid
- the disk blocks have already been overwritten
- you need to restore filenames or full filesystem structures
- you need a Windows-native recovery tool
- you want automated bulk recovery of many files

## Facets
- artifact type: cli-tool
- maturity: active
- function: search-engine, file-system, cli, terminal-ui
- domain: files, security, developer-tools
- platform: cli, python
- tags: data-recovery, forensics, tui, block-device, deleted-files, textual, disk-scanning, command-line, linux, macos

## Member repositories
- PabloLec/RecoverPy (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:36.045536+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:24:11.555104+00:00, confidence not recorded.
  - readme: https://github.com/PabloLec/RecoverPy (fetched 2026-08-28T04:05:36.045536+00:00, sha 1d52e865bdf1)
  - registry_pypi: https://pypi.org/pypi/recoverpy/json (fetched 2026-08-29T11:02:32.431068+00:00, sha 08d95487c413)
- Data as of 2026-08-30T08:39:29.467469+00:00.