A Qt 6 Quick welcome application for MX Linux that provides quick access to useful resources, tools, and system information. Its responsive dashboard uses the desktop palette, fonts, and icon theme on both light and dark desktops.
- Welcome Dashboard: A straightforward collection of buttons for documentation, forums, videos, and system tools
- Responsive Navigation: Sidebar navigation on wide windows and compact controls on smaller screens
- System Page: System information display with hardware details and MX Linux version
- System Reports: Generate comprehensive system information reports
- Auto-start Option: Can be configured to launch automatically on login
- Internationalization: Multi-language support with 40+ translations
- Resource Links: Direct access to MX Tools, manual, forum, wiki, and videos
- Qt6 (Core, Gui, Widgets, Qml, Quick, QuickControls2, LinguistTools)
- Qt 6 Declarative development files (
qt6-declarative-devon Debian/MX) - C++20 compatible compiler (GCC 14+ or Clang)
- CMake 3.16+
- Ninja build system (recommended)
./build.sh # Release build
./build.sh --debug # Debug build
./build.sh --clean # Clean rebuild
./build.sh --debian # Build Debian packagecmake -G Ninja -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
sudo cmake --install builddebuild -us -ucOn MX Linux and compatible Debian-based systems:
sudo apt update
sudo apt install mx-welcome- Launch from the application menu or run
mx-welcomein terminal - Welcome Dashboard: Select a button to access:
- MX Tools: Launch the MX Tools collection
- Manual: Open the MX Linux manual
- Forum: Access the MX Linux community forum
- Wiki: Browse the MX Linux wiki
- Videos: View MX Linux tutorial videos
- Contribute: Learn how to contribute to MX Linux
- About This System: View system information including:
- MX Linux version and build details
- Hardware information (CPU, memory, graphics)
- Generate detailed system reports
mx-welcome [options]
Options:
-a, --about Start with About tab selected
-t, --test Run in test mode
-v, --version Display version information
-h, --help Show help information- Language: C++20
- Framework: Qt 6 with a Qt Quick/QML frontend
- Build System: CMake with Ninja generator
- License: GPL v3
- Version: 25.04.01
src/backend.*: configuration, environment policy, persistence, filtering, and process launchingsrc/actionmodel.*: model exposed to QML for dashboard actionsqml/Main.qml: application window, responsive navigation, system page, and dialogsqml/components/: reusable action cards and themed controls
The application intentionally starts with QApplication and retains the Widgets library so MX/XFCE's Qt GTK integration can provide the correct desktop palette to QML. It does not force a Qt Quick Controls style.
- Modern C++20 with Qt6 framework
- Header guards using
#pragma once - Member variables use camelCase
- Fork the repository
- Create a feature branch
- Follow the existing code style
- Test your changes thoroughly
- Submit a pull request
- Please join Translation Forum: https://forum.mxlinux.org/viewforum.php?f=96
- Please register on Transifex: https://forum.mxlinux.org/viewtopic.php?t=38671
- Choose your language and start translating: https://app.transifex.com/anticapitalista/antix-development
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.
See LICENSE for the full license text.
- Adrian adrian@mxlinux.org
- Paul David Callahan
- Dolphin Oracle
- MX Linux Team http://mxlinux.org