pagedmov/nixos-config
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

added documentation for custom hyprland controls

Browse Source
This commit is contained in:
pagedmov
2024-11-07 15:31:34 -05:00
parent da191e5ae4
commit 2127996ee8
4 changed files with 264 additions and 217 deletions
Download Patch File Download Diff File Expand all files Collapse all files

328
docs/options/home_options.md
View File

@@ -1,235 +1,235 @@
# Home-Manager Options # Home-Manager Options
## homeFiles.enable ## homeFiles.enable
- Enables my declared files - Enables my declared files
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/files/neofetch.nix' - Defined in 'modules/home/files/neofetch.nix'
## hyprlandConfig.enable ## hyprlandConfig.enable
- Enables my custom hyprland configuration - Enables my custom hyprland configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/hyprland.nix' - Defined in 'modules/home/environment/hyprland.nix'
## autojumpConfig.enable ## autojumpConfig.enable
- Enables my autojump options - Enables my autojump options
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/autojump.nix' - Defined in 'modules/home/programs/autojump.nix'
## stylixHomeConfig.enable ## stylixHomeConfig.enable
- Enables my stylix home-manager options - Enables my stylix home-manager options
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/stylix.nix' - Defined in 'modules/home/environment/stylix.nix'
## waybarConfig.enable ## waybarConfig.enable
- Enables my custom waybar configuration - Enables my custom waybar configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/waybar.nix' - Defined in 'modules/home/environment/waybar.nix'
## gtkConfig.enable ## gtkConfig.enable
- Enables my gtk configuration - Enables my gtk configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/gtk.nix' - Defined in 'modules/home/environment/gtk.nix'
## spicetifyConfig.enable ## spicetifyConfig.enable
- Enables my spicetify configuration - Enables my spicetify configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/spicetify.nix' - Defined in 'modules/home/environment/spicetify.nix'
## starshipConfig.enable ## starshipConfig.enable
- Enables my starship configuration - Enables my starship configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/starship.nix' - Defined in 'modules/home/environment/starship.nix'
## btopConfig.enable ## btopConfig.enable
- Enables my btop configuration - Enables my btop configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/btop.nix' - Defined in 'modules/home/programs/btop.nix'
## swayncConfig.enable ## swayncConfig.enable
- Enables my swaync configuration - Enables my swaync configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/swaync.nix' - Defined in 'modules/home/environment/swaync.nix'
## userPkgs.enable ## userPkgs.enable
- Enables my default user packages - Enables my default user packages
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/userpkgs.nix' - Defined in 'modules/home/environment/userpkgs.nix'
## cavaConfig.enable ## cavaConfig.enable
- Enables my cava configuration - Enables my cava configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/cava.nix' - Defined in 'modules/home/programs/cava.nix'
## ezaConfig.enable ## ezaConfig.enable
- Enables my eza configuration - Enables my eza configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/eza.nix' - Defined in 'modules/home/programs/eza.nix'
## firefoxConfig.enable ## firefoxConfig.enable
- Enables my firefox configuration - Enables my firefox configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/firefox.nix' - Defined in 'modules/home/programs/firefox.nix'
## fuzzelConfig.enable ## fuzzelConfig.enable
- Enables my fuzzel configuration - Enables my fuzzel configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/fuzzel.nix' - Defined in 'modules/home/programs/fuzzel.nix'
## fzfConfig.enable ## fzfConfig.enable
- Enables my fzf configuration - Enables my fzf configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/fzf.nix' - Defined in 'modules/home/programs/fzf.nix'
## gitConfig.enable ## gitConfig.enable
- Enables my git configuration - Enables my git configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/git.nix' - Defined in 'modules/home/programs/git.nix'
## kittyConfig.enable ## kittyConfig.enable
- Enables my kitty configuration - Enables my kitty configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/kitty.nix' - Defined in 'modules/home/programs/kitty.nix'
## yaziConfig.enable ## yaziConfig.enable
- Enables my yazi configuration - Enables my yazi configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/yazi.nix' - Defined in 'modules/home/programs/yazi.nix'
## zshConfig.enable ## zshConfig.enable
- Enables my zsh configuration - Enables my zsh configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/environment/zshell.nix' - Defined in 'modules/home/environment/zshell.nix'
## passConfig.enable ## passConfig.enable
- Enables my password-store configuration - Enables my password-store configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/password-store.nix' - Defined in 'modules/home/programs/password-store.nix'
## batConfig.enable ## batConfig.enable
- Enables my bat configuration - Enables my bat configuration
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/programs/bat.nix' - Defined in 'modules/home/programs/bat.nix'
## movScripts.enable ## movScripts.enable
- Enables my custom script binaries - Enables my custom script binaries
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
## movScripts.commandScripts ## movScripts.commandScripts
### enable ### enable
- Enables my custom command scripts - Enables my custom command scripts
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### invoke.enable ### invoke.enable
- Enables the invoke command - Enables the invoke command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### runbg.enable ### runbg.enable
- Enables the runbg command - Enables the runbg command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### splash.enable ### splash.enable
- Enables the splash command - Enables the splash command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### toolbelt.enable ### toolbelt.enable
- Enables the toolbelt command - Enables the toolbelt command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### viconf.enable ### viconf.enable
- Enables the viconf command - Enables the viconf command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
## movScripts.hyprlandControls ## movScripts.hyprlandControls
### enable ### enable
- Enables my hyprland control shortcut scripts - Enables my hyprland control shortcut scripts
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### chpaper.enable ### chpaper.enable
- Enables the chpaper command - Enables the chpaper command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### scheck.enable ### scheck.enable
- Enables the scheck command - Enables the scheck command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### chscheme.enable ### chscheme.enable
- Enables the chscheme command - Enables the chscheme command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### keyring.enable ### keyring.enable
- Enables the keyring command - Enables the keyring command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### moveonscreen.enable ### moveonscreen.enable
- Enables the moveonscreen command - Enables the moveonscreen command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### switchmon.enable ### switchmon.enable
- Enables the switchmon command - Enables the switchmon command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### mkscreenshots.enable ### mkscreenshots.enable
- Enables the mkscreenshots command - Enables the mkscreenshots command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
## movScripts.nixShortcuts ## movScripts.nixShortcuts
### enable ### enable
- Enables my NixOS aliases - Enables my NixOS aliases
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### garbage-collect.enable ### garbage-collect.enable
- Enables the garbage-collect command - Enables the garbage-collect command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### nsp.enable ### nsp.enable
- Enables the nsp command - Enables the nsp command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'
### rebuild.enable ### rebuild.enable
- Enables the rebuild command - Enables the rebuild command
- Type: Boolean - Type: Boolean
- Default: true - Default: true
- Defined in 'modules/home/scripts/default.nix' - Defined in 'modules/home/scripts/default.nix'

