Menu ▾ ▴

Tree [493886] master /
 History

HTTPS git://
HTTPS access

File Date Author Commit
 contrib 2021-11-12 Johns Johns [493886] Fixed active title gradient, title icon placement.
 plugin 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 www 2012-06-11 Johns Johns [60b6e5] Fix h3 close tag.
 .gitattributes 2010-09-27 Johns Johns [005eb8] Documentation update.
 .gitignore 2011-10-31 Johns Johns [1b8605] Ignore generate doc directory. Support distclean.
 .gitmodules 2021-09-23 Johns Johns [f046ad] Use https for submodules.
 .indent.pro 2010-06-01 Johns Johns [bcff66] Fixed typo.
 AGPL-v3.0.md 2021-09-26 Johns Johns [9032b1] Added LICENSE.md and changed to markdown file f...
 CODINGSTYLE.txt 2011-11-05 Johns Johns [e9dada] Add coding style documentation.
 ChangeLog 2011-11-09 Johns Johns [77a5ce] Prepare release 0.30.
 LICENSE.md 2021-09-26 Johns Johns [9032b1] Added LICENSE.md and changed to markdown file f...
 Makefile 2021-11-12 Johns Johns [96f662] Added libXcursor support using xcb-util-cursor.
 README.md 2021-11-12 Johns Johns [96f662] Added libXcursor support using xcb-util-cursor.
 background.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 background.h 2010-10-14 Johns Johns [68af6c] Desktop background support improved.
 border.c 2021-11-12 Johns Johns [493886] Fixed active title gradient, title icon placement.
 border.h 2021-09-24 Johns Johns [58ce12] Update for new core-rc version.
 client.c 2021-11-12 Johns Johns [1cf624] More verbose _NONE_.
 client.h 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 command.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 command.h 2010-10-12 Johns Johns [a84eb0] Fix all FIXME + @todo in uwm.c
 desktop.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 desktop.h 2010-09-27 Johns Johns [bd645b] Removed global UwmConfig.
 dia.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 dia.h 2010-10-07 Johns Johns [b3893e] Diashow improvements.
 draw.c 2021-11-12 Johns Johns [493886] Fixed active title gradient, title icon placement.
 draw.h 2011-11-08 Johns Johns [809b95] Border module cleanup. Added sticky window button.
 event.c 2021-11-12 Johns Johns [96f662] Added libXcursor support using xcb-util-cursor.
 event.h 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 hints.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 hints.h 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 icon.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 icon.h 2010-10-05 Johns Johns [17f8c3] Fix use of render extension.
 image.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 image.h 2010-09-28 Johns Johns [ccb88b] ImageFromEWMH converted to ImageFromARGB.
 keyboard.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 keyboard.h 2011-11-03 Johns Johns [9b0825] Pass complete event to keyboard handler.
 menu.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 menu.h 2021-10-12 Johns Johns [68cdd8] Adds key bindings for window actions.
 misc.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 misc.h 2010-10-03 Johns Johns [2f3055] Fixed compile with USE_XMU, added missing funct...
 moveresize.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 moveresize.h 2010-10-11 Johns Johns [0e6b4a] Add client move/resize outline configuration.
 panel.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 panel.h 2021-09-24 Johns Johns [58ce12] Update for new core-rc version.
 pointer.c 2021-11-12 Johns Johns [96f662] Added libXcursor support using xcb-util-cursor.
 pointer.h 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 property.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 property.h 2011-05-06 Johns Johns [e162f7] Fix xcb 1.7 compatiblity.
 queue.h 2010-10-25 Johns Johns [5605c1] Fix GNU brain damage: using stone age queue.h
 readable_bitmap.h 2009-09-03 Johns Johns [945f63] Reversed bits.
 rule.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 rule.h 2010-09-28 Johns Johns [3b6268] Don't apply move/resize rules on mapped clients.
 screen.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 screen.h 2009-09-17 Johns Johns [4d61b4] Added the screen (physical monitor) module.
 tooltip.c 2021-10-22 Johns Johns [143bbe] Improved and fixed documentation.
 tooltip.h 2011-10-31 Johns Johns [376ec0] Generic tooltip handling.
 u.xpm 2009-09-17 Johns Johns [3ce474] Added default application menu icon.
 uwm.1 2021-10-10 Johns Johns [1d23be] Add support for XDG_CONFIG_HOME.
 uwm.c 2021-10-29 Johns Johns [678f6a] KeepLooping should be volatile.
 uwm.h 2021-11-12 Johns Johns [96f662] Added libXcursor support using xcb-util-cursor.
 uwmrc.5 2010-10-20 Johns Johns [d043f9] Initial (incomplete) uwmrc man page.
 xephyr.sh 2010-11-10 Johns Johns [085744] Fix the xephyr keymap problem.

Read Me

@file README.md @brief µ window manager readme

Copyright (c) 2009 - 2011, 2021 by Lutz Sammer. All Rights Reserved.

Contributor(s):

License: AGPLv3

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.

$Id: 26a94379bd0278ab32d3d3d672816c8e4b642893 $

@mainpage
[TOC]

µwm - (uwm) µ Window Manager {#mainpage}

Based on jwm from Joe Wingbermuehle, but rewritten from scratch.

about

µwm is a lightweight stacking window manager for the X11 Window System
and is written in C and uses only libxcb at a minimum. It has builtin
menus/panels/buttons and other plugins.

overview

  • stacking window manager
  • written in C (with many comments)
  • less dependencies (only XCB and X11 required)
  • doesn't use/need GNU autoconfigure and other auto-tools
  • executable less than 200k
  • less than 23k Source Lines of Code
  • low memory footprint during runtime ~ 1800k RES
  • low X11 resource usage ~ 200k (without desktop backgrounds)
  • low CPU usage

features

  • configurable and themeable
  • no XML config file
  • builtin menu(s)
  • builtin panel(s) (other names are slit/bar/dock) with:
    • button
    • clock
    • netload
    • pager
    • swallow (dock)
    • systray
    • task-list
  • builtin tooltips
  • builtin background setter
  • composite support with xcompmgr (sample X compositing manager)
  • multiple desktops
  • multiple screen (xinerama)
  • 64-bit and 32-bit clean
  • little-endian and big-endian clean
  • compatible with musl, uclibc and libc6
  • compatible with GCC 4.5.3-11.2.0, Clang 2.9-13.0 and ekopath 4.0.11
  • many features can be compile time enabled / disabled

see @ref install

@page install
how to install µwm

To compile you must have the 'requires' installed.

Quickstart:

Just type make and use.

To configure which modules to include, see Makefile
and uwm.h

To configure the look&feel, see
contrib/uwmrc.example

Install:

  1. git
      git clone git://uwm.git.sourceforge.net/gitroot/uwm/uwm
      -or-
      git clone https://github.com/Johns-Q/uwm.git

      cd uwm
      # make should automatic pull the submodules from git.
      make
      ./xephyr.sh ./uwm -c contrib/uwmrc.example

  1. tarball

    this versions are very outdated!
    Download latest version from:
    http://sourceforge.net/projects/uwm/files/

      tar vxf uwm-2011-*.tar.bz2
      cd uwm
      # the tarball contains the submodules
      make
      ./xephyr.sh ./uwm -c contrib/uwmrc.example

More:

  • To build and see the source code documentation use:
      make doc
      firefox doc/html/index.html

Requires: {#requires}

Optional: