A cross-platform build system for creating iOS, macOS, Linux, and Windows programs.

Logos: Hook Splitting

By default, the Logos pre-processor will only process one .xm file at build time. However, it is possible to split the Logos hooking code into multiple files.

To do this, the main file has to be renamed to an .xmi file. Then, other .xm files can be included in it using the #include or #import directives. The Logos pre-processor will add those files to the main file before processing it.

Note that the .xmi file should be listed in XXX_FILES in the makefile while .xm files that are included/imported should not.


Normally, it isn’t possible to initialize a %group across multiple Logos files, but there is a workaround that can be used to unlock this functionality. This is done by wrapping group initializations inside of static methods that can then be called from other files.

Take a look at the following code. All it does is log a message when the SpringBoard application has finished launching. It is inside of a group called TweakGroup, which is initialized in a static function called InitGroup().

// Group.xm
#import "Shared.h"

%group TweakGroup
%hook SpringBoard

- (void)applicationDidFinishLaunching:(id)arg1 {
    NSLog(@"[Group Test] SpringBoard has finished launching");


extern "C" void InitGroup() {

As you may have noticed, there is an import for Shared.h at the top of Group.xm. That is simply a header file that will be imported into our main Logos file so that we may call the function there:

// Shared.h
#import <Foundation/NSObjCRuntime.h>

extern "C" void InitGroup();

Finally, Shared.h can be imported into the Logos file that contains your constructor. Calling the static function will initialize the group from Group.xm and run its hooks:

// Tweak.xm
#import "Shared.h"

%ctor {
	NSLog(@"[Group Test] Our hook for SpringBoard should show up below this");

If done correctly and compiled without errors, this could should log two messages: one from the constructor and the other one from the method inside the group. Keep in mind that this doesn’t apply to hooks that aren’t inside of a group.

A few things to note:

  • This will also work in normal C, in which case you would use .x files for your groups and constructor and remove the extern "C" references.
  • You have to pay attention to how many times you call the initialization as Logos will no longer tell you if it is called more than once.