boot = {
  [...]
  # Kernel parameters for NVIDIA driver support
  kernelParams = [
    "nvidia-drm.modeset=1" # Enables kernel modesetting for the proprietary NVIDIA driver.
    "nouveau.modeset=0" # Disables modesetting for the open-source Nouveau driver, preventing conflicts with proprietary NVIDIA drivers.
  ];
};

# Enable GNOME Keyring for managing secrets
services.gnome.gnome-keyring.enable = true;
security.pam.services.greetd.enableGnomeKeyring = true;

# Configure Greetd for managing the display manager
services.greetd = {
  enable = true; # Enables the greetd display manager service
  settings = {
    # This block defines the default session settings for greetd.
    default_session = {
    # This line specifies the command that greetd will run.
    # Tells greetd to launch tuigreet, a visually appealing login screen with customizable themes and colors, ...
    # display current time (--time) and start Hyprland when a user logs in (--cmd Hyprland).
      command = "${pkgs.greetd.tuigreet}/bin/tuigreet --time --cmd Hyprland";
      user = "YOUR-USERNAME"; # This specifies the username that will be used to log into the session by default.
    };
  };
};

# NVIDIA hardware configuration
hardware.nvidia = {
  modesetting.enable = true; # Enable modesetting for NVIDIA
  # It matches the earlier kernelParams for NVIDIA modesetting.
  open = false; # Indicates that proprietary NVIDIA drivers should be used instead of the open-source alternatives
  nvidiaSettings = true;
  # Enable the NVIDIA settings utility (nvidia-settings) for advanced driver configuration
};

# Enable Bluetooth support
hardware.bluetooth.enable = true;

# Set the LD_LIBRARY_PATH for OpenGL applications
hardware.opengl.setLdLibraryPath = true;

# Specify the video drivers for the X server
services.xserver.videoDrivers = [ "nvidia" ]; # Use the NVIDIA video driver

# Enable sound support in NixOS
sound.enable = true;

# Disable PulseAudio, as we will use PipeWire instead
hardware.pulseaudio.enable = false;
hardware.pulseaudio.support32Bit = false; # Disable 32-bit support for PulseAudio

# Configure PipeWire for sound management
services.pipewire = {
  enable = true; # Enable PipeWire as the main audio server
  alsa.enable = true; # Enable ALSA support for low-level audio device handling
  pulse.enable = true; # Enable PulseAudio compatibility layer
  wireplumber.enable = true; # Enable WirePlumber, a session manager for PipeWire
};

users.users.YOUR-USERNAME = {
  isNormalUser = true; # Set this user as a normal user
  description = "YOUR-USERNAME"; # Description for the user account
  extraGroups = [ "networkmanager" "wheel" "docker" "input" ]; # Add user to additional groups for permissions
  shell = "${pkgs.zsh}/bin/zsh"; # Set the default shell for the user to Zsh
  packages = with pkgs; [ # Additional packages installed only for this user, e.g., keepassxc, cowsay, etc.
  ];
};

# Define system-wide packages to be installed
environment.systemPackages = with pkgs; [
  [...]
  pavucontrol # GUI for controlling PulseAudio settings
  kitty # A GPU-accelerated terminal emulator
  rofi # Application launcher
  rofi-calc # Calculator integration for Rofi
  rofi-power-menu # Power menu for Rofi
  gnupg # GNU Privacy Guard for encryption
  pinentry # PIN entry dialog for GnuPG
  hyprland # The Hyprland compositor
  xorg.xkeyboardconfig # Keyboard configuration for X11
  hyprpaper # Wallpaper manager for Hyprland
  polkit_gnome # PolicyKit integration for GNOME
  waybar # A bar for Wayland (like Polybar but for Wayland)
  psmisc # Package includes utilities like 'killall'
  xorg.xkill # Utility to kill X11 clients
  swww # Simple wallpaper setter
  networkmanagerapplet # Applet for NetworkManager
  xwayland # X compatibility layer for Wayland
  mesa # OpenGL implementation
  gnome.adwaita-icon-theme # Default GNOME icon theme (so flatpak may play "nice")
  gtk3 # GTK 3 libraries
  power-profiles-daemon # Manage power profiles
];

