{"id":13780331,"url":"https://github.com/wizbright/waybox","last_synced_at":"2025-05-11T13:31:55.248Z","repository":{"id":37735601,"uuid":"122101164","full_name":"wizbright/waybox","owner":"wizbright","description":"An openbox clone on Wayland (WIP)","archived":false,"fork":false,"pushed_at":"2024-08-17T03:46:21.000Z","size":2373,"stargazers_count":463,"open_issues_count":4,"forks_count":22,"subscribers_count":44,"default_branch":"master","last_synced_at":"2024-08-17T04:41:07.529Z","etag":null,"topics":["c","openbox","wayland","wip"],"latest_commit_sha":null,"homepage":null,"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/wizbright.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"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}},"created_at":"2018-02-19T18:08:20.000Z","updated_at":"2024-08-17T03:46:24.000Z","dependencies_parsed_at":"2023-11-26T01:32:12.965Z","dependency_job_id":"45105b2d-1815-4974-b70b-ea8392e87cae","html_url":"https://github.com/wizbright/waybox","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wizbright%2Fwaybox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wizbright%2Fwaybox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wizbright%2Fwaybox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wizbright%2Fwaybox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wizbright","download_url":"https://codeload.github.com/wizbright/waybox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225056802,"owners_count":17414212,"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":["c","openbox","wayland","wip"],"created_at":"2024-08-03T18:01:14.598Z","updated_at":"2024-11-17T15:31:06.099Z","avatar_url":"https://github.com/wizbright.png","language":"C","funding_links":[],"categories":["Compositors","Compositor"],"sub_categories":["Stacking"],"readme":"# Waybox\n\nA \\*box-style (minimalist) Wayland compositor modeled largely on Openbox (WIP)\n\n### Goals\n\nThe main goal of this project is to provide a similar feel to \\*box-style window managers but on Wayland\n\n### Contributing\n\n[Details on\ncontributing.](https://github.com/wizbright/waybox/blob/master/CONTRIBUTING.md)\n\n### Dependencies\n\n* [Meson](https://mesonbuild.com/) or [muon](http://muon.build)\n* [Wayland](https://wayland.freedesktop.org/)\n* [libevdev](https://www.freedesktop.org/wiki/Software/libevdev/)\n* [libinput](http://www.freedesktop.org/wiki/Software/libinput)\n* [libxml2](http://xmlsoft.org/)\n* [wlroots](https://gitlab.freedesktop.org/wlroots/wlroots/)\n* [xkbcommon](https://xkbcommon.org/)\n\n### Build instructions\n```\nmeson setup build\ncd build\nninja\n```\n\nAfter that, you should have an executable as waybox/waybox\n\nFor those who don't want to use a Python-based build system, it's also possible\nto use muon instead of Meson.\n\n### Screenshots\n\n![Plain desktop with wallpaper, panel, and dock](../../raw/master/screenshots/emptydesktop.png)\n\n![Showing Firefox and some of the Waybox source code](../../raw/master/screenshots/work.png)\n\n![All work and no play](../../raw/master/screenshots/play.png)\n\n### Useful Programs\n\nBecause \\*box-style compositors are minimalist, most functionality is left to external programs.  As such, Waybox only functions as a box in which you can put whatever you need.  Here are some useful programs to complement Waybox if you desire:\n\n* Panel: You can use [Waybar](https://github.com/Alexays/Waybar) or [yambar](https://codeberg.org/dnkl/yambar), similar to tint2 or fbpanel in Openbox or Fluxbox.\n* Dock: You can use [Cairo Dock](https://www.glx-dock.org/) just like you did on Openbox.  There's also a [port with Wayland-specific enhancements](https://github.com/dkondor/cairo-dock-core/) that you may want to try. A much more compact option is [LavaLauncher](https://sr.ht/~leon_plickat/LavaLauncher/), but it's much harder to configure.\n* Wallpaper utility: There are various utilities to set your wallpaper, each with their own advantages, including [wpaperd](https://github.com/danyspin97/wpaperd) (can select a random wallpaper from a directory), [swaybg](https://github.com/swaywm/swaybg) (can set the background color as well well as a wallpaper), and [hyprpaper](https://github.com/hyprwm/hyprpaper) (can change the wallpaper dynamically during runtime through IPC).\n* Notification client: [mako](https://wayland.emersion.fr/mako/)\n* [wl-clipboard](https://wayland.emersion.fr/mako/): Access the clipboard in scripts (also used by [neovim](https://neovim.io/))\n* Screenshots: [grim](https://git.sr.ht/~emersion/grim) and [slurp](https://github.com/emersion/slurp)\n* Screen recording: [wf-recorder](https://github.com/ammen99/wf-recorder)\n* Menu support: [rofi-wayland](https://github.com/lbonn/rofi)\n\n### Contact\nI can be found as wiz on Rizon and wizbright on Libera. \nJoin [#waybox](https://libera.chat/guides/connect) for discussion\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwizbright%2Fwaybox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwizbright%2Fwaybox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwizbright%2Fwaybox/lists"}