Submin

Maven Central

statement

Submin is a pair of skins (one dark, one light) based on the Web Look-and-FeeL for the Swing toolkit. It is (C)opyright 2012–2026 by Hanns Holger Rutz. All rights reserved. Submin is released under the GNU General Public License v3+ and comes with absolutely no warranties. To contact the author, send an e-mail to contact at sciss.de.

Please note that Web-LaF is made available both under GNU GPL and a commercial license. However, this is a derivative project licensed under GNU GPL. If you own a commercial license for Web-LaF, this does not expand to Submin which is an independently maintained library. If you cannot license your work that links to Submin under a GPL and own a commercial Web-LaF license, you may get in touch to discuss opportunities of obtaining a commercial license for Submin as well.

icons

linking

The following artifact will be available from Maven Central:

"de.sciss" % "submin" % v

The current version v is "1.0.0".

using

The look-and-feel class name is de.sciss.submin.SubminLookAndFeel, which provides a name "Submin" and an id "submin".

Installing this look-and-feel is as simple as the following one line call:

import de.sciss.submin.Submin
Submin.install(true) // dark-skin

The boolean argument is true for the dark skin and false for the light skin.

Starting with JDK 11, one has to add JVM runtime switches --add-opens=...=ALL-UNNAMED for a number of packages (see openJavaOptions in build.sbt), because of reflective access by the xstream library used by web-laf.

building

Submin builds with sbt. It is written in Java and should run on a Java 8 runtime or newer.

running

Run a demo with

sbt "test:run --dark"

To test the improved file-chooser

sbt "test:runMain de.sciss.submin.FileChooserTest"

extensions

Except for the customised look, this library provides the following changes

• FileChooserUI: under Linux/Gnome we populate the file tree with the Gnome favourites as per ~/.config/gtk-3.0/bookmarks. To support other window managers and other operating systems, we require your help. If you can provide information on how to obtain favourites e.g. under KDE, on OS X, or Windows, please let me know.
• style icon-space for buttons and toggle-buttons
• style noshade for labels

to-do

• tri-state-checkbox: label color does not checked when disabled (bug?)
• file-chooser: tool icon color
• split-divider: arrow colors
• path-field: arrow color
• spinner: arrow icons color
• combo-box: arrow icon color
• text-area: background not dimmed when disabled
• table: sorting-arrow color

contributing

Please see the file CONTRIBUTING.md