https://github.com/Battelle/REpsych

Psychological warfare in reverse engineering
https://github.com/Battelle/REpsych

Last synced: about 2 months ago
JSON representation

Psychological warfare in reverse engineering

• Host: GitHub
• URL: https://github.com/Battelle/REpsych
• Owner: Battelle
• License: bsd-3-clause
• Created: 2018-04-03T14:10:28.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-03-22T02:38:52.000Z (over 6 years ago)
• Last Synced: 2024-06-12T02:29:01.514Z (3 months ago)
• Language: Assembly
• Size: 6.4 MB
• Stars: 177
• Watchers: 11
• Forks: 93
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# REpsych

: Psychological Warfare in Reverse Engineering

github.com/xoreaxeaxeax/repsych // domas // @xoreaxeaxeax

### Overview

The REpsych toolset is a proof-of-concept illustrating the generation of images

through a program's [control flow

graph](https://en.wikipedia.org/wiki/Control_flow_graph) (CFG).

 A typical function's CFG    | A REpsych generated CFG

:---------------------------:|:------------------------------------:

 ![cfg](examples/cfg.png)    | ![repsych](examples/repsych.gif)

There is no specific point to the project (other than to show that it can be

done), but possible (non-serious) applications are outlined in the [DEF CON

presentation](https://www.youtube.com/watch?v=HlUe0TUHOIc).

The program works reliably with all tested versions of the IDA Pro reverse

engineering tool, and semi-reliably with other CFG viewers (Hopper, BinNavi,

radare2, etc).

### Usage

The toolset translates source images into functioning programs, such that the

program's control flow graph generates the source image.  

To generate a new program from an image:

* Save the image in the gfx/ folder as a 24 BPP bitmap.

* Run "make image" in the root directory of the project, where "image" is the

  name of your image, without the extension.

Two functioning programs will be created: repsych_v1 and repsych_v2.  Each uses

a different strategy for ensuring the CFG renderer correctly places the CFG

nodes.

### Tips

The tool will create a basic block (CFG node) for each pixel of the source

image; as such, you should try to use small source images (not larger than

100x100), and you may need to increase the number of allowed nodes in your CFG

viewer.

When using an image of text as input to the tool, first convert the image to a

2 BPP black and white bitmap first, then to a 24 BPP bitmap; this will remove

non black and white colors, and give the best results in the control flow graph.

### Examples

![Example 1](examples/repsych_1.png?raw=true)

![Example 4](examples/repsych_4.png?raw=true)

![Example 3](examples/repsych_3.png?raw=true)

![Example 2](examples/repsych_2.png?raw=true)

![Example 5](examples/repsych_5.png?raw=true)

### References

The technique is outlined in detail in the [DEF CON

presentation](https://www.youtube.com/watch?v=HlUe0TUHOIc).

Slides from the presentation are provided

[here](slides/domas_defcon_2015_repsych.pdf).

### Author

REpsych is a proof-of-concept from Christopher Domas

([@xoreaxeaxeax](https://twitter.com/xoreaxeaxeax)).