nix-community / nixpkgs-wayland

Automated, pre-built packages for Wayland (sway/wlroots) tools for NixOS. [maintainers=@colemickens, @Artturin]
522 stars 46 forks source link
nixos nixpkgs sway tiling-window-manager wayland wlroots

nixpkgs-wayland

Build Update Advance

overview

Automated, pre-built, (potentially) pre-release packages for Wayland (sway/wlroots) tools for NixOS (nixos-unstable channel).

These packages are auto-updated to the latest version available from their upstream source control. This means this overlay and package set will often contain unreleased versions.

Community chat is on Matrix: #nixpkgs-wayland:matrix.org. We are not on Libera.

Started by: @colemickens and co-maintained by @Artturin (🙏).

Usage

Binary Cache

The Cachix landing page for nixpkgs-wayland shows how to utilize the binary cache.

Packages from this overlay are regularly built against nixos-unstable and pushed to this cache.

Continuous Integration

We have multiple CI jobs:

  1. Update - this tries to advance nixpkgs and upgrade all packages. If it can successfully build them, the updates are push to master.
  2. Advance - this tries to advance nixpkgs without touching the packages. This can help show when nixpkgs upgrades via nixos-unstable has advanced into a state where we are broken building against it.
  3. Build - this just proves that master was working against nixos-unstable at the point in time captured by whatever is in flake.lock on master.

We don't have CI on Pull Requests, but I keep an eye on it after merging external contributions.

Flake Usage

Install for NixOS (non-flakes, manual import)

If you are not using Flakes, then consult the NixOS Wiki page on Overlays. Also, you can expand this section for a more literal, direct example. If you do pin, use a tool like niv to do the pinning so that you don't forget and wind up stuck on an old version.

```nix { config, lib, pkgs, ... }: let rev = "master"; # 'rev' could be a git rev, to pin the overlay. url = "https://github.com/nix-community/nixpkgs-wayland/archive/${rev}.tar.gz"; waylandOverlay = (import "${builtins.fetchTarball url}/overlay.nix"); in { nixpkgs.overlays = [ waylandOverlay ]; environment.systemPackages = with pkgs; [ wayvnc ]; # ... } ``` You could write that to a file `./wayland.nix` next to your `configuration.nix` and then use it like so: ```nix { config, lib, pkgs, ... }: { # ... imports = [ # ... ./wayland.nix ]; } ```

Install for non-NixOS users

Non-NixOS users have many options, but here are two explicitly:

  1. Activate flakes mode, then just run them outright like the first example in this README.

  2. See the following details block for an example of how to add nixpkgs-wayland as a user-level overlay and then install a package with nix-env.

1. There are two ways to activate an overlay for just your user: 1. Add a new entry in ``~/.config/nixpkgs/overlays.nix`: ```nix let url = "https://github.com/nix-community/nixpkgs-wayland/archive/master.tar.gz"; in [ (import "${builtins.fetchTarball url}/overlay.nix") ] ``` 2. Add a new file under a dir, `~/.config/nixpkgs/overlays/nixpkgs-wayland.nix`: ```nix let url = "https://github.com/nix-community/nixpkgs-wayland/archive/master.tar.gz"; in (import "${builtins.fetchTarball url}/overlay.nix") ``` Note, this method does not pin `nixpkgs-wayland`. That's left to the reader. (Just use flakes...) 2. Then, `nix-env` will have access to the packages: ```nix nix-env -iA neatvnc ```

Packages

Package Description
aml Another main loop
cage Wayland kiosk that runs a single, maximized application
drm_info Small utility to dump info about DRM devices
dunst Lightweight and customizable notification daemon
eww Widget system made in Rust to create widgets for any WM
foot Fast, lightweight and minimalistic Wayland terminal emulator
freerdp3 A Remote Desktop Protocol Client
gebaar-libinput Gebaar, A Super Simple WM Independent Touchpad Gesture Daemon for libinput
glpaper Wallpaper program for wlroots based Wayland compositors such as sway that allows you to render glsl shaders as your wallpaper
grim Grab images from a Wayland compositor
gtk-layer-shell Library to create panels and other desktop components for Wayland using the Layer Shell protocol
i3status-rust Very resource-friendly and feature-rich replacement for i3status
imv Command line image viewer for tiling window managers
kanshi Dynamic display configuration tool
lavalauncher Simple launcher panel for Wayland desktops
libvncserver_master VNC server library
mako Lightweight Wayland notification daemon
neatvnc VNC server library
new-wayland-protocols Wayland protocol extensions
obs-wlrobs Obs-studio plugin that allows you to screen capture on wlroots based wayland compositors
rootbar Bar for Wayland WMs
salut A sleek notification daemon
shotman Uncompromising screenshot GUI for Wayland compositors
sirula Simple app launcher for wayland written in rust
slurp Select a region in a Wayland compositor
sway-unwrapped I3-compatible tiling Wayland compositor
swaybg Wallpaper tool for Wayland compositors
swayidle Idle management daemon for Wayland
swaylock Screen locker for Wayland
swaylock-effects Screen locker for Wayland
swww Efficient animated wallpaper daemon for wayland, controlled at runtime
waybar Highly customizable Wayland bar for Sway and Wlroots based compositors
waypipe Network proxy for Wayland clients (applications)
wayprompt multi-purpose prompt tool for Wayland
wayvnc VNC server for wlroots based Wayland compositors
wbg Wallpaper application for Wayland compositors
wdisplays Graphical application for configuring displays in Wayland compositors
wev Wayland event viewer
wf-recorder Utility program for screen recording of wlroots-based compositors
wl-clipboard Command-line copy/paste utilities for Wayland
wl-gammarelay-rs A simple program that provides DBus interface to control display temperature and brightness under wayland without flickering
wlay Graphical output management for Wayland
wldash Wayland launcher/dashboard
wlogout Wayland based logout menu
wlr-randr Xrandr clone for wlroots compositors
wlroots Modular Wayland compositor library
wlsunset Day/night gamma adjustments for Wayland
wlvncc A Wayland Native VNC Client
wob Lightweight overlay bar for Wayland
wofi Launcher/menu program for wlroots based wayland compositors such as sway
wshowkeys Displays keys being pressed on a Wayland session
wtype xdotool type for wayland
xdg-desktop-portal-wlr xdg-desktop-portal backend for wlroots

Tips

General

sway

Nvidia Users

Development Guide

If for some reason the overlay isn't progressing and you want to help, just clone the repo, run nix develop -c ./main.nu update