{"id":21254501,"url":"https://github.com/cyb3rmx/zepu1chr3","last_synced_at":"2025-07-11T02:31:03.991Z","repository":{"id":57478184,"uuid":"456242022","full_name":"CYB3RMX/Zepu1chr3","owner":"CYB3RMX","description":"A Radare2 based Python module for Binary Analysis and Reverse Engineering.","archived":false,"fork":false,"pushed_at":"2022-02-07T09:05:41.000Z","size":583,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-09T08:42:48.718Z","etag":null,"topics":["binary","binary-analysis","development","malware-analysis","python","r2pipe","radare2","reverse-engineering"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CYB3RMX.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}},"created_at":"2022-02-06T18:51:59.000Z","updated_at":"2024-08-26T22:06:43.000Z","dependencies_parsed_at":"2022-09-18T19:01:15.928Z","dependency_job_id":null,"html_url":"https://github.com/CYB3RMX/Zepu1chr3","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CYB3RMX%2FZepu1chr3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CYB3RMX%2FZepu1chr3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CYB3RMX%2FZepu1chr3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CYB3RMX%2FZepu1chr3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CYB3RMX","download_url":"https://codeload.github.com/CYB3RMX/Zepu1chr3/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225669562,"owners_count":17505386,"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","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":["binary","binary-analysis","development","malware-analysis","python","r2pipe","radare2","reverse-engineering"],"created_at":"2024-11-21T03:56:29.137Z","updated_at":"2024-11-21T03:56:29.835Z","avatar_url":"https://github.com/CYB3RMX.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zepu1chr3\n\u003cimg src=\"https://img.shields.io/badge/-Python-black?style=for-the-badge\u0026logo=python\u0026logoColor=white\"\u003e\n\u003cbr\u003e\u003cb\u003eA Radare2 based Python module for Binary Analysis and Reverse Engineering.\u003c/b\u003e\u003cbr\u003e\n\n# Installation\n- \u003ci\u003eYou can simply run this command.\u003c/i\u003e\n```bash\npip3 install zepu1chr3\n```\n\n# How to Use\n## Specifying a target binary\n- \u003ci\u003eDescription\u003c/i\u003e: You can specify any binary file to analysis you want. It returns a handler for target file.\u003cbr\u003e\n```python\nimport zepu1chr3\n\nzep = zepu1chr3.Binary()\ntarget = zep.File(\"WannaCry.exe\")\n```\n\n## Getting symbols from target binary\n- \u003ci\u003eDescription\u003c/i\u003e: This method will give you what symbols are inside of the target file. It returns an array of symbol information.\u003cbr\u003e\n```python\nimport zepu1chr3\n\nzep = zepu1chr3.Binary()\ntarget zep.File(\"WannaCry.exe\")\nsymbols = zep.GetSymbols(target)\n```\n![image](.animations/symbols.png)\n\n## Getting imports from target binary\n- \u003ci\u003eDescription\u003c/i\u003e: This method will give you what imports are inside of the target file. It returns an array of import information.\u003cbr\u003e\n```python\nimport zepu1chr3\n\nzep = zepu1chr3.Binary()\ntarget = zep.File(\"WannaCry.exe\")\nimports = zep.GetImports(target)\n```\n![image](.animations/imports.png)\n\n## Getting functions from target binary\n- \u003ci\u003eDescription\u003c/i\u003e: This method will give you what functions are inside of the target file. It returns an array of function information.\u003cbr\u003e\n```python\nimport zepu1chr3\n\nzep = zepu1chr3.Binary()\ntarget = zep.File(\"WannaCry.exe\")\nfunctions = zep.GetFunctions(target)\n```\n![image](.animations/functions.png)\n\n## Getting sections from target binary\n- \u003ci\u003eDescription\u003c/i\u003e: This method will give you what sections are inside of the target file. It returns an array of section information.\u003cbr\u003e\n```python\nimport zepu1chr3\n\nzep = zepu1chr3.Binary()\ntarget = zep.File(\"WannaCry.exe\")\nsections = zep.GetSections(target)\n```\n![image](.animations/sections.png)\n\n# Disassembling functions or somethings contained in offsets\n## Getting informations about only machine code\n- \u003ci\u003eDescription\u003c/i\u003e: This method will give you disassembled function codes if ```only_codes``` parameter set to ```True```\u003cbr\u003e\n```python\nimport zepu1chr3\n\nzep = zepu1chr3.Binary()\ntarget = zep.File(\"WannaCry.exe\")\ndisas = zep.DisassembleFunction(target, given_function=\"entry0\", only_codes=True)\nsecond = zep.DisassembleFunction(target, given_function=\"0x401000\", only_codes=True) # You can use offsets to!!\n```\n![image](.animations/disas1.png)\n\n## Getting every information about machine code (verbose!!)\n- \u003ci\u003eDescription\u003c/i\u003e: If you set ```only_codes``` parameter as ```False``` you will get more verbose output.\u003cbr\u003e\n```python\nimport zepu1chr3\n\nzep = zepu1chr3.Binary()\ntarget = zep.File(\"WannaCry.exe\")\ndisas = zep.DisassembleFunction(target, given_function=\"entry0\", only_codes=False)\n```\n![image](.animations/disas2.png)\n\n# Other functionalities are coming soon!!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyb3rmx%2Fzepu1chr3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyb3rmx%2Fzepu1chr3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyb3rmx%2Fzepu1chr3/lists"}