Minimal, flexible & user-friendly X and Wayland tiling window manager with rust

Last update: Aug 28, 2023

Overview

SSWM

Minimal, flexible & user-friendly X and Wayland tiling window manager but with rust.
Feel free to open issues and make pull requests.

[Overview]

SSWM means Saffron Spring Window Manager.
Saffron and Spring are the two well-known revolutions in burma (my home country).
Main focus of the SSWM is to create Free, User Friendly, Configurable, Fast and Safe window manager for both X and Wayland.
SSWM is a part of the project Project SS.

Note: Not recommended to use with Wayland as of now.

[Features]

[RoadMap]

[Configuration]

SSWM will auto generate config file to $HOME/.config/sswm/config.yml
SSWM uses .yaml format for user-friendly configuration.

[Default Config File]

---
max_main: 1
normal_bordar: 0
focused_bordar: 4278190335
workspace_tags:
  - "1"
  - "2"
  - "3"
  - "4"
  - "5"
  - "6"
  - "7"
  - "8"
ratio: 0.6
ratio_step: 0.1
outer_gaps: 5
inner_gaps: 5
top_gaps: 0
start_up: []
commands:
  - keybind: M-S-Return
    command: alacritty
  - keybind: M-x
    command: firefox
actions:
  - keybind: M-S-x
    action: eXit # case doesn't matter for action names
  - keybind: M-S-q
    action: kiLL
xcommands:
  - keybind: M-A-e
    command: emacs
  - keybind: M-C-v
    command: vim
xactions:
  - keybind: M-j
    action: focusNext
  - keybind: M-f
    action: ToggleFullScreen
  - keybind: M-k
    action: focusPrevious
  - keybind: M-S-j
    action: SwapDown
  - keybind: M-S-k
    action: SwapUp
  - keybind: M-S-f
    action: floatfocused
  - keybind: M-Tab
    action: ToggleTag
  - keybind: M-bracketright
    action: FocusNextScreen
  - keybind: M-bracketleft
    action: FocusPreviousScreen
  - keybind: M-grave
    action: NextLayout
  - keybind: M-S-grave
    action: PreviousLayout
  - keybind: M-S-Up
    action: IncMain
  - keybind: M-S-Down
    action: DecMain
  - keybind: M-S-Right
    action: ExpandMain
  - keybind: M-S-Up
    action: ShrinkMain
wcommands:
  - keybind: M-S-Return
    command: kitty
wactions: []

[Config Options]

Option	Format	Description
max_main	Integer	Maximum number of windows in the main area of the layout.
normal_border	Integer	Border color for normal (unfocused) windows.
focused_border	Integer	Border color for focused windows.
workspace_tags	List of Strings	List of workspace tags.
ratio	Float	Initial ratio of the main area to the whole screen.
ratio_step	Float	Step size for adjusting the main area ratio.
outer_gaps	Integer	Outer gaps (spacing) between windows and the screen edges.
inner_gaps	Integer	Inner gaps (spacing) between windows.
top_gaps	Integer	Gaps at the top of the screen for panels or other elements.
start_up	List of Strings	List of commands to run on startup.
commands	List of Command Objects	List of keybindings and associated commands to execute For Both X and Wayland.
actions	List of Action Objects	List of keybindings and associated actions to perform For Both X and Wayland.
xcommands	List of Command Objects	List of keybindings and associated commands to execute For X11.
xactions	List of Action Objects	List of keybindings and associated actions to perform For X11.
wcommands	List of Command Objects	List of keybindings and associated commands to execute For Wayland.
wactions	List of Action Objects	List of keybindings and associated actions to perform For Wayland.

If x and w specified commands and actions(e.g. xactions, wcommands), they might override the commands and actions if they are in conflict.

[Actions]

Actions	Description
Kill	Kill the focused window.
Exit	Exit the window manager.
FocusNext	Focus the next window.
FocusPrevious	Focus the previous window.
SwapDown	Swap the focused window with the one below.
SwapUp	Swap the focused window with the one above.
ToggleFullScreen	Toggle fullscreen mode for the focused window.
FloatFocused	Float the currently focused window.
ToggleTag	Toggle the tag of the focused window.
FocusNextScreen	Focus the next screen.
FocusPreviousScreen	Focus the previous screen.
NextLayout	Switch to the next layout.
PreviousLayout	Switch to the previous layout.
IncMain	Increase the size of the main area.
DecMain	Decrease the size of the main area.
ExpandMain	Expand the main area.
ShrinkMain	Shrink the main area.

