maomaowm/README.md
DreamMaoMao 5f1aa15a35 fix: drag file in x11 app fail
update readme
2025-02-17 15:15:08 +08:00

97 lines
2.4 KiB
Markdown

#
Master-Stack Layout
https://github.com/user-attachments/assets/da80c6d1-b9a5-44c4-b738-6421365e6aa5
Scroller Layout
https://github.com/user-attachments/assets/2ff96868-b276-4fa1-b4d7-87bdc36beb3c
# Maomaowm
This project is developed based on `dwl(0.5)` ,
adding many operation that supported in hyprland and a hyprland-like keybinds,
niri-like scroll layout and sway-like scratchpad.
See below for more features.
# separate window layout for each workspace(tags), with separate workspace parameters
## support layout
- tile(master)
- scroller
- monocle
- grid
- dwindle
- sprial
# 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 support(dunst,waybar wlr taskbar)
- minimize window to waybar(like hych)
- sway scratchpad support (minimize window to scratchpad)
- window pin mode support
- text-input-v2/v3 for fcitx5
- window move/open animaition
- workspace switch animaition
- fade in animation
- alt-tab switch window like gnome
- niri like scroller layout
## suggest tools
```
yay -S wofi foot xdg-desktop-portal-wlr swaybg waybar wl-clip-persist cliphist wl-clipboard wlsunset
```
# install
# wlroots(0.17)
```
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
# set your autostart app ih this
mkdir -p ~/.config/maomao/
# some suggest config
cp waybar ~/.config/maomao/ -r
cp wofi ~/.config/maomao/ -r
cp wallpaper ~/.config/maomao/ -r
```
# config
the config file is `~/.config/maomao/config.conf`
the autostart file is `~/.config/maomao/autostart.sh`
# thanks for some refer repo
- https://github.com/dqrk0jeste/owl - for basal window animaition
- https://github.com/djpohly/dwl - for basal dwl feature
- https://github.com/guyuming76/dwl - for text-input
- https://github.com/swaywm/sway - for foreign-toplevel