# Enable RTKit for real-time audio processing, ...
# improving audio performance and reducing dropouts.
security.rtkit.enable = true;
# Enable D-Bus for inter-process communication
services.dbus.enable = true;

{ config, pkgs, ... }:

let
  username = "nmaximo7"; # Define the username for the Home Manager configuration
  dotfiles = "/home/${username}/dotfiles"; # Path to the user's dotfiles directory
in
{
  # Enable Home Manager features
  home-manager.useGlobalPkgs = true; # Allows usage of globally defined packages in your user environment.
  home-manager.useUserPackages = true;
  # Tell Home Manager to handle user-specific packages
  home-manager.backupFileExtension = "backup";
  # Set the file extension for backups
  # If Home Manager sees conflicting files when deploying new dotfiles,...
  # it appends the extension .backup to old configuration files instead of overwriting them silently.

  # User-specific Home Manager configuration
  home-manager.users.nmaximo7 = { pkgs, ... }:
  {
    # Let Home Manager install and manage itself
    programs.home-manager.enable = true;
    [...]
    # Include other configuration files
    imports = [
          "${dotfiles}/shell.nix"
          "${dotfiles}/kitty.nix"
          "${dotfiles}/zsh.nix"
          "${dotfiles}/alacritty.nix"
          "${dotfiles}/rofi.nix"
          "${dotfiles}/vscode.nix"
          "${dotfiles}/nvim.nix"
          "${dotfiles}/Hyprland/Hyprland.nix"
          # Import Hyprland specific configuration
        # Add other configuration files as needed
    ];

    # Define a global override for Flatpak applications to see (and share) fonts from your Nix store
    home.file.".local/share/flatpak/overrides/global".text = ''
      [Context]
      filesystems=/run/current-system/sw/share/X11/fonts:ro;/nix/store:ro
    '';
  };
}

{ config, pkgs, lib, ... }:

let
  username = "YOUR-USERNAME"; # Define the username for the configuration
  browser = "${pkgs.firefox}/bin/firefox"; # Path to the browser executable (Firefox)
  terminal = "${pkgs.kitty}/bin/kitty"; # Path to the terminal executable (Kitty)
  home = config.home; # Reference to the home configuration
  scriptsDir = "/home/${username}/dotfiles/scripts"; # Directory containing user's scripts
  powerMenuCommand = "rofi -show power-menu -modi power-menu:rofi-power-menu"; # Command for power menu
  # Import keybindings from a separate file for modularity
  keybindings = import /home/${username}/dotfiles/keybindings.nix {
    modifier = "SUPER";  # Modifier key for keybindings
    terminal = terminal;  # Reference to the terminal
    browser = browser;  # Reference to the browser
    scriptsDir = scriptsDir;  # Reference to the scripts directory
    powerMenuCommand = powerMenuCommand;  # Reference to power menu command
  };
