{"id":18852478,"url":"https://github.com/instantos/instantwm","last_synced_at":"2025-04-14T10:02:42.578Z","repository":{"id":40451995,"uuid":"233308257","full_name":"instantOS/instantWM","owner":"instantOS","description":"The window manager for instantOS","archived":false,"fork":false,"pushed_at":"2023-10-28T15:43:16.000Z","size":6219,"stargazers_count":333,"open_issues_count":24,"forks_count":38,"subscribers_count":16,"default_branch":"main","last_synced_at":"2024-05-23T08:23:47.436Z","etag":null,"topics":["hacktoberfest","instantos"],"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/instantOS.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,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-01-11T22:52:00.000Z","updated_at":"2024-04-02T15:00:03.000Z","dependencies_parsed_at":"2024-04-14T01:41:47.567Z","dependency_job_id":null,"html_url":"https://github.com/instantOS/instantWM","commit_stats":{"total_commits":2345,"total_committers":43,"mean_commits":54.53488372093023,"dds":0.7505330490405118,"last_synced_commit":"291ab43398af281dbb162d2a9ca5aa59a5c8d328"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantWM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantWM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantWM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantWM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/instantOS","download_url":"https://codeload.github.com/instantOS/instantWM/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223629082,"owners_count":17176061,"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":["hacktoberfest","instantos"],"created_at":"2024-11-08T03:40:14.267Z","updated_at":"2024-11-08T03:40:14.720Z","avatar_url":"https://github.com/instantOS.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003ch1\u003einstantWM\u003c/h1\u003e\n    \u003cp\u003eWindow manager for instantOS\u003c/p\u003e\n    \u003cimg width=\"300\" height=\"300\" src=\"https://raw.githubusercontent.com/instantOS/instantLOGO/main/png/wm.png\"\u003e\n\u003c/div\u003e\n\ninstantWM the window manager of instantOS.\n\n![img](https://github.com/instantOS/instantLOGO/blob/main/screeenshots/screenshot1.png)\n\n## Installation\n\nIt is preinstalled on instantOS.\nYou can manually install the git build at your own risk by cloning the repo and then running build.sh,\nhowever you'll likely be missing a lot of other tools if you're not on instantOS.\nIt is not recommended to use instantWM with other distributions.\n\n```sh\ngit clone --depth=1 https://github.com/instantOS/instantWM.git\ncd instantWM\n./build.sh\n```\n\n[Download latest release](https://github.com/instantOS/instantWM/releases/download/beta2/instantwm.pkg.tar.xz)\n\n## [Documentation](https://instantos.io/documentation)\n\nDocumentation for instantWM can be found in the general documentation for\ninstantOS and the instructional screencasts.  It is not described in this\nREADME\n\n## Features\n\nThis is just a quick list of some features. For a full list and explanation,\nplease refer to the documentation.\n\n- General\n  * hybrid-wm: tiling and floating mode\n  * Keyboard and Mouse based workflows\n  * start menu\n  * desktop bindings\n  * full multi monitor support\n  * tag system\n  * overview mode\n  * overlays\n- Graphical Features\n  * Animations\n  * Hover indicators\n  * Status markup\n  * color indicators for sticky windows, tag status etc.\n- Mouse support\n  * Drag windows by grabbing the title\n  * Drag windows onto other tags\n  * Rio-like drawing feature\n\n## TODO\n\n- [ ] look at if hack to fix rendering locking up on unknown characters is still needed\n\n\n## Background information\n\ninstantWM is a dwm fork, but contains less than 40% original dwm code.  Most of\nthe changed and added code is completely original which means there are no\npatches replicating the behaviour for dwm. It also makes instantWM incompatible\nwith dwm patches.  Why go this route? Why not just use dwm patches?  The\nfeatures patches introduce are by nature completely isolated. They have no way\nof knowing what else is applied to the WM and therefore are limited in their\nusage of other parts of the WM.  Not relying on patches enables huge amounts of\nfreedom.  Take for instance sticky windows. They are a simple concept, but need\na few checks in some places that adjust behaviour based on wether a window is\nsticky or not. A patch can only apply this to code present in the barren\nvanilla version.  Other examples of this include animations and overlays or\nscratchpads.  Most features weren't available as patches anyway.  instantWM has\ndifferent goals than dwm.  It prioritizes stability, speed and features over\nlines of code.  It aims to have excellent mouse and touch screen support.  It\ncontains graphical features like animations and hover indicators that make it\nlook more appealing.  It is meant to be used as is. instantOS has every feature\nthat a desktop enviroment has or offers a replacement and instantWM closely\nfollows this \"just works\" approach and in many ways goes beyond the\ncapabilities of a desktop environment.  This makes it a possible choice for new\nor casual users that cannot be bothered to learn C, vim, git, bash and loads of\nother stuff just to do their email.\n\n### instantOS is still in early beta, contributions always welcome\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstantos%2Finstantwm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finstantos%2Finstantwm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstantos%2Finstantwm/lists"}