Skip to content

Latest commit

 

History

History
80 lines (56 loc) · 3.36 KB

README.md

File metadata and controls

80 lines (56 loc) · 3.36 KB

wlmaker - Wayland Maker

A Wayland compositor inspired by Window Maker.

Key features:

  • Compositor for windows in stacking mode.
  • Supports multiple workspaces.
  • Appearance inspired by Window Maker, following the look and feel of NeXTSTEP.
  • Easy to use, lightweight, low gimmicks and fast.
  • Dock and clip, to be extended for dockable apps.

How it looks, running in a window using the default theme:

Screenshot of wlmaker running in a window

Current status

Early access: Wayland Maker covers elementary compositor functionality on single-monitor output. Please report what's missing or broken!

Highlights for current version (0.5):

  • new: Window menu and configurable root menu.
  • new: Fixes to wlr_layer_shell_unstable_v1 implementation, early support for keyboard interactivity.
  • Builds with wlroots 0.18.
  • Configurable layout and scaling for the output.
  • Hot corners with configurable actions, default to 'lock' or 'inhibit' locking.
  • Screen saver support, through ext_session_lock_v1 and idle_inhibit_unstable_v1 protocols.
  • Configurable through plist text files: base configuration, style, root menu and docks & workspaces.
  • wlr layer shell support (wlr_layer_shell_unstable_v1), fully implemented & tested.
  • Appearance matches Window Maker: Decorations, dock, clip.
  • Support for Wayland XDG shell (mostly complete. Bug reports welcome).
  • Initial support for X11 applications (positioning and specific modes are missing). Use --start_xwayland argument to enable XWayland, it's off by default.
  • A prototype DockApp (apps/wlmclock).

For further details, see the roadmap.

Protocol support:

  • xdg-decoration-unstable-v1: Implemented & tested.
  • ext_session_lock_v1: Implemented & tested.
  • wlr_layer_shell_unstable_v1: Largely implemented & tested.
  • xdg_shell: Largely implemented & tested.
  • idle_inhibit_unstable_v1: Implemented, untested.

Build & use it!

  • From source: Please follow the detailled build instructions for a step-by-step guide.

  • Once compiled, see the these instructions on how to run Wayland Maker in a window or standalone, and to configure it for your needs.

  • Alternatively, use a pre-built package:

    Packaging status

Contributing

Contributions, help and bug reports are highly welcome! See CONTRIBUTING.md for details, and code of conduct for more.

License

Apache 2.0; see LICENSE for details.

Disclaimer

This project is not an official Google project. It is not supported by Google and Google specifically disclaims all warranties as to its quality, merchantability, or fitness for a particular purpose.

#147: Why is every file copyrighted by Google, then? Google happens to be the primary author's employer, and the copyright note is default recommended Open Source procedure.