About

Disass (Short for disassemble) is an interface for the GNU Debugger (GDB).

It's mainly made for disassembly in mind, but if you found it comfortable to use for normal debugging purposes then go ahead!

Here is a GIF of all of the progress throughout the versions so far.

Screenshot from the latest version: 0.07

How to use

• Make sure you have gdb installed.

  $ gdb --version

  • If not, then install it using the following command depending on your distro of choice:

  Arch and its Derivatives(Manjaro, Antergos, etc..)

  # pacman -S gdb
  

  Debian and its Derivatives(Ubuntu, Linux Mint, etc..)

  # apt update && apt install gdb
  

  RedHat and its Family(CentOS, Fedora, etc..)

  # yum install gdb
  

• Head over to the releases page.

• Download the version you want of Disass.

• Mark the AppImage as executable or run chmod +x Disass-vY-x86_64.AppImage

• Double click the AppImage or run ./Disass-vY-x86_64.AppImage

Note: replace Y with the version you downloaded.

To-Do List

[ ] Add option to run commands from a file.

[ ] Add option to add breakpoints by clicking on code lines.

[ ] Fix an error where sometimes the user input isn't passed the GDB's child process (i.e the program being debugged).

[ ] Add a feature to autodetect if gdb is installed or not, and warn the user if it isn't.

[🗸] Add user help.

[🗸] Design a user friendly GUI with icons for buttons.

[🗸] Add a feature to autodetect 64-bit and 32-bit executables.

[🗸] Deploy an AppImage.

[🗸] Add a register watch box.

[🗸] Add a memory watch box.

License

Disass - GNU Debugger front-end

Copyright (C) 2019 Ahmed Elmayyah (Satharus)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. 
If not, see <https://www.gnu.org/licenses/>.