ResForge

ResForge is a resource editor for macOS, capable of editing classic resource fork files and related formats. Based on ResKnife by Nicholas Shanks and Uli Kusterer, this derivative of the project has been rewritten for modern macOS systems.

Features

• Hexadecimal editor, powered by HexFiend.
• Template editor, supporting a wide array of field types.
• Template-driven bulk data view, with CSV import/export.
• Image editor, supporting 'PICT', 'PNG ', 'PNGf', 'cicn' & 'ppat' resources, plus view-only support for a variety of icons and other bitmaps.
• Sound editor, supporting sampled 'snd ' resources.
• Dialog editor, supporting 'DITL' resources (by Uli Kusterer)
• Menu editor, supporting 'MENU', 'CMNU' & 'cmnu' resources (by Uli Kusterer)
• Tools for EV Nova, including a sprite (rlëD) editor, a ship animation (shän) editor and a galaxy viewer.

Supported File Formats

• Macintosh resource format, in either resource fork or data fork.
• Rez format, used by EV Nova.
• Extended resource format, defined by Graphite.
• MacBinary encoded resource fork.
• AppleSingle/AppleDouble encoded resource fork.

Getting Started

System Requirements

ResForge is compatible with macOS 10.15 or later and runs natively on both 64-bit Intel and Apple Silicon.

Installation

Download the latest version of ResForge from the Releases page.

Building

To build ResForge yourself you will need to have Xcode 14.1 or later installed.

Make sure to use the --recurse-submodules option when cloning the repository, or use git submodule update --init to initialise an existing copy.

Plug-ins

ResForge includes a plug-in architecture, allowing custom editors to be created and distributed independently of the application itself. The specification is not currently documented but feel free to duplicate an existing plug-in, such as the hex editor, and work from there to create your own.

Built With

• Graphite - Provides reading/writing of 'PICT', 'cicn' and 'ppat' resources.
• HexFiend - Powers the hexadecimal editor.
• CSV.swift - Provides reading/writing of CSV files.
• swift-parsing - Provides parsing of custom DSLs.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.