MX Welcome

A Qt6-based welcome application for MX Linux that provides quick access to useful resources, tools, and system information. Features a clean tabbed interface with links to documentation, support forums, and essential system utilities.

Features

• Welcome Tab: Quick access links to documentation, forums, videos, and contribution pages
• About Tab: 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

Installation

Prerequisites

• Qt6 (Core, Gui, Widgets, LinguistTools)
• C++20 compatible compiler (GCC 14+ or Clang)
• CMake 3.16+
• Ninja build system (recommended)

Building from Source

Quick Build

./build.sh           # Release build
./build.sh --debug   # Debug build
./build.sh --clean   # Clean rebuild
./build.sh --debian  # Build Debian package

Manual CMake Build

cmake -G Ninja -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
sudo cmake --install build

Manual Debian Package Build

debuild -us -uc

Package Installation

On MX Linux and compatible Debian-based systems:

sudo apt update
sudo apt install mx-welcome

Usage

1. Launch from the application menu or run mx-welcome in terminal
2. Welcome Tab: Click buttons 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
3. About Tab: View system information including:
   • MX Linux version and build details
   • Hardware information (CPU, memory, graphics)
   • Generate detailed system reports

Command Line Options

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

Technical Details

• Language: C++20
• Framework: Qt6
• Build System: CMake with Ninja generator
• License: GPL v3
• Version: 25.04.01

Development

Code Style

• Modern C++20 with Qt6 framework
• Header guards using #pragma once
• Member variables use camelCase

Contributing

1. Fork the repository
2. Create a feature branch
3. Follow the existing code style
4. Test your changes thoroughly
5. Submit a pull request

Translation Contributions

• 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

License

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.

Authors

• Adrian adrian@mxlinux.org
• Paul David Callahan
• Dolphin Oracle
• MX Linux Team http://mxlinux.org

Links

• MX Linux
• Source Repository
• Issue Tracker
• OpenSUSE Build Service