Screenshot and screencast utility for mango.

curl -fsSL https://raw.githubusercontent.com/xtheeq/msnap/main/install.sh | bash

The script will prompt for user or system-wide installation.

Add msnap's input and overlay in your flake.nix:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";

    msnap = {
      url = "github:xtheeq/msnap";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { nixpkgs, msnap, ... }: {
    nixosConfigurations.your-host = nixpkgs.lib.nixosSystem {
      modules = [
        { nixpkgs.overlays = [ msnap.overlays.default ]; }
        ./configuration.nix
      ];
    };
  };
}

Then add msnap to your packages in configuration.nix:

environment.systemPackages = [ pkgs.msnap ];

Or for a standalone try without installing:

nix run github:xtheeq/msnap -- shot

bind=none,Print,spawn,msnap gui
bind=SHIFT,Print,spawn_shell,msnap shot --region
bind=ALT,Print,spawn_shell,msnap cast --toggle --region

To prevent the GUI from being animated or blurred:

layerrule = layer_name:msnap, noanim:1, noblur:1

msnap shot [OPTIONS]   # take a screenshot
msnap cast [OPTIONS]   # record the screen

--toggle is required — call it once to start recording, again to stop.

Launch from your application launcher, or directly:

msnap gui

Config files live in $XDG_CONFIG_HOME/msnap/ (default: ~/.config/msnap/).

Filename patterns support standard date format tokens (%Y, %m, %d, %H, %M, %S, etc.)

Controls GUI theme (colors, accents, and alphas):

All other options control colors and alpha values for the UI. See the default gui.conf for available options.

Options resolve in this order (highest first):

1. CLI flags
2. msnap.conf
3. XDG env vars (XDG_PICTURES_DIR, XDG_VIDEOS_DIR)
4. Built-in defaults

After capturing, notifications provide quick actions:

Recordings include an auto-generated thumbnail in the notification.

msnap follows the XDG Base Directory Specification. Config is resolved from $XDG_CONFIG_HOME/msnap/ first, falling back to $XDG_CONFIG_DIRS/msnap/.

msnap update              # update to latest release
msnap update --git        # update to latest git commit (unreleased)
msnap update --check      # check for updates without installing
msnap update --version x.x.x  # install specific version
msnap update --force      # reinstall current version

NOTE: Not supported for Nix-managed installs — use nix flake update instead.

msnap uninstall        # interactive
msnap uninstall -f     # skip confirmation

Nix-managed installs should use nix-collect-garbage or remove from flake.nix.