{"id":20563289,"url":"https://github.com/banchouboo/boowm-x11fs","last_synced_at":"2025-04-14T14:42:29.307Z","repository":{"id":180783119,"uuid":"273307896","full_name":"BanchouBoo/boowm-x11fs","owner":"BanchouBoo","description":"Window management tools built on top of https://github.com/periish/x11fs","archived":false,"fork":false,"pushed_at":"2020-07-19T07:45:10.000Z","size":22,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-28T03:41:14.967Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BanchouBoo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-06-18T18:08:17.000Z","updated_at":"2020-09-10T15:04:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"f5b0e66a-6d98-4c70-9d53-7004d31f36c4","html_url":"https://github.com/BanchouBoo/boowm-x11fs","commit_stats":null,"previous_names":["banchouboo/boowm-x11fs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BanchouBoo%2Fboowm-x11fs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BanchouBoo%2Fboowm-x11fs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BanchouBoo%2Fboowm-x11fs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BanchouBoo%2Fboowm-x11fs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BanchouBoo","download_url":"https://codeload.github.com/BanchouBoo/boowm-x11fs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248898602,"owners_count":21179803,"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":[],"created_at":"2024-11-16T04:17:27.846Z","updated_at":"2025-04-14T14:42:29.283Z","avatar_url":"https://github.com/BanchouBoo.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# boowm\n\n## main script\n#### basic window controls you can use to build a window manager with\n```java\nusage: boowm [action] [wid] [args]\n\tfocus                      focus specified window\n\tmap          [true/false]  set window map status\n\tignore       [true/false]  set window ignore status\n\tpos          [int] [int]   set x and y position of window\n\tmove         [int] [int]   add/subtract x and y position from window\n\tsize         [int] [int]   set width and height of window\n\tstretch      [int] [int]   add/subtract width and height from window\n\tswap         [wid]         swap the position and size of two windows\n\tborder_width [int]         set the border width of window\n\tborder_color [hex]         set the border color of window\n\tstack        [raise/lower] move window to the top/bottom of stack\n\n\tNOTE: you can use \"focused\" in place of a window id\n```\n\n## extensions\n\n### tags\n#### a dwm-like tags system for managing workspaces (very WIP)\n\n### rules\n#### event handler for window rules on window creation\nWindow rules should be an executable script located in `~/.config/boowm/rules` which takes the window id as the first argument. Rules are parsed via the file name itself and should be formatted as `class:instance:title`. You may use wildcards in the filenames as well.\n\nex: `St:st:*` would match only st windows that do not specify an instance, whereas `St:*:*` would match any st window.\n\n### focuser\n#### event handler that focuses windows when created or when the mouse enters them\n\n### addborder\n#### event handler to add borders to windows when on creation\n\n### nearsest\n#### script to get the nearest window in a direction and prints it to stdout (needs rewrite to be more accurate)\nex: `boowm nearset focused right` would get the window closest to the right of the focused window\n\n`boowm nearest focused right | boowm swap focused` would swap the window to the right of the focused window with the focused window\n\n### cells\n#### script for positioning and sizing windows aligned to a grid, with support for gaps in the grid, outer gaps, space for a bar, and configurable cell count on the x and y axis\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbanchouboo%2Fboowm-x11fs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbanchouboo%2Fboowm-x11fs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbanchouboo%2Fboowm-x11fs/lists"}