{"id":22157879,"url":"https://github.com/mkbeh/fereda","last_synced_at":"2025-07-26T08:32:11.946Z","repository":{"id":98488021,"uuid":"228757591","full_name":"mkbeh/Fereda","owner":"mkbeh","description":"Cli tool  for restoring hide and removed images from gallery and different messengers on Android.","archived":false,"fork":false,"pushed_at":"2020-07-07T19:00:34.000Z","size":152,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-05T07:40:59.112Z","etag":null,"topics":["android","cli-tool","cybersecurity","gallery","linux","messengers","mobile-forensics","mobile-security","recovery","regex","restoring-hide"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mkbeh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-12-18T04:26:36.000Z","updated_at":"2025-02-06T01:12:46.000Z","dependencies_parsed_at":"2023-06-02T01:15:46.739Z","dependency_job_id":null,"html_url":"https://github.com/mkbeh/Fereda","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/mkbeh/Fereda","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkbeh%2FFereda","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkbeh%2FFereda/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkbeh%2FFereda/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkbeh%2FFereda/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mkbeh","download_url":"https://codeload.github.com/mkbeh/Fereda/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkbeh%2FFereda/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267140646,"owners_count":24041970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-26T02:00:08.937Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","cli-tool","cybersecurity","gallery","linux","messengers","mobile-forensics","mobile-security","recovery","regex","restoring-hide"],"created_at":"2024-12-02T03:16:08.145Z","updated_at":"2025-07-26T08:32:11.841Z","avatar_url":"https://github.com/mkbeh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fereda\n\n![Platform](https://img.shields.io/badge/Platform-all-RED)\n![Python](https://img.shields.io/badge/Python-3.7|3.8-BRIGHTGREEN)\n![Release](https://img.shields.io/github/v/release/mkbeh/Fereda)\n![Issues](https://img.shields.io/github/issues/mkbeh/Fereda)\n![License](https://img.shields.io/badge/License-GPLv3.0-Yellow)\n\n[![Discord](https://user-images.githubusercontent.com/7288322/34429117-c74dbd12-ecb8-11e7-896d-46369cd0de5b.png)](https://discord.gg/Ftaynpe)\n\nCyber security tool of mobile forensics for restoring hide and removed images from gallery and different messengers on Android.\n\n```lang\nMethods of the donation to the development of the project:\n\nBitcoin: bc1qwcp93tr7t7rlwe86zpglusstaq8j50dag0q6ll\n```\n\n**`Supporting devices`**:\n\n* Samsung\n* Redmi\n* Micromax\n\n**`Supporting messengers`**:\n\n* Telegram\n* VK (added , but not tested yet)\n\n```lang\nNOTE #1:\nThe list of supported devices means that the utility \nhas been tested on these devices, but it can work \ncorrectly on many other devices.\n\nNOTE #2:\nNot all devices manage to recover deleted images, \nsince not all devices cache them.\n```\n\n**The following actions were performed on Debian based\ndistr with kernel 5.4.0+**\n\n## **Installation and usage screen cast**\n\n[![Fereda Screencast](https://img.youtube.com/vi/9rh5tERPF40/0.jpg)](https://www.youtube.com/watch?v=9rh5tERPF40\u0026t=191s)\n\n## Installation\n\n```bash\n# Bash script for downloading latest github release\n# Ex. downloadGithubLatestRelease mkbeh Fereda zip true\n\n# Download latest release from github.\n# Require jq utility.\n# Params: \u003cuser\u003e \u003crepo_name\u003e \u003carchieveType:(zip or tar)\u003e \u003cunpack:(true or false)\u003e\nfunction downloadGithubLatestRelease() {\n        user=$1\n        repoName=$2\n        archieveType=$3\n        unpack=$4\n\n        url=$(curl \"https://api.github.com/repos/$user/$repoName/releases/latest\" | jq -r \".${archieveType}ball_url\")\n        wget -O \"$repoName\" $url\n         \n        if [[ $unpack = \"false\" ]]; then\n                return 0\n        fi\n\n\n        if [[ $archieveType == \"zip\" ]]; then\n                unzip $repoName\n        else\n                tar -xzf $repoName\n        fi\n\n        rm $repoName \u0026\u0026 mv $(ls | grep $repoName) $repoName\n}\n```\n\n\u003e downloadGithubLatestRelease mkbeh Fereda zip true \u0026\u0026 cd Fereda\n\n### **Linux**\n\n\u003e chmod u+x install.sh \u0026\u0026 $SHELL install.sh\n\n### **Other OS**\n\n\u003e python3.7 setup.py install\n\n## Usage\n\n### **Options**\n\n* --restore-data - Will copy found files into output directory. Without this option, it will simply show how many files were found and in what places.\n* --self-destruction - Will remove utility from path ~/.local/bin\u0026\u0026lib. Works only on Linux.\n* --move-files - Will move found files from its places into output directory. Works with option `--restore-data`.\n* --off-progress-bar - It will improve performance.\n* --output-dir - Directory where will be copied or moved found files. By default it named `Fereda` and it will be located in the same directory where the utility was launched.\n\n### **Examples**\n\n**`First step`**\n\n```bash\n# ---- Plug in your phone via usb,\n# ---- Enable USB debugging in Developer Settings\n# ---- Install ADB (Android Debug Bridge)\n# ---- Run following commands:\nadb devices\nadb pull /path/to/user/folder .\n\n# Next, go to the second step.\n\nIMPORTANT NOTE:\nUser folder contains directories such as DCIM Pictures and etc.\n```\n\n**`Second step`**\n\n```bash\n# ---- Show help message ----\nfereda -h\n\n# ---- Simple run. Only shows how many files were found and in what places ----\nfereda\n\n# ---- Restore (copy) found files to output directory ----\nfereda -r\n\n# ---- Restore (move) found files from its location to output directory ----\nfereda -rm\n```\n\n## Roadmap\n\n* [ ] Text files analysis by regular expressions.\n* [ ] Databases analysis: including raw SQL request, \nby tables, columns names and fields values using  regular expressions.\n* [ ] Restore hidden and removed images from gallery and\nmessengers from the file system , including SDCARD.\n* [ ] Dump data:\n    * [ ] Calls\n    * [ ] Messages\n    * [ ] Contacts\n    * [ ] Coordinates\n    * [ ] Backups\n    * [ ] Accounts (Experimental)\n    * [ ] Mail     (Experimental)\n    * [ ] Browser cookies\n    * [ ] Browser history","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkbeh%2Ffereda","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmkbeh%2Ffereda","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkbeh%2Ffereda/lists"}