Skip to content
Branch: master
Find file Copy path
Find file Copy path
1 contributor

Users who have contributed to this file

24 lines (16 sloc) 1.63 KB

Binary Templates Tutorial

Binary Templates are a new feature in Hex Fiend 2.9 that allow you to visualize the structure of a binary file. They are implemented in Tcl since this language is easy to embed, easy to write, has a ton of features, and already ships with macOS.

Getting Started

  1. Open a file in Hex Fiend
  2. Select from the Views menu Binary Templates
  3. On the right-side of the window the template view will show. Here you can select a template from the templates folder. Templates are stored at ~/Library/Application Support/com.ridiculousfish.HexFiend/Templates. Each template must have the .tcl file extension.

Writing your First Template

Now that you're familiar with the templates user interface, let's write your first template. As stated before, templates are written using Tcl. If you're already familiar with a programming language, scan through the tutorial to get a feel for the language.

  1. With your favorite text editor, create a new file and save it to ~/Library/Application Support/com.ridiculousfish.HexFiend/Templates/First.tcl.
  2. Enter the code below and save:
uint32 "UInt32"
  1. Go back to Hex Fiend and select Refresh from the Templates drop-down. You should see your template listed as First if everything was correct so far.
  2. Open any file and change the selection cursor to new locations. You'll see the "UInt32" field update.

Congrats, you've written the most basic and simplest template that actually does something! Visit the reference for details on other commands available.

You can’t perform that action at this time.