# Forensic Doctor 1.0.0
Forensic Doctor is a Python package designed for forensic analysis to recover deleted files from disk images, supporting a wide range of file types and sizes.
## Installation
To install Forensic Doctor, use pip:
```bash
pip install forensic-doctor
```
## Usage
### Command Line
#### Recover and save to a specified path
```bash
forensic-doctor --recover--path /path/to/disk_image.E01 /path/to/folder/
```
#### Recover and save to a mentioned folder
```bash
forensic-doctor --recover--path /path/to/disk_image.E01 /path/to/folder/ --output /path/to/folder1/
```
#### Recover a mentioned file only
```bash
forensic-doctor --recover--file /path/to/disk_image.E01 /path/to/folder/image.png
```
#### Recover a mentioned file and move it to the specified path
```bash
forensic-doctor --recover--file /path/to/disk_image.E01 /path/to/folder/image.png --output /path/to/output_file/
```
### Import as a Module
```python
from forensic_doctor import recover_files, recover_file
# Example 1: Recover all files in a directory within the disk image
recovered_files = recover_files("/path/to/disk_image.E01", "/path/to/output_dir")
if recovered_files:
for file in recovered_files:
print(f"Recovered: {file}")
else:
print("No files recovered.")
# Example 2: Recover a specific file from the disk image
recovered_file = recover_file("/path/to/disk_image.E01", "/path/to/image.png", "/path/to/output_file")
if recovered_file:
print(f"Recovered: {recovered_file}")
else:
print("File not recovered.")
# Example 3: Recover files and handle errors
try:
recovered_files = recover_files("/path/to/disk_image.E01", "/path/to/output_dir")
for file in recovered_files:
print(f"Recovered: {file}")
except Exception as e:
print(f"Error occurred: {e}")
# Example 4: Recover specific file and check file existence
recovered_file = recover_file("/path/to/disk_image.E01", "/path/to/image.png", "/path/to/output_file")
if recovered_file:
print(f"Recovered: {recovered_file}")
if os.path.exists(recovered_file):
print("File exists.")
else:
print("File recovered but not found.")
else:
print("File not recovered.")
# Example 5: Handle large files recovery
large_file_path = "/path/to/large_file.iso"
output_directory = "/path/to/output_dir"
recovered_files = recover_files(large_file_path, output_directory)
if recovered_files:
print(f"Recovered {len(recovered_files)} files.")
else:
print("No files recovered.")
```
### Features
- Supports recovery of all file types: images, videos, documents, etc.
- Handles large and small files efficiently.
- Command-line interface for quick and easy usage.
### License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Thanks Note
Thank you for using Forensic Doctor! If you have any questions or need further assistance, feel free to reach out. Your feedback is valuable in improving this tool.
Raw data
{
"_id": null,
"home_page": "https://github.com/Bytebreach/forensic-doctor",
"name": "forensic-doctor",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "MrFidal",
"author_email": "mrfidal@proton.me",
"download_url": "https://files.pythonhosted.org/packages/7e/ab/7c0be1a501ebde128bf91b732c392c1229b5b8ee64fbe8a9a205a29ca5da/forensic-doctor-1.0.0.tar.gz",
"platform": null,
"description": "# Forensic Doctor 1.0.0\r\n\r\nForensic Doctor is a Python package designed for forensic analysis to recover deleted files from disk images, supporting a wide range of file types and sizes.\r\n\r\n## Installation\r\n\r\nTo install Forensic Doctor, use pip:\r\n\r\n```bash\r\npip install forensic-doctor\r\n```\r\n\r\n## Usage\r\n\r\n### Command Line\r\n\r\n#### Recover and save to a specified path\r\n\r\n```bash\r\nforensic-doctor --recover--path /path/to/disk_image.E01 /path/to/folder/\r\n```\r\n\r\n#### Recover and save to a mentioned folder\r\n\r\n```bash\r\nforensic-doctor --recover--path /path/to/disk_image.E01 /path/to/folder/ --output /path/to/folder1/\r\n```\r\n\r\n#### Recover a mentioned file only\r\n\r\n```bash\r\nforensic-doctor --recover--file /path/to/disk_image.E01 /path/to/folder/image.png\r\n```\r\n\r\n#### Recover a mentioned file and move it to the specified path\r\n\r\n```bash\r\nforensic-doctor --recover--file /path/to/disk_image.E01 /path/to/folder/image.png --output /path/to/output_file/\r\n```\r\n\r\n### Import as a Module\r\n\r\n```python\r\nfrom forensic_doctor import recover_files, recover_file\r\n\r\n# Example 1: Recover all files in a directory within the disk image\r\nrecovered_files = recover_files(\"/path/to/disk_image.E01\", \"/path/to/output_dir\")\r\nif recovered_files:\r\n for file in recovered_files:\r\n print(f\"Recovered: {file}\")\r\nelse:\r\n print(\"No files recovered.\")\r\n\r\n# Example 2: Recover a specific file from the disk image\r\nrecovered_file = recover_file(\"/path/to/disk_image.E01\", \"/path/to/image.png\", \"/path/to/output_file\")\r\nif recovered_file:\r\n print(f\"Recovered: {recovered_file}\")\r\nelse:\r\n print(\"File not recovered.\")\r\n\r\n# Example 3: Recover files and handle errors\r\ntry:\r\n recovered_files = recover_files(\"/path/to/disk_image.E01\", \"/path/to/output_dir\")\r\n for file in recovered_files:\r\n print(f\"Recovered: {file}\")\r\nexcept Exception as e:\r\n print(f\"Error occurred: {e}\")\r\n\r\n# Example 4: Recover specific file and check file existence\r\nrecovered_file = recover_file(\"/path/to/disk_image.E01\", \"/path/to/image.png\", \"/path/to/output_file\")\r\nif recovered_file:\r\n print(f\"Recovered: {recovered_file}\")\r\n if os.path.exists(recovered_file):\r\n print(\"File exists.\")\r\n else:\r\n print(\"File recovered but not found.\")\r\nelse:\r\n print(\"File not recovered.\")\r\n\r\n# Example 5: Handle large files recovery\r\nlarge_file_path = \"/path/to/large_file.iso\"\r\noutput_directory = \"/path/to/output_dir\"\r\nrecovered_files = recover_files(large_file_path, output_directory)\r\nif recovered_files:\r\n print(f\"Recovered {len(recovered_files)} files.\")\r\nelse:\r\n print(\"No files recovered.\")\r\n```\r\n\r\n### Features\r\n\r\n- Supports recovery of all file types: images, videos, documents, etc.\r\n- Handles large and small files efficiently.\r\n- Command-line interface for quick and easy usage.\r\n\r\n### License\r\n\r\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\r\n\r\n## Thanks Note\r\n\r\nThank you for using Forensic Doctor! If you have any questions or need further assistance, feel free to reach out. Your feedback is valuable in improving this tool.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A forensic tool for recovering deleted files from disk images.",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/Bytebreach/forensic-doctor"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d5546e0fd4c753ae5445353adae12194dc4086c261b149e13b2e5cbbe340eb46",
"md5": "d740898121f5ff0a15ed901322547bb6",
"sha256": "381ab979d981183a92b8ed2002979725c26887be08068da03599cf73ca353001"
},
"downloads": -1,
"filename": "forensic_doctor-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d740898121f5ff0a15ed901322547bb6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4942,
"upload_time": "2024-07-13T13:14:32",
"upload_time_iso_8601": "2024-07-13T13:14:32.197082Z",
"url": "https://files.pythonhosted.org/packages/d5/54/6e0fd4c753ae5445353adae12194dc4086c261b149e13b2e5cbbe340eb46/forensic_doctor-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7eab7c0be1a501ebde128bf91b732c392c1229b5b8ee64fbe8a9a205a29ca5da",
"md5": "cfe483df6b0a6b687af0c8a1cada39eb",
"sha256": "e3ec83c1d884b837fdb12fe9f6f9bfb80c844e08c7337395ae06234305f5412a"
},
"downloads": -1,
"filename": "forensic-doctor-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "cfe483df6b0a6b687af0c8a1cada39eb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4385,
"upload_time": "2024-07-13T13:14:34",
"upload_time_iso_8601": "2024-07-13T13:14:34.089959Z",
"url": "https://files.pythonhosted.org/packages/7e/ab/7c0be1a501ebde128bf91b732c392c1229b5b8ee64fbe8a9a205a29ca5da/forensic-doctor-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-13 13:14:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Bytebreach",
"github_project": "forensic-doctor",
"github_not_found": true,
"lcname": "forensic-doctor"
}
JSON
