Repository files navigation

Taskbar Launcher forWinApps.Feel free to fork, submit pull requests, open issues and promote this project to grow the WinApps community!

You should already have most required dependencies after installing WinApps, butyad may be missing.

sudo apt install yad

sudo dnf install yad

sudo pacman -Syu --needed yad

sudo zypper install yad

1. Ensure you have already installedWinApps.

2. Identify your WinApps source directory.

   • For a local user installation:~/.local/bin/winapps-src
   • For a system-wide installation:/usr/local/bin/winapps-src

3. Set a variable in your terminal pointing to this directory.Copy the line that matches your setup.

   # FOR LOCAL INSTALL:WINAPPS_SRC_DIR="$HOME/.local/bin/winapps-src"# --- OR ---# FOR SYSTEM-WIDE INSTALL:WINAPPS_SRC_DIR="/usr/local/bin/winapps-src"

4. Clone this repository and run the launcher as a test. This will placewinapps-launcher inside your existingwinapps-src directory.

   # Clone the repository into the correct locationgit clone https://github.com/winapps-org/winapps-launcher.git"${WINAPPS_SRC_DIR}/winapps-launcher"# Make the script executablechmod +x"${WINAPPS_SRC_DIR}/winapps-launcher/winapps-launcher.sh"# Run the launcher as a test"${WINAPPS_SRC_DIR}/winapps-launcher/winapps-launcher.sh"

You can add an application menu icon for WinApps Launcher and/or configure a user service that starts WinApps Launcher automatically at login.

EnsuringWINAPPS_SRC_DIR is still set correctly, run the following within your terminal to add a WinApps Launcher icon to your applications menu.

mkdir -p~/.local/share/applicationscat>~/.local/share/applications/winapps-launcher.desktop<<EOF[Desktop Entry]Type=ApplicationName=WinApps LauncherComment=Taskbar Launcher for WinAppsExec="$WINAPPS_SRC_DIR/winapps-launcher/winapps-launcher.sh"Icon=$WINAPPS_SRC_DIR/winapps-launcher/icons/LinkIcon.svgTerminal=falseCategories=Utility;EOF

1. EnsuringWINAPPS_SRC_DIR is still set correctly, copy and paste the following code block into your terminal to create the systemd user service file.

   mkdir -p~/.config/systemd/usercat>~/.config/systemd/user/winapps-launcher.service<<EOF[Unit]Description=Run 'WinApps Launcher'After=graphical-session.target default.targetWants=graphical-session.target[Service]Type=simpleEnvironment="PATH=%h/.local/bin:%h/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"Environment="LIBVIRT_DEFAULT_URI=qemu:///system"Environment="SCRIPT_PATH=$WINAPPS_SRC_DIR/winapps-launcher/winapps-launcher.sh"Environment="LANG=C"ExecStart=/bin/bash -c "\\"\$SCRIPT_PATH\\""ExecStopPost=/bin/bash -c 'echo "[SYSTEMD] WINAPPS LAUNCHER SERVICE EXITED."'TimeoutStartSec=5TimeoutStopSec=5Restart=on-failureRestartSec=5[Install]WantedBy=default.targetEOF

2. Enable the user service.

   systemctl --userenable winapps-launcher --now# Enable & Start Servicesystemctl --user status winapps-launcher# Verify

systemctl --user stop winapps-launcher# Stop Servicesystemctl --user disable winapps-launcher# Disable Servicerm~/.config/systemd/user/winapps-launcher.service# Delete Service