Aller au contenu principal

Archcraft WSE

Archcraft Wayland Special Edition : An Ultimate Wayland Compositors Experience



This special edition of Archcraft comes with Sway, Wayfire, River, Hyprland and Newm pre-installed, pre-configured and provides you a wayland only Linux experience.


You can download the latest ISO from ko-fi ☕

Default username and password is liveuser


To Create A Bootable USB, See Create A Bootable USB
For Graphical Installation Instructions, See Install Archcraft With Calamares
For CLI Installation Instructions, See Install Archcraft With ABIF


If you're an existing WSE user, you don't need to reinstall the ISO to update the system. Follow the steps below to update your WSE :

  • On regular basis, Just run the following command to update your system -
$ sudo pacman -Syyu
  • When there's a new ISO for WSE get released, an Update Package is also released with ISO for existing WSE users. Use this update package to update WSE specific things.
    • Download the update package existing-wse-update-MONTH-YEAR.tar.gz from ko-fi.
    • Extract it with : tar -xzvf existing-wse-update-MONTH-YEAR.tar.gz
    • Go to extracted directory : cd existing-wse-update-MONTH-YEAR
    • Open a terminal in same directory and run the update script : ./
    • That's it.


Changelog (January 2024) : 7th ISO

Date : January 9th, 2024

  • Updated ISO profile
  • Latest base with new packages
  • Update all Archcraft and AUR packages
  • Updated all wayland compositors
    • Sway: fixed bugs and updated configs
    • Wayfire: migrated to v0.8.0 and updated configs accordingly
    • River: fixed bugs and updated configs
    • Hyprland: using my own hyprland build for stability and updated configs to v0.34.0
    • Newm: fixed issue with waybar gets hidden behind windows and updated configs
  • Migrated alacritty to its new config (yml to toml)
  • Updated all scripts related to alacritty
  • Small improvements and bugs fixed.
Changelog (October 2023) : 6th ISO

Date : October 15th, 2023

  • Updated ISO profile
  • Latest base with new packages
  • Updated all wayland compositors
    • Added better example for multi-monitor support in...
      • Sway: ~/.config/sway/sway-output
      • Wayfire: ~/.config/wayfire.ini
      • River: ~/.config/river/init
      • Hyprland: ~/.config/hypr/hyprland.conf
      • Newm: ~/.config/newm/
  • Added wipe ability in ABIF
  • Fixed issue with help and tips app
  • Small improvements and bugs fixed.
Changelog (July 2023) : 5th ISO

Date : July 11th, 2023

  • Updated ISO profile with latest archiso
  • Latest base with new packages
  • Fixed sddm not saving the last used session issue
  • Added a calculator app
  • Added Welcome and Help-and-Tips App
  • Fixed Scaling issue in QT apps in wayland
  • Sway, Wayfire, River, Hyprland
    • Added bluetooth module on Waybar
    • Added a rofi bluetooth applet
    • Added alacritty terminal
    • Added pywal support
    • Improved a lot of scripts
    • etc
  • Many small bugs fixed.
Changelog (May 2023) : 4th ISO

Date : May 6th, 2023

  • Fixed pacman-init issue
  • Added ability to choose desktop in the installer (calamares)
  • Fixed auto-login issue
  • etc
Changelog (April 2023) : 3rd ISO

Date : April 15th, 2023

  • Using sddm-git now, Solved shutdown/reboot issue
  • Using new method to boot the ISO on Nvidia Machines
  • Updated the Installers with (possible) Nvidia support
  • Updated the base system with latest packages
  • Updated All the wayland compositors
    • Updated the config structure
    • Added Rofi menu, applets and scripts (network, music, etc)
    • Fixed area screenshot overlay issue
    • Fixed nerwork-applet overlay issue in hyprland
    • Modified the configs for waybar, wlogout and wofi (added separate colors.css file)
    • Changes gtk themes in sway, wayfire and hyprland
    • Updated lockscreen script in sway
    • Added two packages for NEWM (one normal and one blur)
    • Added spotify module in waybar in all WCs
    • Animated MPD and spotify modules in waybar
  • Many Bug fixes, etc
Changelog (January 2023) : 2nd ISO

Date : January 10th, 2023

  • Added ABIF (CLI) installer
  • Updated the base system
  • Updated All the compositors
  • Bug fixes, etc
Changelog (October 2022) : 1st ISO

Date : October 20th, 2022

  • Created the ISO base from scratch
  • Grub2 bootloader with themes
  • Customized Plymouth & SDDM
  • Basic Applications Only, No Bloatware
  • Calamares Installer (Graphical)
  • Full Network Manager Support, Various VPN plugins
  • Built-in Bluetooth Support
  • Pipewire For Sound/Audio (Systemwide, Bluetooth, Jack)
  • Built-in Printer Support
  • Almost All Audio, Video and Image Codecs
  • Full File manager functionality (Mounting, Networking, Archiving, etc)
  • Built-in AUR support
  • Minimal User Interface
  • Multiple Wayland Compositors (Sway, Wayfire, River, Hyprland, Newm)
  • Archcraft Icons, Themes, Wallpapers, Fonts
  • Etc


Virtual Machines

This ISO does not work with VMs (Virtualbox, VMware, Qemu, etc). I mean it does but... on some, you won't pass the login screen (SDDM) and on some, the compositors will be very laggy due to poor 3D support.


There is no official support for Nvidia. Unfortunately, their drivers are so messy, and their products so random, that it’s impossible to help if the ISO don’t work on your machine. Every card seems to be random, and might work perfectly, or not work at all. However...
The ISO have everything configured out-of-the-box, Needed to run a wayland compositor on Nvidia. It has all the needed modules enabled into mkinitcpio.conf and initrd, Kernel parameters are added, and the needed proprietary graphics drivers installed.
Now, It's your choise to give it a try.

Update : As Reported, Users are able to boot and Install the ISO on their Nvidia Machines.

More info : Sway Installation, Hyprland Nvidia, wayland Requirements, DRM_kernel_mode_setting, NVIDIA#Installation

Intel Iris XE

Some users reported that, This ISO does not work on systems with Intel Iris XE GPUs.

Update : I've personally tested the ISO with an Nvidia + Intel iris XE system (Dell Inspiron 5520) and the ISO is working just fine.


Click on image to view all the screenshots.





How to use Archcraft WSE?

For any help with Configurations and Keybindings, visit the respective wayland compositor's page.

How to get the Updated ISO/Update package?

Follow the steps below to get updates (or re-download files):

  • Login to you Ko-fi account
  • Go to your Ko-fi Payments History
  • Select the purchases you've made
  • Click on View Details
  • Then, Click on View Content to download the updated files.
Will i get refund if the ISO doesn't work for me?

First of all, It's a donation model of Archcraft, Where you donate to support your favorite open-source project.

Archcraft doesn't accept donations. These exclusive stuff helps Archcraft to fullfill its financial needs. the Idea behind this is, You support Archcraft and in return you'll get a gift. A win-win for both!

All the scenarios are clearly mentioned on this page (see compatibility), about the working of this ISO. If you still choose to go with it (knowing all the details about it) and the ISO did not work for you. Please don't ask for refunds or exchange. I'll definitely help you with your issues and try to solve them as soon as possible.

I need help with this ISO?

The best places to get help quickly are Archcraft Communities. So join them and ask for help there. The links are in footer section of this wiki.

If you face any issue with this, Email me at and feel free to ask for help.

Where do i report issues?

Have you found any bug in the ISO and want to report it, Open an issue on Github