mirror of
https://github.com/nix-community/home-manager
synced 2024-11-04 18:29:45 +01:00
36a53d9f26
This process was automated by [my fork of `nix-doc-munge`]. All
conversions were automatically checked to produce the same DocBook
result when converted back, modulo minor typographical/formatting
differences on the acceptable-to-desirable spectrum.
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 \
{} +
$ ./format
[my fork of `nix-doc-munge`]: https://github.com/emilazy/nix-doc-munge/tree/home-manager
103 lines
2.9 KiB
Nix
103 lines
2.9 KiB
Nix
{ config, lib, pkgs, ... }:
|
|
|
|
with lib;
|
|
|
|
let
|
|
|
|
cfg = config.services.random-background;
|
|
|
|
flags = lib.concatStringsSep " "
|
|
([ "--bg-${cfg.display}" "--no-fehbg" "--randomize" ]
|
|
++ lib.optional (!cfg.enableXinerama) "--no-xinerama");
|
|
|
|
in {
|
|
meta.maintainers = [ maintainers.rycee ];
|
|
|
|
options = {
|
|
services.random-background = {
|
|
enable = mkEnableOption (lib.mdDoc "") // {
|
|
description = lib.mdDoc ''
|
|
Whether to enable random desktop background.
|
|
|
|
Note, if you are using NixOS and have set up a custom
|
|
desktop manager session for Home Manager, then the session
|
|
configuration must have the `bgSupport`
|
|
option set to `true` or the background
|
|
image set by this module may be overwritten.
|
|
'';
|
|
};
|
|
|
|
imageDirectory = mkOption {
|
|
type = types.str;
|
|
example = "%h/backgrounds";
|
|
description = lib.mdDoc ''
|
|
The directory of images from which a background should be
|
|
chosen. Should be formatted in a way understood by systemd,
|
|
e.g., '%h' is the home directory.
|
|
'';
|
|
};
|
|
|
|
display = mkOption {
|
|
type = types.enum [ "center" "fill" "max" "scale" "tile" ];
|
|
default = "fill";
|
|
description =
|
|
lib.mdDoc "Display background images according to this option.";
|
|
};
|
|
|
|
interval = mkOption {
|
|
default = null;
|
|
type = types.nullOr types.str;
|
|
example = "1h";
|
|
description = lib.mdDoc ''
|
|
The duration between changing background image, set to null
|
|
to only set background when logging in. Should be formatted
|
|
as a duration understood by systemd.
|
|
'';
|
|
};
|
|
|
|
enableXinerama = mkOption {
|
|
default = true;
|
|
type = types.bool;
|
|
description = lib.mdDoc ''
|
|
Will place a separate image per screen when enabled,
|
|
otherwise a single image will be stretched across all
|
|
screens.
|
|
'';
|
|
};
|
|
};
|
|
};
|
|
|
|
config = mkIf cfg.enable (mkMerge ([
|
|
{
|
|
assertions = [
|
|
(hm.assertions.assertPlatform "services.random-background" pkgs
|
|
platforms.linux)
|
|
];
|
|
|
|
systemd.user.services.random-background = {
|
|
Unit = {
|
|
Description = "Set random desktop background using feh";
|
|
After = [ "graphical-session-pre.target" ];
|
|
PartOf = [ "graphical-session.target" ];
|
|
};
|
|
|
|
Service = {
|
|
Type = "oneshot";
|
|
ExecStart = "${pkgs.feh}/bin/feh ${flags} ${cfg.imageDirectory}";
|
|
IOSchedulingClass = "idle";
|
|
};
|
|
|
|
Install = { WantedBy = [ "graphical-session.target" ]; };
|
|
};
|
|
}
|
|
(mkIf (cfg.interval != null) {
|
|
systemd.user.timers.random-background = {
|
|
Unit = { Description = "Set random desktop background using feh"; };
|
|
|
|
Timer = { OnUnitActiveSec = cfg.interval; };
|
|
|
|
Install = { WantedBy = [ "timers.target" ]; };
|
|
};
|
|
})
|
|
]));
|
|
}
|