Swiftpack.co - Package - milend/hmap

What is this?

hmap is a command line tool to work with Clang header maps produced by Xcode. It is written in Swift.

How to Get

  • Homebrew: brew install milend/taps/hmap
  • Grab a release from GitHub.
  • Build from source. See instructions below.

How to Use

To print the contents of a header map:

hmap print ~/path/to/header_map.hmap

To convert the contents of a binary header map to JSON:

hmap convert ~/header_map.hmap ~/header_map.json

hmap deduces file formats by looking at the file extensions of the paths.

You can also use the convert command to create a binary header map from JSON:

hmap convert ~/header_map.json ~/header_map.hmap

You can discover all the commands and options by using hmap --help.


  • hmap requires Swift 5.
  • Starting from Xcode 10.2, Swift 5 command line tools require the Swift 5 runtime libraries which are included in macOS Majave 10.4.4. If you're running an earlier version of macOS, you need to install the Swift 5 Runtime Support for Command Line Tools.

Building from Source


Before building with Xcode, you must download all dependencies by running:

swift package update

Then generate an Xcode project by running:

swift package generate-xcodeproj

Swift Package Manager

If you would like to build from the command line, run:

swift build

To produce a release build suitable for distribution, run:

swift build -c release

To verify that all tests pass, run:

swift test


Stars: 45
Help us keep the lights on


Used By

Total: 0


1.0.4 - Jul 27, 2019

Version 1.0.4

  • Switch to Swift 5

1.0.3 - Dec 31, 2018

Version 1.0.3

  • Adds ability to print multiple files.
  • Updated to Swift 4.

1.0.2 - Aug 22, 2017

1.0.1 - Aug 21, 2017

1.0 - Aug 20, 2017