{"id":13422810,"url":"https://github.com/patois/xray","last_synced_at":"2025-03-15T12:30:52.513Z","repository":{"id":148619336,"uuid":"193128220","full_name":"patois/xray","owner":"patois","description":"Hexrays decompiler plugin that colorizes and filters the decompiler's output based on regular expressions","archived":false,"fork":false,"pushed_at":"2023-12-08T16:20:53.000Z","size":2609,"stargazers_count":124,"open_issues_count":1,"forks_count":10,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-10-28T00:00:33.877Z","etag":null,"topics":["bug-hunting","decompiler","filter","hexrays","highlight","ida","ida-pro","idapython","malware-analysis","plugin","regular-expression"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/patois.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}},"created_at":"2019-06-21T16:18:10.000Z","updated_at":"2024-10-03T05:13:31.000Z","dependencies_parsed_at":"2023-05-20T17:31:07.688Z","dependency_job_id":null,"html_url":"https://github.com/patois/xray","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patois%2Fxray","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patois%2Fxray/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patois%2Fxray/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patois%2Fxray/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patois","download_url":"https://codeload.github.com/patois/xray/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243731046,"owners_count":20338761,"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":["bug-hunting","decompiler","filter","hexrays","highlight","ida","ida-pro","idapython","malware-analysis","plugin","regular-expression"],"created_at":"2024-07-30T23:00:58.220Z","updated_at":"2025-03-15T12:30:51.447Z","avatar_url":"https://github.com/patois.png","language":"Python","readme":"# xray - Filter Hex-Rays Decompiler Output\n\nxray is a plugin for the Hexrays decompiler that both filters and\ncolorizes the textual representation of the decompiler's output based\non configurable regular expressions.\n\nThis helps highlighting interesting code patterns which can be\nuseful in malware analysis and vulnerability identification.\n\n![xray animated gif](/rsrc/xray.gif?raw=true)\n\n## Installation/Updating:\nxray installs or updates itself as a plugin by loading it as a\nscript using the \"File-\u003eScript file...\" (Alt-F7) menu item within IDA.\n\nRunning the plugin for the first time creates a default\nconfiguration file \"xray.cfg\" within the folder\n\"%APPDATA%/Hex-Rays/IDA Pro/plugins/\", which can and should then be\ncustomized by the user.\n\nWhile still under development, updating from a previous installation\nof the plugin may introduce changes to the configuration file which may\ncause incompatibility. If this is the case, the current configuration\nfile should be ported to the new format or deleted.\n\nxray requires IDA 7.2+ (with some effort it may be backported to 7.0).\n\nThis IDAPython project is compatible with Python3. For compatibility with older versions of IDA, you may want to check out the Python2 branch of this project.\n\n## Usage:\nThe plugin offers two distinct filtering/highlighting features:\n* \"xray\", a persistent, configurable regular expression parser that\n  applies color filters to the output of the Hexrays decompiler.\n  This filter can be turned on and off using a keyboard shortcut as\n  described in the next section.\n\n  Persistent filtering attempts to match regular expressions taken\n  from the plugin's configuration file against each of the decompiler's\n  text lines. Successful matches will cause the background\n  color of a matching text line to be changed accordingly.\n  Optionally, changing the \"high_contrast\" setting to \"1\" in the\n  configuration file will cause a visual \"xray\" effect.  \n\n  For more settings and details, please refer to the comments in the\n  configuration file.\n\n* a dynamic filter that filters/highlights Hexrays output. This filter\n  works similar to how the built-in filters for IDA \"choosers\" work.\n  Possible \"filter types\" are \"Regex\" and \"ASCII\". Additional \"filter\n  options\" determine how the filters are applied to respective Hexrays\n  output:\n  * \"Text\" removes any lines from the decompiler's output that a\n    specified search term could not be matched against.\n  * \"Color\" does not remove non-matching lines but only their respective\n    color tags instead. This will cause matching text to be highlighted\n    visually.\n\n## Popup Menus/Keyboard shortcuts:\n* F3:       Toggle xray\n* Ctrl-R:   Reload xray configuration file and apply changes\n            (edit and reload the configuration file on-the-fly)\n* Ctrl-F:   Find ascii string/regular expression and apply\n            filters based on Filter type and options.\n            \"Text\": removes any non-matching lines from the outpout\n            \"Color\": removes colors from non-matching lines\n\n![xray3 animated gif](/rsrc/xray3.gif?raw=true)\n","funding_links":[],"categories":["IDA Plugins","\u003ca id=\"fcf75a0881617d1f684bc8b359c684d7\"\u003e\u003c/a\u003e效率\u0026\u0026导航\u0026\u0026快速访问\u0026\u0026图形\u0026\u0026图像\u0026\u0026可视化"],"sub_categories":["\u003ca id=\"03fac5b3abdbd56974894a261ce4e25f\"\u003e\u003c/a\u003e显示增强"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatois%2Fxray","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatois%2Fxray","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatois%2Fxray/lists"}