mirror of
https://github.com/nix-community/home-manager
synced 2024-09-12 06:16:33 +02:00
These (and the `*MD` functions apart from `literalMD`) are now no-ops in nixpkgs and serve no purpose other than to add additional noise and potentially mislead people into thinking unmarked DocBook documentation will still be accepted. Note that if backporting changes including documentation to 23.05, the `mdDoc` calls will need to be re-added. To reproduce this commit, run: $ NIX_PATH=nixpkgs=flake:nixpkgs/e7e69199f0372364a6106a1e735f68604f4c5a25 \ nix shell nixpkgs#coreutils \ -c find . -name '*.nix' \ -exec nix run -- github:emilazy/nix-doc-munge/98dadf1f77351c2ba5dcb709a2a171d655f15099 \ --strip {} + $ ./format
347 lines
11 KiB
Nix
347 lines
11 KiB
Nix
{ config, lib, pkgs, ... }:
|
|
|
|
with lib;
|
|
|
|
let
|
|
|
|
cfg = config.services.mako;
|
|
|
|
in {
|
|
meta.maintainers = [ maintainers.onny ];
|
|
|
|
imports =
|
|
[ (mkRenamedOptionModule [ "programs" "mako" ] [ "services" "mako" ]) ];
|
|
|
|
options = {
|
|
services.mako = {
|
|
enable = mkEnableOption ''
|
|
Mako, lightweight notification daemon for Wayland
|
|
'';
|
|
|
|
package = mkOption {
|
|
type = types.package;
|
|
default = pkgs.mako;
|
|
defaultText = literalExpression "pkgs.mako";
|
|
description = "The mako package to use.";
|
|
};
|
|
|
|
maxVisible = mkOption {
|
|
default = 5;
|
|
type = types.nullOr types.int;
|
|
description = ''
|
|
Set maximum number of visible notifications. Set -1 to show all.
|
|
'';
|
|
};
|
|
|
|
sort = mkOption {
|
|
default = "-time";
|
|
type =
|
|
types.nullOr (types.enum [ "+time" "-time" "+priority" "-priority" ]);
|
|
description = ''
|
|
Sorts incoming notifications by time and/or priority in ascending(+)
|
|
or descending(-) order.
|
|
'';
|
|
};
|
|
|
|
output = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Show notifications on the specified output. If empty, notifications
|
|
will appear on the focused output. Requires the compositor to support
|
|
the Wayland protocol xdg-output-unstable-v1 version 2.
|
|
'';
|
|
};
|
|
|
|
layer = mkOption {
|
|
default = "top";
|
|
type =
|
|
types.nullOr (types.enum [ "background" "bottom" "top" "overlay" ]);
|
|
description = ''
|
|
Arrange mako at the specified layer, relative to normal windows.
|
|
Supported values are background, bottom, top, and overlay. Using
|
|
overlay will cause notifications to be displayed above fullscreen
|
|
windows, though this may also occur at top depending on your
|
|
compositor.
|
|
'';
|
|
};
|
|
|
|
anchor = mkOption {
|
|
default = "top-right";
|
|
type = types.nullOr (types.enum [
|
|
"top-right"
|
|
"top-center"
|
|
"top-left"
|
|
"bottom-right"
|
|
"bottom-center"
|
|
"bottom-left"
|
|
"center"
|
|
]);
|
|
description = ''
|
|
Show notifications at the specified position on the output.
|
|
Supported values are top-right, top-center, top-left, bottom-right,
|
|
bottom-center, bottom-left, and center.
|
|
'';
|
|
};
|
|
|
|
font = mkOption {
|
|
default = "monospace 10";
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Font to use, in Pango format.
|
|
'';
|
|
};
|
|
|
|
backgroundColor = mkOption {
|
|
default = "#285577FF";
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Set popup background color to a specific color, represented in hex
|
|
color code.
|
|
'';
|
|
};
|
|
|
|
textColor = mkOption {
|
|
default = "#FFFFFFFF";
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Set popup text color to a specific color, represented in hex color
|
|
code.
|
|
'';
|
|
};
|
|
|
|
width = mkOption {
|
|
default = 300;
|
|
type = types.nullOr types.int;
|
|
description = ''
|
|
Set width of notification popups in specified number of pixels.
|
|
'';
|
|
};
|
|
|
|
height = mkOption {
|
|
default = 100;
|
|
type = types.nullOr types.int;
|
|
description = ''
|
|
Set maximum height of notification popups. Notifications whose text
|
|
takes up less space are shrunk to fit.
|
|
'';
|
|
};
|
|
|
|
margin = mkOption {
|
|
default = "10";
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Set margin of each edge specified in pixels. Specify single value to
|
|
apply margin on all sides. Two comma-separated values will set
|
|
vertical and horizontal edges separately. Four comma-separated will
|
|
give each edge a separate value.
|
|
For example: 10,20,5 will set top margin to 10, left and right to 20
|
|
and bottom to five.
|
|
'';
|
|
};
|
|
|
|
padding = mkOption {
|
|
default = "5";
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Set padding of each edge specified in pixels. Specify single value to
|
|
apply margin on all sides. Two comma-separated values will set
|
|
vertical and horizontal edges separately. Four comma-separated will
|
|
give each edge a separate value.
|
|
For example: 10,20,5 will set top margin to 10, left and right to 20
|
|
and bottom to five.
|
|
'';
|
|
};
|
|
|
|
borderSize = mkOption {
|
|
default = 1;
|
|
type = types.nullOr types.int;
|
|
description = ''
|
|
Set popup border size to the specified number of pixels.
|
|
'';
|
|
};
|
|
|
|
borderColor = mkOption {
|
|
default = "#4C7899FF";
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Set popup border color to a specific color, represented in hex color
|
|
code.
|
|
'';
|
|
};
|
|
|
|
borderRadius = mkOption {
|
|
default = 0;
|
|
type = types.nullOr types.int;
|
|
description = ''
|
|
Set popup corner radius to the specified number of pixels.
|
|
'';
|
|
};
|
|
|
|
progressColor = mkOption {
|
|
default = "over #5588AAFF";
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Set popup progress indicator color to a specific color,
|
|
represented in hex color code. To draw the progress
|
|
indicator on top of the background color, use the
|
|
`over` attribute. To replace the background
|
|
color, use the `source` attribute (this can
|
|
be useful when the notification is semi-transparent).
|
|
'';
|
|
};
|
|
|
|
icons = mkOption {
|
|
default = true;
|
|
type = types.nullOr types.bool;
|
|
description = ''
|
|
Whether or not to show icons in notifications.
|
|
'';
|
|
};
|
|
|
|
maxIconSize = mkOption {
|
|
default = 64;
|
|
type = types.nullOr types.int;
|
|
description = ''
|
|
Set maximum icon size to the specified number of pixels.
|
|
'';
|
|
};
|
|
|
|
iconPath = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Paths to search for icons when a notification specifies a name
|
|
instead of a full path. Colon-delimited. This approximates the search
|
|
algorithm used by the XDG Icon Theme Specification, but does not
|
|
support any of the theme metadata. Therefore, if you want to search
|
|
parent themes, you'll need to add them to the path manually.
|
|
|
|
The {file}`/usr/share/icons/hicolor` and
|
|
{file}`/usr/share/pixmaps` directories are
|
|
always searched.
|
|
'';
|
|
};
|
|
|
|
markup = mkOption {
|
|
default = true;
|
|
type = types.nullOr types.bool;
|
|
description = ''
|
|
If 1, enable Pango markup. If 0, disable Pango markup. If enabled,
|
|
Pango markup will be interpreted in your format specifier and in the
|
|
body of notifications.
|
|
'';
|
|
};
|
|
|
|
actions = mkOption {
|
|
default = true;
|
|
type = types.nullOr types.bool;
|
|
description = ''
|
|
Applications may request an action to be associated with activating a
|
|
notification. Disabling this will cause mako to ignore these requests.
|
|
'';
|
|
};
|
|
|
|
format = mkOption {
|
|
default = "<b>%s</b>\\n%b";
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
Set notification format string to format. See FORMAT SPECIFIERS for
|
|
more information. To change this for grouped notifications, set it
|
|
within a grouped criteria.
|
|
'';
|
|
};
|
|
|
|
defaultTimeout = mkOption {
|
|
default = 0;
|
|
type = types.nullOr types.int;
|
|
description = ''
|
|
Set the default timeout to timeout in milliseconds. To disable the
|
|
timeout, set it to zero.
|
|
'';
|
|
};
|
|
|
|
ignoreTimeout = mkOption {
|
|
default = false;
|
|
type = types.nullOr types.bool;
|
|
description = ''
|
|
If set, mako will ignore the expire timeout sent by notifications
|
|
and use the one provided by default-timeout instead.
|
|
'';
|
|
};
|
|
|
|
groupBy = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
description = ''
|
|
A comma-separated list of criteria fields that will be compared to
|
|
other visible notifications to determine if this one should form a
|
|
group with them. All listed criteria must be exactly equal for two
|
|
notifications to group.
|
|
'';
|
|
};
|
|
|
|
extraConfig = mkOption {
|
|
default = "";
|
|
type = types.lines;
|
|
example = literalExpression ''
|
|
[urgency=low]
|
|
border-color=#b8bb26
|
|
'';
|
|
description = "Additional configuration.";
|
|
};
|
|
};
|
|
};
|
|
|
|
config = let
|
|
boolToString = v: if v then "true" else "false";
|
|
optionalBoolean = name: val:
|
|
lib.optionalString (val != null) "${name}=${boolToString val}";
|
|
optionalInteger = name: val:
|
|
lib.optionalString (val != null) "${name}=${toString val}";
|
|
optionalString = name: val:
|
|
lib.optionalString (val != null) "${name}=${val}";
|
|
in mkIf cfg.enable {
|
|
assertions =
|
|
[ (hm.assertions.assertPlatform "services.mako" pkgs platforms.linux) ];
|
|
|
|
home.packages = [ cfg.package ];
|
|
|
|
xdg.configFile."mako/config" = {
|
|
onChange = ''
|
|
${cfg.package}/bin/makoctl reload || true
|
|
'';
|
|
text = ''
|
|
${optionalInteger "max-visible" cfg.maxVisible}
|
|
${optionalString "sort" cfg.sort}
|
|
${optionalString "output" cfg.output}
|
|
${optionalString "layer" cfg.layer}
|
|
${optionalString "anchor" cfg.anchor}
|
|
|
|
${optionalString "font" cfg.font}
|
|
${optionalString "background-color" cfg.backgroundColor}
|
|
${optionalString "text-color" cfg.textColor}
|
|
${optionalInteger "width" cfg.width}
|
|
${optionalInteger "height" cfg.height}
|
|
${optionalString "margin" cfg.margin}
|
|
${optionalString "padding" cfg.padding}
|
|
${optionalInteger "border-size" cfg.borderSize}
|
|
${optionalString "border-color" cfg.borderColor}
|
|
${optionalInteger "border-radius" cfg.borderRadius}
|
|
${optionalString "progress-color" cfg.progressColor}
|
|
${optionalBoolean "icons" cfg.icons}
|
|
${optionalInteger "max-icon-size" cfg.maxIconSize}
|
|
${optionalString "icon-path" cfg.iconPath}
|
|
${optionalBoolean "markup" cfg.markup}
|
|
${optionalBoolean "actions" cfg.actions}
|
|
${optionalString "format" cfg.format}
|
|
${optionalInteger "default-timeout" cfg.defaultTimeout}
|
|
${optionalBoolean "ignore-timeout" cfg.ignoreTimeout}
|
|
${optionalString "group-by" cfg.groupBy}
|
|
|
|
${cfg.extraConfig}
|
|
'';
|
|
};
|
|
};
|
|
}
|