Aira Force FAQ
==============

Q. Why is it called "Aira Force"?

It uses the fantastic text-driven Amiga [ira](https://aminet.net/package/dev/asm/ira) "reassembler" but adds a convenient GUI using [Dear ImGui](https://github.com/ocornut/imgui) to reduce iteration time when reverse engineering. So this is the Advanced Interactive ReAssembler. Aira Force is beautiful place in the English Lake District. One of the few places I've ever seen a red squirrel. It also has a great waterfall.  

Q. What is ira?

ira is a portable Motorola 680x0 reassembler that is available on Aminet. 

https://aminet.net/package/dev/asm/ira

It disassembles both hunky Amiga Modules (Load Modules and Object Modules) as well as raw binaries. The disassembly is designed to be immediately reassemblable with the vasm assembler.

http://sun.hasenbraten.de/vasm/


Q. What is Aira Force?

A graphical user interface interactive disassembler built from ira + SDL2 + dear imgui


Q. Why would I want to use this tool?

This tool is useful for reverse engineering Amiga software for which no source code is available. It can be great fun to learn how classic games were put together.


Q. Does it run on Windows?

Yes. Windows is my primary development platform.


Q. Does it run on Linux?

Yes. The source code can be built using GCC or Clang. Archive and Debian packages are available.


Q. Does it run on Mac?

Yes. The source code can be built using Clang on Mac and a package (application bundle) is available.


Q. Does it run on Amiga?

Sadly not. The tool is built on SDL2 and imgui, which are not available on Amiga. Please tell me if I am mistaken!


Q. Can I see the source code?

The source code will be made available on GitHub soon.


Q. Can I contribute?

There is still some groundwork to do before the codebase is suitable for collaborations.


Q. Why does the UI look a bit blurry on my machine?

It shouldn't but I've seen this too, on Mac especially. I think I've configured SDL2 and dear Imgui correctly, but I may have made a mistake.


Q. Does it support other processors?

No - it only supports the Motorola 680x0 CPUs.


Q. Can I use the keyboard instead of the mouse?

Yes. Most common commands are available from the main menu, and most are annotated with their keyboard shortcut.


Q. Is this a bit like ReSource?

I think so, but I haven't really used ReSource much - I keep meaning to give it a good go. 


Q. Is there a getting started guide?

I will try to write one!


Q. What can I do to reduce iteration time?

Disable reassembly from the main menu.
