Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/milchreis/uibooster
ð Creates fast and easy dialogs for utility tools
https://github.com/milchreis/uibooster
cli confirmation-dialog dark-theme dialog easy-dialogs fast form gui java login login-dialog progress-dialog selection-dialog swing table table-dialog ui utility
Last synced: 5 days ago
JSON representation
ð Creates fast and easy dialogs for utility tools
- Host: GitHub
- URL: https://github.com/milchreis/uibooster
- Owner: Milchreis
- License: gpl-3.0
- Created: 2019-08-20T20:15:02.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-12-29T23:43:43.000Z (about 1 month ago)
- Last Synced: 2025-01-20T17:13:49.878Z (13 days ago)
- Topics: cli, confirmation-dialog, dark-theme, dialog, easy-dialogs, fast, form, gui, java, login, login-dialog, progress-dialog, selection-dialog, swing, table, table-dialog, ui, utility
- Language: Java
- Homepage:
- Size: 1.31 MB
- Stars: 116
- Watchers: 4
- Forks: 12
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://jitpack.io/#Milchreis/UiBooster)
[](https://github.com/Milchreis/UiBooster/blob/master/LICENSE)
[](https://snyk.io/test/github/Milchreis/UiBooster)
[](https://ko-fi.com/milchreis)
UiBooster is a lean library to create fast and easy dialogs for utility tools. It equips your applications blazing
fast with GUI components to increase the comfort for your users.
It's based on Java swing components to run on current JREs without any struggle. This library encapsulates the long and
sometimes complicated GUI code and leaves more clarity in your project.
I decided to create this project, because I missed something like [zenity](https://de.wikipedia.org/wiki/Zenity)
for my Java applications.
If you like this project, and you want to keep me awake ðĪŠ, please:
## Components
- [Information dialogs](#information-dialogs)
- [Text input dialog](#text-input-dialog)
- [Confirmation dialog](#confirmation-dialog)
- [Password input dialog](#password-input-dialog)
- [Selection dialog](#selection-dialog)
- [Multiple selection dialog](#multiple-selection-dialog)
- [Slider dialog](#slider-dialog)
- [Colorpicker](#colorpicker)
- [FontChooser](#font-chooser)
- [Datepicker](#datepicker)
- [File and directory selection dialogs](#file-and-directory-selection-dialogs)
- [Text area dialog](#text-area-dialog)
- [HTML text dialog](#html-text-dialog)
- [Exception dialog](#exception-dialog)
- [List dialog](#list-dialog)
- [Login dialog](#login-dialog)
- [Waiting dialog](#waiting-dialog)
- [Progress dialog](#progress-dialog)
- [Table dialog](#table-dialog)
- [Gallery dialog](#gallery-dialog)
- [Form dialog](#form-dialog)
- [Splash screen](#splash-screen)
- [System tray menu](#system-tray)
- [Notification](#notification)
### Information dialogs
```java
new UiBooster().showInfoDialog("UiBooster is a lean library to ....");
```
```java
new UiBooster().showWarningDialog("Your computer has a low battery ....", "WARN");
```
```java
new UiBooster().showErrorDialog("The connection to SQL database is failed.", "ERROR");
```
### Text input dialog
```java
String opinion = new UiBooster().showTextInputDialog("What do you think?");
```
### Confirmation dialog
```java
new UiBooster().showConfirmDialog(
"Do you really want this action?",
"Are you sure?",
() -> System.out.println("Action accepted"),
() -> System.out.println("Action declined"));
```
### Password input dialog
```java
String password = booster.showPasswordDialog("Whats your password?", "Password");
```
### Selection dialog
```java
String selection = new UiBooster().showSelectionDialog(
"What's your favorite movie?",
"Favorite Movie?",
Arrays.asList("Pulp Fiction", "Bambi", "The Godfather", "Hangover"));
```
### Multiple selection dialog
```java
List selectedElement = new UiBooster().showMultipleSelection(
"What are your favorite hobbies?",
"Your hobbies",
"Reading", "Traveling", "Fishing", "Music", "Gardening", "Sport", "Television",
"Video Games", "Crafting", "Bird Watching", "Collecting");
```
### Slider dialog
```java
Integer numberOfHotDogs = new UiBooster().showSlider("How many HotDogs do you want?", "Your order",
0, 10, 2, 5, 1);
```
### Colorpicker
```java
Color selectedColor = new UiBooster().showColorPicker("Choose your favorite color", "Color picking");
```
_library by @dheid: [colorpicker](https://github.com/dheid/colorpicker)_
### Font Chooser
```java
Font selectedFont = new UiBooster().showFontChooser("Choose your favorite font", "Font choosing");
```
_library by @dheid: [fontchooser](https://github.com/dheid/fontchooser)_
### Datepicker
```java
Date birthday = new UiBooster().showDatePicker("What's your birthday?", "Birthday");
```
### File and directory selection dialogs
```java
UiBooster booster = new UiBooster();
File file = booster.showFileSelection();
File directory = booster.showDirectorySelection();
File fileOrDirectory = booster.showFileOrDirectorySelection();
```
### Text area dialog
```java
new UiBooster().showTextArea("Want to read some lorem ipsum?", "Message for you",
"Lorem ipsum dolor sit amet ...",
10, 40, false);
);
```
### HTML text dialog
```java
new UiBooster().showHtmlText("My menu", "Menu overview",
"
ð Menu
" +
"- " +
- ð Pizza " +
- ð Cheeseburger " +
- ðĨ Caesar-Salat " +
"
"
"
"
```
### Exception dialog
```java
new UiBooster().showException(
"An error occurred",
"Exception message",
new Exception("Something went wrong ...")
);
```
### List dialog
```java
ListElement selectedElement = new UiBooster().showList(
"Select a robot",
"Avatars from RoboHash.org",
element -> System.out.println("Selected: " + element.toString()),
new ListElement("Robo 1", "Green and strong", "src/test/resources/avatar1.png"),
new ListElement("Robo 2", "Shy without an avatar!"),
new ListElement("Robo 3", "- Crazy\n- Fast\n- Funny", "src/test/resources/avatar2.png"),
new ListElement("Robo 4", null, "src/test/resources/avatar3.png")
);
```
### Login dialog
```java
LoginCredentials credentials = new UiBooster().showLogin(
"Login",
"Internal area",
"Username",
"Password",
"Go",
"Cancel");
```
### Waiting dialog
```java
WaitingDialog dialog = new UiBooster().showWaitingDialog("Starting", "Please wait");
dialog.setMessage("Ready");
dialog.close();
```
```java
WaitingDialog dialog = new UiBooster().showWaitingDialog("Starting", "Please wait");
dialog.setMessage("Initializing");
dialog.setLargeMessage("Some more information...\nMaybe from log files or other resources. \nBe transparent to the user to understand long processes...");
dialog.close();
```
### Progress dialog
```java
ProgressDialog dialog = new UiBooster().showProgressDialog("Please wait", "Waiting", 0, 120);
dialog.setProgress(10);
// ...
dialog.setProgress(120);
dialog.setMessage("Ready");
dialog.close();
```
### Table dialog
```java
String[][] modifiedData = new UiBooster().showTable( // showTableImmutable for immutable tables
new String[][]{
{"Jimmy Johnson", "35", "Zombieland"},
{"Danny Durango", "23", "Hangover"},
{"Larry Berry", "54", ""}
},
Arrays.asList("Name", "Age", "Favorite movie"),
"Favorite movies");
```
### Gallery dialog
```java
new UiBooster().showPictures(
"My picture",
Arrays.asList(
new File("/home/nick/pictures/img-01.jpg"),
new File("/home/nick/pictures/img-02.jpg")
)
);
```
### Form dialog
```java
UiBooster booster = new UiBooster();
Form form = booster.createForm("Personal information")
.addText("Whats your first name?")
.addTextArea("Tell me something about you")
.addSelection(
"Whats your favorite movie?",
Arrays.asList("Pulp Fiction", "Bambi", "The Godfather", "Hangover"))
.addLabel("Choose an action")
.addButton("half full", () -> booster.showInfoDialog("Optimist"))
.addButton("half empty", () -> booster.showInfoDialog("Pessimist"))
.addSlider("How many liters did you drink today?", 0, 5, 1, 5, 1)
.show();
// use .run() instead of show() to open the formBuilder without blocking.
```
The form is very powerful and provides a lot of features:
* add your own elements ([Example](https://github.com/Milchreis/UiBooster/blob/master/src/test/java/de/milchreis/uibooster/CustomFormBuilderElementTest.java))
* put multiple elements in one row ([Example](https://github.com/Milchreis/UiBooster/blob/master/src/test/java/de/milchreis/uibooster/FormBuilderWithRowsTest.java#L41))
* add a listener for any changes ([Example](https://github.com/Milchreis/UiBooster/blob/master/src/test/java/de/milchreis/uibooster/FormBuilderChangeListenerTest.java#L22))
* add a listener on window close ([Example](https://github.com/Milchreis/UiBooster/blob/master/src/test/java/de/milchreis/uibooster/FormBuilderTest.java#L115))
* set window setting, f.e. size and position ([Example](https://github.com/Milchreis/UiBooster/blob/master/src/test/java/de/milchreis/uibooster/FormBuilderTest.java#L141))
* data-binding to manage inputs in form in dedicated variables ([Example](https://github.com/Milchreis/UiBooster/blob/master/src/test/java/de/milchreis/uibooster/DataBindingTest.java#L44))
### Splash screen
```java
Splashscreen splash = new UiBooster().showSplashscreen("/path/to/your/splash.png");
// do your stuff
splash.hide();
```
### System tray
```java
UiBooster booster = new UiBooster();
booster.createTrayMenu("Food", "screenshots/color.jpg")
.withPopupMenu()
.addMenu("Hotdogs", () -> booster.showInfoDialog("Sausage in a roll"))
.addMenu("Fries", () -> booster.showInfoDialog("Fried potatoes"))
.addMenu("Pizza", () -> booster.showInfoDialog("Dough with tomato sauce"));
```
### Notification
```java
new UiBooster().createNotification("It's hot and delicious", "Dinner is ready");
```
## Options
```java
UiBooster booster = new UiBooster(
UiBoosterOptions.Theme.DARK_THEME,
"/path/to/your/custom-window-icon.png"
);
```
See some examples for UiBoosterOptions [here](https://github.com/Milchreis/UiBooster/blob/master/src/test/java/de/milchreis/uibooster/UiBoosterOptionsTest.java)
### More themes powered by flatlaf
1. Add themes as maven dependency
```xml
com.formdev
flatlaf-intellij-themes
3.2.1
```
2. Create a new UiBooster with theme as UiBoosterOption
```java
UiBooster booster = new UiBooster(new UiBoosterOptions(new com.formdev.flatlaf.intellijthemes.materialthemeuilite.FlatMaterialOceanicIJTheme(), null, null));
booster.showInfoDialog("Info Message Empty Constructor");
```
[List with beautiful themes](https://github.com/JFormDesigner/FlatLaf/tree/main/flatlaf-intellij-themes#themes)
## Include to project
### Maven
If you want to use `UiBooster` than add the following to your pom.xml.
```xml
jitpack.io
https://jitpack.io
```
```xml
com.github.milchreis
uibooster
1.21.1
```
### Gradle
If you want to use `UiBooster` with gradle than add the repo, and the dependency to your root build.gradle file.
```gradle
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
```
```gradle
dependencies {
implementation 'com.github.milchreis:uibooster:1.21.1'
}
```