QT5OPTIONS(7)

✨ NAME ✨

qt5options — the common commandline options that every single application built on the Qt™ toolkit shares. one page, all the apps, we love a communal queen 💖

🎀 SYNOPSIS 🎀

Qt application [-style= style / -style style]
               [-stylesheet= stylesheet / -stylesheet stylesheet]
               [-widgetcount] [-reverse] [-qmljsdebugger= port]
               [-platform platformName[:options]]
               [-platformpluginpath path] [-platformtheme platformTheme]
               [-plugin plugin] [-qwindowgeometry geometry]
               [-qwindowicon icon] [-qwindowtitle title] [-reverse]
               [-session session] [-display hostname:screen_number]
               [-geometry geometry] [-dialogs= [xp|none]]
               [-fontengine= freetype] [-h, --help and -? on Windows®]
               [-v --version]

💅 OPTIONS 💅

okay bestie, these are the options that apply to all Qt™ applications. every last one. no skipping. 🫶

• -style= style / -style style — sets the application GUI style. what values can you actually use? depends on your system configuration, so it's giving "it depends" energy. but here's the tea: if Qt™ was compiled with extra styles, or if it has extra styles hanging around as plugins, those show up as options for -style too. slay.
• -stylesheet= stylesheet / -stylesheet stylesheet — sets the application styleSheet. the value must be a path to a file that contains the Style Sheet. that's it, that's the rule ✨
• -widgetcount — prints a debug message at the end about how many widgets were left undestroyed, plus the maximum number of widgets that existed at the same time. little forensic moment 🔍
• -reverse — sets the application's layout direction to Qt::RightToLeft. it's a debugging aid, bestie — do not use this in production, fr fr. the default value is automatically detected from the user's locale (see also QLocale::textDirection()).
• -qmljsdebugger= port — activates the QML/JS debugger on a port you specify. the value must be in the format port:1234[,block], where block is optional and makes the application wait until a debugger connects to it. so if you need it to sit there and chill until you show up, that's your block.
• -platform platformName[:options] — specify the Qt™ Platform Abstraction (QPA) plugin.
• -platformpluginpath path — specify the path to platform plugins.
• -platformtheme platformTheme — specify the platform theme.
• -plugin plugin — specify additional plugins to load. the argument may appear multiple times, so stack 'em if you got 'em 🍓
• -qwindowgeometry geometry — specify the window geometry for the main window using the X11-syntax. for example: -qwindowgeometry 100x100+50+50
• -qwindowicon icon — set the default window icon.
• -qwindowtitle title — set the title of the first window. main character energy for your window bar 👑
• -session session — restore the application from an earlier session. time travel but make it Qt™ 🦋
• -display hostname:screen_number — switch displays on X11. this one overrides the DISPLAY environment variable, so it's the louder voice in the room.
• -geometry geometry — specify the window geometry for the main window on X11. for example: -geometry 100x100+50+50
• -dialogs= [xp|none] — only available for the Windows® platform. xp uses native style dialogs and none disables them.
• -fontengine= freetype — use the FreeType font engine.
• -h, --help and -? on Windows® — print all options and the application description. your "what does anything do" button 💖
• -v --version — display the version string of the application.

🌈 SEE ALSO 🌈

kf5options(7) — go read that one next, bestie, it's the sibling 💜

🧚 AUTHORS 🧚

this man page was originally written by Lauri Watts <lauri@kde.org>

then updated to Frameworks 5 by Burkhard Lück <lueck@hube-lueck.de>

and the infos for this man page come from the QApplication documentation[1], the QGuiApplication documentation[2] and the QCommandLineParser documentation[3].

• Lauri Watts <lauri@kde.org> — Author.
• Burkhard Lück <lueck@hube-lueck.de> — Author.

📝 NOTES 📝

1. QApplication documentation https://doc.qt.io/qt-5/qapplication.html#QApplication
2. QGuiApplication documentation https://doc.qt.io/qt-5/qguiapplication.html#QGuiApplication
3. QCommandLineParser documentation https://doc.qt.io/qt-5/qcommandlineparser.html

and that's the whole page, no cap. written under KDE Frameworks Qt 5.4, dated 2016-06-04, filed as QT5OPTIONS(7). periodt 💅✨