in
{
  # Enables Hyprland with XWayland support and specifies the package to use.
  wayland.windowManager.hyprland = {
    enable = true; # Enable the Hyprland window manager under Wayland.
    xwayland = {
      enable = true; # Enable XWayland support for X11 applications
    };
    systemd.enable = true; # Enable systemd integration
    package = pkgs.hyprland; # Specify the package to use

    extraConfig = let
      modifier = "SUPER"; # Define the modifier key (usually the Windows key)
    in ''
      # Monitor configuration
      monitor=DVI-I-1,1920x1080@60,auto,1

❯ hyprctl monitors
# This command provides detailed information about all available monitors
# This information includes identifiers, resolutions, positions, and other properties.
Monitor DVI-I-1 (ID 0):
	1920x1080@60.00000 at 0x0
	description: LG Electronics LG TV SSCR2 0x01010101
	[...]
  availableModes: 3840x2160@30.00Hz ... 1920x1080@50.00Hz 1920x1080@29.97Hz ... 640x480@59.94Hz

      # Import environment variables on session start
      ${import /home/${username}/dotfiles/Hyprland/env.nix {}}

      # It updates the systemd user environment with variables needed for Wayland and your desktop environment.
      # Ensure that applications and services running in your user session have the necessary environment variables set.
      exec-once = dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP
      # It runs the NetworkManager tray icon.
      exec-once = nm-applet --indicator
      # It launches Waybar after a 1-second delay.
      exec-once = sleep 1 && waybar
      # It opens Alacritty on workspace 1 with a custom message.
      exec-once = [workspace 1 silent] alacritty -e sh -c 'cowsay "Welcome master! Type inicio"; exec $SHELL'
      # Each ${import ...} statement loads a separate Nix file, which allows you to keep different parts of your configuration modular. This is beneficial for organization and ease of maintenance.

      # Window rules
      ${import /home/${username}/dotfiles/Hyprland/windowrules.nix {}}

      # Visual customization
      ${import /home/${username}/dotfiles/Hyprland/visual.nix {}}

      # Import animations
      ${import /home/${username}/dotfiles/Hyprland/animations.nix {}}

      # Decorations
      ${import /home/${username}/dotfiles/Hyprland/decorations.nix {}}

      # Importing your keybindings. It allows you to manage your keybindings independently.
      ${keybindings}

    '';
  };
}

{ }:

''
# Sets necessary environment variables for Wayland and application compatibility.
env = XDG_CURRENT_DESKTOP,Hyprland
# Tells apps you're running Hyprland. Some applications look for XDG_CURRENT_DESKTOP to detect your environment and adapt behavior.
env = XDG_SESSION_TYPE,wayland # Indicates a Wayland session
env = GDK_BACKEND,wayland # It ensures GTK applications use Wayland.
env = QT_QPA_PLATFORM,wayland # It ensures Qt applications use Wayland.
env = MOZ_ENABLE_WAYLAND,1 # It helps Firefox and other Mozilla-based apps run natively on Wayland.
env = GDK_SCALE,1
env = QT_SCALE_FACTOR,1
# GDK_SCALE and QT_SCALE_FACTOR help scale apps correctly on high DPI or scaled displays.
''

{ }:

''
  # Assign applications to specific workspaces
  windowrulev2 = workspace 1, class:^(Alacritty)$
  # It places Alacritty windows on workspace 1, firefox on workspace 2, and so on.
  windowrulev2 = workspace 2, class:^(firefox)$
  windowrulev2 = workspace 3, class:^(obsidian)$
  windowrulev2 = workspace 4, class:^(code-oss)$
  windowrulev2 = workspace 4, class:^(Google-chrome)$
  windowrulev2 = workspace 5, class:^(pcmanfm)$
  windowrulev2 = workspace special:geany, class:^(Geany)$

  # Float VLC and pavucontrol, meaning VLC and pavucontrol...
  # will always be a floating window, rather than tiling with other apps.
  windowrulev2 = float, class:^(vlc)$
  windowrulev2 = float, class:^(pavucontrol)$

  # Float Rofi windows
  windowrulev2 = float, class:^(Rofi)$
''

{ }:
''
# General Settings
general {
        gaps_in = 6
        # gaps_in and gaps_out control the space within and around tiled windows.
        gaps_out = 8
        # This specifies the thickness of the window borders.
        border_size = 2
        layout = dwindle # uses a spiral/dwindle tiling layout.
        # The dwindle layout is a dynamic tiling layout that allows windows to dynamically resize, move, and reorganize, providing a flexible workspace.
        resize_on_border = true
        # It allows you to resize windows by dragging their borders, which can enhance usability.
}

