• C 99.1%
  • Meson 0.9%
Find a file
xeon bfcb87a6b8 output: implement SWC_REFRESH_RATE environment variable
Allows to specify the desired refresh rate, so the mode with matching refresh will be used instead of the default 'preferred' one
2026-06-01 19:19:16 +03:00
cursor switch to meson 2026-03-12 16:36:15 +00:00
example switch to meson 2026-03-12 16:36:15 +00:00
extra meson fix 2026-03-12 16:36:15 +00:00
launch strerr -> strerror, add a more defined if guard to fix build failure on freebsd 2026-04-28 20:27:05 +00:00
libswc output: implement SWC_REFRESH_RATE environment variable 2026-06-01 19:19:16 +03:00
protocol breaking change! deprecate swc_wallpaper in favor of layer shell 2026-05-23 14:58:19 +00:00
.clang-format add clang-format config 2026-03-07 20:38:58 +00:00
.gitignore prevent patches or build from being added 2026-03-25 02:17:32 +01:00
LICENSE Update LICENSE 2019-09-07 01:23:29 -07:00
meson.build fix meson.build 2026-03-25 21:37:58 +00:00
meson.options switch to meson 2026-03-12 16:36:15 +00:00
README.md breaking change! deprecate swc_wallpaper in favor of layer shell 2026-05-23 14:58:19 +00:00
README.original Add an install block in Makefile and add a README 2026-03-07 20:38:58 +00:00
swc.pc.in swc.pc: Properly set Requires{,.private} 2014-11-02 03:36:00 +00:00

neuswc

neuswc is a fork of swc created by wayland.fyi. it provides an easy C library interface to make a wayland compositor. it is much smaller than alternatives like wlroots, and easier to use. it is also portable to linux, freebsd, and netbsd (natively, without any linux compatibility layers.) openbsd support is partial; if you want tohelp with that (or anything else) submit a patch to the mailing list

you can view a list of some compositors made with neuswc at the wayland.fyi website.

the refrence compositor implementation is tohu: it uses many of the new features and is small and simple to understand. if you want to make your own compositor, it can be a useful place to refrence how things work, or a base to customize.

neu features

  • z axis ordering
  • more cursor functions
  • zooming
  • experimental subsurface support
  • fullscreen
  • double window borders
  • screenshots
  • evdev-only input backend
  • layer shell support
  • window decorations

neuswc is in active development, we plan to add many more features, and increase compatibility with new wayland protocols.

build

you will need:

  • A C99-compatible compiler
  • meson or muon
  • pkg-config
  • wayland-scanner, wayland-server, wayland-client
  • wayland-server, wayland-client
  • libdrm, pixman, xkbcommon
  • neuwld
  • on linux, either libinput or evdev, depending on your choice of input backend, neither on BSD
  • xcb, xcb-composite, xcb-ewmh and xcb-icccm if you want Xwayland support.

to build, i use muon and samu. you can probably do something similar with meson and ninja. warning if you use muon, you will need a recent version built from their git for wayland module support, probably not your distro-packaged version. i do:

muon setup build
samu -C build
sudo samu -C build install

credits

an extremely large thank you to michael forney for creating the original swc and wld, without his amazing work none of this would be possible! once they are more stable, we hope some of the changes from our neu* forks will eventually be upstreamed into the original projects.