Cross-platform SystemTray support for Swing/AWT, GtkStatusIcon, and AppIndicator on Java 8+
Go to file
2014-11-03 02:11:35 +01:00
src/dorkbox/util/tray Initial commit of project 2014-11-03 02:11:03 +01:00
.classpath Initial commit of project 2014-11-03 02:11:03 +01:00
.gitignore Initial commit of project 2014-11-03 02:11:03 +01:00
.project Initial commit of project 2014-11-03 02:11:03 +01:00
LICENSE Added License 2014-11-03 02:10:04 +01:00
README.md Added Readme 2014-11-03 02:10:18 +01:00

SystemTray

Cross-platform SystemTray and AppIndicator support for java applications.

This small library only purpose is to show reasonably decent system-tray icons/app-indicators with a simple popup-menu.

There are a number of problems on Linux with the Swing (and SWT) system-tray icons, namely that

  1. Swing system-tray icons on linux do not support transparent backgrounds (they have a white background)
  2. Swing/SWT do not support app-indicators, which are necessary on more recent versions of linux (ie: ubuntu)
  3. Swing popup menus look like crap
  • system-tray icons use a JMenuPopup, which looks nicer than the java 'regular' one.
  • app-indicators use native popups.

This is for cross-platform use, specifically - linux 32/64, mac 32/64, and windows 32/64. Java 6+ This library uses JNA, which means there are fun bits that are native.

Note: This library does NOT uses SWT for system-tray support, only for the purpose
      of lessening the jar dependencies. SWT-based wouldn't be difficult, just remember
      that SWT on linux *already* starts up the GTK main event loop.

      This library might need some additional testing in SWT environments.
Note: If you use the attached JNA libraries, you **MUST** load the respective
      native libraries yourself, especially with JNA (as the loading logic has
      been removed from the jar)
Note: This project was heavily influence by the excellent Lantern project,
      *Many* thanks to them for figuring out AppIndicators via JNA.
      https://github.com/getlantern/lantern
* Lantern - Apache 2.0 License
  https://github.com/getlantern/lantern
  Copyright 2010 Brave New Software Project, Inc.

* JNA - Apache 2.0 License
  https://github.com/twall/jna
  Copyright (c) 2011 Timothy Wall