Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Displays a JavaFX splash page for an intensive startup task with progress monitoring
import javafx.animation.FadeTransition;
import javafx.application.Application;
import javafx.collections.*;
import javafx.concurrent.*;
import javafx.geometry.*;
import javafx.scene.Scene;
import javafx.scene.control.*;
import javafx.scene.effect.DropShadow;
import javafx.scene.image.*;
import javafx.scene.layout.*;
import javafx.scene.paint.Color;
import javafx.stage.*;
import javafx.util.Duration;
* Example of displaying a splash page for a standalone JavaFX application
public class FadeApp extends Application {
public static final String APPLICATION_ICON =
public static final String SPLASH_IMAGE =
private Pane splashLayout;
private ProgressBar loadProgress;
private Label progressText;
private Stage mainStage;
private static final int SPLASH_WIDTH = 676;
private static final int SPLASH_HEIGHT = 227;
public static void main(String[] args) throws Exception {
public void init() {
ImageView splash = new ImageView(new Image(
loadProgress = new ProgressBar();
loadProgress.setPrefWidth(SPLASH_WIDTH - 20);
progressText = new Label("Will find friends for peanuts . . .");
splashLayout = new VBox();
splashLayout.getChildren().addAll(splash, loadProgress, progressText);
"-fx-padding: 5; " +
"-fx-background-color: cornsilk; " +
"-fx-border-width:5; " +
"-fx-border-color: " +
"linear-gradient(" +
"to bottom, " +
"chocolate, " +
"derive(chocolate, 50%)" +
splashLayout.setEffect(new DropShadow());
public void start(final Stage initStage) throws Exception {
final Task<ObservableList<String>> friendTask = new Task<ObservableList<String>>() {
protected ObservableList<String> call() throws InterruptedException {
ObservableList<String> foundFriends =
ObservableList<String> availableFriends =
"Fili", "Kili", "Oin", "Gloin", "Thorin",
"Dwalin", "Balin", "Bifur", "Bofur",
"Bombur", "Dori", "Nori", "Ori"
updateMessage("Finding friends . . .");
for (int i = 0; i < availableFriends.size(); i++) {
updateProgress(i + 1, availableFriends.size());
String nextFriend = availableFriends.get(i);
updateMessage("Finding friends . . . found " + nextFriend);
updateMessage("All friends found.");
return foundFriends;
() -> showMainStage(friendTask.valueProperty())
new Thread(friendTask).start();
private void showMainStage(
ReadOnlyObjectProperty<ObservableList<String>> friends
) {
mainStage = new Stage(StageStyle.DECORATED);
mainStage.setTitle("My Friends");
mainStage.getIcons().add(new Image(
final ListView<String> peopleView = new ListView<>();
mainStage.setScene(new Scene(peopleView));;
private void showSplash(
final Stage initStage,
Task<?> task,
InitCompletionHandler initCompletionHandler
) {
task.stateProperty().addListener((observableValue, oldState, newState) -> {
if (newState == Worker.State.SUCCEEDED) {
FadeTransition fadeSplash = new FadeTransition(Duration.seconds(1.2), splashLayout);
fadeSplash.setOnFinished(actionEvent -> initStage.hide());;
} // todo add code to gracefully handle other task states.
Scene splashScene = new Scene(splashLayout, Color.TRANSPARENT);
final Rectangle2D bounds = Screen.getPrimary().getBounds();
initStage.setX(bounds.getMinX() + bounds.getWidth() / 2 - SPLASH_WIDTH / 2);
initStage.setY(bounds.getMinY() + bounds.getHeight() / 2 - SPLASH_HEIGHT / 2);
public interface InitCompletionHandler {
void complete();
Copy link

SyCode7 commented Jan 14, 2015

Hi JewelSea,

Thanks for this great tutorial, i want to insert an image for the splashscreen from the local file system.
I have no clue on the best way to go around this, all my efforts have not yeilded my
desired result. Can you kindly give me some guidance. Thanks


Copy link

jewelsea commented Feb 4, 2015

@SyCode7 Just use an ImageView with a file: protocol to load an image from the filesystem into a node that you can display on your splash screen. Though usually, rather than hardcoding a file protocol, you want to get resources like images using getResource rather than directly from the filesystem as it makes your application more portable in that you can bundle the resources in your application jar. For example new ImageView(new Image(MyJavaFXApplication.class.getResource("application-icon.png").toExternalForm())).

Copy link

JulietteGe commented Jun 19, 2015

Thanks a lot! This is great, works well and looks awesome! :D Thank you for providing this code!

Copy link

MarceloAugusto commented Mar 3, 2016

Muito obrigado, foi muito util....

Copy link

Perneel commented Mar 7, 2016

Very nice piece of code, I have been using this as a base to create my own preloader in a seperate jar. I tried to expand this to handle the download progress of the jars as well but failed to do so. If you have time, I made a question on SO about this: Feel free to check it out!

Copy link

MICOFO commented Apr 20, 2016

Very Good tutorial.
Thank you very much

Copy link

g9164313 commented Jun 22, 2016

Good tutorial. Thank you.

Copy link

OUSSAMA-EZZIOURI commented May 29, 2017

nice one boss, I like it. Thank you soo muck :)

Copy link

tolutronics commented Jul 18, 2017

i will i edit it to start another window rather than list of friends

Copy link

lvwarren commented Jan 19, 2019

kudos, jewelsea, i have been following your threads for years on StackOverflow and they are always top notch!

Copy link

tango4567 commented Jun 25, 2020

Wonder full tutorial. Thank you soo much

Copy link

Damian-crypto commented Aug 31, 2020

Great! Thank you!

Copy link

Charlie-Kwon commented May 12, 2022

Wonderful!! Thank you very much.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment