Skip to content
Patrice LECUYER edited this page Jul 30, 2026 · 1 revision

FAQ & Troubleshooting

The Windows installer says "unknown publisher" / SmartScreen blocks it

The installer is not code-signed, so Windows SmartScreen shows "Windows protected your PC". Click More info → Run anyway. This is expected for unsigned installers; the app is safe. A signed build would remove the warning.

I ticked "desktop icon" but it didn't appear

The shortcut is created — Windows Explorer sometimes doesn't repaint the desktop immediately. Press F5 on the desktop (or sign out and back in) and it appears. The installer places it on the all-users desktop.

Where are my settings stored?

In portable mode, next to the executable; when installed, in %APPDATA%\XIMOD Architect (Windows), ~/.config/XIMOD Architect (Linux) or ~/Library/Application Support/XIMOD Architect (macOS). See Configuration.

The up/down arrows don't select the next item

They are reorder buttons, not navigation — they move the selected step/group/plugin to a new position (the order matters in a FOMOD). To select a different item, click it in the list. See User Interface.

Some characters show as empty squares

That means a glyph is missing from the current font. XIMOD bundles Noto fonts for every writing system and loads them on demand; if you see boxes, make sure the assets/fonts folder shipped alongside the executable.

Linux: the app won't start / missing libraries

Install the runtime dependencies with packaging/linux/build-deps.sh (Debian/Ubuntu, Fedora, Arch). See Building from Source.

macOS: "cannot be opened because the developer cannot be verified"

Release builds are signed ad-hoc (not notarized). Right-click the app → Open, then confirm, to allow it the first time.

Can I use it without a GUI?

Yes — see Command Line for validate / build / package.

Clone this wiki locally