Case doesn't matter for writing Actions name.
kill, Kill, KiLL all work.

[Required Packages]

rustup
xorg
libwayland
libxkbcommon
libudev
libinput
libgbm
libseat

[Installation]

git clone https://github.com/Walker-00/sswm
cd sswm
cargo install --path .
sudo cp sswm.desktop sswm_way.desktop /usr/share/xsessions/.

[ScreenShot]

[Voices From Burma]

Currently, Burma is under the Military rule and as a burmese, living under the dictatorship is extremely chellenging.
But we stayed strong and are fighting against Military Junta's bullets and violence.
We demand Justice and Democracy.
And we kindly want to ask for the International support and attention.

You might also like...

Watches changes in a rust project, runs test and shows friendly notification

Cargo testify Automatically runs tests on your Rust project and notifies about the result. Install Install prerequisites (for Debian/Ubuntu): apt-get

77 May 16, 2022

Rust Util Collection, a simple and friendly error-chain

RUC Rust Util Collection, a simple and friendly error-chain, with many useful utils as an addition. The painful experience of using error-chain gave b

8 Dec 8, 2022

Rust Util Collection, a simple and friendly error-chain, with many useful utils as an addition.

RUC Rust Util Collection, a simple and friendly error-chain, with many useful utils as an addition. The painful experience of using error-chain gave b

6 Mar 27, 2022

A strict, yet friendly mocking library for Rust 2018

Mockiato A strict, yet friendly mocking library for Rust 2018 ⚠️ Disclaimer for working with stable rust Mockiato relies on the unstable proc_macro_di

228 Dec 30, 2022

🐦 Friendly little instrumentation profiler for Rust 🦀

