DEV Community

Cover image for Adding a first-run setup wizard to a Windows tray app
Emir Mrkaljević
Emir Mrkaljević

Posted on

Adding a first-run setup wizard to a Windows tray app

I build PanelOS, a Windows tray app for small 3.5-inch USB screens in a PC case (480x320, 5-inch support is still beta). Until 1.4.4, first launch started with the defaults. Theme, orientation, music source, and the weather city all lived in Settings.

The new wizard is a three-step window in the Settings style. It opens by itself only when there is no settings file yet. You can start it later from the tray, under Setup wizard...

PanelOS setup step 1

Step 1 looks for the panel on USB id 1A86:5722, plus the 5-inch name check. If nothing is plugged in, it says to plug it in and click Retry. The scan cannot crash the app, and you can still go Next without a screen.

PanelOS setup step 2

Step 2 is the theme: the six built-in layouts, a thumbnail when the preview renderer works, and landscape or portrait.

PanelOS setup step 3

Step 3 is music: Auto, SMTC, or Spotify (Auto is the default), plus an optional city for the weather view.

Finish saves through the same path as Settings "Save and apply". Skip, and closing the window, keep the current defaults and mark setup finished so the wizard does not open by itself again.

The same release moves user data into a PanelOS folder under Local AppData. Existing data is copied once and the old folder stays. Uninstall leaves both folders.

Lite is free, and Pro is a one-time $6.99.
Site: https://emirmrkaljevic.github.io/panelos-site/

Top comments (0)