phracker/hopperscripts

Python Scripts for use with Hopper Disassembler

**HopperScripts** ===

The script stash for Hopper Disassembler. Contribute a script today!

To Install:

OS X: $ curl -sL http://git.io/vqHHE | bash

Manual Install / Other Platforms: Download, unzip to Hopper's Scripts folder.

Check out the Hopper Scripting Reference if you're new to scripting for Hopper.

Credits:

• Demangle Strings.py was sourced from github user NetsourceLabs.
• WS2_32.dll Ordinals to Names.py by chort
• Add CFString Inline Comments.py, Create Procedures ARM.py, Hopper GDB to GDB.py, and Read Class Dump.py from here.
• Generate PseudoCode.py by hexploitable
• Find C Strings (ASCII).py by BobuSumisu
• The remainder of these scripts were authored by various members of MSJ.

Related Links

• agatti's Hopper 3 Plugins

hopperscripts's Issues

Proposing a PR to fix a few small typos

Issue Type

[x] Bug (Typo)

Steps to Replicate and Expected Behaviour

• Examine Demangle Strings.py and observe insturction, however expect to see instruction.
• Examine Demangle Strings.py and observe proceedure, however expect to see procedure.

Notes

Semi-automated issue generated by
https://github.com/timgates42/meticulous/blob/master/docs/NOTE.md

To avoid wasting CI processing resources a branch with the fix has been
prepared but a pull request has not yet been created. A pull request fixing
the issue can be prepared from the link below, feel free to create it or
request @timgates42 create the PR. Alternatively if the fix is undesired please
close the issue with a small comment about the reasoning.

https://github.com/timgates42/HopperScripts/pull/new/bugfix_typos

Thanks.

Issues getting Ordinal to Names to work

I am debugging a DLL file which uses WS32_DLL functionality on Linux (x64) using HopperV4. Trying to run your Orinal -> Name plugins I run into some errors. Hopefully you can help me.

Running at imports

; Imports from WS2_32.dll'
imp_ordinal_WS2_32.dll_18: // ordinal_WS2_32.dll_18'
100163c4 dd 0x80000012 ; DATA XREF=sub_100016d0+856'

Running WS2_32.dll Ordinals to Names.py does not work because of the mid-name extension .dll in the file name. Renaming this to WS2_32 Ordinals to Names.py solves this issue and causes the file to run, but still crashes with the following error message:

Renaming in range 0x100163c4L to 0x10016404L
Address: 268526532
Name: imp_ordinal_WS2_32.dll_18
Traceback (most recent call last):
File "WS2_32 Ordinals to Names", line 138, in
KeyError: 'imp_ordinal_WS2_32.dll_18'

I also noticed there is another (perhaps more general) script to rename the Ordinal called Ordinals to Names.py. Running this results in the following error:

Selection: 100163c4 - 10016400
Loading symbols for WS2_32.dll
Unhandled Exception in Ordinals to Names
Traceback (most recent call last): File "Ordinals to Names", line 99, in File "Ordinals to Names", line 70, in main File "Ordinals to Names", line 40, in get_symbols File "/usr/lib/python2.7/posixpath.py", line 70, in join elif path == '' or path.endswith('/'): AttributeError: 'NoneType' object has no attribute 'endswith'

Running at the main disassembly

10001757 call dword [imp_ordinal_WS2_32.dll_52] ; DATA XREF=sub_100016d0+856'

Running WS2_32 Ordinals to Names.py does not name the script, but does not rename the ordinals either:

Renaming in range 0x10001757L to 0x1000175dL
Address: 268441431
Address: 268441435

Running Ordinals to Names.py does not name the script, but does not rename the ordinals either:

Selection: 10001757 - 1000175d
Unhandled Exception in Ordinals to Names
Traceback (most recent call last): File "Ordinals to Names", line 99, in File "Ordinals to Names", line 67, in main File "Ordinals to Names", line 19, in find_import_before File "Ordinals to Names", line 29, in get_import_at AttributeError: 'NoneType' object has no attribute 'startswith'

Hopper crashes when running any script

When I try to run a script in Hopper, it crashes:

1. Read TextEdit.app executable
2. Run any script, eg. ("Add CFString Inline Comments", "Address To Clipboard")
3. Hopper crashes completely

Here are three different crash logs, where this happens:
https://www.filepicker.io/api/file/jSIcEzCcSLC5RsU3A2Xt
https://www.filepicker.io/api/file/gcM80wGWT6GHjQU4jhY7
https://www.filepicker.io/api/file/lPKnlJ5ATTSPqtaO0tu0

---

I know this is probably a bug in Hopper, not in the scripts, but you have not answered my emails for over a month.

Could you please create an official place to submit feature requests and bug reports to Hopper, such as an empty GitHub repo with only issues?

求Hopper Disassembler的破解版

The automatic installation script does not work on High Sierra

It seems that the automatic installation script has trouble running on macOS 10.13 due to the lack of tempfile. It can be run by using mktemp instead.

doc.askFile() not documented in Script Reference

https://github.com/phracker/HopperScripts/wiki/Hopper-Script-Reference

ask() is documented. askFile() is used in Annotation Export.py and Annotation Import.py but not documented.

(I tried to edit the wiki but I see an ugly mash of   and non-intuitive <span> classes yet these don't appear in the rendered page?).

How to use scripts ?

Hello everyone, I'm a beginner at Hopper, can you write instructions on how to install scripts and how to use them ?