🐦 puffin The friendly little instrumentation profiler for Rust How to use fn my_function() { puffin::profile_function!(); ... if ... {

848 Dec 29, 2022

dbt Cloud™️ infrastructure-as-code that is friendly to analysts

dbterra dbt Cloud ™️ infrastructure-as-code that is friendly to analysts, bizops, etc Motivation While there are Terraform ™️ plugins that can be used

6 May 2, 2023

A lean, minimal, and stable set of types for color interoperation between crates in Rust.

This library provides a lean, minimal, and stable set of types for color interoperation between crates in Rust. Its goal is to serve the same function that mint provides for (linear algebra) math types.

16 Sep 21, 2022

A program written in Rust, that allows the user to find the current location of the International Space Station and see it on a map.

ISS Location ViewFinder A program written in Rust, that allows the user to find the current location of the International Space Station and see it on

2 Nov 8, 2021

untyped-arena provides an Arena allocator implementation that is safe and untyped with minimal complexity

untyped-arena untyped-arena provides an Arena allocator implementation that is safe and untyped with minimal complexity Usage let arena = Arena::new()

1 Jan 9, 2022

Comments

Make README a little bit more readable and fix a few typos

fixed a few spelling errors and re-wrote the [Voices from Burma] sessions.

Please pay attention to this line

original

If x and w specified commands and actions might be overrided to commands and actions if they were conflit.

fixed version

If x and w specified commands and actions(e.g. xactions, wcommands), they might override the commands and actions if they are in conflict.

is this what you intend to describe?

opened by mustardfrog 1
Error on compiling

OS: Ubuntu 20.04LTS

cargo-src: from package managers

DE: no

WM: yes(I3wm)

try to compile on i3wm but it's an error while compiling.

TERMINAL LOGS::

error: failed to run custom build command for libseat-sys v0.1.7

Caused by: process didn't exit successfully: /home/woody/Desktop/nestProjects/task-scheduling/sswm/target/release/build/libseat-sys-766419febbf22492/build-script-build (exit status: 101) --- stdout cargo:rerun-if-env-changed=LIBSEAT_NO_PKG_CONFIG cargo:rerun-if-env-changed=PKG_CONFIG_x86_64-unknown-linux-gnu cargo:rerun-if-env-changed=PKG_CONFIG_x86_64_unknown_linux_gnu cargo:rerun-if-env-changed=HOST_PKG_CONFIG cargo:rerun-if-env-changed=PKG_CONFIG cargo:rerun-if-env-changed=LIBSEAT_STATIC cargo:rerun-if-env-changed=LIBSEAT_DYNAMIC cargo:rerun-if-env-changed=PKG_CONFIG_ALL_STATIC cargo:rerun-if-env-changed=PKG_CONFIG_ALL_DYNAMIC cargo:rerun-if-env-changed=PKG_CONFIG_PATH_x86_64-unknown-linux-gnu cargo:rerun-if-env-changed=PKG_CONFIG_PATH_x86_64_unknown_linux_gnu cargo:rerun-if-env-changed=HOST_PKG_CONFIG_PATH cargo:rerun-if-env-changed=PKG_CONFIG_PATH cargo:rerun-if-env-changed=PKG_CONFIG_LIBDIR_x86_64-unknown-linux-gnu cargo:rerun-if-env-changed=PKG_CONFIG_LIBDIR_x86_64_unknown_linux_gnu cargo:rerun-if-env-changed=HOST_PKG_CONFIG_LIBDIR cargo:rerun-if-env-changed=PKG_CONFIG_LIBDIR cargo:rerun-if-env-changed=PKG_CONFIG_SYSROOT_DIR_x86_64-unknown-linux-gnu cargo:rerun-if-env-changed=PKG_CONFIG_SYSROOT_DIR_x86_64_unknown_linux_gnu cargo:rerun-if-env-changed=HOST_PKG_CONFIG_SYSROOT_DIR cargo:rerun-if-env-changed=PKG_CONFIG_SYSROOT_DIR

--- stderr thread 'main' panicked at 'called Result::unwrap() on an Err value: "pkg-config" "--libs" "--cflags" "libseat" did not exit successfully: exit status: 1 error: could not find system library 'libseat' required by the 'libseat-sys' crate

--- stderr Package libseat was not found in the pkg-config search path. Perhaps you should add the directory containing libseat.pc' to the PKG_CONFIG_PATH environment variable Package 'libseat', required by 'virtual:world', not found ', /root/.cargo/registry/src/github.com-1ecc6299db9ec823/libseat-sys-0.1.7/build.rs:30:42 note: run withRUST_BACKTRACE=1environment variable to display a backtrace warning: build failed, waiting for other jobs to finish... error: failed to compilesswm v0.0.1 (/home/woody/Desktop/nestProjects/task-scheduling/sswm), intermediate artifacts can be found at/home/woody/Desktop/nestProjects/task-scheduling/sswm/target`

screen shot?

documentation

opened by RizeKishimaro 6
Suggestion to have xmonad/dwm configuration

Would be kinda cool to have an easy way to config your entire project by modifying the source code, similarly to how xmonad and dwm does it. This gives the user much more control.
help wanted

opened by Raj2032 14

Owner

Linus Walker

15 y.o Founder of @Null-Gate, A mad man.

GitHub

A scrollable-tiling Wayland compositor.

niri The beginnings of a scrollable-tiling Wayland compositor. Status Heavily work in progress. The occasional thing works, but likely is in a half-br

17 Aug 16, 2023

Let Tauri's transparent background rendering window be stacked on Bevy's rendering window in real time to run the game with native-level performance!

Native Bevy with Tauri HUD DEMO 将 Tauri 的透明背景渲染窗口实时叠在 Bevy 的渲染窗口上，以使用原生级别性能运行游戏！ Let Tauri's transparent background rendering window be stacked on Bev

3 Mar 25, 2024

Minimal, flexible & user-friendly X and Wayland tiling window manager with rust

Related tags

Overview

You might also like...

Watches changes in a rust project, runs test and shows friendly notification

Rust Util Collection, a simple and friendly error-chain

Rust Util Collection, a simple and friendly error-chain, with many useful utils as an addition.

A strict, yet friendly mocking library for Rust 2018

🐦 Friendly little instrumentation profiler for Rust 🦀

dbt Cloud™️ infrastructure-as-code that is friendly to analysts

A lean, minimal, and stable set of types for color interoperation between crates in Rust.

A program written in Rust, that allows the user to find the current location of the International Space Station and see it on a map.

untyped-arena provides an Arena allocator implementation that is safe and untyped with minimal complexity

Comments

Owner

Linus Walker

A scrollable-tiling Wayland compositor.

Let Tauri's transparent background rendering window be stacked on Bevy's rendering window in real time to run the game with native-level performance!

Minimal, flexible framework for implementing solutions to Advent of Code in Rust

Byte is a blazingly fast🚀 Discord Bot with a user-friendly design using twilight written in rust🦀.

`xrandr` for Gnome/wayland, on distros that don't support `wlr-randr`

Demonstration of flexible function calls in Rust with function overloading and optional arguments

Cross-platform Window library in Rust for Tauri. [WIP]

Flexible snowflake generator, reference snoyflake and leaf.

A flexible, simple to use, immutable, clone-efficient String replacement for Rust

Concatenate Amazon S3 files remotely using flexible patterns