Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Mac Debugger

Mac Debugger was created with the focus on giving the programmer a powerful framework to programatically create scripts to debug programs on Mac OSX not found in other products for the platform.

The core of macdbg, written in C, is kept as minimal as possible to provide enough basic interaction between the kernel and userland to create powerful features. Higher level functionality is left to the Python implementation such as stack tracing, dissasembly, watchpoints, thread state, and more. A wrapper class is provided for the programmer to create a scripting program.

NOTE: This is an Alpha implementation more showing concepts and ideas but not fully refined. Expect the Beta version in the coming months with more refined variable naming cleaner code and more useable examples. Thanks for all the interest suggestions comments and help welcome!

Getting Started

$ git clone

Navigate to the MacDBG directory, then cd src and make. The shared library libmcdb.dylib will be compiled and several binaries.



Running a test debugger on a test program.

  1. cd Python/examples and open another terminal.
  2. Run sudo ./
  3. This is just a test rogram which we will be attach and set breakpoints on. Hit f to fork the program enter to continue or press c to crash it. You should see breakpoint output like seen below.
  4. There are many other examples in the examples directory most having at least a small description available, nore descriptions and usage coming soon.
  5. Most examples will spawn a program but nearly all of them can take a PID and attach to that. Please note some were written specifaclly for a specific program such as was written to track mallocs on Firefox changes would need to be made to make it work on other programs.


Simple easy to use C and python debugging framework for OSX






No releases published


No packages published