add desciptions of packages from chatgpt

provision/hosts/bulwark/configuration.nix

@@ -63,11 +63,9 @@
     }];
   }];
 
-  # List packages installed in system profile.
   environment.systemPackages = with pkgs; [
-      # One-off packages
+      discord # Voice, video, and text communication platform for communities and friends.
-      discord
+      gamemode # Optimizes Linux system performance for gaming by adjusting system settings.
-      gamemode
   ];
 
   # Enable modules

provision/hosts/bulwark/steam-deck.nix

@@ -25,8 +25,8 @@
   hardware.pulseaudio.enable = lib.mkForce false;
 
   environment.systemPackages = with pkgs; [
-    jupiter-dock-updater-bin
+    jupiter-dock-updater-bin # Binary package for updating firmware on Jupiter Dock, a hardware accessory for certain laptops.
-    steamdeck-firmware
+    steamdeck-firmware # Firmware package for Valve's Steam Deck, a handheld gaming device.
   ];
 
   # GNOME settings through home

provision/hosts/bulwark/syncthing.nix

@@ -3,7 +3,9 @@
   networking.firewall.allowedTCPPorts = [ 8384 22000 ];
   networking.firewall.allowedUDPPorts = [ 22000 21027 ];
 
-  environment.systemPackages = with pkgs; [ syncthing ];
+  environment.systemPackages = with pkgs; [ 
+    syncthing # File sync program for multiple devices in real-time.
+  ];
 
   services.syncthing = {
     enable = true;

provision/hosts/kestrel/configuration.nix

@@ -69,10 +69,8 @@
     }];
   }];
   
-  # List packages installed in system profile.
   environment.systemPackages = with pkgs; [
-      # One-off stable packages
+      distrobox # Platform for creating and managing Linux distribution images.
-      distrobox
   ];
 
   # Enable modules

provision/hosts/kestrel/syncthing.nix

@@ -3,7 +3,9 @@
   networking.firewall.allowedTCPPorts = [ 8384 22000 ];
   networking.firewall.allowedUDPPorts = [ 22000 21027 ];
 
-  environment.systemPackages = with pkgs; [ syncthing ];
+  environment.systemPackages = with pkgs; [ 
+    syncthing # File sync program for multiple devices in real-time.
+  ];
 
   services.syncthing = {
     enable = true;

provision/hosts/manofwar/configuration.nix

@@ -56,10 +56,8 @@
     extraGroups = [ "dialout" "wheel" ]; # Enable ‘sudo’ for the user.
   };
   
-  # List packages installed in system profile.
   environment.systemPackages = with pkgs; [
-      # One-off packages
+    libraspberrypi # Library providing access to Raspberry Pi hardware features and interfaces.
-      libraspberrypi
   ];
 
   # Enable modules

provision/hosts/shivan/configuration.nix

@@ -69,10 +69,8 @@
     }];
   }];
   
-  # List packages installed in system profile.
   environment.systemPackages = with pkgs; [
-      # One-off packages
+    distrobox # Platform for creating and managing Linux distribution images.
-      distrobox
   ]; 
 
   # Enable modules

provision/hosts/shivan/syncthing.nix

@@ -3,7 +3,9 @@
   networking.firewall.allowedTCPPorts = [ 8384 22000 ];
   networking.firewall.allowedUDPPorts = [ 22000 21027 ];
 
-  environment.systemPackages = with pkgs; [ syncthing ];
+  environment.systemPackages = with pkgs; [ 
+    syncthing # File sync program for multiple devices in real-time.
+  ];
 
   services.syncthing = {
     enable = true;

provision/hosts/torus/configuration.nix

@@ -73,13 +73,11 @@
     shell = pkgs.bash;
   };
 
-  # List packages installed in system profile. To search, run:
-  # $ nix search wget
   environment.systemPackages = with pkgs; [
-    docker-compose
+    docker-compose # Tool for defining and running multi-container Docker applications.
-    python3
+    python3 # Interpreted, high-level programming language known for its simplicity and versatility.
-    zk
+    zk # Command-line tool for interacting with Apache ZooKeeper, a centralized service for distributed systems.
-    gollum
+    gollum # Wiki software that provides a simple, Git-based wiki engine.
   ];
 
   # Enable the OpenSSH daemon.

provision/hosts/torus/samba-server.nix

@@ -37,5 +37,7 @@
   networking.firewall.allowedUDPPorts = [ 137 138 ];
 
   # To make SMB mounting easier on the command line
