{"id":15134555,"url":"https://github.com/weisj/darklaf","last_synced_at":"2025-05-14T09:13:25.578Z","repository":{"id":37896350,"uuid":"207628269","full_name":"weisJ/darklaf","owner":"weisJ","description":"Darklaf - A themeable swing Look and Feel based on Darcula-Laf","archived":false,"fork":false,"pushed_at":"2025-03-08T22:56:56.000Z","size":33019,"stargazers_count":450,"open_issues_count":27,"forks_count":41,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-14T09:12:37.109Z","etag":null,"topics":["darcula","darcula-theme","feel","gui","hacktoberfest","intellij","intellij-theme","laf","look","lookandfeel","native","solarized","solarized-dark-theme","solarized-light-theme","svg","swing","theme","themes"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/weisJ.png","metadata":{"files":{"readme":"README.md","changelog":"change_notes.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-09-10T18:00:09.000Z","updated_at":"2025-04-30T00:47:24.000Z","dependencies_parsed_at":"2024-07-18T00:35:14.919Z","dependency_job_id":"dab87256-7206-4fae-97b0-a84d6092008f","html_url":"https://github.com/weisJ/darklaf","commit_stats":{"total_commits":2148,"total_committers":15,"mean_commits":143.2,"dds":0.3929236499068901,"last_synced_commit":"a3ae840d42949f47eb90006eda09e6503c97ebf1"},"previous_names":[],"tags_count":120,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weisJ%2Fdarklaf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weisJ%2Fdarklaf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weisJ%2Fdarklaf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/weisJ%2Fdarklaf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/weisJ","download_url":"https://codeload.github.com/weisJ/darklaf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254110448,"owners_count":22016392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["darcula","darcula-theme","feel","gui","hacktoberfest","intellij","intellij-theme","laf","look","lookandfeel","native","solarized","solarized-dark-theme","solarized-light-theme","svg","swing","theme","themes"],"created_at":"2024-09-26T05:22:52.104Z","updated_at":"2025-05-14T09:13:25.555Z","avatar_url":"https://github.com/weisJ.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Darklaf -  A themeable swing Look and Feel\n\n[![CI Status](https://github.com/weisJ/darklaf/workflows/CI/badge.svg?branch=master)](https://github.com/weisJ/darklaf/actions?query=workflow%3ACI)\n[![Native Libraries](https://github.com/weisJ/darklaf/workflows/Build%20Native%20Libraries/badge.svg)](https://github.com/weisJ/darklaf/actions?query=workflow%3A%22Build+Native+Libraries%22)\n[![Code Style](https://github.com/weisJ/darklaf/workflows/Spotless/badge.svg)](https://github.com/weisJ/darklaf/actions?query=workflow%3ASpotless)\n[![Maven Central](https://img.shields.io/maven-central/v/com.github.weisj/darklaf-core?label=Maven%20Central)](https://search.maven.org/artifact/com.github.weisj/darklaf-core)\n\nThis project is based on the [darcula](https://github.com/bulenkov/Darcula) look and feel for Swing.\n\n# Screenshots\n|   |   |\n|:-:|:-:|\n|![IntelliJ](https://github.com/weisJ/darklaf/blob/master/img/file_chooser/intellij.png)|![Darcula](https://github.com/weisJ/darklaf/blob/master/img/file_chooser/darcula.png)|\n|![Solarized Light](https://github.com/weisJ/darklaf/blob/master/img/file_chooser/solatized_light.png)|![Solarized Dark](https://github.com/weisJ/darklaf/blob/master/img/file_chooser/solarized_dark.png)|\n|![High Contrast Light](https://github.com/weisJ/darklaf/blob/master/img/file_chooser/high_constrast_light.png)|![High Contrast Dark](https://github.com/weisJ/darklaf/blob/master/img/file_chooser/high_constrast_dark.png)|\n\n# Usage \u0026 [Features](https://github.com/weisJ/darklaf/wiki#features)\nA list of all features can be found [here](https://github.com/weisJ/darklaf/wiki#features).\nThe LaF is compatible with Java \u003e=1.8 (you need \u003e=1.9 to get proper scaling).\n\nYou can find all property values on [weisj.github.io/darklaf-docs](https://weisj.github.io/darklaf-docs/)\n\nThis project is available on Maven Central:\n### Maven\n````xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.github.weisj\u003c/groupId\u003e\n  \u003cartifactId\u003edarklaf-core\u003c/artifactId\u003e\n  \u003cversion\u003e3.0.2\u003c/version\u003e\n\u003c/dependency\u003e\n````\n### Gradle\n````kotlin\nimplementation(\"com.github.weisj:darklaf-core:3.0.2\")\n````\n\nYou can also use the latest nightly build.\n````kotlin\nrepositories {\n    maven {\n        url = uri(\"https://oss.sonatype.org/content/repositories/snapshots/\")\n    }\n}\n\nconfigurations.all {\n    resolutionStrategy.cacheChangingModulesFor(0, \"seconds\")\n}\n\ndependencies {\n    implementation(\"com.github.weisj:darklaf-core:latest.integration\")\n}\n````\n\n## Installation\nThe LookAndFeel can be easily installed using the `LafManager`\n````java\n// For default theme (IntelliJ)\nLafManager.install();\n````\n````java\n// Specify explicit theme.\nLafManager.setTheme(new IntelliJTheme());\nLafManager.install();\n````\n````java\n// Directly install theme\nLafManager.install(new DarculaTheme());\n````\n\nFor more information see the [wiki](https://github.com/weisJ/darklaf/wiki/LafManager#setting-the-theme).\n\n**Note**: The recommended method is using the `LafManager` as it automatically handles reloading the ui.\n\n### Choosing a theme\nIt is highly encouraged to provide users more than one theme. Forcing users to use a light/dark theme because of personal preferences might be degrading their experience in certain situations.\nFor the visually impaired darklaf provides a set of high contrast themes, `HighContrastThemeLight` and `HighContrastThemeDark`.\n\nDarklaf supports detecting the system theme on macOS and Windows with the ability to automatically change the theme if the settings change.\n\n````java\n// This returns the preferred theme of the system settings.\nLafManager.themeForPreferredStyle(getPreferredThemeStyle());\n````\n\nThe following settings are picked up by darklaf:\n\n| Windows                   | macOS                   | Setting             |\n|:-------------------------:|:-----------------------:|:--------------------|\n| :ballot_box_with_check:   | :ballot_box_with_check: | Light/Dark mode     |\n| :ballot_box_with_check:   | :ballot_box_with_check: | High contrast mode  |\n| :ballot_box_with_check:   | :ballot_box_with_check: | Accent color        |\n|                           | :ballot_box_with_check: | Selection color     |\n| :ballot_box_with_check:   |                         | Font size           |\n\nYou can use the `ThemeSettings` class with `ThemeSettings#showSettingsDialog` or `ThemeSettings#getSettingsPanel` to provide the user\nthe most possible customization.\n\n## Example\n````java\nimport com.github.weisj.darklaf.LafManager;\nimport javax.swing.*;\nimport java.awt.*;\n\npublic class DarklafDemo {\n\n    public static void main(final String[] args) {\n         SwingUtilities.invokeLater(() -\u003e {\n            LafManager.install();\n\n            JFrame frame = new JFrame(\"Darklaf - A themeable LaF for Swing\");\n            frame.setSize(600, 400);\n\n            JButton button = new JButton(\"Click here!\");\n\n            JPanel content = new JPanel();\n            content.add(button);\n\n            frame.setLocationRelativeTo(null);\n            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);\n            frame.setContentPane(content);\n            frame.setVisible(true);\n        });\n    }\n}\n````\n\nAll custom component-variants and settings can be enabled by setting the appropriate client\nproperty of the component.\nThey can be found [here](https://github.com/weisJ/darklaf/wiki/Features#alternative-visualsbehaviour-for-components).\n\nThis 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.\n\n## Extensions\nCheck out the [darklaf-extension project](https://github.com/weisJ/darklaf-extensions) for additional artifacts which add\nsupport for some third-party projects.\n\n# Build\n\n    ./gradlew build\n\nWhen building on Windows, you need a C++ toolchain installed to build native extension.\n\nWhen building on macOS you need to have XCode (or the command line tools) installed to build the native extension.\n\nIf you want to build for platforms different from your machine the necessary binaries are automatically downloaded.\nFor this you have to specify a valid GithubAccessToken using `githubAccessToken` property in your local `gradle.properties` file.\nThe access token only needs to have the permission to read repositories.\n\nYou can also manually download the respective native libraries\nfrom the latest successful run of the [Build Native Libraries Action](https://github.com/weisJ/darklaf/actions?query=workflow%3A%22Build+Native+Libraries%22+branch%3Amaster) and place it in the corresponding `\u003cvariant\u003e/libraries` folder.\nThis is necessary if you don't have the appropriate toolchain installed, but you machine is a binary target.\n\n**Note**: You can still build the project without the libraries, but then custom decorations won't be supported.\n\n# Contribute\nHere 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:\n\n- [Native window decorations on Linux.](https://github.com/weisJ/darklaf/issues/2)\n  * See [/windows](https://github.com/weisJ/darklaf/tree/master/windows) for the Windows implementation.\n  * See [/macos](https://github.com/weisJ/darklaf/tree/master/macos) for the macOS implementation.\n- Localization:\n  * Theme preferences panel. [here](https://github.com/weisJ/darklaf/blob/master/core/src/main/resources/com/github/weisj/darklaf/task/theme_settings.properties)\n\n# Artifacts\n- Group ID: `com.github.weisj`\n- Version: `3.0.2`\n- Artifact IDs:\n  - `darklaf-core` The LaF itself. Include this in your project to use the LaF. Includes all other artifacts.\n  - `darklaf-iconset` The icons used by the laf.\n  - `darklaf-theme` The themes to use with the LaF.\n  - `darklaf-theme-spec` Relevant classes needed to implement a custom theme.\n  - `darklaf-property-loader` Library to load and parse property files and icon.\n  - `darklaf-utils` Shared utility classes for other modules.\n  - `darklaf-native-utils` Loading of native libraries.\n  - `darklaf-platform-base` Common classes for the platform modules.\n  - `darklaf-platform-decorations` Standalone module to provide custom window decorations on macOS and Windows.\n  - `darklaf-platform-preferences` Standalone module to access and listen to changes to the system theme.\n  - `darklaf-windows` Code specific to Windows.\n  - `darklaf-macos` Code specific to macOS.\n  - `darklaf-compatiblity` Don't use this. It's only meant to encapsulate code not portable across JVM versions.\n\n\n# Projects using Darklaf\n\n- [JMeter](https://github.com/apache/jmeter)\n- [Litiengine](https://github.com/gurkenlabs/litiengine)\n- [BoofVC](https://github.com/lessthanoptimal/BoofCV)\n- [threadtear](https://github.com/GraxCode/threadtear)\n- [HO](https://github.com/akasolace/HO)\n- [Bytecode viewer](https://github.com/Konloch/bytecode-viewer)\n- [Remote Hacker Probe](https://github.com/quantumcore/remote_hacker_probe)\n- [OpenRocket](https://github.com/openrocket/openrocket)\n\nPlease send me your project, and I'll add it here.\n\n# License\nThis project is licensed under the [MIT license](https://github.com/weisJ/darklaf/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweisj%2Fdarklaf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweisj%2Fdarklaf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweisj%2Fdarklaf/lists"}