Taidan is a GUI Out-Of-Box-Experience (OOBE) and Welcome App for Ultramarine Linux, written in Rust and the Slint toolkit.
For an up-to-date list, see scripts/taidan.spec.
kwin, dbus-daemon, swaybg [the OOBE session]
polkit [running the setup as root]
fontconfig
vercel-geist-fonts, atkinson-hyperlegible-next-fonts and atkinson-hyperlegible-mono-fonts
orca [screen reader]
libxkbcommon, wayland and EGL libraries [loaded at runtime by Slint]
NetworkManager
cog [browser for captive portals]
tzdata [time zones]
gsettings or (plasma-apply-colorscheme and kwriteconfig6)
kwriteconfig6
shadow-utils
systemd and systemd-udev
kbd and procps-ng [chvt and pkill for the session]
bash, util-linux [runuser and lastlog2]
dnf5, dnf5-command(copr) and dnf5-command(config-manager)
flatpak
xdg-terminal-exec [the debug terminal, see Testing]
umcli [tweaks, through taidan-default-configs]
chrony and grubby [recommended, the clock and NVIDIA drivers]
pkgconfig(openssl)
pkgconfig(fontconfig)
pkgconfig(libxcrypt)
clang
glibc-all-langpacks [for `localedef --list-archive`]
xkeyboard-config [for /usr/share/X11/xkb/rules/evdev.lst]
Taidan runs as the unprivileged taidan user. Everything it does as root goes through
/usr/libexec/taidan-helper (libtaidan/helper.rs), the only path the polkit rule lets taidan
pkexec while the OOBE runs. The helper takes a fixed set of requests with checked arguments, and
once the system is marked configured it refuses everything but a few cleanup ones.
This limits what a bug in Taidan can do as root, but it isn't a boundary against other code running
as taidan: the OOBE exists to make an admin with a chosen password, so anything that can make
those requests can get root. Nothing untrusted may run as taidan, which is why Orca's help and
links open in an empty sandbox and the captive portal browser runs as its own user. Packaging has
to install the helper:
cargo build --release -p libtaidan --bin taidan-helper
install -Dpm755 target/release/taidan-helper /usr/libexec/taidan-helpertdnx is a small libtaidan bridge used by
Ultramarine Server OOBE to
validate setup operations. It isn't part of the desktop build or the taidan
package. server-oobe builds it from this repo:
cargo build --release -p tdnx --no-default-features --features server-oobeThe desktop-install backend goes through taidan-helper like Taidan, so the helper has to be
installed. Custom repos, coprs and scripts in actions, and packages Taidan doesn't install itself,
are only taken when tdnx runs as root.
TAIDAN_LOG=trace cargo rTAIDAN_SIMULATE_HW=nvidia,broadcom-wifi(orall) fakes that hardware for the drivers list (withnvidia, the simulated install asks for a reboot)TAIDAN_SIMULATE_ERROR=1makes the simulated install fail halfwayTAIDAN_SIMULATE_UPDATES=1fakes downloaded updates, for the done page's restart buttonTAIDAN_SIMULATE_DRIVER_ERROR=1fakes a failed driver install, for the done page's note about it
On a real machine, boot with taidan.debug_shell on the kernel command line, then press
Alt+Shift+T for a root terminal.
Debug builds run the root helper from TAIDAN_HELPER if it's set.
GPL-3.0-or-later
Copyright © 2024~2026 Fyra Labs & Ultramarine Linux Contributors
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
Taidan reads an optional configuration file at /etc/taidan.toml:
edition = "plasma"
skip_pages = ["location", "drivers"] # hide pages you don't want, see `SkipPage` in src/cfg.rs for the names
org = "Fyra Labs"Changes from the GTK version of Taidan:
skip_pages = ["devicename"]is ignored with a warning, the device name is on the network page now. Skippingnetworkkeeps the system's hostname.skip_pages = ["keyboard"]also hides the input method picker, which moved onto the keyboard page. Input methods are then picked from the locale. To set up none, skipinputmethod.- Codecs follow the drivers toggle.
skip_pages = ["codecs"]is the same asdrivers, which hides the page but still installs drivers and codecs. internet_timeoutandinternet_retry_intervalare ignored with a warning, and/etc/com.fyralabs.Taidan/detect-internetisn't run anymore. Connectivity comes from NetworkManager./usr/share/taidan/oobe.shisn't run anymore. Use a tweak instead.- The analytics page sends the Plausible pageview
detect-internetused to send, once, at the end of setup, and only if the user leaves it on. Skipanalyticsto never send it. - Taidan doesn't ship a systemd preset anymore. The distro's presets need to
enable taidan-initial-setup-reconfiguration.service.
Tweaks are optional settings the user can turn on from the summary page. Each is a directory in
/usr/share/taidan/tweaks/ named after the tweak's id, with an executable up script and an
optional tweak.toml (fields in Tweak, libtaidan/tweaks.rs). up 1 turns the tweak on. up 0
only runs when an earlier, unfinished install turned it on and the user has since turned it off.
Both run as root.
An optional condition script determines whether a tweak applies to this system.
The tweak is enabled if the exit code is 0; nonzero, failure to run, or a five-second timeout hides it.
TAIDAN_X86_64_LEVEL (1–4 on x86-64, 0 elsewhere) and TAIDAN_SECURE_BOOT
(0 for disabled, 1 for enforced, unknown if detection failed) are available.
up gets the user's choices as JSON on stdin (Settings in libtaidan/settings.rs):
The proxy URL on stdin never has credentials in it. For its own downloads, up gets the full proxy
in http_proxy and friends. A tweak should only set the proxy up somewhere that outlives the install
when proxy_persist is true, otherwise Taidan removes its own proxy config.
With proxy_persist on, Taidan writes the proxy to /etc/environment (without credentials) and
/etc/dnf/libdnf5.conf.d/50-taidan-proxy.conf (root only). libdnf5 has no no_proxy, so repos
whose baseurl, metalink or mirrorlist host is in the bypass list get proxy= in
/etc/dnf/repos.override.d/50-taidan-proxy-bypass.repo. Mirrors handed out by a metalink or
mirrorlist are only known at runtime, so they still go through the proxy.
Changes from the GTK version:
langlocaleis nowlocaletheme_is_darkis nowdark_mode, which can benullaccentis lowercase ("blue"instead of"Blue")tweaksis a list of the ids to turn on instead of aboolper tweakpasswdis gonetimezone,avatar,download_updates,location,a11y,proxy,proxy_persist,ims_pickedandimfare new
Other distros can replace Ultramarine's look from the same file. Every key is optional. Colors are #rrggbb or #aarrggbb.
logo = "/usr/share/pixmaps/my-distro.svg" # header and window icon
font = "Inter" # needs to be installed, Geist if unset
accent_color = "#00078f" # main buttons and selections, light mode
accent_color_dark = "#4a56e2" # the same in dark mode
accent_foreground_color = "#ffffff" # text and icons on the accent
accent_foreground_color_dark = "#ffffff" # dark mode, accent_foreground_color if unset
[welcome]
t0 = "My Distro 42" # caption on the picture beside the pages, none if unset
t0_color = "#ffffff" # caption color
t1_color = "#ffffff" # Taidan version color, only shown in dev sessions
hero_image = "/usr/share/backgrounds/my-distro.png" # the picture, light mode
hero_image_dark = "/usr/share/backgrounds/my-distro-dark.png"The picture falls back to /usr/share/backgrounds/default.png (or default-dark.png), then to
Ultramarine's. The distro name comes from NAME= in /etc/os-release. The legible font option in
the accessibility settings overrides font with Atkinson Hyperlegible Next.
{ "skipconfig": false, "nointernet": false, // setting up offline "kb_layout": "us", "kb_variant": null, "device_name": "Cypress's Laptop", "hostname": "cypresss-laptop", "timezone": "America/Denver", // "" to keep the system's "locale": "en_US.UTF-8", // "" to keep the system's "fullname": "Cypress", "username": "cypress", "avatar": null, // path to the user's icon "install_codecs_drivers": true, "download_updates": true, "location": true, // null when the location page was skipped "analytics": true, // null when the analytics page was skipped "a11y": { "screen_reader": false, "zoom": false, "larger_text": false, ... }, "dark_mode": true, // null to keep the distro's default "accent": "blue", // or teal, green, yellow, orange, red, pink, purple, slate, or null "proxy": null, // or { "url": "http://proxy:3128", "no_proxy": "localhost" } "proxy_persist": true, // whether the installed system keeps using the proxy "ims": ["Pinyin"], "ims_picked": false, "imf": "fcitx5", // or "ibus" "actions": [[], [], [], [], []], "tweaks": ["my_tweak"] // ids of the tweaks to turn on }