104
docs/options/system_options.md
View File

@@ -1,79 +1,79 @@
# System Options # System Options
## networkModule.enable ## networkModule.enable
- Enables my network configuration - Enables my network configuration
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/hardware/network.nix' - Defined in 'modules/sys/hardware/network.nix'
## nixSettings.enable ## nixSettings.enable
- Enables my NixOS settings - Enables my NixOS settings
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/environment/nix.nix' - Defined in 'modules/sys/environment/nix.nix'
## bootLoader.enable ## bootLoader.enable
- Enables my bootloader settings - Enables my bootloader settings
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/hardware/bootloader.nix' - Defined in 'modules/sys/hardware/bootloader.nix'
## issue.enable ## issue.enable
- Enables my custom /etc/issue tty splash screen - Enables my custom /etc/issue tty splash screen
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/environment/issue.nix' - Defined in 'modules/sys/environment/issue.nix'
## sddmConfig.enable ## sddmConfig.enable
- Enables my catppuccin-sddm configuration - Enables my catppuccin-sddm configuration
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/environment/sddm.nix' - Defined in 'modules/sys/environment/sddm.nix'
## stylixConfig.enable ## stylixConfig.enable
- Enables stylix for system theming - Enables stylix for system theming
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/environment/stylix.nix' - Defined in 'modules/sys/environment/stylix.nix'
## gamingPkgs.enable ## gamingPkgs.enable
- Enables gaming-related packages - Enables gaming-related packages
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/software/gaming/gaming_pkgs.nix' - Defined in 'modules/sys/software/gaming/gaming_pkgs.nix'
## steamConfig.enable ## steamConfig.enable
- Enables my Steam configuration - Enables my Steam configuration
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/software/gaming/steam.nix' - Defined in 'modules/sys/software/gaming/steam.nix'
## sysPkgs.enable ## sysPkgs.enable
- Installs my default system packages - Installs my default system packages
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/software/packages.nix' - Defined in 'modules/sys/software/packages.nix'
## sysProgs.enable ## sysProgs.enable
- Enables - Enables
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/software/programs.nix' - Defined in 'modules/sys/software/programs.nix'
## sysServices.enable ## sysServices.enable
- Description - Description
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/software/services.nix' - Defined in 'modules/sys/software/services.nix'
## virtConfig.enable ## virtConfig.enable
- Description - Description
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/software/virtualization.nix' - Defined in 'modules/sys/software/virtualization.nix'
## powerProfiles.enable ## powerProfiles.enable
- Description - Description
- Type: Boolean - Type: Boolean
- Default: false - Default: false
- Defined in 'modules/sys/hardware/powerprofiles.nix' - Defined in 'modules/sys/hardware/powerprofiles.nix'

