git.scottworley.com Git - nix-env-apps/blob - README.md

   1 # nix-env-apps
   2
   3 A simple GUI to make managing declarative nix-env easier
   4
   5 It has two buttons: "Edit Configuration" and "Apply Configuration"
   6
   7 ![screenshot](nix-env-apps/blob_plain/HEAD:/screenshot.png)
   8
   9 The "Edit Configuration" button launches an editor on
  10 `~/.config/nixpkgs/overlays/userPackages.nix`, creating it with a
  11 useful template if it doesn't exist.  All you have to do is put the
  12 applications you want installed between the [ ] brackets.  For example,
  13 to add Firefox and LibreOffice, you'd type `firefox` and `libreoffice`
  14 where shown here:
  15
  16     final: prev: {
  17       userPackages = final.buildEnv {
  18         name = "userPackages";
  19         paths = (with final; [
  20
  21           firefox
  22           libreoffice
  23
  24         ];
  25       };
  26     }
  27
  28 Remember to save before pressing "Apply Configuration"!
  29
  30 The "Apply Configuration" button runs `nix-env -riA nixos.userPackages`,
  31 which makes your changes take effect.  Note that this **removes** any
  32 other packages that you may have installed imperatively with `nix-env -i`.
  33 Prefer declarative installation by listing everything you want installed
  34 in the "Edit Configuration" configuration file!