virtualisation.virtualbox.guest.enable = true; # Enables VirtualBox Guest Additions
virtualisation.virtualbox.guest.seamless = true;
# Enables seamless mode integration.
# It allows windows from the guest and host to be displayed together, providing a more integrated experience and ...
# making it appear as if applications from the guest are running directly on the host.
virtualisation.virtualbox.guest.clipboard = true;
# Enables clipboard sharing (copy and paste) between host and guest
virtualisation.virtualbox.guest.x11 = true;
# Ensures X11-based graphical improvements, improving display resolution, mouse pointer integration, and overall usability inside the virtual machine.

sound.enable = true; # Enables basic sound support in NixOS (ALSA).
hardware.pulseaudio.enable = true; # Enables the PulseAudio sound server.
# It provides advanced sound management features, such as per-application volume control and network audio streaming.
hardware.pulseaudio.support32Bit = true; # Allows support for 32-bit applications to use PulseAudio.

users.users.nmaximo7 = {
  isNormalUser = true;
  # ...other user settings...
  extraGroups = [ "audio" ]; # Add the user to 'audio' group
};

nix = {
# A recurring problem with NixOS is the lack of space on /, it is relatively easy for /nix/store to grow beyond reasonable sizes.
settings.auto-optimise-store = true; # It periodically optimizes the Nix store to save space.
	gc = { # Enables automatic garbage collection.
  		automatic = true; # Automatically cleans up old or unused packages and system generations weekly.
        dates = "weekly"; # Schedules garbage collection weekly.
        options = "--delete-older-than 7d"; # Deletes generations older than 7 days, ensuring the store doesn't accumulate outdated packages.
    };
};
# System Auto-Upgrades
system.autoUpgrade = {
  	enable = true; # Activates the automatic upgrade feature.
    dates = "02:00"; # Schedules the upgrade to run daily at 02:00 AM.
    randomizedDelaySec = "45min"; #  Adds a random delay (up to 45 minutes) to avoid simultaneous updates across multiple systems (system administrator.)
};

sudo nix-channel --update
# This fetches the latest package lists from subscribed channels (it synchronizes local channel metadata with remote sources).
sudo nixos-rebuild switch --upgrade
# Fetches updated versions, rebuilds, and activates the system configuration with the latest packages, making it a convenient way to keep your system up-to-date.

#!/bin/sh
# Ultimate update
# _  _  __  _  _  __   ___    _  _  ___  ___   __  ____  ___
#( \( )(  )( \/ )/  \ / __)  ( )( )(  ,\(   \ (  )(_  _)(  _)
# )  (  )(  )  (( () )\__ \   )()(  ) _/ ) ) )/__\  )(   ) _)
#(_)\_)(__)(_/\_)\__/ (___/   \__/ (_)  (___/(_)(_)(__) (___)

# Setting Variables
cowsay "Update"
echo "Update"
USER=nmaximo7
BACKUP_DEST="/run/media/${USER}/mydisk2"

# This fetches the latest package lists from subscribed channels.
if ! nix-channel --update; then
    echo "Failed to update Nix channels."
    exit 1
fi
# Rebuild the system
if ! sudo nixos-rebuild switch; then
    echo "Failed to rebuild the system."
    exit 1
fi

# Update your installed Flatpak applications so you can benefit from the latest features and security updates.
if ! flatpak update; then
    echo "Failed to update Flatpak applications."
fi

# Upgrade all containers in Distrobox
if ! distrobox-upgrade --all; then
    echo "Failed to upgrade Distrobox containers."
fi

# Upgrade the system. Fetches the latest packages, rebuilds, and activates the new generation, making it a convenient way to keep your system up-to-date.
if ! sudo nixos-rebuild switch --upgrade; then
    echo "Failed to upgrade the system configuration."
    exit 1
fi

# Version Control: Keep your configuration files under version control to track changes and facilitate rollbacks.

