Skip to content

How to rebrand the app

Simone Martorelli edited this page Jun 18, 2025 · 7 revisions

1. Changing the application name and bundle identifier

  1. To change application name open the project in Xcode, in Project Navigator select "migrator" and double click on the target name (nr. 1 on picture above).
  2. Then change bundle identifier (nr. 2 on picture above). Do not just leave the default bundle ID.

2. Changing org name reference in AppContext.swift class

This is the organisation/team name used in some of the app dialogs. Customise it replacing <Organization Name> string with you org/team name. For example static let orgName: String = "Mac@IBM".
Also Available as Custom Settings deployable through a Configuration Profile.

3. Changing service name reference in AppContext.swift class

This is the name of the service advertised by bonjour. Customise it replacing <Service Identifier> string with something like _migrator_ibm. We suggest to include your company name in it. Do not add spaces or special characters except _. Remember to change the Bonjour services entry in the project Info panel to match your new service identifier, leaving the ._tcp ending as it is.
Also Available as Custom Settings deployable through a Configuration Profile.

4. Changing application icons

There are two kinds of icons in this application. App icons - used as an application icons by macOS, and icon used as an icon on the different pages.
To change the App Icon, in Project Navigator select and right click folder Shared/Resources -> Assets.xcassets. Choose option Show in Finder as per screenshot below

Inside Finder you will see all the icons used by the app.

  1. To change app icon, replace all PNG files inside AppIcon.appiconset folder, with your custom icon files. The file names and resolution must be exactly same as the original files. For example file [email protected] must be named [email protected] and must have resolution 32x32 pixels.
  1. To change the default pop-up icon, in Project Navigator select migrator -> Assets.xcassets, select icon asset and replace the file inside with a simple drag and drop of the new one. For best result we recommend using a .pdf file.