GalleonCore

Install GalleonCoreInstaller GalleonCore

Choose your operating system. Version 0.1.0 has direct downloads; distribution repositories also provide updates. The keyboard needs its own hardware access rules and a running per-user daemon.Choisis ton système. La version 0.1.0 propose des téléchargements directs ; les dépôts de distribution facilitent aussi les mises à jour. Le clavier nécessite des règles d’accès au matériel et un démon utilisateur actif.

sudo add-apt-repository ppa:paulwoisard/galleoncore
sudo apt update
sudo apt install galleoncore

sudo dnf copr enable paullux/GalleonCore
sudo dnf install galleoncore

yay -S galleoncore

Native Linux packages include galleond, Bosun, libgalleon, widgets, wallpapers and udev rules. Enable the optional user service with systemctl --user enable --now galleond.service. Fedora RPMs are Fedora-specific. On other distributions, check AppImage compatibility with your system and install the separate hardware integration.Les paquets Linux natifs incluent galleond, Bosun, libgalleon, les widgets, les fonds d’écran et les règles udev. Active le service utilisateur facultatif avec systemctl --user enable --now galleond.service. Les RPM Fedora sont propres à Fedora. Sur les autres distributions, vérifie la compatibilité de l’AppImage avec ton système et installe l’intégration matérielle séparée.

What each release file contains and its checksumsContenu de chaque fichier de la release et sommes de contrôle

Project and build linksLiens du projet et des compilations

Galleon Bosun in picturesGalleon Bosun en images

The five default pages are shown with applications found on one Linux desktop; installed apps and icons vary by computer. Wallpapers and screensavers are selected in their own tabs. Click a picture to view it at full size.Les cinq pages par défaut sont montrées avec les applications trouvées sur un poste Linux ; les applications et icônes varient selon l’ordinateur. Les fonds d’écran et écrans de veille se choisissent dans leurs onglets. Clique sur une image pour l’agrandir.

Windows: unresponsive Stream Deck keysWindows : touches Stream Deck sans réponse

Project scopePérimètre du projet

The first five pagesLes cinq pages initiales

StatusAvancement

• Stream Deck: LCD keys, screen and dialsStream Deck : touches LCD, écran et molettesConfirmed on Linux and in initial Windows testsConfirmé sous Linux et lors des premiers essais Windows
• Rendering QML widgets to the keyboard screenRendu des widgets QML sur l'écran du clavierImplementedImplémenté
• galleond: Linux D-Bus and Windows local controlgalleond : D-Bus Linux et contrôle local WindowsImplementedImplémenté
• Bosun settings and five initial pagesRéglages Bosun et cinq pages initialesAvailable on Linux and WindowsDisponibles sous Linux et Windows
• KDE Plasma widgetsWidgets KDE PlasmaSkeletonSquelette
• OpenRGB dial-ring lightingÉclairage des anneaux via OpenRGBHardware confirmedConfirmé sur le module
• Per-key RGB on the main keyboardRVB par touche du clavier principalProtocol blockedProtocole bloqué
• Windows Setup and distribution packagesSetup Windows et paquets de distributionv0.1.0 releasedv0.1.0 publiée
• Extended Windows hardware checksEssais matériels prolongés sous WindowsStill to confirmEncore à confirmer

The OpenRGB plugin controls the dial rings. Per-key lighting on the main keyboard remains blocked: an unsafe colour write can freeze it until unplugged. Windows controls worked in the owner's first test after updating the Stream Deck firmware; cold-start and long-session stability still need confirmation. Le plugin OpenRGB pilote les anneaux des molettes. L'éclairage par touche du clavier principal reste bloqué : une écriture de couleur risquée peut le figer jusqu'au débranchement. Les commandes Windows ont fonctionné lors du premier essai du propriétaire après la mise à jour du firmware Stream Deck ; le démarrage à froid et la stabilité prolongée restent à confirmer.

How it fits togetherComment tout s'articule

libgalleon

The C++20 / Qt 6 library that talks to the keyboard. La bibliothèque C++20 / Qt 6 qui dialogue avec le clavier. Split in three layers: the protocol (pure functions, no I/O), the transport (HID access), and the deck logic. The protocol can be tested and fuzzed without the keyboard. LGPL-3.0, so other projects can reuse it. Découpée en trois couches : le protocole (fonctions pures, sans entrées/sorties), le transport (accès HID) et la logique du deck. Le protocole se teste et se fuzze sans le clavier. Sous LGPL-3.0, pour que d'autres projets puissent la réutiliser.

galleond

The daemon. It owns the keyboard, renders widgets for its screen and offers a D-Bus interface to the rest of the desktop. Le démon. Il possède le clavier, rend les widgets pour son écran et offre une interface D-Bus au reste du bureau.

WidgetsWidgets

Plain QML, with no Plasma dependency, so the same file runs inside galleond and inside a Plasma widget. Du QML pur, sans dépendance à Plasma : le même fichier tourne dans galleond et dans un widget Plasma.

RGB controllerContrôleur RVB

Developed in OpenRGB itself and proposed upstream, rather than in this repository. Développé dans OpenRGB lui-même et proposé en amont, plutôt que dans ce dépôt.

Build itCompiler

sudo apt install cmake g++ qt6-base-dev qt6-declarative-dev libhidapi-dev pkg-config
git clone https://github.com/Paullux/GalleonCore
cd GalleonCore
cmake -B build
cmake --build build
ctest --test-dir build

sudo cp tools/udev/70-galleon.rules /etc/udev/rules.d/
sudo udevadm control --reload && sudo udevadm trigger

Checked on every changeVérifié à chaque modification

• a build with GCC and Clang, strict warnings treated as errors;une compilation avec GCC et Clang, avertissements stricts traités en erreurs ;
• the unit tests, also under AddressSanitizer and UndefinedBehaviorSanitizer;les tests unitaires, aussi sous AddressSanitizer et UndefinedBehaviorSanitizer ;
• a minute of fuzzing on the input report parser;une minute de fuzzing sur le parseur des rapports d'entrée ;
• clang-tidy, qmllint, and a REUSE licensing check.clang-tidy, qmllint, et une vérification des licences REUSE.