cd /home/nmaximo7/dotfiles
# git status --porcelain: This command returns a list of files that have changes compared to the last commit.
# if [ -n "$(git status --porcelain)" ]... checks if git status --porcelain produces any output.
# If it does, this means there are changes in the working directory or the staging area that haven't been committed yet.
# Then, it commits them (if any are found), ensuring version-controlled configuration changes are always up-to-date.

if [ -n "$(git status --porcelain)" ]; then
    git add .
    git commit -m "Update NixOS configuration"
    git push
else
echo "No changes to commit."
fi

# Monitor disk use
# nix-store --gc --print-dead
# df -h /nix/store

nix = {
	package = pkgs.nixFlakes; # Use the Nix package manager with Flakes support.
	extraOptions =  ''
		experimental-features = nix-command flakes
		''; # Nix Flakes are an experimental feature, so you must explicitly enable them.
  };

	mkdir flake # Create a Directory for Your Flake
	cd flake # Go into this directory.
	nix flake init -t templates#nixos-recommended # Initialize a new flake.
  # Create a basic flake in the current directory from a template. # It will create a flake.nix using a template.
	# The -t templates#nixos-recommended flag specifies a template that provides a recommended flake structure.
	vim flake.nix

# vim flake.nix
{
  description = "NixOS Configuration"; # A brief description of the flake

  # The inputs attribute specifies external dependencies for the flake.
  # nixpkgs and home-manager are pulled from GitHub
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.05";  # Specifies the source of Nix packages from the stable branch of Nixpkgs
    home-manager = {
      url = "github:nix-community/home-manager/release-24.05";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
  # The outputs function defines what this flake produces or provides.
  # It takes self (the flake itself), nixpkgs (the imported package set), and home-manager as arguments.
  outputs = { self, nixpkgs, home-manager, ... }:
    let
        system = "x86_64-linux"; # Use the defined system architecture
        pkgs = import nixpkgs { inherit system; }; # Import the Nixpkgs package
        lib = nixpkgs.lib;  # Import the Nixpkgs library for utility functions
    in {
    	# Define NixOS system configurations here keyyed by hostname (e.g., your-user) [*]
    	nixosConfigurations = {
    		your-user = lib.nixosSystem { # Create a NixOS system configuration named "your-user"
    		   inherit system; # It specifies the architecture for which the NixOS configuration is built. This is usually x86_64-linux for standard desktops and servers.
           # lib.nixosSystem builds a full NixOS system configuration from a list of modules.
    		   modules = [ # A list of NixOS module files to include in the configuration.
    		   ./configuration.nix # Include the main configuration file for system settings
    		   home-manager.nixosModules.home-manager # It also integrates Home Manager as a NixOS module.
                   {
                      home-manager.useGlobalPkgs = true;
	                    home-manager.useUserPackages = true;
                      # Inside the modules sets up a Home Manager configuration for user "your-user"
	                    home-manager.users.your-user = {
	                	    imports = [ ./home.nix];
	                    };
                   }
    		   ];
    		};
    	}; # end of nixosConfigurations
    };
}

# vim home.nix
# This is your home-manager configuration file
# Use this to configure your home environment
{ config, pkgs, ... }:

  # home.username and home.homeDirectory are derived from the NixOS user account.
  # Add packages for your user as you see fit.
  # These are user-level packages managed by Home Manager.
  home.packages = with pkgs; [ htop ];

  # Enable git
  programs.git.enable = true;

  # Nicely reload system units when changing configs
  systemd.user.startServices = [ "sd-switch" ];

  home.stateVersion = "24.05";  # It must match both your NixOS and Home Manager release version to ensure compatibility.
}

	sudo nixos-rebuild switch --flake .#your-user
  # --flake .#your-user specifies the flake in the current directory (.) and..
  # the your-user configuration defined in flake.nix [*].

	sudo nixos-rebuild switch --flake '.#your-user'
  # In zsh, "#" is used for comments, so you need to quote the argument.