darklaf/README.md

Darklaf - A Darcula Look and Feel

This project is based on the darcula look and feel for Swing.

Screenshots

Darcula Theme	IntelliJ Theme

Solarized Dark Theme	Solarized Light Theme

Usage & Features

A list of all features can be found here. The LaF is compatible with Java >=1.8 (you need >=1.9 to get proper scaling). This project is available on Maven Central:

Maven

<dependency>
  <groupId>com.github.weisj</groupId>
  <artifactId>darklaf-core</artifactId>
  <version>[1.4.2.0,)</version>
</dependency>

Gradle

implementation 'com.github.weisj:darklaf-core:[1.4.2.0,)'

Installation

The LookAndFeel can be easily installed using the 'LafManager'

LafManager.install(); //For default theme (IntelliJ)
LafManager.install(new DarculaTheme()); //Specify the used theme.

or by using the UIManager

LafManager.setTheme(new DarculaTheme());
UIManager.setLookAndFeel(DarkLaf.class.getCanonicalName());

Example

import com.github.weisj.darklaf.LafManager;
import javax.swing.*;
import java.awt.*;

public class DarklafDemo {

    public static void main(final String[] args) {
         SwingUtilities.invokeLater(() -> {
            LafManager.install();

            JFrame frame = new JFrame("Darklaf - A themeable LaF for Swing");
            frame.setSize(600, 400);

            JButton button = new JButton("Click here!");

            JPanel content = new JPanel();
            content.add(button);

            frame.setLocationRelativeTo(null);
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setContentPane(content);
            frame.setVisible(true);
        });
    }
}

All custom component-variants and settings can be enabled by setting the appropriate client property of the component. They can be found here.

This LookAndFeel supports custom window decorations (only on Windows at this point). In contrast to most other LaFs the native window behaviour is not compromised giving a seamless experience that still looks native.

Build

./gradlew build

When building on Windows, you need a C++ toolchain installed to build native extension.

If you wan't to build for platforms different than your machine you can download the respective native libraries from the latest run of the Build Native Libraries Action and place it in the corresponding <variant>/libraries folder. Further details can be found in the respective library.md file. The libraries are then automatically included in the jar when building the project. When building the project there will be a message for every library that needs to be manually included.

Note: You can still build the project without the libraries, but then custom decorations won't be supported.

Contribute

Here is a list of things that currently are not finished or need refinement. This list is a work in progress and being updated regulary. If you find any problems with the LaF feel free to submit an issue:

• Native window decorations on Linux and MacOS.
  • See /windows for the windows implementation.
• Adjustment of platform specific properties
  • See the properties folder especially the platform folder.
• Create missing demo classes. (See Todo's in test/ui/)

Artifacts

• Group ID: com.github.weisj
• Version: 1.4.2.0
• Artifact IDs:
  • darklaf-core The LaF itself. Include this in your project to use the LaF. Includes all other artifacts.
  • darklaf-property-loader Library to load and parse property files and icon.
  • darklaf-utils Shared utility classes for other modules.
  • darklaf-decorations-base Common classes for the decorations modules.
  • darklaf-native-utils Loading of native libraries.
  • darklaf-windows Code specific to window decorations on windows.
  • darklaf-macos Code specific to window decorations on macOS.

License

This project is licensed under the MIT license.