-  environment.systemPackages = with pkgs; [ cifs-utils ];
+  environment.systemPackages = with pkgs; [ 
+    cifs-utils # Utilities for mounting and managing CIFS (Common Internet File System) shares.
+  ];
 }

provision/hosts/torus/share.nix

@@ -3,7 +3,9 @@
   networking.firewall.allowedTCPPorts = [ 5001 ];
   networking.firewall.allowedUDPPorts = [ 5001 ];
 
-  environment.systemPackages = with pkgs; [ dufs ];
+  environment.systemPackages = with pkgs; [ 
+    dufs # Distinctive utility file server
+  ];
 
   systemd.services.share = {
     description = "Start dufs for quick sharing of files";

provision/hosts/torus/syncthing.nix

@@ -3,7 +3,9 @@
   networking.firewall.allowedTCPPorts = [ 8384 22000 ];
   networking.firewall.allowedUDPPorts = [ 22000 21027 ];
 
-  environment.systemPackages = with pkgs; [ syncthing ];
+  environment.systemPackages = with pkgs; [ 
+    syncthing # File sync program for multiple devices in real-time.
+  ];
 
   services.syncthing = {
     enable = true;

provision/modules/desktop/browser.nix

@@ -6,8 +6,8 @@ in {
   options.modules.desktop.browser.enable = lib.mkEnableOption "browser";
   config = lib.mkIf cfg.enable {
     environment.systemPackages = with pkgs; [
-      google-chrome
+      google-chrome # Web browser developed by Google.
-      play-with-mpv
+      play-with-mpv # Script for playing media files with MPV media player in a simple and efficient manner.
     ];
     programs.chromium = {
       enable = true;

provision/modules/desktop/default.nix

@@ -3,18 +3,18 @@
   imports = [ ./keyd.nix ./browser.nix ./gnome.nix ./sway.nix ];
 
   environment.systemPackages = with pkgs; [
-    bc
+    bc # Arbitrary-precision arithmetic language.
-    fzf
+    fzf # Command-line fuzzy finder for Unix-like operating systems.
-    gamemode
+    gamemode # Optimizes system performance for gaming by adjusting system settings.
-    discord
+    discord # Voice, video, and text communication platform for communities and friends.
-    inkscape
+    inkscape # Vector graphics editor for creating illustrations, icons, logos, diagrams, and more.
-    libreoffice-fresh
+    libreoffice-fresh # Office suite compatible with Microsoft Office.
-    xournal
+    xournal # Note-taking and sketching application.
-    mpv
+    mpv # Media player for playing audio and video files.
-    p7zip
+    p7zip # Command-line file archiver with high compression ratio.
-    borgbackup
+    borgbackup # Deduplicating backup program with optional compression and authenticated encryption.
-    gimp
+    gimp # GNU Image Manipulation Program for editing and composing raster images.
-    wl-clipboard # wl-copy and wl-paste for copy/paste from stdin / stdout
+    wl-clipboard # Command-line utility to access and manipulate clipboard content in a Wayland session.
   ];
 
   # xdg-desktop-portal settings

provision/modules/desktop/gnome.nix

@@ -27,34 +27,31 @@ in {
 
   config = lib.mkIf cfg.enable {
     environment.systemPackages = with pkgs; [
-      gnome.dconf-editor
+      gnome.dconf-editor # Graphical tool for editing settings stored in the dconf database of GNOME.
-      gnome.gnome-tweaks
+      gnome.gnome-tweaks # Utility for customizing various aspects of the GNOME desktop environment.
-      gnomeExtensions.focus-changer
+      gnomeExtensions.focus-changer # GNOME Shell extension for changing window focus behavior.
-      evolution
+      evolution # Personal information management application that provides email, calendar, and contact management features.
-      # TODO: Add back when fixed upstream
+      #gnomeExtensions.fullscreen-avoider # TODO: Add back when fixed upstream
-      #gnomeExtensions.fullscreen-avoider
     ];
 
     environment.gnome.excludePackages = with pkgs.gnome; [
-      baobab          # disk usage analyzer
+      baobab # Disk usage analyzer for the GNOME desktop environment.
-      cheese          # photo booth
+      cheese # Webcam application for taking photos and videos.
-      epiphany        # web browser
+      epiphany # Web browser for the GNOME desktop environment.
-      pkgs.gedit      # text editor
+      pkgs.gedit # Text editor for the GNOME desktop environment.
-      simple-scan     # document scanner
+      simple-scan # Simple scanning utility for scanning documents and images.
-      totem           # video player
+      totem # Movie player for the GNOME desktop environment.
-      yelp            # help viewer
+      yelp # Help viewer application for the GNOME desktop environment.
-      evince          # document viewer
+      evince # Document viewer for the GNOME desktop environment.
-      geary           # email client
+      geary # Email client for the GNOME desktop environment.
-      seahorse        # password manager
+      seahorse # GNOME application for managing encryption keys and passwords.
-      pkgs.gnome-tour # tour app
+      pkgs.gnome-tour # Guided tour application for introducing users to GNOME desktop environment features.
-      pkgs.snapshot   # camera application
+      pkgs.snapshot # Utility for taking and managing system snapshots in the GNOME desktop environment.
-
+      pkgs.gnome-connections # GNOME application for accessing remote machines and services.
-      # these should be self explanatory
+      gnome-font-viewer # Utility for previewing and managing fonts in the GNOME desktop environment.
-      pkgs.gnome-connections
+      gnome-logs # Log viewer application for GNOME.
-      gnome-font-viewer 
+      gnome-maps # Map application for the GNOME desktop environment.
-      gnome-logs 
+      gnome-music # Music player and management application for GNOME.
-      gnome-maps 
-      gnome-music 
     ];
 
     # Enable wayland gnome

provision/modules/desktop/sway.nix

@@ -28,33 +28,33 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [
-      sway
+      sway # Tiling Wayland compositor and a drop-in replacement for the i3 window manager for X11.
-      swayidle
+      swayidle # Idle manager for Wayland, executing actions when the system is idle.
-      swaybg
+      swaybg # Wallpaper utility for Wayland, setting the background image.
-      sway-scratchpad
+      sway-scratchpad # Helper tool for managing scratchpad windows in the Sway window manager.
-      grim # screenshot functionality
+      grim # Screenshot utility for Wayland.
-      mako # notification system developed by swaywm maintainer
+      mako # Lightweight notification daemon for Wayland.
-      libnotify
+      libnotify # Library for sending desktop notifications.
-      wdisplays # tool to configure displays
+      wdisplays # Utility for managing displays in a Wayland session.
-      playerctl
+      playerctl # Command-line utility for controlling media players.
-      wayland
+      wayland # Protocol for a compositor to talk to its clients as well as a C library implementation of that protocol.
-      xwayland
+      xwayland # X server running as a Wayland client.
-      configure-gtk
+      configure-gtk # GTK-based utility for configuring various aspects of the desktop environment.
-      xdg-utils # for opening default programs when clicking links
+      xdg-utils # Collection of tools for managing desktop environments based on the XDG specifications.
-      glib # gsettings
+      glib # Library providing various core functions for the GNOME project.
-      dracula-theme # gtk theme
+      dracula-theme # Dark theme for various applications and environments.
-      gnome3.adwaita-icon-theme  # default gnome cursors
+      gnome3.adwaita-icon-theme # Default icon theme for GNOME.
-      networkmanagerapplet
+      networkmanagerapplet # GNOME applet for NetworkManager.
-      pcmanfm
+      pcmanfm # Lightweight file manager for X11.
-      udiskie
+      udiskie # Removable disk automounter for udisks.
-      pavucontrol
+      pavucontrol # GTK-based volume control utility for PulseAudio.
-      waybar
+      waybar # Highly customizable Wayland bar for Sway and Wlroots-based compositors.
       (pkgs.waybar.overrideAttrs (oldAttrs: {
          mesonFlags = oldAttrs.mesonFlags ++ [ "-Dexperimental=true" ];
          })
       )
     ] ++ [
-      inputs.hyprland-contrib.packages.${pkgs.system}.grimblast
+      inputs.hyprland-contrib.packages.${pkgs.system}.grimblast # Hyprland version of Grimshot
     ];
 
     xdg = {

provision/modules/devel/engineering.nix

@@ -9,10 +9,10 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [ 
-      super-slicer 
+      super-slicer # 3D printing slicing software with advanced features and customization options.
-      prusa-slicer
+      prusa-slicer # Slicing software optimized for Prusa 3D printers, offering user-friendly interface and settings.
-      freecad
+      freecad # Open-source parametric 3D CAD modeler.
-      blender 
+      blender # Open-source 3D creation suite for modeling, animation, rendering, and more.
     ];
   };
 }

provision/modules/devel/notes.nix

@@ -6,13 +6,12 @@ in {
   options.modules.devel.notes.enable = lib.mkEnableOption "notes";
   config = lib.mkIf cfg.enable {
     environment.systemPackages = with pkgs; [
-      pandoc
+      pandoc # Universal document converter.
-      gollum
+      gollum # Wiki software that provides a simple, Git-based wiki engine.
-      obsidian
+      obsidian # Note-taking and knowledge management application.
-      zk
+      zk # Command-line tool for interacting with Apache ZooKeeper, a centralized service for distributed systems.
-      # for zk
+      bat # Cat clone with syntax highlighting and Git integration.
-        bat
+      fzf # Command-line fuzzy finder for Unix-like operating systems.
-        fzf
     ];
   };
 }

provision/modules/devel/python.nix

@@ -5,10 +5,10 @@
 let
   cfg = config.modules.devel.python;
   my-python-packages = ps: with ps; [
-    virtualenv
+    virtualenv # Tool for creating isolated Python environments.
-    i3ipc
+    i3ipc # Python library for controlling i3 window manager via its IPC interface.
-    ipython
+    ipython # Interactive computing environment for Python.
-    pip
+    pip # Package installer for Python.
   ];
   
 in {
@@ -17,9 +17,9 @@ in {
 
     environment.systemPackages = with pkgs; [ 
       (python3.withPackages my-python-packages)
-      fava 
+      fava # Web interface for the double-entry bookkeeping software Beancount.
-      beancount
+      beancount # Double-entry bookkeeping software for tracking financial transactions.
-      nodePackages_latest.pyright
+      nodePackages_latest.pyright # Latest version of the Pyright package, a static type checker for Python.
     ];
   };
 }

provision/modules/devel/tooling.nix

@@ -9,11 +9,11 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [
-      cmake
+      cmake # Cross-platform build system generator.
-      gcc
+      gcc # GNU Compiler Collection, a compiler system for programming languages.
-      coreutils
+      coreutils # Collection of basic file, shell, and text manipulation utilities.
-      gnumake
+      gnumake # GNU Make, a build automation tool.
-      go
+      go # Programming language developed by Google, known for its simplicity and efficiency.
     ];
   };
 }

provision/modules/gaming/emulation.nix

@@ -6,17 +6,17 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [ 
-      yuzu-archive
+      yuzu-archive # Nintendo Switch emulator.
-      citra-archive
+      citra-archive # Nintendo 3DS emulator.
-      dolphin-emu
+      dolphin-emu # GameCube and Wii emulator.
-      ppsspp
+      ppsspp # PSP emulator.
-      mgba
+      mgba # Game Boy Advance emulator.
       (retroarch.override {
         cores = with libretro; [
-          nestopia
+          nestopia # Nintendo Entertainment System (NES) emulator.
-          snes9x
+          snes9x # Super Nintendo Entertainment System (SNES) emulator.
-          mgba
+          mgba # Game Boy Advance emulator.
-          melonds
+          melonds # Nintendo DS emulator.
         ];
       })
     ];

provision/modules/gaming/misc.nix

@@ -6,10 +6,10 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [ 
-      sunshine
+      sunshine # Utility for streaming Android device display to a computer.
-      moonlight-qt
+      moonlight-qt # Qt-based client for NVIDIA GameStream, allowing streaming of PC games to other devices.
-      prismlauncher
+      prismlauncher # Launcher for Prism, a web application framework.
-      jdk17
+      jdk17 # Java Development Kit (JDK) version 17.
     ];
   };
 }

provision/modules/gaming/steam.nix

@@ -15,9 +15,9 @@ in {
     hardware.steam-hardware.enable = true;
 
     environment.systemPackages = with pkgs; [ 
-      steam
+      steam # Digital distribution platform for purchasing and playing video games.
-      steamtinkerlaunch
+      steamtinkerlaunch # Launcher and optimization tool for Steam games.
-      gamescope
+      gamescope # Utility for running games using Valve's Steam Play compatibility layer with improved performance and compatibility.
     ];
   };
 }

provision/modules/services/peripherals.nix

@@ -9,8 +9,8 @@ in {
     hardware.openrazer.users = ["tstarr"];
 
     environment.systemPackages = with pkgs; [
-        polychromatic
+      polychromatic # Graphical utility for configuring RGB lighting effects on Razer peripherals.
-        pulseaudio
+      pulseaudio # Sound server for Linux and other Unix-like operating systems.
     ];
 
     # rtkit is optional but recommended

provision/modules/services/samba-client.nix

@@ -10,6 +10,8 @@ in {
     networking.firewall.allowedUDPPorts = [ 137 138 ];
 
     # To make SMB mounting easier on the command line
-    environment.systemPackages = with pkgs; [ cifs-utils ];
+    environment.systemPackages = with pkgs; [ 
+      cifs-utils # Utilities for mounting and managing CIFS (Common Internet File System) shares.
+    ];
   };
 }

provision/modules/services/virt-manager.nix

@@ -6,6 +6,8 @@ in {
   config = lib.mkIf cfg.enable {
     virtualisation.libvirtd.enable = true;
     programs.dconf.enable = true;
-    environment.systemPackages = with pkgs; [ virt-manager ];
+    environment.systemPackages = with pkgs; [ 
+      virt-manager # Desktop application for managing virtual machines through libvirt.
+    ];
   };
 }

provision/modules/system/terminal.nix

@@ -6,48 +6,38 @@ in {
   config = lib.mkIf cfg.enable {
 
     environment.systemPackages = with pkgs; [
-      git
+      git # Version control system for tracking changes in source code during software development.
-      git-annex
+      git-annex # Manages files with git, without checking the file contents into git.
-      lazygit
+      lazygit # Terminal-based GUI for git, making it easier to use and visualize git repositories.
-      killall
+      killall # Command-line utility to terminate processes by name.
-      pciutils
+      pciutils # Utilities for inspecting and manipulating devices connected to the PCI bus.
-      chezmoi
+      chezmoi # Manages your dotfiles across multiple machines, ensuring consistency and version control.
-      nix-init
+      nix-init # Command-line utility for initializing and managing NixOS system configurations.
-      btop
+      btop # Terminal-based resource monitor, providing an interactive view of system resources.
-      cookcli
+      cookcli # Command-line tool for managing Cook, a job scheduling system.
-
+      nix-search-cli # Command-line utility for searching the Nix package repository.
-      rbw 
+      rbw # Command-line interface to the Bitwarden password manager.
-      # for rbw
+      pinentry-curses # Simple curses-based passphrase entry dialog for GnuPG.
-        pinentry-curses 
+      bash # GNU Bourne-Again SHell, a command language interpreter for Unix-like operating systems.
-
+      bash-completion # Provides programmable completion for the bash shell.
-      bash
+      tmux # Terminal multiplexer, allowing multiple terminal sessions within a single window.
-      # for bash
+      tmuxp # Manages tmux sessions through simple, declarative configuration files.
-        bash-completion
+      thefuck # Corrects errors in previous console commands.
-        tmux
+      nnn # Terminal file manager with a focus on performance and ease of use.
-        tmuxp
+      advcpmv # Advanced version of the Unix utilities cp and mv.
-        thefuck
+      unzip # Command-line utility for extracting files from ZIP archives.
-
+      trash-cli # Command-line interface to the freedesktop.org Trash.
-      nnn
+      catimg # Display images in the terminal using ASCII characters.
-      # for nnn
+      vim # Text editor that is highly configurable and widely used, especially in the Unix environment.
-        advcpmv
+      neovim # Fork of Vim aiming to improve extensibility and usability.
-        unzip
+      nodejs # JavaScript runtime built on Chrome's V8 JavaScript engine.
-        trash-cli
+      ripgrep # Line-oriented search tool that recursively searches directories for a regex pattern.
-        catimg
+      cargo # Package manager and build system for Rust.
-
+      taskwarrior # Command-line task management tool.
-      vim
+      taskopen # Open Taskwarrior tasks in a text editor.
-      neovim
+      taskwarrior-tui # Interactive terminal user interface for Taskwarrior.
-      # for neovim
+      timewarrior # Command-line time tracking utility.
-        nodejs 
+      ollama # Command-line tool for viewing and managing Open Location Codes.
-        ripgrep
-        cargo
-
-      taskwarrior
-      # for taskwarrior
-        taskopen
-        taskwarrior-tui
-        timewarrior
-      ollama
     ];
-
   };
 }

provision/modules/system/wireguard-client.nix

@@ -18,7 +18,9 @@ in {
   config = lib.mkIf cfg.enable {
     # Create qr code for phones with:
     # qrencode -t ansiutf8 < myfile_here
-    environment.systemPackages = with pkgs; [ qrencode ];
+    environment.systemPackages = with pkgs; [ 
+      qrencode # Command-line utility for generating QR codes from text or data.
+    ];
     networking.firewall = {
       allowedUDPPorts = [ 51820 ];
     };