# Input Settings
input {
    kb_layout = es, us
    # It sets Spanish and US English keyboard layouts, allowing for quick switching.
    kb_options = "grp:alt_shift_toggle,caps:super"
    # The options specify how to toggle keyboard layouts (by pressing Alt + Shift) and set the Caps Lock key to act as a Super key
    sensitivity = 0.0
    # Setting the sensitivity to 0.0 might indicate that you want to disable any pressure sensitivity for input devices, such as touchpads or styluses.
    accel_profile = "flat"
    # This setting indicates a linear acceleration profile for mouse movement, providing consistent pointer speed, which can be beneficial for precision tasks.
}

# Misc settings
misc {
        initial_workspace_tracking = 0
        # This controls the initial tracking of the workspace. A value of 0 mean no initial tracking is set, allowing for a fresh start.
        mouse_move_enables_dpms = true
        # Setting this to true means that moving the mouse will wakes the display after power-saving mode,...
        # which can help save energy when the display is not in use.
        key_press_enables_dpms = false
        # This setting disables DPMS activation (power-saving mode) on key presses.
}
''

# -----------------------------------------------------
# Animations Configuration
# -----------------------------------------------------
{ ... }:

''
animations {
    enabled = true;  # Enable animations
    bezier = myBezier, 0.05, 0.9, 0.1, 1.05;
    # Defines a custom bezier curve to shape the animation’s movement for windows and transitions.

    # Define different window animations
    animation = windows, 1, 7, myBezier;  # Transitions for windows appearing.
    # The numeric parameters (1, 7, etc.) affect timing and animation speed.
    animation = windowsOut, 1, 7, default, popin 80%;  # Transitions for windows disappearing
    animation = border, 1, 10, default;  # Animation for border changes
    animation = borderangle, 1, 8, default;  # Animation for border angle changes
    animation = fade, 1, 7, default;  # Fade animation
    animation = workspaces, 1, 6, default;  # Animation for switching workspaces
}
''

{ modifier, terminal, browser, scriptsDir, powerMenuCommand, ... }:
let
  screenshotDir = "$HOME/Downloads";
in

''
# Keybindings for launching applications, moving windows, and managing workspaces.
# ${modifier} usually references SUPER or the "Windows" key.
# Launching Apps ------------------------------
bind = ${modifier},Return,exec,${terminal} # Open terminal with Windows (Modifier) + Return.
bind = ${modifier},W,exec,${browser} # Open browser (Firefox) with Windows + W
bind = ${modifier},F1,exec,alacritty # Launch Alacritty terminal with Windows + F1
bind = ${modifier},F2,exec,firefox # Launch Firefox with Windows + F2
bind = ${modifier},E,exec,sh /home/${username}/dotfiles/scripts/empezar.sh # Custom script
# Window/Session Management ------------------------------
bind = ${modifier},M,exit # forcibly closes the entire Hyprland session
bind = ${modifier},V,togglefloating # It switches the current window between tiled (normal) and floating (free-moving) modes.
# Rofi ------------------------------
bind = ${modifier},D,exec,rofi -combi-modi window,drun,ssh ,emoji -font "hack 10" -show combi -show-icons
# Launch Rofi with the combined modes specified (window, drun, ssh, emoji)...
#  for launching programs, switching windows, or picking emojis and displays icons next to the entries.

bind = ${modifier}+SHIFT,D,exec,rofi -show power-menu --choices=shutdown/reboot/logout/lockscreen --confirm=logout/lockscreen
# Launch Rofi power menu. It prompts for confirmation ONLY before executing the logout or lock screen actions.
bind = ${modifier},Q,killactive # Kill active window
bind = ${modifier}+CTRL,Q,exec,hyprctl dispatch exit # Exit Hyprland

# Screenshots ------------------------------
bind = ${modifier},P,exec,sh -c 'grim "${screenshotDir}/$(date +%Y-%m-%d_%H-%M-%S).png"'
# It takes a full screenshot with Grim, saving it to $HOME/Downloads.
bind = ${modifier}+ALT,P,exec,sh -c 'grim -g "$(slurp)" "${screenshotDir}/$(date +%Y-%m-%d_%H-%M-%S).png"'
# It takes a region screenshot, letting you select an area with Slurp.