2
docs/scripts/nixshortcuts.md
View File

@@ -1,7 +1,7 @@
# pagedMov's Nix Aliases # pagedMov's Nix Aliases
## fetchfromgh ## fetchfromgh
- Given a username and repo name like someuser/somerepo, generates a full pkgs.fetchFromGitHub call. - Given a username and repo name like someuser/somerepo, generates a full pkgs.fetchFromGitHub call. Uses the most recent commit.
- Usage: - Usage:
- `fetchfromgh someuser/somerepo` - `fetchfromgh someuser/somerepo`
- Example: - Example:

47
docs/scripts/wmcontrols.md Normal file
View File

@@ -0,0 +1,47 @@
# Custom Hyprland Controls
None of these are meant to be invoked directly in the terminal and are mainly used as helpers for my other scripts. I will
still document them in case you wish to use them in your own scripts.
## chscheme
- Opens a fzf menu containing all of the color schemes contained in the base16schemes package in nixpkgs. The fzf preview contains the colors so you can see them in your terminal before you choose them.
- Usage:
- `chscheme` - Does not take arguments.
- Defined in 'modules/home/scripts/wm-controls/chscheme.nix'
## chpaper
- Opens a fzf menu containing all of the wallpapers held in $FLAKEPATH/assets/wallpapers. The fzf preview shows the image file that the user is hovering over.
- Usage:
- `chpaper` - Does not take arguments.
- Defined in 'modules/home/scripts/wm-controls/chpaper.nix'
## keyring
- Opens a fzf menu containing all of the directories/files contained in ~/.password-store. Selecting one uses `pass -c` to copy it to the clipboard. The script pauses the clipboard history daemon while it does this so that the password is not added to your clipboard history. If anyone can think of a more secure way to do this, let me know. Password is cleared from the clipboard automatically after 10 seconds if not overwritten by something else.
- Usage:
- `keyring` - Does not take arguments.
- Defined in 'modules/home/scripts/wm-controls/keyring.nix'
## mkscreenshots
- If workspace 4 is empty, switches to that workspace and takes some screenshots that showcase the desktop environment. These screenshots are then saved to $FLAKEPATH/assets/screens, overwriting the old ones. README.md is then updated to include the commit that the screenshots were taken on.
- Usage:
- `mkscreenshots` - Does not take arguments. Only runs if workspace 4 has no windows.
- Defined in 'modules/home/scripts/wm-controls/mkscreenshots.nix'
## moveonscreen
- Uses hyprctl to move the currently active window, if it is floating. The window moves relative to the cursor, and will not move past the bounds of the screen. Used by toolbelt to produce the cool window movements.
- Usage:
- `moveonscreen` - Moves the window to the cursor's position, anchored at the top-left corner. Does not leave the bounds of the screen.
- `moveonscreen --center` - Behaves the same way, except anchors at the center of the window instead of the top-left corner.
- Defined in 'modules/home/scripts/wm-controls/moveonscreen.nix'
## s_check
- A simple test invocation checking to see if $SOUNDS_ENABLED is 0 or 1. Don't ask why this doesn't work as a zsh alias, because it doesn't for some reason and I don't really know why. Does not return anything except for the status code from the test.
- Usage:
- `s_check` - Does not take arguments.
- Defined in 'modules/home/scripts/wm-controls/switchmon.nix'
## switchmon
- Uses hyprctl to switch the focused monitor to the other monitor. Currently only supports setups with two monitors.
- Usage:
- `switchmon` - Does not take arguments.
- Defined in 'modules/home/scripts/wm-controls/switchmon.nix'