{"id":16602789,"url":"https://github.com/bbidulock/adwm","last_synced_at":"2025-03-16T21:30:51.562Z","repository":{"id":13864765,"uuid":"16562595","full_name":"bbidulock/adwm","owner":"bbidulock","description":"advanced dynamic window manager","archived":false,"fork":false,"pushed_at":"2024-03-27T06:28:42.000Z","size":9741,"stargazers_count":64,"open_issues_count":5,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-02-27T14:31:03.964Z","etag":null,"topics":["ewmh","icccm","stacking","tiling-window-manager","window-manager"],"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/bbidulock.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS"}},"created_at":"2014-02-05T23:34:12.000Z","updated_at":"2025-01-13T03:35:15.000Z","dependencies_parsed_at":"2024-01-10T21:02:00.540Z","dependency_job_id":"0896ac2e-54fe-48fd-9ec4-3b3cb12e576a","html_url":"https://github.com/bbidulock/adwm","commit_stats":null,"previous_names":[],"tags_count":61,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbidulock%2Fadwm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbidulock%2Fadwm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbidulock%2Fadwm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbidulock%2Fadwm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbidulock","download_url":"https://codeload.github.com/bbidulock/adwm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243830939,"owners_count":20354853,"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":["ewmh","icccm","stacking","tiling-window-manager","window-manager"],"created_at":"2024-10-12T00:23:52.903Z","updated_at":"2025-03-16T21:30:50.633Z","avatar_url":"https://github.com/bbidulock.png","language":"C","readme":"[adwm -- read me first file.  2024-03-27]: #\n\nadwm\n===============\n\nPackage `adwm-0.7.17` was released under GPLv3 license\n2024-03-27.\n\nThis was originally a fork of Echinus which in turn was a fork of `dwm(1)`,\nand borrows concepts from `velox(1)`, `awesome(1)`, `spectrwm(1)` and\n`wmii(1)`.  What it includes is a full rewrite with significant updates and\nadditions resulting in full EWMH (NetwM), WMH (WinWM), MWMH (CDE/Motif),\nICCCM 2.0 compliance and support.\n\nThe source for `adwm` is hosted on [GitHub][1].\n\n\nRelease\n-------\n\nThis is the `adwm-0.7.17` package, released 2024-03-27.\nThis release, and the latest version, can be obtained from [GitHub][1],\nusing a command such as:\n\n    $\u003e git clone https://github.com/bbidulock/adwm.git\n\nPlease see the [RELEASE][3] and [NEWS][4] files for release notes and\nhistory of user visible changes for the current version, and the\n[ChangeLog][5] file for a more detailed history of implementation\nchanges.  The [TODO][6] file lists features not yet implemented and\nother outstanding items.\n\nThe file [COMPLIANCE][7] lists the current state of EWMH/ICCCM compliance.\n\nPlease see the [INSTALL][8] file for installation instructions.\n\nWhen working from `git(1)`, please use this file.  An abbreviated\ninstallation procedure that works for most applications appears below.\n\n`echinus(1)` and `dwm(1)` were published under the MIT/X Consortium License\nthat can be found in the file [LICENSE][9].  As over 90% of the source file\nlines have been supplied or replaced and the remaining 10% is not subject\nto copyright,\nthis release is published under GPLv3.  Please see the license in the\nfile [COPYING][10].\n\n\nQuick Start\n-----------\n\nThe quickest and easiest way to get `adwm` up and\nrunning is to run the following commands:\n\n    $\u003e git clone https://github.com/bbidulock/adwm.git\n    $\u003e cd adwm\n    $\u003e ./autogen.sh\n    $\u003e ./configure\n    $\u003e make\n    $\u003e make DESTDIR=\"$pkgdir\" install\n\nThis will configure, compile and install `adwm` the\nquickest.  For those who like to spend the extra 15 seconds reading\n`./configure --help`, some compile time options can be turned on and off\nbefore the build.\n\nFor general information on GNU's `./configure`, see the file\n[INSTALL][8].\n\nDependencies\n------------\n\nInstall the following X Libraries to build and load `adwm`:\n\n- `libxft`\n- `libxrandr`\n- `libxinerama`\n- `libxpm`\n- `startup-notification`\n- `libxcomposite`\n- `libxdamage`\n- `libpng`\n\nTo support default key and mouse bindings, build and install the\nfollowing packages:\n\n- [xdg-launch][11]: for application launching default key bindings\n- [xde-ctools][12]: for `xde-run`, `xde-winmenu`, `xde-winlist` and\n  `xde-wkspmenu` default bindings\n- [xde-menu][13]: for `xde-menu` root menu default bindings\n- [xde-session][14]: for `xde-logout` and `xde-xlock` default bindings\n\nTo support default key bindings, the following applications must be\ninstalled:\n\n- `uxterm`: to be able to launch a terminal at all\n- `roxterm`: for terminal application launching\n- `firefox`: for browser application launching\n- `pcmanfm`: for file manager application launching\n- `gvim`: for editor application launching\n- `scrot`: to support screenshot key bindings\n- `xbrightness` and `xbacklight` or `acpibacklight`: to support\n  brightness keys\n- `amixer`: to support audio control keys\n- `xrandr`: to support screen rotation key bindings\n\nFor a more full-featured desktop environment, build and install the\nfollowing packages:\n\n- [xde-styles][17]: for a small, consistent set of styles for ADWM and\n  other light-weight window managers\n- [xde-panel][15]: for a panel that works well with ADWM\n- [xde-applets][16]: for various WindowMaker dock applications and systray\n  applets\n- [xde-theme][18]: for various desktop themes and theme packs\n- [xde-sounds][19]: for base sound themes\n\nOf course for a minimal desktop, lemon-bar and dmenu will suffice\n([xde-menu][13] supports a version of dmenu that supports\nfreedesktop.org desktop files).\n\n\nRunning\n-------\n\nRead the manual page after installation:\n\n    $\u003e man adwm\n\n\nFeatures\n--------\n\nFollowing are some of the features provided by `adwm(1)` not provided by\nsimilar window managers:\n\nGeneral:\n\n- full NetWM/EWMH, WinWM/WMH (gnome), OSF/Motif and ICCCM 2.0 compliance;\n- full support for ICCCM 2.0 client and global modality;\n- full RANDR and Xinerama compliance with full support for multi-head\n  setups;\n- full support for Window Maker dock applications in floating and tiling\n  modes;\n- window manager based auto-hide for panels and docks (struts);\n- three focus models: click-to-focus, sloppy and all-sloppy;\n- soon to come: full X11R6 session management;\n- very wide array of available key-binding actions;\n- key-binding defaults consistent with a wide array of light-weight and\n  popular window managers (see [NOTES](NOTES.html)).\n\nViews, Workspaces and Desktops:\n\n- view/tag based workspaces and desktops;\n- scroll wheel support for switching desktops;\n- key bindings for switching desktops observes EMWH desktop layout.\n\nFloating/stacking mode:\n\n- smart cascading placement algorithm;\n- window decorations: title bar, resize grips, wide array of configurable\n  buttons;\n- themed buttons include hovered, toggled, pressed, focused and unfocused\n  pixmaps;\n- multiple mouse actions per title bar button based on mouse button\n  pressed;\n- separate click and click-drag actions for title bar, borders and grips;\n- windows can snap to other windows and workspace/monitor boundaries;\n- key bindings for moving and resizing windows without using the mouse.\n- drop shadowed XFT text in title bars, with separate color selection for\n  active and inactive windows;\n- dragging of windows between monitor;\n- `metacity(1)`-like drag-to-left, -right or -top functions to optimize\n  single-desktop operation.\n\nTiling modes:\n\n- per-monitor tiling layouts for multi-head setups;\n- multiple tiling modes including master/stacking, monocle and grid (but,\n  no dwindle or centered-master modes, yet);\n- adjustable window borders and inter-window margins;\n- one pixel open space around dynamic desktop area for clicking on the root\n  window in tiled modes;\n- ability to drag-and-swap windows in tiling layouts (ala `awesome(1)`,\n  `wmii(1)` and `spectrwm(1)`);\n\nIssues\n------\n\nReport issues on GitHub [here][2].\n\n\nSamples\n-------\n\nFollowing are some sample screenshots:\n\n___Figure 1:___ Tiled layout (master right)\n![tiled.jpg](scrot/tiled.jpg \"Tiled\")\n\n___Figure 2:___ Tiled layout (bar exposed)\n![tiled_bar.jpg](scrot/tiled_bar.jpg \"Tiled with bar exposed\")\n\n___Figure 3:___ Tiled layout (master left)\n![tiled_master_left.jpg](scrot/tiled_master_left.jpg \"Tiled w/ master on left\")\n\n___Figure 4:___ Tiled layout (windows decorated)\n![tiled_decorated.jpg](scrot/tiled_decorated.jpg \"Tiled w/ decorated windows\")\n\n___Figure 5:___ Floating layout\n![floating.jpg](scrot/floating.jpg \"Floating\")\n\n___Figure 6:___ Floating layout (root menu)\n![floating_menus.jpg](scrot/floating_menus.jpg \"Floating w/ root menu\")\n\n___Figure 7:___ Floating layout (window menu)\n![floating_winmenu.jpg](scrot/floating_winmenu.jpg \"Floating w/ window menu\")\n\n___Figure 8:___ Airforce XDE Theme\n![airforce_theme.jpg](scrot/airforce_theme.jpg \"Airforce theme\")\n\n___Figure 9:___ Airforce XDE Theme (Xeyes properly rendered)\n![airforce_theme_xeyes.jpg](scrot/airforce_theme_xeyes.jpg \"Airforce theme\nw/ proper Xeyes\")\n\n\n\n[1]: https://github.com/bbidulock/adwm\n[2]: https://github.com/bbidulock/adwm/issues\n[3]: https://github.com/bbidulock/adwm/blob/0.7.17/RELEASE\n[4]: https://github.com/bbidulock/adwm/blob/0.7.17/NEWS\n[5]: https://github.com/bbidulock/adwm/blob/0.7.17/ChangeLog\n[6]: https://github.com/bbidulock/adwm/blob/0.7.17/TODO\n[7]: https://github.com/bbidulock/adwm/blob/0.7.17/COMPLIANCE\n[8]: https://github.com/bbidulock/adwm/blob/0.7.17/INSTALL\n[9]: https://github.com/bbidulock/adwm/blob/0.7.17/LICENSE\n[10]: https://github.com/bbidulock/adwm/blob/0.7.17/COPYING\n[11]: https://github.com/bbidulock/xdg-launch\n[12]: https://bbidulock.github.io/xde-ctools\n[13]: https://github.com/bbidulock/xde-menu\n[14]: https://github.com/bbidulock/xde-session\n[15]: https://github.com/bbidulock/xde-panel\n[16]: https://github.com/bbidulock/xde-applets\n[17]: https://github.com/bbidulock/xde-styles\n[18]:\nhttps://github.com/bbidulock?tab=repositories\u0026q=xde-theme-\u0026type=\u0026language=\u0026sort=name\n[19]: https://github.com/bbidulock/xde-sounds\n\n[ vim: set ft=markdown sw=4 tw=72 nocin nosi fo+=tcqlorn spell: ]: #\n","funding_links":[],"categories":["Packages"],"sub_categories":["window-managers"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbidulock%2Fadwm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbidulock%2Fadwm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbidulock%2Fadwm/lists"}