Install Guide Rum InstallerGUI Prototype

Rum Installer GUI (Prototype)

⚠️ Experimental / prototype, not the recommended install path. This page documents a graphical wrapper around the Install-Guide-Rum steps. It is unfinished, described in its own source as "Skeleton Level," and is not maintained to the same standard as the manual guide. Use Install-Guide-Rum if you want a working, supported install.

Source: Guides/Rum/AoL-InstallerGui in this repository.

What It Is

AoL-InstallerGui is a prototype PyQt6 graphical installer that automates the same steps as the manual Install-Guide-Rum guide: installing dependencies, setting up Wine and rum, running the Affinity installer, and creating .desktop launchers with icons.

The repository ships two Python scripts, AoL-InstallerGui_v0.0.1.py and AoL-wizard_v0.0.1.py. They are currently identical in content. Both are early skeletons of the same idea, not two different tools.

How to Run It

1. Save the script as:

   Guides/Rum/AoL-InstallerGui/aoL_installer.py
   

2. Make it executable:

   chmod +x aoL_installer.py

3. Run it:

   ./aoL_installer.py

   Or, if PyQt6 is not on your $PATH:

   python3 aoL_installer.py

Features (Skeleton Level)

The current build's own documentation describes it as "Skeleton Level," with:

• Step-by-step buttons for each stage
• A dependency check
• Automatic creation of the Wine runner/prefix directories
• Scanning ~/Downloads for installers
• Running the Affinity .exe under Wine
• Automatic creation of .desktop shortcuts with icons
• Minimal progress and error feedback

Planned Flow (Design Notes, Not Yet All Implemented)

The project's design notes describe a fuller install flow than the current skeleton implements:

1. Launch / Welcome: shows the AffinityOnLinux logo and a "Start Installation" button.
2. Dependency Check: checks for wget, unzip, git, winetricks, with an offer to auto-install or show copy-paste commands per distro.
3. Wine + Rum Setup: creates the runner/prefix directories, downloads ElementalWarrior's Wine fork, installs rum to /opt/rum, and symlinks it to /usr/local/bin/rum.
4. Select Affinity Apps: scans ~/Downloads/ for Affinity installer executables, or lets you pick a file manually, or opens Serif's download pages.
5. Configure Wine Prefix: runs wineboot --init and applies remove_mono vcrun2022 dotnet48 renderer=vulkan corefonts win11 through winetricks, then downloads WinMetadata.
6. Run Affinity Installers: launches each selected .exe inside Wine.
7. Desktop Integration: creates .desktop files with icons, with optional dark theme and HiDPI scaling tweaks, and updates the desktop/icon caches.
8. Success Screen: confirms the install and offers to launch the installed apps.
9. Advanced Tab (optional): reset the Wine prefix, reapply HiDPI scaling, or manually update the runner.

The design notes recommend Python + PyQt6 (or PySide6) packaged as an AppImage, or Gtk/PyGObject as an alternative for better GNOME integration.

3.53.sh

The folder also contains a script named 3.53.sh. Its exact relationship to the GUI prototype above is purpose under investigation: it is a large (700+ line), self-contained bash installer with its own interactive menu for setting up Wine and installing Affinity Photo, Designer, or Publisher, along with backup/reinstall handling. Nothing in the two Python scripts or the other guide files in this folder references or calls 3.53.sh, and its filename gives no clear version or authorship clue. Treat it as unconfirmed until someone traces its origin or intended use.

Credits

This prototype and its design notes live in this repository's own Guides/Rum/AoL-InstallerGui folder. See Credits for the project's general contributor list.

Troubleshooting

• The script will not run. Confirm PyQt6 is installed (python3 -m pip show PyQt6), then run it with python3 aoL_installer.py instead of executing it directly.
• A step described in the design notes does not happen. Expected. The current build is "Skeleton Level" and does not yet implement the full planned flow above.

Known Issues

• The GUI has not reached feature parity with the manual Install-Guide-Rum guide. Several steps described in the design notes are not yet implemented.
• 3.53.sh's purpose and its relationship to the rest of this folder are unconfirmed. See the section above.