7.5 KiB
Master-Stack Layout
https://github.com/user-attachments/assets/a9d4776e-b50b-48fb-94ce-651d8a749b8a
Scroller Layout
https://github.com/user-attachments/assets/c9bf9415-fad1-4400-bcdc-3ad2d76de85a
Maomaowm
This project is developed based on dwl,
it is basically compatible with all dwm features.
In addition, it is added many operation that supported in hyprland, such as smooth and customizable animation、External configuration that can be hot overloaded,pin mode,maximize window etc...
See below for more features.
separate window layout for each workspace(tags), with separate workspace parameters
support layout
- tile
- scroller
- monocle
- grid
- dwindle
- spiral
window open rules
options
- appid: type-string if match it or title, the rule match
- title: type-string if match it or appid, the rule match
- tags: type-num(1-9) which tags to open the window
- isfloating: type-num(0 or 1)
- isfullscreen: type-num(0 or 1)
- scroller_proportion: type-float(0.1-1.0)
- animation_type : type-string(zoom,slide)
- isnoborder : type-num(0 or 1)
- monitor : type-num(0-99999)
- width : type-num(0-9999)
- height : type-num(0-9999)
some special feature
- hycov like overview
- foreign-toplevel protocol(dunst,waybar wlr taskbar)
- minimize window to waybar(like hych)
- sway scratchpad (minimize window to scratchpad)
- window pin mode/ maximize mode
- text-input-v2/v3 protocol for fcitx5
- window move/open/close animaition
- workspaces(tags) switch animaition
- fade/fadeout animation
- alt-tab switch window like gnome
- niri like scroller layout
suggest tools
yay -S rofi foot xdg-desktop-portal-wlr swaybg waybar wl-clip-persist cliphist wl-clipboard wlsunset
install
stable - wlroots(0.17)
Since 0.18 has some bugs that affect the experience, I chose the more stable 0.17.4.
git clone -b 0.17.4 https://gitlab.freedesktop.org/wlroots/wlroots.git
cd wlroots
meson build -Dprefix=/usr
sudo ninja -C build install
git clone https://github.com/DreamMaoMao/maomaowm.git
cd maomaowm
meson build -Dprefix=/usr
sudo ninja -C build install
unstable wlroots(0.19)
This is the latest version of wlroots, it doesn't own enough test. you can try it out if you want to help to test.
yay -S wlroots-git
git clone -b wlroots-0.19 https://github.com/DreamMaoMao/maomaowm.git
cd maomaowm
meson build -Dprefix=/usr
sudo ninja -C build install
config
you can use MAOMAOCONFIG env to set the config-folder-path and the autostart-folder-patch
like MAOMAOCONFIG=/home/xxx/maomao
-
the only default keybinds is ctrl+alt+[F1-F12] to change tty
-
the default config path is
~/.config/maomao/config.conf -
the default autostart path is
~/.config/maomao/autostart.sh -
the fallback config path is in
/etc/maomao/config.conf, you can find the default config here
keybinds notice
All mod keys(alt,ctrl,shift,super) are case insensitive, in addition to other key names are case sensitive, the name follows the xkb standard name, you can use the xev command to get the key name of the key you want, note that if your mod key contains the shift key, then it may not be the key name displayed on the keyboard. Real name Refer to the name displayed in the xev command.
for example:
this is wrong:
bind=alt+shift,2,quit
this is right:
bind=alt+shift,at,quit
because your keybinds contain shift, the 2 cover to at
custom animation
animation_curve_open=0.46,1.0,0.29,1.1
animation_curve_move=0.46,1.0,0.29,1
animation_curve_tag=0.46,1.0,0.29,1
animation_curve_close=0.46,1.0,0.29,1
You can design your animaition curve in: here, on cssportal.com,
or you can just choice a curve in: easings.net.
overview mode
hotarea_size=10
enable_hotarea=1
ov_tab_mode=0
- enable_hotarea: when your cursor enter the bottom left corner of monitor, it will toggle overview.
- hotarea_size: the size of hotarea, 10x10 default.
- ov_tab_mode:
- it will circle switch focus when you toggle overview.
- and will leave ov mode when you release your mod key.
notice
when you in ov mode, you can use right mouse button to close window, and left mouse button to jump to a window.
About warbar
- you can also use the dwl moudle in waybar to show tags and window title refer to waybar wiki: dwl-module
"modules-left": ["dwl/tags","dwl/window"],
"dwl/tags": {
"num-tags":9,
},
#tags{
background-color: transparent;
}
#tags button{
background-color: #fff ;
color: #a585cd ;
}
#tags button.occupied{
background-color: #fff ;
color: #cdc885 ;
}
#tags button.focused{
background-color: rgb(186, 142, 213);
color: #fff ;
}
#tags button.urgent{
background: rgb(171, 101, 101);
color: #fff;
}
#window{
background-color: rgb(237, 196, 147);
color: rgb(63, 37, 5);
}
window#waybar.empty #window {
background-color: transparent;
color: transparent;
border-bottom:none;
box-shadow: none;
padding-right: 0px;
padding-left: 0px;
margin-left: 0px;
margin-right: 0px;
}
NixOS+Home-manager
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
home-manager = {
url = "github:nix-community/home-manager";
inputs.nixpkgs.follows = "nixpkgs";
};
flake-parts.url = "github:hercules-ci/flake-parts";
maomaowm.url = "github:DreamMaoMao/maomaowm";
};
outputs =
inputs@{ self, flake-parts, ... }:
flake-parts.lib.mkFlake { inherit inputs; } {
debug = true;
systems = [ "x86_64-linux" ];
flake = {
nixosConfigurations = {
hostname = inputs.nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [
inputs.home-manager.nixosModules.home-manager
{
home-manager = {
useGlobalPkgs = true;
useUserPackages = true;
backupFileExtension = "backup";
users."username".imports =
[
(
{ ... }:
{
wayland.windowManager.maomaowm = {
enable = true;
settings = ''
# see config.conf
'';
autostart_sh = ''
# see autostart.sh
# Note: here no need to add shebang
'';
};
}
)
]
++ [
# Add maomaowm hm module
inputs.maomaowm.hmModules.maomaowm
];
};
}
];
};
};
};
};
}
my dotfile
thanks for some refer repo
-
https://gitlab.freedesktop.org/wlroots/wlroots - implementation of wayland protocol
-
https://github.com/dqrk0jeste/owl - basal window animaition
-
https://codeberg.org/dwl/dwl - basal dwl feature
-
https://github.com/guyuming76/dwl - sample of text-input protocol
-
https://github.com/swaywm/sway - sample of wayland protocol