Giter Club home page Giter Club logo

cemu's Introduction

CEMU

MIT IRC Python-Version PyPi-Version

cemu-linux

Description

Writing assembly is fun. Assembly is the lowest language (humanly understandable) available to communicate with computers, and is crucial to understand the internal mechanisms of any machine. Unfortunately, setting up an environment to write, compile and run assembly for various architectures (x86, ARM, MIPS, SPARC) has always been painful. CEmu is an attempt to fix this by providing a bundled GUI application that empowers users to write assembly and test it by compiling it to bytecode and executing it in an QEMU-based emulator.

CEmu combines all the advantages of a basic assembly IDE, compilation and execution environment, by relying on the great libraries Keystone, Unicorn and Capstone engines in a Qt powered GUI.

It allows to test binary samples, check your shellcodes or even simply learn how to write assembly code, all of this for the following architectures:

  • x86-32 / x86-64
  • Arm / AArch64
  • MIPS / MIPS64
  • SPARC / SPARC64
  • (more to come)

CEmu was tested and works on Linux, Windows and MacOSX.

Installation

Since version 0.2.2, cemu is now Python3 only for simplicity (and also due to the fact that Python2 will soon cease to exist).

If your current installation of cemu is <= 0.2.1 and on Python2, please uninstall it and install it using Python3.

Quick install with PIP

Last stable from PyPI:

pip3 install cemu

Last stable from Github:

git clone https://github.com/hugsy/cemu && cd cemu
pip3 install --upgrade .

For 99% of cases, that's all you need to do. cemu will be installed in your ${LOCALPATH}/bin directory (by default, /usr/local/bin/cemu if installed as root, ~/.local/bin/cemu for non-root).

Installation notes

Kali Linux

If you are using Kali Linux, there is a known problem with the installation of the keystone-engine package using PIP. A quick'n dirty fix for that would be (as root):

$ sudo updatedb
$ sudo locate libkeystone.so
$ sudo ln -sf /path/to/libkeystone.so/found/above /usr/local/lib/libkeystone.so

OSX

If you are using OSX, I would highly recommand installing Capstone engine directly using brew.sh command instead of pip, as its version seems more up-to-date than the one on PyPI. Doing so, the installation should work out of the box:

$ brew install capstone 
$ pip3 install -U cemu

Windows

The fastest way for Windows is to install the packaged binaries for:

Then spawn cmd.exe and install the missing Python packages using pip:

# From PyPI
C:\> pip.exe install -U cemu
# From Github
## Download ZIP and extract it
C:\> cd path\to\cemu
C:\path\to\cemu> pip.exe install . -U

CEmu launcher (cemu.exe) will be in the C:\Python3\Scripts directory.

Contribution

cemu was created and maintained by myself, @_hugsy_, but kept fresh thanks to all the contributors.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.