ro-Assist

Language: English | Turkish

ro-Assist is a Qt6 desktop assistant built specifically for Fedora 43 KDE Plasma systems. It executes update workflows and reports progress through a simple GUI while preserving native desktop behavior where possible.

Features

• Real-time update progress tracking from command output parsing.
• Qt6-based desktop interface tuned for Fedora 43 KDE Plasma.
• Package management integration centered on Fedora workflows.
• Breeze style and themed icon integration when running inside KDE.

Tech Stack

• C++17
• Qt6 (Widgets, Network)
• CMake (with CPack RPM support)

Requirements

• CMake 3.16+
• C++17 compatible compiler (gcc or clang)
• Qt6 6.6+ development packages

Fedora 43 example:

sudo dnf install cmake gcc-c++ qt6-qtbase-devel

Build

cmake --preset default
cmake --build --preset default

Test

ctest --preset default

Run

./build/ninja/ro-assist

Packaging

RPM metadata is configured in both CMakeLists.txt (CPack) and packaging/rpm/ro-assist.spec.

GitHub Actions builds RPMs on a Fedora 41 compatibility baseline and validates them on Fedora 43. It produces two simple RPM artifacts:

• ro-assist-x64
• ro-assist-arm64

The RPM workflow also verifies that:

• dnf install ro-assist works from a generated repository
• /usr/bin/ro-assist launcher and /usr/libexec/ro-assist/ro-assist binary are present
• ldd -r /usr/libexec/ro-assist/ro-assist resolves
• RPM requirements do not contain Qt_6.10 or Qt_6.10_PRIVATE_API

When installed on Fedora 43 KDE, the package also ships an autostart entry that launches ro-assist --autostart on the first login only.

Project Structure

.
|- docs/
|- include/roassist/
|- packaging/linux/
|- packaging/rpm/
|- resources/icons/
|- src/
|- tests/
|- CMakeLists.txt
`- .github/

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

Code of Conduct

This project follows the code of conduct in CODE_OF_CONDUCT.md.

Security

Security reporting guidance is available in SECURITY.md.

License

This project is licensed under GPL-3.0-or-later. See LICENSE for details.