{"id":13438403,"url":"https://github.com/dylanaraps/sowm","last_synced_at":"2025-03-19T18:33:02.062Z","repository":{"id":38712792,"uuid":"214422918","full_name":"dylanaraps/sowm","owner":"dylanaraps","description":"An itsy bitsy floating window manager (220~ sloc!).","archived":true,"fork":false,"pushed_at":"2023-09-10T23:19:47.000Z","size":310,"stargazers_count":905,"open_issues_count":27,"forks_count":70,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-08-01T03:27:15.278Z","etag":null,"topics":["wm","xlib","xorg"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dylanaraps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-10-11T11:49:37.000Z","updated_at":"2024-07-22T23:16:10.000Z","dependencies_parsed_at":"2022-09-14T02:51:00.044Z","dependency_job_id":"6f68e929-8238-427c-bbe9-99d428504692","html_url":"https://github.com/dylanaraps/sowm","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanaraps%2Fsowm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanaraps%2Fsowm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanaraps%2Fsowm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylanaraps%2Fsowm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dylanaraps","download_url":"https://codeload.github.com/dylanaraps/sowm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221729889,"owners_count":16871136,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["wm","xlib","xorg"],"created_at":"2024-07-31T03:01:05.249Z","updated_at":"2024-10-27T20:32:15.276Z","avatar_url":"https://github.com/dylanaraps.png","language":"C","funding_links":[],"categories":["C","Packages"],"sub_categories":["window-managers"],"readme":"# sowm (*~~Simple~~ Shitty Opinionated Window Manager*)\n\n\u003ca href=\"https://user-images.githubusercontent.com/6799467/66687576-9747c200-ec72-11e9-947d-5b96753eab03.jpg\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/6799467/66687576-9747c200-ec72-11e9-947d-5b96753eab03.jpg\" width=\"43%\" align=\"right\"\u003e\u003c/a\u003e\n\nAn itsy bitsy floating window manager (*220~ sloc!*).\n\n- Floating only.\n- Fullscreen toggle.\n- Window centering.\n- Mix of mouse and keyboard workflow.\n- Focus with cursor.\n- Rounded corners (*[through patch](https://github.com/dylanaraps/sowm/pull/58)*)\n- Titlebars (*[through patch](https://github.com/dylanaraps/sowm/pull/57)*)\n\n\u003ca href=\"https://user-images.githubusercontent.com/6799467/66687814-8cd9f800-ec73-11e9-97b8-6ae77876bd1b.jpg\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/6799467/66687814-8cd9f800-ec73-11e9-97b8-6ae77876bd1b.jpg\" width=\"43%\" align=\"right\"\u003e\u003c/a\u003e\n\n- Alt-Tab window focusing.\n- All windows die on exit.\n- No window borders.\n- [No ICCCM](https://web.archive.org/web/20190617214524/https://raw.githubusercontent.com/kfish/xsel/1a1c5edf0dc129055f7764c666da2dd468df6016/rant.txt).\n- No EWMH.\n- etc etc etc\n\n\n\u003cbr\u003e\n\nPatches available here: https://github.com/dylanaraps/sowm/pulls\n\n## Default Keybindings\n\n**Window Management**\n\n| combo                      | action                 |\n| -------------------------- | -----------------------|\n| `Mouse`                    | focus under cursor     |\n| `MOD4` + `Left Mouse`      | move window            |\n| `MOD4` + `Right Mouse`     | resize window          |\n| `MOD4` + `f`               | maximize toggle        |\n| `MOD4` + `c`               | center window          |\n| `MOD4` + `q`               | kill window            |\n| `MOD4` + `1-6`             | desktop swap           |\n| `MOD4` + `Shift` +`1-6`    | send window to desktop |\n| `MOD1` + `TAB` (*alt-tab*) | focus cycle            |\n\n**Programs**\n\n| combo                    | action           | program        |\n| ------------------------ | ---------------- | -------------- |\n| `MOD4` + `Return`        | terminal         | `st`           |\n| `MOD4` + `d`             | dmenu            | `dmenu_run`    |\n| `MOD4` + `p`             | scrot            | `scr`          |\n| `MOD4` + `w`             | wallpaper cycler | `bud`          |\n| `XF86_AudioLowerVolume`  | volume down      | `amixer`       |\n| `XF86_AudioRaiseVolume`  | volume up        | `amixer`       |\n| `XF86_AudioMute`         | volume toggle    | `amixer`       |\n| `XF86_MonBrightnessUp`   | brightness up    | `bri`          |\n| `XF86_MonBrightnessDown` | brightness down  | `bri`          |\n\n\n## Dependencies\n\n- `xlib` (*usually `libX11`*).\n\n\n## Installation\n\n1) Copy `config.def.h` to `config.h` and modify it to suit your needs.\n2) Run `make` to build `sowm`.\n3) Copy it to your path or run `make install`.\n    - `DESTDIR` and `PREFIX` are supported.\n4) (Optional) Apply patch with `git apply patches/patch-name`\n    - In case of applying multiple patches, it has to be done **manually**.\n\nIf you are using GDM, save the following to `/usr/share/xsessions/sowm.desktop`. It is still recommended to start `sowm` from `.xinitrc` or through\n[your own xinit implementation](https://github.com/dylanaraps/bin/blob/dfd9a9ff4555efb1cc966f8473339f37d13698ba/x).\n\n```\n[Desktop Entry]\nName=sowm\nComment=This session runs sowm as desktop manager\nExec=sowm\nType=Application\n```\n\n\n## Thanks\n\n- [2bwm](https://github.com/venam/2bwm)\n- [SmallWM](https://github.com/adamnew123456/SmallWM)\n- [berry](https://github.com/JLErvin/berry)\n- [catwm](https://github.com/pyknite/catwm)\n- [dminiwm](https://github.com/moetunes/dminiwm)\n- [dwm](https://dwm.suckless.org)\n- [monsterwm](https://github.com/c00kiemon5ter/monsterwm)\n- [openbox](https://github.com/danakj/openbox)\n- [possum-wm](https://github.com/duckinator/possum-wm)\n- [swm](https://github.com/dcat/swm)\n- [tinywm](http://incise.org/tinywm.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylanaraps%2Fsowm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdylanaraps%2Fsowm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylanaraps%2Fsowm/lists"}