{"id":20565877,"url":"https://github.com/phenax/bsp-layout","last_synced_at":"2025-04-05T11:11:07.396Z","repository":{"id":37011381,"uuid":"251409313","full_name":"phenax/bsp-layout","owner":"phenax","description":"Manage layouts in bspwm (tall and wide)","archived":false,"fork":false,"pushed_at":"2024-06-16T02:18:57.000Z","size":140,"stargazers_count":376,"open_issues_count":22,"forks_count":29,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-29T10:08:05.549Z","etag":null,"topics":["bash","bspwm","i3","layout","window-manager"],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/phenax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://www.paypal.me/phenax","https://www.buymeacoffee.com/phenax"],"github":["phenax"]}},"created_at":"2020-03-30T19:34:58.000Z","updated_at":"2025-03-25T07:22:16.000Z","dependencies_parsed_at":"2024-12-01T16:11:21.078Z","dependency_job_id":null,"html_url":"https://github.com/phenax/bsp-layout","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/phenax%2Fbsp-layout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phenax%2Fbsp-layout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phenax%2Fbsp-layout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phenax%2Fbsp-layout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phenax","download_url":"https://codeload.github.com/phenax/bsp-layout/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247325693,"owners_count":20920714,"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":["bash","bspwm","i3","layout","window-manager"],"created_at":"2024-11-16T04:39:23.003Z","updated_at":"2025-04-05T11:11:07.377Z","avatar_url":"https://github.com/phenax.png","language":"Shell","funding_links":["https://www.paypal.me/phenax","https://www.buymeacoffee.com/phenax","https://github.com/sponsors/phenax"],"categories":[],"sub_categories":[],"readme":"# bsp-layout\nManage layouts in bspwm (tall and wide)\n\n[BSPWM](https://github.com/baskerville/bspwm) does one thing and it does it well. It is a window manager. But some workflows require layout management to some extent. `bsp-layout` fills that gap.\n\n\u003e **[Looking for maintainers](https://github.com/phenax/bsp-layout/issues/27)**\n\n\n\n### Dependencies\n* `bash`\n* `bspc`\n* `bc`\n* `man`\n\n\n### Installation\n\n#### AUR\nArch users can install it from AUR [bsp-layout](https://aur.archlinux.org/packages/bsp-layout) or [bsp-layout-git](https://aur.archlinux.org/packages/bsp-layout-git)\n```bash\n# If you are using yay\nyay -S bsp-layout\n\n# Or for git master\nyay -S bsp-layout-git\n```\n\n#### Install script\nOthers can install it directly using the install script.\n\n**Note: Please read scripts like these before executing it on your machine**\n```bash\ncurl https://raw.githubusercontent.com/phenax/bsp-layout/master/install.sh | bash -;\n```\n\n#### Clone and make\nYou can also clone the repo on your machine and run `sudo make install` in the cloned directory\n\n\n\n### Supported layouts\n\n* `tall` - Master-stack with a tall window.\n```\n_______________\n|        |____|\n|        |____|\n|        |____|\n|________|____|\n```\n\n* `rtall` - Master-stack with a reversed tall window.\n```\n_______________\n|____|        |\n|____|        |\n|____|        |\n|____|________|\n```\n\n* `wide` - Master-stack with a wide window.\n```\n_______________\n|             |\n|             |\n|_____________|\n|____|____|___|\n```\n\n* `rwide` - Master-stack with a reversed wide window.\n```\n_______________\n|____|____|___|\n|             |\n|             |\n|_____________|\n```\n\n* `grid` - Horizontal grid layout\n```\n_____________\n|   |   |   |\n|___|___|___|\n|   |   |   |\n|___|___|___|\n```\n\n* `rgrid` - Vertical grid layout\n```\n_____________\n|_____|_____|\n|_____|_____|\n|_____|_____|\n```\n\n\n* `even` - Evenly balances all window areas\n```\n_______________\n|___|____|____|\n|___|____|____|\n|___|____|____|\n\nOR\n_______________\n|    |        |\n|    |________|\n|    |        |\n|____|________|\n```\n\n* `tiled` - Default bspwm's tiled layout\n```\n_______________\n|        |    |\n|        |____|\n|        |  | |\n|________|__|_|\n```\n\n* `monocle` - Default bspwm's monocle layout\n```\n_______________\n|             |\n|             |\n|             |\n|_____________|\n```\n\n\n\n### Usage\n\n* Help menu\n```bash\nbsp-layout help\n```\n\n* Set a layout in desktop named 6\nNot specifying the desktop will apply the layout on the focused desktop\n```bash\nbsp-layout set tall 6\n```\n\n* Set tall layout to desktop with a 40% split\nSet the master size for layout\n```bash\n// Currently focused workspace\nbsp-layout set tall -- --master-size 0.4\n\n// Workspace 6\nbsp-layout set tall 6 -- --master-size 0.4\n```\n\n* Remove layout applied to desktop named 6\nThis will remove any layout applied\n```bash\nbsp-layout remove 6\n```\n\n* Apply a layout on your focused workspace once\nThis will apply the layout on the current set of nodes on that workspace but newer nodes won't conform to the layout.\n```bash\nbsp-layout once tall\n```\n\n* Go back through layouts\nGo back through all (or a custom list of) layouts.\n```bash\n# Switch to previous layout\nbsp-layout previous\n\n# Or to go back through a custom list of layouts\nbsp-layout previous --layouts tall,monocle,wide\n\n# For a specific desktop\nbsp-layout previous --layouts tall,monocle,wide --desktop 4\n```\n\n* Go through layouts\nGo through all (or a custom list of) layouts.\n```bash\n# Switch to next layout\nbsp-layout next\n\n# Or to go through a custom list of layouts\nbsp-layout next --layouts tall,monocle,wide\n\n# For a specific desktop\nbsp-layout next --layouts tall,monocle,wide --desktop 4\n```\n\n* Toggle layout\n```bash\n# Toggle between monocle and tall layouts\nbsp-layout next tall,monocle\n```\n\n\n\n### Configuration\n\nYou can configure the size of the master window in percentage in `$XDG_CONFIG_DIR/bsp-layout/layoutrc` file.\nAn example of that file can be found in [`example.layoutrc`](https://github.com/phenax/bsp-layout/blob/master/example.layoutrc)\n\n```bash\nmkdir ~/.config/bsp-layout \u0026\u0026 curl https://raw.githubusercontent.com/phenax/bsp-layout/master/example.layoutrc \u003e ~/.config/bsp-layout/layoutrc;\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphenax%2Fbsp-layout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphenax%2Fbsp-layout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphenax%2Fbsp-layout/lists"}