README.md

Vanilla OS Desktop Image with Gnome and Sway-WM

Containerfile for building a Vanilla OS Desktop image with Gnome and Sway-WM.

This image is based on top of vanillaos/desktop and extends the default Vanilla OS Gnome Desktop experience with Sway.

Sway

Sway is a tiling Wayland compositor and a drop-in replacement for the i3 window manager for X11.

Sway allows you to arrange your application windows logically, rather than spatially. Windows are arranged into a grid by default which maximizes the efficiency of your screen and can be quickly manipulated using only the keyboard.

Project Goals

We want to provide a similar experiance as the Manjaro Sway Edition does for Manjaro Linux.

Features

• Vanilla OS background image
• screen locking: swaylock, triggered by swayidle
• app launcher: Fuzzel
• bar: Waybar
• logout menu: wlogout
• notifications: SwayNotificationCenter
• print screen / video capture with Print key: sway-interactive-screenshot
  • XDG Desktop Portal backend: xdg-desktop-portal-wlr
  • grim to take the screenshot
  • slurp to select an area on the screen
  • swappy to edit the captured screenshot
  • xdg-utils to open the captured screenshot with the default image viewer
  • dragon-drop to drag and drop the captured screenshot
  • wl-clipboard to copy the screenshot to the clipboard
  • wf-recorder to capture videos
• brightness control with XF86MonBrightnessUp/Down keys: blight 0.7.1
• based on Vanilla OS Desktop image (Gnome3 desktop)

Managing user applications with systemd

• sway's output handled by journald: journalctl --user --identifier sway
• waybar.service
• swaync.service
• xdg-desktop-portal.service
• xdg-desktop-portal-wlr.service
• sway-session.target
• swayidle.service
• swaylock.service

Guide used: systemd integration - Managing user applications with systemd

Installation

Method A: Custom Image via Live-ISO

Download the Vanilla OS 2 Orchid Live-ISO, flash it to your USB stick and boot from it.

You will see the following dialog:

Select Install Custom Image (Advanced). This installation method differs in one step from the Install method: You can choose the Vanilla OS Image which will be installed by the Vanilla OS Installer.

At some point, you will see the following dialog:

Enter the URL ghcr.io/develangel/desktop-sway:latest.

After installing Vanilla OS, you can follow the First Setup guide to set up your system.

After the First Setup has finished, reboot the system and the First Setup will install the applications.

After reboot, it is time to set your password. [NOTE: Keep the Gnome session active. Do not switch to the Sway session!]

After login, the First Setup installs the previously configured applications.

After the First Setup has finished the finalizing step, the Tour dialog pops up.

Now, it is time to reboot and you are done. Let's switch to the Sway session...

Method B: Change the image in ABRoot

If you have installed Vanilla OS with the Install method, you can point ABRoot to the custom image to use it.

• Open the terminal Black Box.
• Edit the configuration file with the command: abroot config-editor.
• Change the "name" entry from something like vanilla-os/desktop to develangel/desktop-sway. [Note: All characters must be in lowercase.]
• Change the "tag" entry to latest to use releases, only.
• Now, run abroot upgrade to switch to the custom image.
• Reboot.

After reboot, you can select the Sway session when you log in.

Switch to the Sway session

Select the Sway session when you log in the next time.

Build

Note

The fsguard compiled plugin .so file should be downloaded from the latest release and be placed under a plugins directory beside the recipe.yml file.

vib build recipe.yml
podman image build -t vanillaos/desktop-sway .