[!WARNING] If you got here "automagically" when trying to run nfc4pc, you DO NOT have the right Java runtime.

nfc4pc desktop integration

You need to have a JDK17+ with JavaFX for the desktop integration to work. If you tried to run nfc --desktop and it threw an exception (or opened this website), you were not using Java with JavaFX included.

FXTrayIcon by @dustinkredmond (MIT License) is used for showing the nice tray icon.

Java 17+ with JavaFX support

Recommended (read: the only one tested) Java for Desktop is Zulu JDK/JRE, FX variant. Please download it from azul.com (the link should lead you to a pre-filled download page, with the right version selected. Just select your platform and architecture).

[!IMPORTANT] Once installed, make sure you either set your $JAVA_HOME properly to that JDK or use the full path to java in your commands or aliases.

[!TIP] On macOS, setting $JAVA_LAUNCHER_VERBOSE to true in your environment (export JAVA_LAUNCHER_VERBOSE=true) helps to debug java launcher and $JAVA_HOME usage.