Skip to content

Supported Linux distros

Jump to bottom
RedBearAK edited this page Jul 10, 2024 · 19 revisions

This is a list of Linux distributions and desktop variants I've been able to test so far. For those with release versions provided, that is just what I happened to download and test. Older or newer versions of the same distro, within reason, may also work. Or may have major inompatibilities.

As noted elsewhere in the README, there is no Windows version of Toshy, unlike Kinto.

Fedora and Fedora Variants

  • Fedora Asahi Remix 39 (Fedora for Apple Silicon Macs)

    • Reported working by user (See Toshy issue #98)

  • Fedora 38/39/40 (upstream of CentOS Stream and RHEL)

    • Workstation (GNOME) works
    • Wayland+GNOME requires shell extension (see Requirements)
    • KDE Plasma variant works (X11/Xorg or Wayland session)
    • Sway spin variant works
    • Hyprland works (using JaKooLit Fedora-Hyprland setup script)
    • Other spins like Cinnamon, Budgie should work fine

  • Nobara 38 (Fedora-based)

    • Tested the usual GNOME desktop variant (X11/Xorg and Wayland)
    • Many Toshy dependencies are pre-installed on Nobara
    • Nobara pre-installs the Extension Manager app. Nice!
    • Enable the AppIndicator extension (pre-installed) for tray icon
    • Install an extension from Requirements if using Wayland+GNOME

  • Silverblue/Kinoite 38/39/40 (Fedora-based immutables)

    • Package layering is used during install (can be removed later?)
    • Wayland+GNOME session needs extension (see Requirements)

  • Ultramarine Linux 38/39 (Fedora-based)

    • Ultramarine GNOME tested (Wayland session requires extension)

Red Hat Enterprise Linux (RHEL), Clones, CentOS Stream

  • AlmaLinux 9.3 (RHEL compatible)

    • Installed from KDE "live" ISO, updated from 9.2 to 9.3
    • KDE Plasma desktop tested (Wayland session supported)
    • Some non-default (but official) repos like CRB will be enabled

  • [ AlmaLinux | Rocky Linux ] 9.2 (RHEL clones)

    • Tested with "Workstation" installer choice, not "Server with GUI"
    • Default GNOME desktop tested (Wayland session requires extension)
    • KDE Plasma desktop tested (Wayland session supported)
    • Some non-default (but official) repos like CRB will be enabled

  • AlmaLinux 8.8 (RHEL clone) - Partial support:

    • Tested with "Workstation" installer choice, not "Server with GUI"
    • Default GNOME desktop tested, X11/Xorg session only
    • Wayland+GNOME session NOT supported, because:
      • GNOME is old, no compatible Shell extension available
    • Install AppIndicator extension from the Software app
    • RHEL 8.x and clones probably also work in a similar manner

  • CentOS Stream 9 (RHEL 9 upstream)

    • Same info as the RHEL 9.x clones above
    • Tested with "Workstation" installer choice

Important

CentOS Stream 8 is now beyond end of builds (May 31, 2024).
Red Hat has disabled the mirrorlist.centos.org URL, so in order to install anything, the repo files have to be updated to change the URLs to point to the CentOS Vault. The prep_centos_before_setup.sh shell script will do this automatically on an existing CentOS 7 system, and then refresh the yum and/or dnf cache(s). Run the main Toshy setup afterward.

  • CentOS Stream 8 (RHEL upstream) - Partial support:

    • Tested with "Workstation" installer choice (GNOME)
    • Auto-start with systemd user services works (unlike CentOS 7)
    • GNOME X11/Xorg session works, Wayland does not
      • Choose "Standard (X11 display server)" at login
    • For tray icon support:
      • Install AppIndicator extension from GNOME Software app
    • NB: GNOME Wayland session WILL NOT WORK! Because:
      • GNOME shell too old, no compatible extension available

Important

CentOS 7 is now beyond end of life (June 30, 2024).
Red Hat has disabled the mirrorlist.centos.org URL, so in order to install anything, the repo files have to be updated to change the URLs to point to the CentOS Vault. The prep_centos_before_setup.sh shell script will do this automatically on an existing CentOS 7 system, and then refresh the yum and/or dnf cache(s). Run the main Toshy setup afterward.

  • CentOS 7 (RHEL 7 clone) - Partial support:

    • You must first install python3 to run setup_toshy.py
    • GUI preferences app will not work (Tk too old for sv_ttk theme)
    • systemd "user" services are not supported in CentOS/RHEL 7
    • Auto-start at login with systemd services not available
    • Cmd+Space (Alt+F1) shortcut must be assigned to app launcher menu
    • To manually start Toshy config from tray icon menu:
      • "(Re)Start Config-Only" option will start Toshy config
      • "Stop Config-Only" option will stop background Toshy config
    • To manually start Toshy config from terminal:
      • Use toshy-config-start or toshy-config-verbose-start
      • Use toshy-config-stop to stop a background Toshy config

  • Eurolinux 9.2 (RHEL clone)

    • Tested with "Server with GUI" installer choice
    • Default GNOME desktop tested (Wayland session requires extension)
    • Some non-default (but official) repos like CRB will be enabled

  • RHEL and RHEL clones not listed should be supportable

    • Red Hat Enterprise Linux itself? Probably.
    • Try ./setup_toshy.py --override-distro=almalinux or =rhel

openSUSE (RPM-based packaging system)

  • openSUSE Leap 15.5/15.6 (SLES-based, fixed release) WORKING!

    • GNOME desktop works (Wayland session needs extension, see Requirements)
    • KDE desktop works (X11/Xorg or Wayland)
    • Other desktop choices should work, if session is X11/Xorg

  • openSUSE Aeon/Kalpa (OpenSUSE MicroOS-based, rolling release?)

    • Aeon Wayland needs GNOME shell extension (see Requirements)
    • Kalpa (KDE Plasma) fully supported
    • Uses transactional-update to install native packages

  • openSUSE Tumbleweed (rolling release)

    • GNOME desktop works (Wayland session needs extension, see Requirements)
    • KDE desktop works (X11/Xorg or Wayland)
    • Other desktop choices should work, if session is X11/Xorg

OpenMandriva (DNF/RPM-based, descended from Mandriva, Mandrake)

  • OpenMandriva ROME 2023/2024 (rolling release variant)

    • Wayland+Plasma tested

  • OpenMandriva 5.0 (fixed release variant)

    • Wayland+Plasma tested

Ubuntu variants and Ubuntu-based distros

  • Bodhi Linux 7.0 (Ubuntu-based)

    • Desktop is Enlightenment
    • Install package xapp to remove some errors from log

  • Feren OS 2023.04 (Ubuntu LTS variant)

    • Current base is Ubuntu 20.04 LTS
    • Desktop is KDE Plasma 5.25.x

  • elementary OS 7.0/7.1 (Ubuntu-based)

    • Tray icons are not supported in Pantheon desktop

  • KDE Neon (based on Ubuntu LTS releases)

    • X11/Xorg or Wayland+Plasma session

  • Linux Mint 21.1/21.2/21.3 (Ubuntu-based)

    • Cinnamon desktop (X11/Xorg or Wayland)
    • Xfce desktop (X11/Xorg only)
    • MATE desktop (X11/Xorg only)
    • All desktops can be installed on the same Mint system:
    • sudo apt install mint-meta-mate mint-meta-xfce mint-meta-cinnamon

  • Pop!_OS 22.04 LTS (Ubuntu-based)

    • X11/Xorg or Wayland+GNOME (requires extension)

  • Rhino Linux (Ubuntu rolling release variant)

    • Desktop is Xfce/Unicorn (X11/Xorg)

  • Tuxedo OS 1/2 (Ubuntu LTS variant)

    • X11/Xorg
    • KDE Plasma desktop

  • Ubuntu official variants tested:

    • Ubuntu 22.04/23.04/23.10
      • X11/Xorg or Wayland+GNOME (requires extension)
    • Kubuntu 22.04/23.04/23.10
      • X11/Xorg or Wayland+Plasma
    • Xubuntu 23.04/23.10
      • X11/Xorg only
    • Lubuntu 23.04/23.10
      • X11/Xorg only
    • Ubuntu Unity 23.10
      • X11/Xorg only
    • Ubuntu Budgie 23.04
      • X11/Xorg only
    • Ubuntu Kylin 24.04 - WORKING, BUT SEE NOTE BELOW
      • X11/Xorg only
    • Ubuntu Kylin 23.10 - NOT WORKING!
      • PACKAGE CONFLICT IN REPO
      • X11/Xorg only

  • Zorin OS 17/17.1 Core/Lite (Ubuntu-based)

    • X11/Xorg or Wayland+GNOME (requires extension)
    • Wayland+GNOME requires extension (see Requirements)
    • GNOME Shell is version 43.x, any extension should work now

  • Zorin OS 16.2/16.3 Core/Lite (Ubuntu-based)

    • X11/Xorg or Wayland+GNOME (requires extension)
    • NOTE: GNOME Shell on Zorin 16.x is old: 3.38
    • Xremap is the only compatible shell extension

Ubuntu Kylin issues

Toshy can finally be installed on Ubuntu Kylin 24.04, unlike the earlier 23.10 release, which had a fatal package version conflict that I couldn't resolve. But the UKUI desktop environment (at least in the tested 24.04 beta release) seems to have some strange issues with task switching, and with transferring keyboard focus properly after task switching. Since keymaps for an app like Peony (the default UKUI/Kylin file manager) are specific to the app class of peony-qt, the correct keymap only activates after clicking on the Peony window, even if it appears to already be the focused app (watch the highlights on the window controls).

Using Cmd+Tab to switch from another app currently results in the keyboard focus (and the app class) remaining with the previous app. So if the previous app was Mate-terminal, the keyboard shortcuts will respond as if you are still in the Mate-terminal window, until you click on the Peony window. This probably affects other apps after task switching with the keyboard.

Task switching is also broken with the 24.04 beta UKUI desktop, in the sense that you can't switch beyond the last app with the keyboard. The task switcher dialog doesn't respond to holding the modifier key and hitting Tab multiple times. This has nothing to do with Toshy (it's broken even before installing Toshy or when Toshy is disabled) and is similar to a longstanding bug in task switching on the Budgie desktop enironment. If you have any idea where to report these issues to the Ubuntu Kylin developers, please do so if you care about getting them fixed.

Debian and Debian-based distros

  • antiX 22.x/23.x (Debian-based, related to MX Linux)

    • Preliminary support, no SysVinit services yet, so no auto-start.
    • Starting only the "config script" from the tray icon menu should work now.
    • Use toshy-config-start or toshy-config-verbose-start for manual start.
    • Only "rox-icewm" desktop verified/tested.

  • Debian 12 tested and can be made to work:

    • If you gave root a password, your user will NOT be in the sudo group!
    • If necessary, add your user to sudo group (and reboot!)
      • su - (enter root's password)
      • usermod -aG sudo yourusername
      • Save a reboot step later by also doing this:
      • usermod -aG input yourusername
      • Seriously, reboot now!
    • Then, for Wayland+GNOME:
      • Install flatpak and the Flathub repo. Instructions here:
      • Do flatpak install com.mattjakeman.ExtensionManager
      • Reboot again! (So Flatpak folders are added to path.)
      • Install any compatible shell extension (see Requirements)
      • Recommended additional extensions:
        • AppIndicator and KStatusNotifierItem (for tray icon)
        • Logo Menu (enable power options in its settings)

  • Deepin 23 (Debian-based)

    • NOTE: Long delay before services start (Zenity error?)

  • Kali Linux 2023/2024 (Debian-based)

    • Tested with default desktop of Xfce
    • GNOME & KDE Plasma available in Kali installer

  • LMDE 5/6 (Linux Mint Debian Edition)

    • Default desktop is Cinnamon, works

  • MX Linux 21.x/23.x (Debian-based, related to antiX)

    • Preliminary support, no SysVinit services yet, so no auto-start.
    • Starting only the "config script" from the tray icon menu should work now.
    • Use toshy-config-start or toshy-config-verbose-start for manual start.
    • Choosing advanced options and booting with systemd will work fine.

  • PeppermintOS (Debian-based)

    • New release based on Debian 12 tested
    • Desktop is Xfce4 v4.18

  • Q4OS 5.2 (Debian-based)

    • Trinity desktop ISO tested.

  • Window Maker Live 0.96 (Debian-based)

    • Tray icon may not auto-load at login. Gdk error?
    • Tray icon can be reloaded from the application finder.

Arch, Arch-based and related distros

  • Arch in general? (maybe, needs more testing)

    • Installer will try to work on any distro that identifies as arch

  • ArcoLinux (Arch-based)

    • ArcoLinuxL ISO (full installer) tested
    • Multiple desktops tested (GNOME, KDE, others)
    • X11/Xorg and Wayland (all working Wayland environments)
    • plasma-wayland-session can be installed
    • See FAQ Re: Application Menu shortcut fix

  • EndeavourOS (Arch-based)

    • Most desktops should work in X11/Xorg
    • GNOME desktop should work in X11/Xorg and Wayland (requires extension)
    • KDE (Plasma) desktop should work in X11/Xorg and Wayland
    • plasma-wayland-session can be installed

  • Garuda Linux (Arch-based)

    • KDE Dr460nized works
    • KDE Lite also works
    • GNOME will need shell extension (see Requirements)
    • Xfce, Cinnamon, i3wm, Qtile should work (not tested)
    • Sway should work (not tested)
    • Hyprland works

  • Manjaro (Arch-based)

    • GNOME desktop variant tested
    • Xfce desktop variant tested
    • KDE Plasma desktop variant tested
    • plasma-wayland-session can be installed
    • See FAQ Re: Application Menu shortcut fix

Independent distros

  • Solus 4.4/4.5 (eopkg)

    • Budgie ISO tested, GNOME and MATE should work without issue

  • Void Linux (xbps, rolling release) - PARTIAL SUPPORT

    • Void doesn't use systemd, no Runit scripts provided

    • Options to start the manual keymapper config script:

      • Tray icon menu: Re/Start Config-Only
      • Terminal command: nohup toshy-config-start &
      • Runit service script to run terminal command
      • Put a desktop entry file in ~/.config/autostart
Clone this wiki locally