diff --git a/.warp.md b/.warp.md index 778dbae..c9682bb 100644 --- a/.warp.md +++ b/.warp.md @@ -2,10 +2,10 @@ This file provides guidance to WARP (warp.dev) when working with code in this repository. -This is a minimal entrypoint for agents. - -For the full, up-to-date commands, architecture, and workflows, see: -- cheatsheets/project-guide.md - -Note: Keep cheatsheets/project-guide.md current. Make updates to this index by editing that guide. +Agent entrypoint +- Start with WARP.md (primary project rules and workflows for agents). +- For extended quick refs and workflows, see cheatsheets/project-guide.md. +Maintenance note +- Keep both WARP.md and cheatsheets/project-guide.md current. +- Prefer updating WARP.md for canonical rules; use the project guide for quick commands. diff --git a/CHANGELOG.md b/CHANGELOG.md index 9ec7a97..269eda2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,15 +5,619 @@ --- -# 🚀 **Current Release - ZaneyOS v2.4** +# 🚀 **Current Release - ZaneyOS v2.6.1** + +- Removed `discord` and `discord-canary` + - They use an outdated `electron` + - That build uses and `openssl v1.1.1w` + - That ius OEL and marked insecure in NIXOS + - Users can use an alternativve client until discord is updated +- Disabled `zen browser` in `zaneyos/modules/home/default.nix` + - Needs to be migrated to being enabled via host variable +- Changed from `zen` to `latest` kernel + - Linux kernel v7.0 is much better than 6.19_zen +- Disabled `vfr = true;` in hyprland config + - It's not supportorted after `v54.3` + - Disabling now to avoid error on next update +- Added `awww` as flake input for installs < 25.11 +- Fixed eval warnings: + - `gtk.gtk4.theme` set to `null` + - `git.signing.format` set to `null` +- `nixvim` lualine theme set to `auto` +- Changed to NixOS unstable branch +- Ported `DropTerminal` from `KoolDots` to ZaneyOS + - Replaces pyprland and some python dependencies +- Hyprland updated to v0.54 + - Added support for scrolling and monocle layouts + - Fixed hyprland float-all bindings + - Updated Window Rules for new Hyprland format +- Disabled steam by default +- Removed `adb.enable` no longer supported and not needed for ZaneyOS +- Changed `nixfmt-rfc-style` package for updated `nitfmt` + - `nixfmt-rfc-style` no longer supported +- Fixed other evaluation warnings with `Xorg` package changes + +# 🚀 **Current Release - ZaneyOS v2.6.0** + +#### 📅 **Updated: April 3rd, 2026** + +- Swapped `awww` for `swww` + - `swww` is no longer maintained + - removed `--format xrgb` flag also no needed + +#### 📅 **Updated: February 19th, 2026** + +- Fixed `zcli` GPU detection for newer AMD GPUs + - Fixed the fix to properly detect VMs +- `nixvim.nix` changes + - Disabled Zig language server + - Disabled marksman language server + - Caused dotnet lib to be compiled (takes hours) + +#### 📅 **Updated: February 16th, 2026** + +- Removed `hyprpanel` + - No longer maintained + - Vendor created `wayle` to replace it + - Replaced in ZaneyOS with 'noctalia-shell' + +- `webkitgtk` being built from source + - Removed audacity is called `wxwidgets` + - Created overlay for `tumbler` to disable `libepub` + - These caused the build from source issue + - Building `webkitgtk` takes hours every rebuild/update + +#### 📅 **Updated: January 31st, 2026** + +- Changed default login manager to `TUI` + - Issues recently (again) with SDDM and some GPUs + - Often related to SDDM wayland support option + - Some GPUs need it enabled, others disabled + +#### 📅 **Updated: January 28th, 2026** + +- Disabled gnome in stylix. Caused install failure + +#### 📅 **Updated: January 26th, 2026** + +- `noctalia-shell` regression: + - Removed `noctalia-shell` systemd service + - Caused old version of `noctalia-shell` + - Adjusted `noctalia-shell` bindings to match change +- Default applications now settable + - Globally for all hosts + - `zaneyos/modules/home/xdg.nix` + - Per host + - `zaneyos/hosts/HOSTNAME/variables.nix` + - Host settings override `xdg.nix` settings + +#### 📅 **Updated: January 23rd, 2026** + +- Added additional fonts +- Fixed issue with Hypridle and Home Manager + - Added `systemdTarget = "hyprland-session.target";` + - Thank you `Yang Kexuan` for the fix + - Reference issue: [5899](https://github.com/nix-community/home-manager/issues/5899) + +#### 📅 **Updated: January 5th, 2026** + +- Removed extra newline in `exec-once.nix` +- Fixed typo in `noctalia.nix` +- Added docs reference per systemd spec +- Improved code overall + - Thanks `lichen.gel.calm` for finding these issues +- Disabled `noctalia-shell` systemd service + - Caused older revision of `noctalia-shell` to load + - Now started from hyprland + +#### 📅 **Updated: December 29th, 2025** + +- Removed extra `noctalia-shell` startup +- Added initial support for AMD, NVIDIA Hybrid laptops +- Keypress to recover from DPMS now enabled by default + +#### 📅 **Updated: December 21st, 2025** + +- Added user systemd service for `noctalia-shell` +- Updated Hyprland bindings to accomodate change +- Updated `nixvim` + +## `nixvim` Features Migrated from Bugsvim + +#### Custom Diagnostic Icons + + ```lua + Error = " " + Warn = " " + Hint = "" + Info = "" + ``` + - Custom unicode symbols for each diagnostic severity level + - Integrated into vim.diagnostic.config() for gutter display + +#### Diagnostic Display Options + + - **Sign Column**: Shows diagnostic icons in the gutter with custom text and highlight groups + - **Virtual Text**: Inline diagnostics with custom prefix (`●`) and 2-space spacing + - **Virtual Lines**: Enhanced visibility for error context without cluttering + - **Underline**: Visual underline for error locations + - **Floating Window**: Hover diagnostics with rounded borders and source attribution + - **Severity Sorting**: Errors prioritized over warnings + +### 2. Text Yank Highlighting + + **Migration**: Highlight yanked text for 200ms (IncSearch highlight group) + - Autocmd-based implementation in extraConfigLua + - Uses vim.hl.on_yank for smooth visual feedback + +### 3. LSP Attachment Keybindings + + **Enhanced LSP Integration** with on-attach callbacks: + ``` + K - Hover documentation + gd - Goto definition + gD - Goto declaration + gi - Goto implementation + gr - References + rn - Rename symbol + ca - Code action + ``` + - Buffer-local scope prevents global pollution + - Guard against multiple registrations with flag check + +### 4. Startup Dashboard + + **Migration**: alpha-nvim with custom banner generation + +#### Dynamic Header Generation + + - Primary: `toilet -f ansi-shadow NIXOS` + - Secondary: `figlet -f "ANSI Shadow" NIXOS` + - Tertiary: `figlet NIXOS` + - Fallback: ASCII art banner (9 lines) + +#### Dashboard Buttons + + | Shortcut | Action | Command | + |----------|--------|---------| + | `f` | Find file | Telescope find_files | + | `r` | Recent files | Telescope oldfiles | + | `g` | Live grep | Telescope live_grep | + | `n` | New file | :enew | + | `e` | File browser | Neotree toggle | + | `q` | Quit | :qa | + +#### Footer + + Dynamic version display: `NixVim • Neovim X.Y.Z` + +### 5. Theme Integration + + **Migration**: Tokyo Night colorscheme with Stylix integration + - Tokyo Night colors for status line (lualine) + - Notify background color tied to Stylix palette: `#${config.lib.stylix.colors.base01}` + - Consistent color management across UI components + +## Comprehensive Feature Set + +### UI/Visuals Migrated + + - Lualine status line (Tokyo Night theme) + - Bufferline for buffer management + - Indent-blankline for visual indentation + - Colorizer for inline color display + - Illuminate for reference highlighting + - Which-key for keybinding discovery (Helix preset) + +### Core Editing + + - Treesitter for syntax highlighting + - Neo-tree file browser + - Telescope fuzzy finder with media_files extension + - Project.nvim for project management + - Hop/Leap motion plugins + - vim-surround for text manipulation + - Comment.nvim for toggle comments + +### Advanced Features + + - snacks.nvim ecosystem (terminal, scratch buffers, zen mode, git integration, notifier) + - Noice for enhanced UI/messages + - Notify for notifications + - todo-comments for task navigation + - nvim-autopairs with Treesitter support + +### Language Support + + **LSP Servers**: nil_ls, lua_ls, pyright, ts_ls, html, cssls, clangd, zls, marksman, hyprls, tailwindcss, bashls + + **Formatters**: + - Nix: alejandra + - Lua: stylua + - JavaScript/TypeScript: prettierd + - Shell: shfmt + + **Completion**: blink-cmp with luasnip snippets + +### Development Tools + + - Git integration: gitsigns + diffview + - Markdown preview + - Trouble diagnostics panel + - Terminal: toggleterm with float direction + +## Implementation Details + +### Module Structure + + - **File**: `modules/home/editors/nixvim.nix` (743 lines) + - **Framework**: Nixvim home-manager module + - **Theme**: Tokyo Night (primary), Catppuccin (fallback) + - **Runtime Tools**: 23+ packages (bat, chafa, fd, figlet, lazygit, prettierd, ripgrep, etc.) + +## Keybinding Highlights + + ``` + jk - Exit insert mode + ff - Find files + fm - Find media files + lg - Live grep + fe - File explorer toggle + t - Toggle terminal + . - Toggle comment (line/visual) + z - Zen mode + Z - Zoom + gg - Lazygit + - Terminal (via snacks) + ]t / [t - Next/prev TODO comment + n - Notification history + ``` + +#### 📅 **Updated: December 21st, 2025** + +- Added user systemd service for `noctalia-shell` +- Updated Hyprland bindings to accomodate change +- Updated `nixvim` + +## `nixvim` Features Migrated from Bugsvim + +#### Custom Diagnostic Icons + + ```lua + Error = " " + Warn = " " + Hint = "" + Info = "" + ``` + - Custom unicode symbols for each diagnostic severity level + - Integrated into vim.diagnostic.config() for gutter display + +#### Diagnostic Display Options + + - **Sign Column**: Shows diagnostic icons in the gutter with custom text and highlight groups + - **Virtual Text**: Inline diagnostics with custom prefix (`●`) and 2-space spacing + - **Virtual Lines**: Enhanced visibility for error context without cluttering + - **Underline**: Visual underline for error locations + - **Floating Window**: Hover diagnostics with rounded borders and source attribution + - **Severity Sorting**: Errors prioritized over warnings + +### 2. Text Yank Highlighting + + **Migration**: Highlight yanked text for 200ms (IncSearch highlight group) + - Autocmd-based implementation in extraConfigLua + - Uses vim.hl.on_yank for smooth visual feedback + +### 3. LSP Attachment Keybindings + + **Enhanced LSP Integration** with on-attach callbacks: + ``` + K - Hover documentation + gd - Goto definition + gD - Goto declaration + gi - Goto implementation + gr - References + rn - Rename symbol + ca - Code action + ``` + - Buffer-local scope prevents global pollution + - Guard against multiple registrations with flag check + +### 4. Startup Dashboard + + **Migration**: alpha-nvim with custom banner generation + +#### Dynamic Header Generation + + - Primary: `toilet -f ansi-shadow NIXOS` + - Secondary: `figlet -f "ANSI Shadow" NIXOS` + - Tertiary: `figlet NIXOS` + - Fallback: ASCII art banner (9 lines) + +#### Dashboard Buttons + + | Shortcut | Action | Command | + |----------|--------|---------| + | `f` | Find file | Telescope find_files | + | `r` | Recent files | Telescope oldfiles | + | `g` | Live grep | Telescope live_grep | + | `n` | New file | :enew | + | `e` | File browser | Neotree toggle | + | `q` | Quit | :qa | + +#### Footer + + Dynamic version display: `NixVim • Neovim X.Y.Z` + +### 5. Theme Integration + + **Migration**: Tokyo Night colorscheme with Stylix integration + - Tokyo Night colors for status line (lualine) + - Notify background color tied to Stylix palette: `#${config.lib.stylix.colors.base01}` + - Consistent color management across UI components + +## Comprehensive Feature Set + +### UI/Visuals Migrated + + - Lualine status line (Tokyo Night theme) + - Bufferline for buffer management + - Indent-blankline for visual indentation + - Colorizer for inline color display + - Illuminate for reference highlighting + - Which-key for keybinding discovery (Helix preset) + +### Core Editing + + - Treesitter for syntax highlighting + - Neo-tree file browser + - Telescope fuzzy finder with media_files extension + - Project.nvim for project management + - Hop/Leap motion plugins + - vim-surround for text manipulation + - Comment.nvim for toggle comments + +### Advanced Features + + - snacks.nvim ecosystem (terminal, scratch buffers, zen mode, git integration, notifier) + - Noice for enhanced UI/messages + - Notify for notifications + - todo-comments for task navigation + - nvim-autopairs with Treesitter support + +### Language Support + + **LSP Servers**: nil_ls, lua_ls, pyright, ts_ls, html, cssls, clangd, zls, marksman, hyprls, tailwindcss, bashls + + **Formatters**: + - Nix: alejandra + - Lua: stylua + - JavaScript/TypeScript: prettierd + - Shell: shfmt + + **Completion**: blink-cmp with luasnip snippets + +### Development Tools + + - Git integration: gitsigns + diffview + - Markdown preview + - Trouble diagnostics panel + - Terminal: toggleterm with float direction + +## Implementation Details + +### Module Structure + + - **File**: `modules/home/editors/nixvim.nix` (743 lines) + - **Framework**: Nixvim home-manager module + - **Theme**: Tokyo Night (primary), Catppuccin (fallback) + - **Runtime Tools**: 23+ packages (bat, chafa, fd, figlet, lazygit, prettierd, ripgrep, etc.) + +## Keybinding Highlights + + ``` + jk - Exit insert mode + ff - Find files + fm - Find media files + lg - Live grep + fe - File explorer toggle + t - Toggle terminal + . - Toggle comment (line/visual) + z - Zen mode + Z - Zoom + gg - Lazygit + - Terminal (via snacks) + ]t / [t - Next/prev TODO comment + n - Notification history + ``` + +#### 📅 **Updated: December 21st, 2025** + +- Updated: + - `nixvim.nix` now uses `blink-cmp` for completion/suggestions + - This replaces `nvim-cmp` + - `blink-cmp` is better, integrated in nixvim + - Removed LUA code related to `nvim-cmp` + +- Fixed: + - Output of `zcli list-gens` corrected + - Thanks `@codingismy11to71` + +#### 📅 **Updated: December 14th, 2025** + +- Fixed: +- hyprlock background image +- `--diff-always` to `nh` rebuilds +- Removed extra `Ghz` in `fastfetch` output +- Fixed hard coded directory for cheatsheets path +- Removed hard coded title +- Focus follows mouse + - Consistent with hyprland +- Turned off resize overlay +- Added curosr wrap shader + - Thanks to Steven Scott for the fixes + +#### 📅 **Updated: December 12th, 2025** + +- Fixed: + - `Weather.py` script + - Start menu in waybars +- Ported from ddubsos: + - `kitty-bg` and `ghostty-bg` + - Adds random backgrounds to terminals + - Custom Quickshell logout menu + - Custom startmenu + - Custom logout menu + - Quickshell wallpaper apps + - One for images, one for video wallpapers + - `ly` login manager + - `nwg-dock-hyprland.nix` + - `SUPERCTRL+D` to toggle +- Added: + - More wallpapers + - Video wallpapers + +#### 📅 **Updated: December 9th, 2025** + +- Notifcation history binding had wrong keyword + - Thanks to Kexuan Yang for fixing it + +#### 📅 **Updated: December 7th, 2025** + +- Added `alejandra` formatter to `flake.nix` + - ran `nix fmt ./` and updated all files to current format spec +- Added `alejandra` as default formatter in `nixvim.nix` +- Hybrid GPU detection fails in `install-zaneyos.sh` + - Should be `nvidia-laptop` not `hybrid` + - Thanks to sasek @sasek333 for spotting this + +#### 📅 **Updated: December 6th, 2025** + +- Changed: + - Quickshell now comes fromm NixPkgs. + - No more compiling on rebuilds + - Remove Flake input and input in `quickshell.nix` + +#### 📅 **Updated: December 3rd, 2025** + +- Added: + - Cheatsheets from ddubsOS + - Covers, terminals, emacs, etc + - In English and Spanish + - Zen browser + - Via Flake, for current builds + - Nano customized config +- Pinned: `nixvim` to v25.11 branch +- Added: Support for `kb_variants` at install time. + - Keyboards, like `dvorak`, `coleman,` or `euro` + - Configures, console, SDDM and Hyprland +- Fixed: TUI greetd service name changed to `services.greetd` +- Updated: + - `cachix settings updated for better speed + - Moved to its own `cacheix.nix` file + +#### 📅 **Updated: December 1st, 2025** + +- Added: System keybinds search tool from ddubsOS + - Shows bindings for: + - Hyprland, kitty, wezterm, ghostty, emacs and yazi + - SUPER + K to invoke + - SUPER + SHIFT + K for legacy keybind rofi menu +- Fixed: Added power profiles daemon for noctalia +- Fixed: `gpu-screen-recorder` not installed + - Thanks to `@mugdad11` for finding them +- Fixed: Both rofi and noctalia clipboard + - Both were active on `SUPER + V` + - Now checks for waybar or noctalia shell + - Thanks to `@mugdad11` for finding it +- Fixed: Laptop battery not showing in noctalia shell + - Thanks again `@mugdad11` for finding issue + - And doing the Merge Request to fix it + - `upower` package not installed and `upower` service not enabled + +- NEW: Added `quickshell-overview` integration + - Workspace overview with live window previews + - Toggled via `SUPER + TAB` keybind + - Drag-and-drop workspace navigation + - Uses IPC for seamless integration with Hyprland + - QML code managed via Home Manager activation script +- FIXED: Username wasn't reliably being set in `flake.nix` +- Set ZaneyOS to NixOS v25.11 stable branch +- Moved to `nixvim` for NeoVIM configuration + - Works better + - Fewer issues vs. `nvf.nix` + - `nvf.nix` still included, but commented out +- Added `alacritty.nix` from ddubsOS +- Added `tmux.nix` from ddubosOS (courtesy of Tony,btw) +- Added `vscode.nix` from ddubsOS. + - Pre-configured with many useful plugins + - Also works as template to add more +- Added `antigravity` IDE from Google based on vscodium +- Created `modules/core/overlays.nix` + - Currently only has `antigravity` but more maybe be needed later +- Fixed gestures errors from Hyprland Upgrade +- Added Noctalia Shell as default +- Added Additional waybars from dddubsOS +- Added Addtional Animations from ddubsOS +- Switched to `bindd` for friendlier keybinds descriptions +- Updated keybind parser to use these descriptions +- Keybinds are now conditional on waybar or noctalia shell +- Updated `README.md` and `README.es.md` + - New screenshots + - Updated Keybindings + - Moved screenshots into a markdown suummary to reduce clutter +- Added script to fix `doom iedit` update error +- Moved some modules/home/\*.nix files to their own subdir + - Terminals + - Alacritty + - ghostty + - Kitty + - tmux + - Wezterm + - Editors + - antigravity + - emacs + - evil-helix + - nixvim + - nvf + - vscode + - CLI/Utils + - bat + - Btop + - Bottom + - cava + - fzf + - git + - gh + - lazygit + + Contributors: `@mugdad11` + +#### 📅 **Updated: September 18th, 2025** + +- 🧪 EXPERIMENTAL: AMD+NVIDIA hybrid support (amd-hybrid) + - New driver module: `modules/drivers/nvidia-amd-hybrid.nix` (options: + `enable`, `amdgpuBusID`, `nvidiaBusID`) + - Kernel pin: `boot.kernelPackages` forced to `linuxPackages_6_12` when + enabled (required for RTX 50xx open kernel module) + - New profile: `profiles/amd-hybrid/default.nix` (wires `amdgpuID`/`nvidiaID` + from `hosts//variables.nix`) + - zcli detection updated to recognize `amd-hybrid`; `install-zaneyos.sh` + prompts include `amd-hybrid` + - Added `amdgpuID` to `hosts/*/variables.nix` + - Docs updated (`README`, `WARP.md`, cheatsheets) + - Caution: Can't fully test at this time. Please verify your Bus IDs via + `lspci` and use `zcli rebuild-boot` for safer activation #### 📅 **Updated: September 9th, 2025** - 🛡️ Installer: Added defensive hostname validation and sanitization - - Prevents invalid hostnames (e.g., with dots) from causing Nix evaluation errors - - Auto-sanitizes to a compliant hostname (letters/digits with '-' or '_', 1–63 chars) and prompts for confirmation + - Prevents invalid hostnames (e.g., with dots) from causing Nix evaluation + errors + - Auto-sanitizes to a compliant hostname (letters/digits with '-' or '\_', 1–63 + chars) and prompts for confirmation - Explicitly rejects 'default' to avoid template overwrites -- 🧩 Nix: Added assertion in modules/core/network.nix for clearer errors if an invalid hostname is provided +- 🧩 Nix: Added assertion in modules/core/network.nix for clearer errors if an + invalid hostname is provided #### 📅 **Updated: August 30th, 2025** @@ -223,6 +827,7 @@ - 📊 Added info on `zcli` utility - ⬆️ Updated `zcli` now uses `nh` util to select # of generations to keep - ➕ Added `zcli` CLI util. runs rebuild, update, garbage collection and diags + ```text ❯ zcli diff --git a/FAQ.es.md b/FAQ.es.md index f8fed2f..5a08953 100644 --- a/FAQ.es.md +++ b/FAQ.es.md @@ -1,15 +1,8 @@ [English](FAQ.md) | [Español](FAQ.es.md) -# 💬 Preguntas frecuentes de ZaneyOS para v2.4 +# 💬 Preguntas frecuentes de ZaneyOS -- **Revisión v1.26** -- **Fecha:** 1-septiembre-2025 - -> IMPORTANTE: ¿Actualizando de v2.3 a v2.4? -> - Altamente recomendado: Lee `ZaneyOS-Upgrade.md` completamente antes de intentar la actualización. -> - Explica la actualización automatizada, respaldo completo, migración de host y proceso de reversión. -> - NO uses los alias `fu` o `fr` para esta actualización. -> - Si has hecho modificaciones extensas, no ejecutes el script—revisa los documentos y migra manualmente. +- **Fecha:** 14 de deciembre de 2025 **⌨ ¿Dónde puedo ver los atajos de teclado de Hyprland?** @@ -20,43 +13,76 @@ **✨🖥️ ZCLI: ¿Qué es y cómo lo uso?**
-La utilidad `zcli` es una herramienta de línea de comandos diseñada para simplificar la gestión de tu entorno `zaneyos`. Proporciona un conjunto completo de comandos para realizar tareas comunes como actualizar tu sistema, gestionar hosts, limpiar generaciones antiguas y gestionar Doom Emacs. +La utilidad `zcli` es una herramienta de línea de comandos diseñada para +simplificar la gestión de tu entorno `zaneyos`. Proporciona un conjunto completo +de comandos para realizar tareas comunes como actualizar tu sistema, gestionar +hosts, limpiar generaciones antiguas y gestionar Doom Emacs. -Para usarlo, abre una terminal y escribe `zcli` seguido de uno de los comandos listados a continuación: +Para usarlo, abre una terminal y escribe `zcli` seguido de uno de los comandos +listados a continuación: ## Comandos del Sistema Core: -- `cleanup`: Limpia generaciones antiguas del sistema. Puedes especificar el número de generaciones a mantener. Incluye limpieza automatizada de logs de compilaciones antiguas. -- `diag`: Crea un reporte de diagnóstico completo del sistema usando `inxi --full`, guardado en `~/diag.txt`. Perfecto para solucionar problemas. -- `list-gens`: Lista tanto generaciones de usuario como de sistema con información detallada. -- `rebuild`: Recompila la configuración del sistema NixOS con verificaciones de seguridad mejoradas y manejo de archivos de respaldo. -- `rebuild-boot`: Recompila y establece como boot por defecto (se activa en el próximo reinicio). Más seguro para cambios importantes del sistema y actualizaciones del kernel. -- `trim`: Recorta sistemas de archivos para mejorar el rendimiento del SSD con prompts de confirmación del usuario. -- `update`: Actualiza el flake y recompila el sistema con manejo de errores completo. -- `update-host`: Establece automáticamente el host y perfil en `flake.nix`. Características detección inteligente de GPU y validación de hostname. -- `add-host`: Crea configuraciones de host nuevas con detección automática de GPU, generación de hardware.nix y integración con git. -- `del-host`: Elimina configuraciones de host de forma segura con prompts de confirmación para prevenir eliminación accidental. -**Uso:** `zcli add-host [hostname] [profile]` +- `cleanup`: Limpia generaciones antiguas del sistema. Puedes especificar el + número de generaciones a mantener. Incluye limpieza automatizada de logs de + compilaciones antiguas. +- `diag`: Crea un reporte de diagnóstico completo del sistema usando + `inxi --full`, guardado en `~/diag.txt`. Perfecto para solucionar problemas. +- `list-gens`: Lista tanto generaciones de usuario como de sistema con + información detallada. +- `rebuild`: Recompila la configuración del sistema NixOS con verificaciones de + seguridad mejoradas y manejo de archivos de respaldo. +- `rebuild-boot`: Recompila y establece como boot por defecto (se activa en el + próximo reinicio). Más seguro para cambios importantes del sistema y + actualizaciones del kernel. +- `trim`: Recorta sistemas de archivos para mejorar el rendimiento del SSD con + prompts de confirmación del usuario. +- `update`: Actualiza el flake y recompila el sistema con manejo de errores + completo. +- `update-host`: Establece automáticamente el host y perfil en `flake.nix`. + Características detección inteligente de GPU y validación de hostname. +- `add-host`: Crea configuraciones de host nuevas con detección automática de + GPU, generación de hardware.nix y integración con git. +- `del-host`: Elimina configuraciones de host de forma segura con prompts de + confirmación para prevenir eliminación accidental. + +**Uso:** `zcli add-host [hostname] [profile]`\ **Perfiles de GPU:** `amd`, `intel`, `nvidia`, `nvidia-hybrid`, y `vm` ## Opciones Avanzadas de Compilación: -Los comandos `rebuild`, `rebuild-boot` y `update` soportan opciones mejoradas para control granular: -- `--dry, -n`: Modo preview - muestra qué se haría sin ejecutar (dry run) -- `--ask, -a`: Prompts de confirmación interactiva para operaciones críticas de seguridad -- `--cores N`: Limita operaciones de compilación a N núcleos de CPU (esencial para VMs y sistemas con recursos limitados) -- `--verbose, -v`: Habilita logs detallados de operación y salida verbose para troubleshooting -- `--no-nom`: Deshabilita nix-output-monitor para salida tradicional de línea de comandos -**Múltiples opciones pueden combinarse** para control preciso sobre tu proceso de compilación. +Los comandos `rebuild`, `rebuild-boot` y `update` soportan opciones mejoradas +para control granular: + +- `--dry, -n`: Modo preview - muestra qué se haría sin ejecutar (dry run) +- `--ask, -a`: Prompts de confirmación interactiva para operaciones críticas de + seguridad +- `--cores N`: Limita operaciones de compilación a N núcleos de CPU (esencial + para VMs y sistemas con recursos limitados) +- `--verbose, -v`: Habilita logs detallados de operación y salida verbose para + troubleshooting +- `--no-nom`: Deshabilita nix-output-monitor para salida tradicional de línea de + comandos + +**Múltiples opciones pueden combinarse** para control preciso sobre tu proceso +de compilación. ## Gestión de Doom Emacs: -Gestión completa del ciclo de vida de Doom Emacs con características de seguridad: -- `doom install`: Instalación automatizada de Doom Emacs usando el script get-doom con todos los paquetes requeridos -- `doom status`: Verifica el estado de instalación y muestra información de versión para verificación -- `doom remove`: Remueve la instalación de Doom Emacs de forma segura con prompts de confirmación para prevenir eliminación accidental -- `doom update`: Actualiza paquetes de Doom Emacs y configuración vía `doom sync` -**Características:** Verificaciones de seguridad integradas, manejo de errores completo y gestión automática de dependencias. +Gestión completa del ciclo de vida de Doom Emacs con características de +seguridad: + +- `doom install`: Instalación automatizada de Doom Emacs usando el script + get-doom con todos los paquetes requeridos +- `doom status`: Verifica el estado de instalación y muestra información de + versión para verificación +- `doom remove`: Remueve la instalación de Doom Emacs de forma segura con + prompts de confirmación para prevenir eliminación accidental +- `doom update`: Actualiza paquetes de Doom Emacs y configuración vía + `doom sync` + +**Características:** Verificaciones de seguridad integradas, manejo de errores +completo y gestión automática de dependencias. ```text ❯ zcli @@ -94,6 +120,7 @@ Doom Emacs: ``` **Ejemplos:** + ```bash # Gestión del sistema zcli rebuild --dry # Muestra qué se recompilaría @@ -112,15 +139,45 @@ zcli doom status # Verifica estado de instalación
+
+**¿Cómo configuro aplicaciones predeterminadas (PDF, navegador) por host?** + +- Edita `~/zaneyos/hosts//variables.nix` y descomenta `mimeDefaultApps`. +- Home Manager usará esto vía `modules/home/xdg.nix` para escribir tu `~/.config/mimeapps.list`. +- Usa IDs `.desktop` reales de `/usr/share/applications` o `~/.local/share/applications`. + +```nix +# hosts//variables.nix +# Aplicaciones predeterminadas a nivel de host (consumidas por xdg.mimeApps) +# mimeDefaultApps = { +# # PDFs +# "application/pdf" = ["okular.desktop"]; +# "application/x-pdf" = ["okular.desktop"]; +# # Navegador web +# "x-scheme-handler/http" = ["google-chrome.desktop"]; # o brave-browser.desktop, firefox.desktop +# "x-scheme-handler/https" = ["google-chrome.desktop"]; +# "text/html" = ["google-chrome.desktop"]; +# # Archivos +# "inode/directory" = ["thunar.desktop"]; # gestor de archivos +# "text/plain" = ["nvim.desktop"]; # o code.desktop +# }; +``` + +
+ ## Atajos Principales de Hyprland -A continuación se muestran los atajos de teclado para Hyprland, formateados para fácil referencia. +A continuación se muestran los atajos de teclado para Hyprland, formateados para +fácil referencia. ## Lanzamiento de Aplicaciones - `$modifier + Return` → Lanzar `Terminal` +- `$modifier + Tab` → Alternar `Quickshell Overview` (visor de espacios con + vistas en vivo) - `$modifier + K` → Lista atajos -- `$modifier + Shift + Return` → Lanzar `rofi-launcher` +- `$modifier + D` → Lanzar `launcher` +- `$modifier + Shift + Return` → Lanzar `launcher` - `$modifier + Shift + W` → Abrir `web-search` - `$modifier + Alt + W` → Abrir `wallsetter` - `$modifier + Shift + N` → Ejecutar `swaync-client -rs` @@ -128,7 +185,7 @@ A continuación se muestran los atajos de teclado para Hyprland, formateados par - `$modifier + Y` → Abrir `kitty` con `yazi` - `$modifier + E` → Abrir `emopicker9000` - `$modifier + S` → Tomar captura de pantalla -- `$modifier + D` → Abrir `Discord` +- `$modifier + Shift + D` → Abrir `Discord` - `$modifier + O` → Lanzar `OBS Studio` - `$modifier + C` → Ejecutar `hyprpicker -a` - `$modifier + G` → Abrir `GIMP` @@ -148,10 +205,14 @@ A continuación se muestran los atajos de teclado para Hyprland, formateados par ## Movimiento de Ventanas -- `$modifier + Shift + ← / → / ↑ / ↓` → Mover ventana izquierda/derecha/arriba/abajo -- `$modifier + Shift + H / L / K / J` → Mover ventana izquierda/derecha/arriba/abajo -- `$modifier + Alt + ← / → / ↑ / ↓` → Intercambiar ventana izquierda/derecha/arriba/abajo -- `$modifier + Alt + 43 / 46 / 45 / 44` → Intercambiar ventana izquierda/derecha/arriba/abajo +- `$modifier + Shift + ← / → / ↑ / ↓` → Mover ventana + izquierda/derecha/arriba/abajo +- `$modifier + Shift + H / L / K / J` → Mover ventana + izquierda/derecha/arriba/abajo +- `$modifier + Alt + ← / → / ↑ / ↓` → Intercambiar ventana + izquierda/derecha/arriba/abajo +- `$modifier + Alt + 43 / 46 / 45 / 44` → Intercambiar ventana + izquierda/derecha/arriba/abajo ## Movimiento de Foco @@ -186,11 +247,14 @@ A continuación se muestran los atajos de teclado para Hyprland, formateados par - El nombre `ZaneyOS` es un chiste interno entre amigos. - La intención es que esta configuración pueda usarse como daily driver - Desarrollar software, jugar juegos vía steam, etc. -- Mi esperanza es que sea útil, y lo modifiques para que se ajuste a tus necesidades. +- Mi esperanza es que sea útil, y lo modifiques para que se ajuste a tus + necesidades. - Ese es el punto clave. Hazlo tuyo. - Crea un fork de ZaneyOS, luego modifícalo. -- Si encuentras un issue y lo arreglas, o proporcionas una nueva característica, por favor compártelo. -- ZaneyOS no es una distro. En este momento no hay planes para crear un ISO de instalación. +- Si encuentras un issue y lo arreglas, o proporcionas una nueva característica, + por favor compártelo. +- ZaneyOS no es una distro. En este momento no hay planes para crear un ISO de + instalación. @@ -273,7 +337,8 @@ A continuación se muestran los atajos de teclado para Hyprland, formateados par - Remueve la línea con el paquete que quieres remover o coméntala - Guarda el archivo y haz un rebuild con el alias `fr` -- Después puedes ejecutar `flatpak list` para verificar que los paquetes(s) estén removidos +- Después puedes ejecutar `flatpak list` para verificar que los paquetes(s) + estén removidos - Nota: Las dependencias base para flatpaks permanecen una vez instaladas. @@ -310,9 +375,13 @@ waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix;
**¿Cómo cambio la configuración del monitor? ** -La configuración del monitor está en el archivo: `~/zaneyos/hosts//variables.nix` +La configuración del monitor está en el archivo: +`~/zaneyos/hosts//variables.nix` -Dentro de las comillas la sintaxis es "monitor=adaptador de video,resolución@refresh rate, auto,escala" El monitor debe estar en minúsculas. Si no estás seguro de tus dispositivos de video ejecuta `hyprctl monitors` en una CLI de terminal. La salida se verá similar a esto: +Dentro de las comillas la sintaxis es "monitor=adaptador de +video,resolución@refresh rate, auto,escala" El monitor debe estar en minúsculas. +Si no estás seguro de tus dispositivos de video ejecuta `hyprctl monitors` en +una CLI de terminal. La salida se verá similar a esto: ```text hyprctl monitors @@ -344,15 +413,21 @@ Edita la línea `extraMonitorSettings`. **Ejemplos:** - Monitor Único: `extraMonitorSettings = "monitor=eDP-1,1920x1080@60,auto,1";` - Monitores Múltiples: `extraMonitorSettings = " - monitor=eDP-1,1920x1080@60,auto,auto - monitor=HDMI-A-1,2560x1440@75,auto,auto - ";` + monitor=eDP-1,1920x1080@60,auto,auto + monitor=HDMI-A-1,2560x1440@75,auto,auto + ";` -- Para configuraciones multi-monitor más complejas, puedes usar la aplicación GUI, `nwg-displays` Esta mostrará tus monitores conectados actualmente permitiéndote usar el mouse para coincidir cómo están arreglados físicamente. Ej. qué monitor está a la izquierda, derecha, arriba o abajo. Es muy similar a la herramienta X11 basada, `arandr` Creará entonces un archivo de configuración compatible con Hyprland en `~/.config/hypr/monitors.conf` +- Para configuraciones multi-monitor más complejas, puedes usar la aplicación + GUI, `nwg-displays` Esta mostrará tus monitores conectados actualmente + permitiéndote usar el mouse para coincidir cómo están arreglados físicamente. + Ej. qué monitor está a la izquierda, derecha, arriba o abajo. Es muy similar a + la herramienta X11 basada, `arandr` Creará entonces un archivo de + configuración compatible con Hyprland en `~/.config/hypr/monitors.conf` -Después de configurar los monitores como deseas, presiona `Apply` para guardar los cambios en `~/.config/hypr/monitors.conf`\ +Después de configurar los monitores como deseas, presiona `Apply` para guardar +los cambios en `~/.config/hypr/monitors.conf`\ El contenido se verá algo como esto: ```text @@ -361,11 +436,14 @@ monitor=HDMI-A-1,1920x1080@74.97,2136x268,1.0 monitor=eDP-1,1920x1080@144.0,216x268,1.0 ``` -Solo necesitas copiar las líneas `monitor=` y pegarlas en el archivo `variables.nix` como se describe en el proceso arriba. +Solo necesitas copiar las líneas `monitor=` y pegarlas en el archivo +`variables.nix` como se describe en el proceso arriba. -Una vez hecho eso. Ejecuta el comando alias `fr` para construir una nueva generación para hacer efectivos los cambios. +Una vez hecho eso. Ejecuta el comando alias `fr` para construir una nueva +generación para hacer efectivos los cambios. -Más información sobre configurar monitores está disponible en el [Wiki de Hyprland](https://wiki.hyprland.org/Configuring/Monitors/) +Más información sobre configurar monitores está disponible en el +[Wiki de Hyprland](https://wiki.hyprland.org/Configuring/Monitors/)
@@ -374,13 +452,15 @@ Más información sobre configurar monitores está disponible en el [Wiki de Hyp ### Hay dos opciones. Una para todos los hosts que tienes, otra para un host específico. -1. Para aplicaciones que se incluirán en todos los hosts definidos edita el archivo `~/zaneyos/modules/core/packages.nix` file. +1. Para aplicaciones que se incluirán en todos los hosts definidos edita el + archivo `~/zaneyos/modules/core/packages.nix` file. Hay una sección que comienza con: `environment.systemPackages = with pkgs;` Seguida de una lista de paquetes. Estos son requeridos para ZaneyOS. -Te sugerimos agregar un comentario al final de los nombres de paquetes. Luego agrega tus paquetes. +Te sugerimos agregar un comentario al final de los nombres de paquetes. Luego +agrega tus paquetes. ```text ... @@ -427,7 +507,8 @@ La parte del archivo que necesitas editar se ve como esto: } ``` -Puedes agregar paquetes adicionales, o por ejemplo cambiar `discord` a `discord-canary` para obtener la versión beta de Discord pero solo en este host. +Puedes agregar paquetes adicionales, o por ejemplo cambiar `discord` a +`discord-canary` para obtener la versión beta de Discord pero solo en este host. @@ -438,7 +519,8 @@ Puedes agregar paquetes adicionales, o por ejemplo cambiar `discord` a `discord- - Usa la utilidad `zcli`. `zcli rebuild` - El alias legacy `fr`, Flake Rebuild está depreciado pero aún disponible -Si el rebuild se completa exitosamente, se creará una nueva generación con tus paquetes agregados. +Si el rebuild se completa exitosamente, se creará una nueva generación con tus +paquetes agregados. @@ -456,7 +538,7 @@ Si el rebuild se completa exitosamente, se creará una nueva generación con tus - Usa la utilidad `zcli`. `zcli rebuild` - El alias legacy `fr`, Flake Rebuild está depreciado pero aún disponible ** - NOTA: Si **creaste un nuevo archivo** + NOTA: Si **creaste un nuevo archivo\*\* - necesitarás ejecutar un comando `git add .` en la carpeta `zaneyos` - Si es exitoso se generará una nueva generación con tus cambios - Un logout o reboot podría ser requerido dependiendo de qué cambiaste @@ -466,7 +548,8 @@ Si el rebuild se completa exitosamente, se creará una nueva generación con tus
** ¿Cómo puedo configurar un kernel diferente en un host específico? ** -1. Tienes que editar el archivo `hardware.nix` para ese host en `~/zaneyos/hosts/HOSTNAME/hardware.nix` y override el default. +1. Tienes que editar el archivo `hardware.nix` para ese host en + `~/zaneyos/hosts/HOSTNAME/hardware.nix` y override el default. 2. Cerca del top encontrarás esta sección del archivo `hardware.nix`. ```nix @@ -490,7 +573,8 @@ boot.kernelModules = ["kvm-intel"]; boot.extraModulePackages = []; ``` -5. Usa el comando `zcli rebuild` o alias `fr` para crear una nueva generación y reboot para que tome efecto. +5. Usa el comando `zcli rebuild` o alias `fr` para crear una nueva generación y + reboot para que tome efecto.
@@ -501,28 +585,37 @@ NixOS ofrece varios tipos principales de kernel para adaptarse a diferentes nece 1. **`linuxPackages`** - El kernel estable default, típicamente una versión LTS (Long-Term Support). - LTS en 25.05 (warbler) es 6.12.x Versiones más viejas, 6.6.x, 6.8.x no están soportadas. + LTS en 25.05 (warbler) es 6.12.x Versiones más viejas, 6.6.x, 6.8.x no + están soportadas. 2. **`linuxPackages_latest`** - - El kernel mainline más reciente, que puede incluir nuevas características pero podría ser menos estable. + - El kernel mainline más reciente, que puede incluir nuevas características + pero podría ser menos estable. 3. **`linuxPackages_zen`** - - Un kernel optimizado para rendimiento con parches dirigidos a mejorar la responsividad e interactividad. Comúnmente usado por gamers y usuarios de desktop. + - Un kernel optimizado para rendimiento con parches dirigidos a mejorar la + responsividad e interactividad. Comúnmente usado por gamers y usuarios de + desktop. 4. **`linuxPackages_hardened`** - - Un kernel enfocado en seguridad con parches adicionales de hardening para protección mejorada. + - Un kernel enfocado en seguridad con parches adicionales de hardening para + protección mejorada. 5. **`linuxPackages_rt`** - - Un kernel en tiempo real diseñado para baja latencia y aplicaciones sensibles al tiempo, como producción de audio o robótica. + - Un kernel en tiempo real diseñado para baja latencia y aplicaciones + sensibles al tiempo, como producción de audio o robótica. 6. **`linuxPackages_libre`** - - Un kernel stripped de firmware y drivers propietarios, adhiriéndose a principios de software libre. + - Un kernel stripped de firmware y drivers propietarios, adhiriéndose a + principios de software libre. 7. **`linuxPackages_xen_dom0`** - - Un kernel adaptado para correr como host (dom0) en entornos de virtualización Xen. + - Un kernel adaptado para correr como host (dom0) en entornos de + virtualización Xen. 8. **`linuxPackages_mptcp`** - - Un kernel con soporte para Multipath TCP, útil para escenarios avanzados de networking. + - Un kernel con soporte para Multipath TCP, útil para escenarios avanzados de + networking. @@ -530,7 +623,10 @@ NixOS ofrece varios tipos principales de kernel para adaptarse a diferentes nece ** Tengo generaciones viejas que quiero borrar, ¿cómo puedo hacerlo? ** -- El alias NixOS Clean Generations `ncg` removerá **TODAS** menos la más actual generación. Asegúrate de haber booted desde esa generación antes de usar este alias. También hay un schedule que removerá generaciones viejas automáticamente con el tiempo. +- El alias NixOS Clean Generations `ncg` removerá **TODAS** menos la más actual + generación. Asegúrate de haber booted desde esa generación antes de usar este + alias. También hay un schedule que removerá generaciones viejas + automáticamente con el tiempo. @@ -538,9 +634,11 @@ NixOS ofrece varios tipos principales de kernel para adaptarse a diferentes nece **¿Cómo cambio el hostname? ** -Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el cambio efectivo. +Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el +cambio efectivo. -1. Copia el directorio del host que quieres renombrar a un directorio con el nuevo nombre. +1. Copia el directorio del host que quieres renombrar a un directorio con el + nuevo nombre. - `cp -rpv ~/zaneyos/hosts/OLD-HOSTNAME ~/zaneyos/hosts/NEW-HOSTNAME` @@ -548,9 +646,11 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c - `host = "NEW-HOSTNAME"` -3. En el directorio `~/zaneyos` ejecuta `git add .` _El rebuild fallará con un error 'file not found' si olvidas este paso._ +3. En el directorio `~/zaneyos` ejecuta `git add .` _El rebuild fallará con un + error 'file not found' si olvidas este paso._ -4. Usa el comando `zcli rebuild` o `fr` alias para crear una nueva generación con el nuevo hostname. Debes reboot para hacer el cambio efectivo. +4. Usa el comando `zcli rebuild` o `fr` alias para crear una nueva generación + con el nuevo hostname. Debes reboot para hacer el cambio efectivo.
@@ -566,20 +666,30 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c ``` 3. Cámbialo a `false` -4. Ejecuta el comando `zcli rebuild` o alias `fr` para crear una nueva generación. +4. Ejecuta el comando `zcli rebuild` o alias `fr` para crear una nueva + generación.
** ¿Cómo configuro mi laptop híbrida con GPUs Intel/NVIDIA? ** -1. Ejecuta el script `install-zaneyos.sh` y selecciona el template `nvidia-laptop` o si configurando manualmente, establece el template en el `flake.nix` a `nvidia-prime` +1. Ejecuta el script `install-zaneyos.sh` y selecciona el template + `nvidia-laptop` o si configurando manualmente, establece el template en el + `flake.nix` a `nvidia-prime` -2. En el archivo `~/zaneyos/hosts/HYBRID-HOST/variables.nix` necesitarás establecer los PCI IDs para las GPUs Intel y NVIDIA. Refiérete a [esta página](https://nixos.wiki/wiki/Nvidia) para ayudar a determinar esos valores. +2. En el archivo `~/zaneyos/hosts/HYBRID-HOST/variables.nix` necesitarás + establecer los PCI IDs para las GPUs Intel y NVIDIA. Refiérete a + [esta página](https://nixos.wiki/wiki/Nvidia) para ayudar a determinar esos + valores. -3. Una vez que todo esté configurado apropiadamente, usa el alias Flake Rebuild `fr` para crear una nueva generación. +3. Una vez que todo esté configurado apropiadamente, usa el alias Flake Rebuild + `fr` para crear una nueva generación. -4. En el archivo `~/zaneyos/modules/home/hyprland/config.nix` hay un ENV setting`"AQ_DRM_DEVICES,/dev/dri/card0:/dev/dri/card1:/dev/dri/card2"` Esto establece la GPU primaria y secundaria. Usando la info del weblink arriba podrías tener que cambiar el orden de estos valores. +4. En el archivo `~/zaneyos/modules/home/hyprland/config.nix` hay un ENV + setting`"AQ_DRM_DEVICES,/dev/dri/card0:/dev/dri/card1:/dev/dri/card2"` Esto + establece la GPU primaria y secundaria. Usando la info del weblink arriba + podrías tener que cambiar el orden de estos valores.
@@ -635,7 +745,8 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c ``` 3. Selecciona la imagen que quieres que `stylix` use para la paleta de colores. -4. Ejecuta el comando `zcli rebuild` o `fr` alias para crear una nueva generación con este esquema de colores. +4. Ejecuta el comando `zcli rebuild` o `fr` alias para crear una nueva + generación con este esquema de colores. - Para deshabilitar descomenta @@ -643,27 +754,28 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c 2. Descomenta desde `base16Scheme` hasta el `};` después de `base0F` ```nix - base16Scheme = { - base00 = "282936"; - base01 = "3a3c4e"; - base02 = "4d4f68"; - base03 = "626483"; - base04 = "62d6e8"; - base05 = "e9e9f4"; - base06 = "f1f2f8"; - base07 = "f7f7fb"; - base08 = "ea51b2"; - base09 = "b45bcf"; - base0A = "00f769"; - base0B = "ebff87"; - base0C = "a1efe4"; - base0D = "62d6e8"; - base0E = "b45bcf"; - base0F = "00f769"; - }; + base16Scheme = { + base00 = "282936"; + base01 = "3a3c4e"; + base02 = "4d4f68"; + base03 = "626483"; + base04 = "62d6e8"; + base05 = "e9e9f4"; + base06 = "f1f2f8"; + base07 = "f7f7fb"; + base08 = "ea51b2"; + base09 = "b45bcf"; + base0A = "00f769"; + base0B = "ebff87"; + base0C = "a1efe4"; + base0D = "62d6e8"; + base0E = "b45bcf"; + base0F = "00f769"; +}; ``` -3. Ejecuta el comando `zcli rebuild` o `fr` alias para construir una nueva generación con el dracula default o establece tus propios colores custom +3. Ejecuta el comando `zcli rebuild` o `fr` alias para construir una nueva + generación con el dracula default o establece tus propios colores custom @@ -671,7 +783,8 @@ Para cambiar el hostname, hay varios pasos y tendrás que reboot para hacer el c ¿Cómo cambio la imagen que Stylix usa para tematizar? 1. Edita el archivo `~/zaneyos/hosts/HOSTNAME/varibles.nix` -2. Cambia el `stylixImage =` al nombre del archivo que quieres usar. Los wallpapers están en `~/zaneyos/wallpapers` +2. Cambia el `stylixImage =` al nombre del archivo que quieres usar. Los + wallpapers están en `~/zaneyos/wallpapers` ```nix # Establecer Imagen Stylix @@ -712,7 +825,7 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg; ** ¿Cómo puedo establecer un temporizador para cambiar el wallpaper automáticamente? ** 1. Edita el archivo `~/zaneyos/modules/home/hyprland/config.nix` file. -2. Comenta la línea `sleep 1.5 && swww img ...` +2. Comenta la línea `sleep 1.5 && awww img ...` 3. Agrega nueva línea después de eso con `sleep 1 && wallsetter` ```json @@ -720,18 +833,19 @@ settings = { exec-once = [ "dbus-update-activation-environment --all --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" "systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" - "killall -q swww;sleep .5 && swww init" + "killall -q awww;sleep .5 && awww init" "killall -q waybar;sleep .5 && waybar" "killall -q swaync;sleep .5 && swaync" "nm-applet --indicator" "lxqt-policykit-agent" "pypr &" - #"sleep 1.5 && swww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" + #"sleep 1.5 && awww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" "sleep 1 && wallsetter" ]; ``` -4. Ejecuta el comando `zcli rebuild` o alias `fr` para crear una nueva generación. +4. Ejecuta el comando `zcli rebuild` o alias `fr` para crear una nueva + generación. 5. Necesitarás logout o reboot para que el cambio sea efectivo. @@ -742,7 +856,8 @@ settings = { 1. Edita el archivo `~/zaneyos/modules/home/scripts/wallsetter` 2. Cambia el valor `TIMEOUT =` . Está en segundos. -3. Ejecuta el comando `zcli rebuild` o alias `fr`, para crear una nueva generación. +3. Ejecuta el comando `zcli rebuild` o alias `fr`, para crear una nueva + generación. 4. Necesitarás logout o reboot para que el cambio sea efectivo. @@ -759,26 +874,37 @@ settings = {
Para versión v2.3 -Altamente recomendado: Lee `ZaneyOS-Upgrade.md` antes de proceder. Detalla el upgrade automatizado seguro, respaldo, y proceso de revert. +Altamente recomendado: Lee `ZaneyOS-Upgrade.md` antes de proceder. Detalla el +upgrade automatizado seguro, respaldo, y proceso de revert. -Usa el upgrade automatizado v2.3 → v2.4. Ve `ZaneyOS-Upgrade.md` y `UPGRADE-2.3-to-2.4.md`. Para evitar sobrescribir tu config antes de crear un respaldo, fetch solo el script sin modificar tu working tree: +Usa el upgrade automatizado v2.3 → v2.4. Ve `ZaneyOS-Upgrade.md` y +`UPGRADE-2.3-to-2.4.md`. Para evitar sobrescribir tu config antes de crear un +respaldo, fetch solo el script sin modificar tu working tree: - Git (recomendado): + ```bash git -C ~/zaneyos fetch origin git -C ~/zaneyos show origin/main:upgrade-2.3-to-2.4.sh > ~/upgrade-2.3-to-2.4.sh chmod +x ~/upgrade-2.3-to-2.4.sh ``` + - Curl: + ```bash curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o ~/upgrade-2.3-to-2.4.sh chmod +x ~/upgrade-2.3-to-2.4.sh ``` -Luego ejecuta el script: `~/upgrade-2.3-to-2.4.sh`. Creará un respaldo completo antes de cambiar branches y migrará tus hosts de forma segura desde el respaldo. + +Luego ejecuta el script: `~/upgrade-2.3-to-2.4.sh`. Creará un respaldo completo +antes de cambiar branches y migrará tus hosts de forma segura desde el respaldo. **IMPORTANTE:** -- NO uses los alias `fu` o `fr` para este upgrade; el script usa un boot build seguro. -- Si has hecho modificaciones extensas, no ejecutes el script. Lee los docs arriba y migra manualmente en su lugar. + +- NO uses los alias `fu` o `fr` para este upgrade; el script usa un boot build + seguro. +- Si has hecho modificaciones extensas, no ejecutes el script. Lee los docs + arriba y migra manualmente en su lugar.
@@ -788,29 +914,35 @@ Luego ejecuta el script: `~/upgrade-2.3-to-2.4.sh`. Creará un respaldo completo 1. Primero respaldo tu directorio `zaneyos` existente. ej. `cp -r ~/zaneyos ~/zaneyos-backup` -2. No hay update directo. Cuando clones la nueva config los archivos de config y layout han cambiado. +2. No hay update directo. Cuando clones la nueva config los archivos de config y + layout han cambiado. 3. Necesitas instalar zaneyos como una nueva install. `./install-zaneyos.sh` -4. Una vez que el build se complete y hayas rebooted puedes revisar el nuevo layout y decidir si algún cambio que hiciste en la versión anterior puede ser migrado a v2.3. +4. Una vez que el build se complete y hayas rebooted puedes revisar el nuevo + layout y decidir si algún cambio que hiciste en la versión anterior puede ser + migrado a v2.3.
Para versión v1.x -1. El layout y configuración son completamente diferentes. Virtualmente nada de 1.x es aplicable a v2.3. +1. El layout y configuración son completamente diferentes. Virtualmente nada de + 1.x es aplicable a v2.3. 2. Respalda tu directorio `zaneyos` ej. `cp -r ~/zaneyos ~/zaneyos-backup` -3. Ejecuta el script `./install-zaneyos.sh` y sigue las nuevas instrucciones de install. +3. Ejecuta el script `./install-zaneyos.sh` y sigue las nuevas instrucciones de + install.
¿Cómo sé cuándo se lanza una nueva versión de ZaneyOS? -Será anunciado en el servidor Discord de Zaney [Discord](https://discord.gg/W7efsSDS). +Será anunciado en el servidor Discord de Zaney +[Discord](https://discord.gg/W7efsSDS).
@@ -830,13 +962,13 @@ Será anunciado en el servidor Discord de Zaney [Discord](https://discord.gg/W7e ~/zaneyos/ ├── hosts/ # Carpeta donde se guardan configs de host │ ├── default # Template de host default - │ └── nixstation # Host de Zaney + │ └── nixstation # Host de Zaney ├── img/ # Imágenes para README.md ├── modules/ # Archivos de config Core, HomeMgr, drivers │ └── drivers/ # Configs AMD,NVIDA,Intel,VM │ └── core/ # Servicios, paquetes, fonts, etc │ └── home/ # Archivos de config Home Manager - │ ├── fastfetch/ # Config Fastfetch + │ ├── fastfetch/ # Config Fastfetch │ ├── hyprland/ # Configs Hyrprland │ ├── rofi/ # Configs de menú rofi │ ├── scripts/ # screenshots, wallpaper, etc. @@ -850,9 +982,9 @@ Será anunciado en el servidor Discord de Zaney [Discord](https://discord.gg/W7e │ ├── nvidia/ # Configs video NVIDIA discrete │ ├── nvidia-laptop/ # Configs video NVIDIA Hybrid │ └── vm/ # Configs Virtual Machine - ├── wallpapers/ # Agrega tus wallpapers aquí + ├── wallpapers/ # Agrega tus wallpapers aquí ├── CHANGELOG.md # Lista de cambios - ├── CONTRIBUTING.md # Cómo puedes ayudar + ├── CONTRIBUTING.md # Cómo puedes ayudar ├── FAQ.md # Preguntas Frecuentes ├── flake.lock # Guarda info de versión de todos los paquetes instalados ├── flake.nix # flake que controla config ZaneyOS @@ -877,8 +1009,10 @@ Será anunciado en el servidor Discord de Zaney [Discord](https://discord.gg/W7e **Update**
-- Usando el comando `zcli rebuild` o `zcli upgrade` buscará este archivo causando fallos de rebuild -- Si encuentras otros archivos que causan esto puedes agregarlos en el `zaneyos/modules/home/scripts/default.nix` +- Usando el comando `zcli rebuild` o `zcli upgrade` buscará este archivo + causando fallos de rebuild +- Si encuentras otros archivos que causan esto puedes agregarlos en el + `zaneyos/modules/home/scripts/default.nix`
```text @@ -898,7 +1032,8 @@ May 08 18:33:57 explorer systemd[1]: Failed to start Home Manager environment fo - Te promptará para borrar estos backups - También crea un log - Nota: El script no es perfecto -- Si obtienes este msg pero `hm-find` no reporta ninguno tendrás que buscar manualmente ej `journalctl | grep hm-activate` +- Si obtienes este msg pero `hm-find` no reporta ninguno tendrás que buscar + manualmente ej `journalctl | grep hm-activate` - Puedes entonces redo tu rebuild - Usa el comando `zcli rebuild` o `fr` para `flake rebuild` - El flake ya ha sido actualizado @@ -916,16 +1051,22 @@ May 08 18:33:57 explorer systemd[1]: Failed to start Home Manager environment fo **1. Layout Master** - El layout **Master** divide el workspace en dos áreas principales: - - Un **área master** para la ventana primaria, que toma una porción más grande de la pantalla. - - Un **área stack** para todas las otras ventanas, que están tiled en el espacio restante. -- Este layout es ideal para workflows donde quieres enfocarte en una ventana main mientras mantienes otras accesibles. + - Un **área master** para la ventana primaria, que toma una porción más grande + de la pantalla. + - Un **área stack** para todas las otras ventanas, que están tiled en el + espacio restante. +- Este layout es ideal para workflows donde quieres enfocarte en una ventana + main mientras mantienes otras accesibles. **2. Layout Dwindle** - El layout **Dwindle** es un layout de tiling basado en árbol binario: - - Cada nueva ventana split el espacio disponible dinámicamente, alternando entre splits horizontales y verticales. - - Los splits son determinados por el aspect ratio del contenedor padre (ej. splits más anchos horizontalmente, más altos verticalmente). -- Este layout es más dinámico y distribuye espacio equitativamente entre todas las ventanas. + - Cada nueva ventana split el espacio disponible dinámicamente, alternando + entre splits horizontales y verticales. + - Los splits son determinados por el aspect ratio del contenedor padre (ej. + splits más anchos horizontalmente, más altos verticalmente). +- Este layout es más dinámico y distribuye espacio equitativamente entre todas + las ventanas. --- @@ -945,7 +1086,8 @@ Para verificar cuál layout está activo actualmente, usa el comando `hyprctl`:

-El archivo de configuración de Yazi está localizado en `~/zaneyos/modules/home/yazi.nix` +El archivo de configuración de Yazi está localizado en +`~/zaneyos/modules/home/yazi.nix` Yazi está configurado como VIM y motions VIM @@ -985,7 +1127,7 @@ El keymap está en el archivo `~/zaneyos/modules/home/yazi/keymap.toml` file roboto-mono symbola terminus_font - # NERD fonts + # NERD fonts nerd-fonts.0xproto nerd-fonts._3270 nerd-fonts.agave @@ -1071,10 +1213,13 @@ El keymap está en el archivo `~/zaneyos/modules/home/yazi/keymap.toml` file Mi cursor en Kitty es "janky" y salta alrededor. ¿Cómo lo arreglo? -- Esa característica se llama "cursor_trail" en el archivo `~/zaneyos/modules/home/kitty.nix`. +- Esa característica se llama "cursor_trail" en el archivo + `~/zaneyos/modules/home/kitty.nix`. -1. Edita ese archivo y cambia el `cursor_trail 1` a `cursor_trail 0` o comenta esa línea. -2. Usa el alias `zcli rebuild` o `fr` para crear una nueva generación con el cambio. +1. Edita ese archivo y cambia el `cursor_trail 1` a `cursor_trail 0` o comenta + esa línea. +2. Usa el alias `zcli rebuild` o `fr` para crear una nueva generación con el + cambio. @@ -1151,7 +1296,8 @@ Los defaults son: ¿Cómo habilito WezTerm? -Edita el `/zaneyos/modules/home/wezterm.nix` Cambia `enable = false` a `enable = true;`\ +Edita el `/zaneyos/modules/home/wezterm.nix` Cambia `enable = false` a +`enable = true;`\ Guarda el archivo y rebuild zaneyos con el comando `zcli rebild` o el alias `fr` ``` @@ -1177,7 +1323,7 @@ ALT es la tecla META definida para WezTerm ALT + t Abrir nuevo Tab ALT + w Cerrar Tab actual ALT + n Mover a siguiente Tab -ALT + p Mover a Tab anterior +ALT + p Mover a Tab anterior -- Gestión de pane ALT + v Crear Split Vertical ALT + h Crear Split Horizontal @@ -1221,7 +1367,8 @@ theme = Dracula #theme = GruvboxDarkHard ``` -3. Comenta `Dracula` y descomenta uno de los otros o agrega uno de los muchos temas de ghostty. +3. Comenta `Dracula` y descomenta uno de los otros o agrega uno de los muchos + temas de ghostty. @@ -1271,29 +1418,34 @@ theme = Dracula
-** ---> 🪧 Temas relacionados con NixOS general -** +** --> 🪧 Temas relacionados con NixOS general **
**❄ ¿Qué son los Flakes en NixOS? **
-**Flakes** son una característica del package manager Nix que simplifica y estandariza cómo se gestionan configuraciones, dependencias y paquetes. Si estás familiarizado con herramientas como `package.json` en JavaScript o `Cargo.toml` en Rust, flakes sirven un propósito similar en el ecosistema Nix. +**Flakes** son una característica del package manager Nix que simplifica y +estandariza cómo se gestionan configuraciones, dependencias y paquetes. Si estás +familiarizado con herramientas como `package.json` en JavaScript o `Cargo.toml` +en Rust, flakes sirven un propósito similar en el ecosistema Nix. ** Características Clave de Flakes: ** 1. **Pin Dependencias**: - - Flakes lock las versiones de dependencias en un archivo `flake.lock`, asegurando reproducibilidad entre sistemas. + - Flakes lock las versiones de dependencias en un archivo `flake.lock`, + asegurando reproducibilidad entre sistemas. 2. **Estandarizar Configuraciones**: - - Usan un archivo `flake.nix` para definir cómo build, run o deploy un proyecto o sistema, haciendo setups más predecibles. + - Usan un archivo `flake.nix` para definir cómo build, run o deploy un + proyecto o sistema, haciendo setups más predecibles. 3. **Mejorar Usabilidad**: - - Flakes simplifican compartir y reusar configuraciones entre diferentes sistemas o proyectos proporcionando una estructura consistente. + - Flakes simplifican compartir y reusar configuraciones entre diferentes + sistemas o proyectos proporcionando una estructura consistente. -En esencia, flakes ayudan a gestionar setups de NixOS o proyectos basados en Nix de una manera más portable y confiable. +En esencia, flakes ayudan a gestionar setups de NixOS o proyectos basados en Nix +de una manera más portable y confiable.
@@ -1302,50 +1454,75 @@ En esencia, flakes ayudan a gestionar setups de NixOS o proyectos basados en Nix
**🏡 ¿Qué es NixOS Home Manager? ** -**Home Manager** es una herramienta poderosa en el ecosistema Nix que te permite gestionar configuraciones y entornos específicos de usuario de manera declarativa. Con Home Manager, puedes simplificar el setup de dotfiles, settings de shell, aplicaciones y paquetes de sistema para tu perfil de usuario. +**Home Manager** es una herramienta poderosa en el ecosistema Nix que te permite +gestionar configuraciones y entornos específicos de usuario de manera +declarativa. Con Home Manager, puedes simplificar el setup de dotfiles, settings +de shell, aplicaciones y paquetes de sistema para tu perfil de usuario. ### Características Clave de Home Manager: 1. **Configuración Declarativa**: - - Define todos tus settings y preferencias en un solo archivo `home.nix`, haciendo fácil trackear, compartir y replicar tu setup. + - Define todos tus settings y preferencias en un solo archivo `home.nix`, + haciendo fácil trackear, compartir y replicar tu setup. 2. **Soporte Cross-Distribution**: - - Home Manager funciona no solo en NixOS sino también en otras distribuciones Linux y macOS, permitiéndote estandarizar configuraciones entre dispositivos. + - Home Manager funciona no solo en NixOS sino también en otras distribuciones + Linux y macOS, permitiéndote estandarizar configuraciones entre + dispositivos. 3. **Gestión de Entorno de Usuario**: - - Gestiona aplicaciones, variables de entorno, configuraciones de shell y más—todo aislado a tu perfil de usuario. + - Gestiona aplicaciones, variables de entorno, configuraciones de shell y + más—todo aislado a tu perfil de usuario. ### ¿Por Qué Usar Home Manager? -Home Manager simplifica la gestión de sistema ofreciendo consistencia, reproducibilidad y portabilidad. Ya sea que estés customizando tu entorno de desarrollo o compartiendo configuraciones entre máquinas, proporciona una manera eficiente de adaptar tu experiencia de usuario. +Home Manager simplifica la gestión de sistema ofreciendo consistencia, +reproducibilidad y portabilidad. Ya sea que estés customizando tu entorno de +desarrollo o compartiendo configuraciones entre máquinas, proporciona una manera +eficiente de adaptar tu experiencia de usuario.
**🏭 ¿Qué son los Builds Atómicos?** -**Builds atómicos** en NixOS aseguran que cualquier cambio de sistema (como instalar software o actualizar la configuración) se aplique de manera segura y fail-proof. Esto significa que una actualización de sistema es completamente exitosa o no tiene efecto alguno, eliminando el riesgo de un estado de sistema parcialmente aplicado o roto. +**Builds atómicos** en NixOS aseguran que cualquier cambio de sistema (como +instalar software o actualizar la configuración) se aplique de manera segura y +fail-proof. Esto significa que una actualización de sistema es completamente +exitosa o no tiene efecto alguno, eliminando el riesgo de un estado de sistema +parcialmente aplicado o roto. ### Cómo Funcionan los Builds Atómicos: 1. **Generación de Sistema Inmutable**: - - Cada cambio de configuración crea una nueva "generación" del sistema, mientras las previas permanecen intactas. Puedes fácilmente rollback a una generación anterior si algo sale mal. + - Cada cambio de configuración crea una nueva "generación" del sistema, + mientras las previas permanecen intactas. Puedes fácilmente rollback a una + generación anterior si algo sale mal. 2. **Comportamiento Transaccional**: - - Similar a transacciones de database, los cambios se aplican atómicamente: o tienen éxito y se convierten en el nuevo sistema activo, o fallan y dejan el sistema actual sin cambios. + - Similar a transacciones de database, los cambios se aplican atómicamente: o + tienen éxito y se convierten en el nuevo sistema activo, o fallan y dejan + el sistema actual sin cambios. 3. **Rollbacks Sin Problemas**: - - En caso de errores o issues, puedes reboot y seleccionar una generación previa de sistema desde el menú de boot para retornar a un estado funcional. + - En caso de errores o issues, puedes reboot y seleccionar una generación + previa de sistema desde el menú de boot para retornar a un estado + funcional. ### Beneficios de Builds Atómicos: -- **Confiabilidad**: Tu sistema está siempre en un estado consistente, incluso si un cambio de configuración falla. -- **Reproducibilidad**: La misma configuración siempre producirá el mismo estado de sistema, haciendo fácil debuggear o replicar. -- **Facilidad de Rollback**: Revertir a una configuración funcional es tan simple como reboot y seleccionar la generación previa. +- **Confiabilidad**: Tu sistema está siempre en un estado consistente, incluso + si un cambio de configuración falla. +- **Reproducibilidad**: La misma configuración siempre producirá el mismo estado + de sistema, haciendo fácil debuggear o replicar. +- **Facilidad de Rollback**: Revertir a una configuración funcional es tan + simple como reboot y seleccionar la generación previa. ### ¿Por Qué NixOS Usa Builds Atómicos? -Esta característica es un cornerstone de la filosofía de diseño declarativo y reproducible de NixOS, asegurando que la gestión de sistema sea predecible y sin estrés. +Esta característica es un cornerstone de la filosofía de diseño declarativo y +reproducible de NixOS, asegurando que la gestión de sistema sea predecible y sin +estrés.
@@ -1372,4 +1549,4 @@ Esta característica es un cornerstone de la filosofía de diseño declarativo y -
\ No newline at end of file + diff --git a/FAQ.md b/FAQ.md index 4e7e26b..32c6708 100644 --- a/FAQ.md +++ b/FAQ.md @@ -1,15 +1,8 @@ [English](FAQ.md) | [Español](FAQ.es.md) -# 💬 ZaneyOS FAQ for v2.4 +# 💬 ZaneyOS FAQ -- **Revision v1.26** -- **Date:** 01-September-2025 - -> IMPORTANT: Upgrading from v2.3 to v2.4? -> - Strongly recommended: Read `ZaneyOS-Upgrade.md` fully before attempting the upgrade. -> - It explains the automated upgrade, full backup, host migration, and revert process. -> - Do NOT use the `fu` or `fr` aliases for this upgrade. -> - If you've made extensive modifications, do not run the script—review the docs and migrate manually. +- **Date:** 14-Decemnber-2025 **⌨ Where can I see the Hyprland keybindings?** @@ -21,48 +14,72 @@
The `zcli` utility is a command-line tool designed to simplify the management of -your `zaneyos` environment. It provides a comprehensive set of commands to perform common -tasks such as updating your system, managing hosts, cleaning up old generations, -and managing Doom Emacs. +your `zaneyos` environment. It provides a comprehensive set of commands to +perform common tasks such as updating your system, managing hosts, cleaning up +old generations, and managing Doom Emacs. To use it, open a terminal and type `zcli` followed by one of the commands listed below: ## Core System Commands: -- `cleanup`: Clean up old system generations. You can specify the number of generations to keep. Includes automated log cleanup for old build logs. -- `diag`: Create a comprehensive system diagnostic report using `inxi --full`, saved to `~/diag.txt`. Perfect for troubleshooting. + +- `cleanup`: Clean up old system generations. You can specify the number of + generations to keep. Includes automated log cleanup for old build logs. +- `diag`: Create a comprehensive system diagnostic report using `inxi --full`, + saved to `~/diag.txt`. Perfect for troubleshooting. - `list-gens`: List both user and system generations with detailed information. -- `rebuild`: Rebuild the NixOS system configuration with enhanced safety checks and backup file handling. -- `rebuild-boot`: Rebuild and set as boot default (activates on next restart). Safer for major system changes and kernel updates. -- `trim`: Trim filesystems to improve SSD performance with user confirmation prompts. -- `update`: Update the flake and rebuild the system with comprehensive error handling. +- `rebuild`: Rebuild the NixOS system configuration with enhanced safety checks + and backup file handling. +- `rebuild-boot`: Rebuild and set as boot default (activates on next restart). + Safer for major system changes and kernel updates. +- `trim`: Trim filesystems to improve SSD performance with user confirmation + prompts. +- `update`: Update the flake and rebuild the system with comprehensive error + handling. ## Host Management: -- `update-host`: Automatically set the host and profile in `flake.nix`. Features intelligent GPU detection and hostname validation. -- `add-host`: Create new host configurations with automated GPU detection, hardware.nix generation, and git integration. -- `del-host`: Safely delete host configurations with confirmation prompts to prevent accidental removal. -**Usage:** `zcli add-host [hostname] [profile]` +- `update-host`: Automatically set the host and profile in `flake.nix`. Features + intelligent GPU detection and hostname validation. +- `add-host`: Create new host configurations with automated GPU detection, + hardware.nix generation, and git integration. +- `del-host`: Safely delete host configurations with confirmation prompts to + prevent accidental removal. + +**Usage:** `zcli add-host [hostname] [profile]`\ **GPU Profiles:** `amd`, `intel`, `nvidia`, `nvidia-hybrid`, and `vm` ## Advanced Build Options: -The `rebuild`, `rebuild-boot`, and `update` commands support enhanced options for fine-grained control: -- `--dry, -n`: Preview mode - shows what would be done without executing (dry run) + +The `rebuild`, `rebuild-boot`, and `update` commands support enhanced options +for fine-grained control: + +- `--dry, -n`: Preview mode - shows what would be done without executing (dry + run) - `--ask, -a`: Interactive confirmation prompts for safety-critical operations -- `--cores N`: Limit build operations to N CPU cores (essential for VMs and resource-constrained systems) -- `--verbose, -v`: Enable detailed operation logs and verbose output for troubleshooting +- `--cores N`: Limit build operations to N CPU cores (essential for VMs and + resource-constrained systems) +- `--verbose, -v`: Enable detailed operation logs and verbose output for + troubleshooting - `--no-nom`: Disable nix-output-monitor for traditional command-line output -**Multiple options can be combined** for precise control over your build process. +**Multiple options can be combined** for precise control over your build +process. ## Doom Emacs Management: + Complete Doom Emacs lifecycle management with safety features: -- `doom install`: Automated Doom Emacs installation using the get-doom script with all required packages -- `doom status`: Check installation status and display version information for verification -- `doom remove`: Safely remove Doom Emacs installation with confirmation prompts to prevent accidental deletion + +- `doom install`: Automated Doom Emacs installation using the get-doom script + with all required packages +- `doom status`: Check installation status and display version information for + verification +- `doom remove`: Safely remove Doom Emacs installation with confirmation prompts + to prevent accidental deletion - `doom update`: Update Doom Emacs packages and configuration via `doom sync` -**Features:** Built-in safety checks, comprehensive error handling, and automatic dependency management. +**Features:** Built-in safety checks, comprehensive error handling, and +automatic dependency management. ```text ❯ zcli @@ -100,6 +117,7 @@ Doom Emacs: ``` **Examples:** + ```bash # System management zcli rebuild --dry # Show what would be rebuilt @@ -125,8 +143,11 @@ Below are the keybindings for Hyprland, formatted for easy reference. ## Application Launching - `$modifier + Return` → Launch `Terminal` +- `$modifier + Tab` → Toggle `Quickshell Overview` (workspace overview with live + previews) - `$modifier + K` → List keybinds -- `$modifier + Shift + Return` → Launch `rofi-launcher` +- `$modifier + D` → Application Launcher +- `$modifier + Shift + Return` → Application Launcher - `$modifier + Shift + W` → Open `web-search` - `$modifier + Alt + W` → Open `wallsetter` - `$modifier + Shift + N` → Run `swaync-client -rs` @@ -134,7 +155,7 @@ Below are the keybindings for Hyprland, formatted for easy reference. - `$modifier + Y` → Open `kitty` with `yazi` - `$modifier + E` → Open `emopicker9000` - `$modifier + S` → Take a screenshot -- `$modifier + D` → Open `Discord` +- `$modifier + Shift + D` → Open `Discord` - `$modifier + O` → Launch `OBS Studio` - `$modifier + C` → Run `hyprpicker -a` - `$modifier + G` → Open `GIMP` @@ -207,6 +228,32 @@ Below are the keybindings for Hyprland, formatted for easy reference.
+
+**How do I set default apps (PDF, browser) per host?** + +- Edit `~/zaneyos/hosts//variables.nix` and uncomment `mimeDefaultApps`. +- Home Manager will consume these via `modules/home/xdg.nix` to write your `~/.config/mimeapps.list`. +- Use real `.desktop` IDs from `/usr/share/applications` or `~/.local/share/applications`. + +```nix +# hosts//variables.nix +# Host-level default applications (picked up by Home Manager xdg.mimeApps) +# mimeDefaultApps = { +# # PDFs +# "application/pdf" = ["okular.desktop"]; +# "application/x-pdf" = ["okular.desktop"]; +# # Web browser +# "x-scheme-handler/http" = ["google-chrome.desktop"]; # or brave-browser.desktop, firefox.desktop +# "x-scheme-handler/https" = ["google-chrome.desktop"]; +# "text/html" = ["google-chrome.desktop"]; +# # Files +# "inode/directory" = ["thunar.desktop"]; # file manager +# "text/plain" = ["nvim.desktop"]; # or code.desktop +# }; +``` + +
+
**How to I add flatpaks? ?** @@ -354,9 +401,9 @@ Edit the `extraMonitorSettings` line. **Examples:** - Single Monitor: `extraMonitorSettings = "monitor=eDP-1,1920x1080@60,auto,1";` - Multiple Monitors: `extraMonitorSettings = " - monitor=eDP-1,1920x1080@60,auto,auto - monitor=HDMI-A-1,2560x1440@75,auto,auto - ";` + monitor=eDP-1,1920x1080@60,auto,auto + monitor=HDMI-A-1,2560x1440@75,auto,auto + ";` - For more complex, multi-monitor configurations, you may wish to use the GUI application, `nwg-displays` This will show your currently connected monitors @@ -407,7 +454,7 @@ packages. ... virt-viewer wget - ### My Apps ### + ### My Apps ### bottom dua emacs-nox @@ -479,7 +526,7 @@ will be created. - Use the `zcli` utility. `zcli rebuild` - The legacy `fr`, Flake Rebuild alias, is depreciated but still available ** - NOTE: If you **created a new file** + NOTE: If you **created a new file\*\* - you will need to run a `git add .` command in the `zaneyos` folder - If successful a new generation will be generated with your changes - A logout or reboot could be required depending on what you changed @@ -764,7 +811,7 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg; ** How can I set a timer to change the wallpaper automatically? ** 1. Edit the `~/zaneyos/modules/home/hyprland/config.nix` file. -2. Comment out the line `sleep 1.5 && swww img ...` +2. Comment out the line `sleep 1.5 && awww img ...` 3. Add new line after that with `sleep 1 && wallsetter` ```json @@ -772,13 +819,13 @@ settings = { exec-once = [ "dbus-update-activation-environment --all --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" "systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" - "killall -q swww;sleep .5 && swww init" + "killall -q awww;sleep .5 && awww init" "killall -q waybar;sleep .5 && waybar" "killall -q swaync;sleep .5 && swaync" "nm-applet --indicator" "lxqt-policykit-agent" "pypr &" - #"sleep 1.5 && swww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" + #"sleep 1.5 && awww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" "sleep 1 && wallsetter" ]; ``` @@ -811,26 +858,37 @@ settings = {
For version v2.3 -Strongly recommended: Read `ZaneyOS-Upgrade.md` before proceeding. It details the safe, automated upgrade, backup, and revert process. +Strongly recommended: Read `ZaneyOS-Upgrade.md` before proceeding. It details +the safe, automated upgrade, backup, and revert process. -Use the automated v2.3 → v2.4 upgrade. See `ZaneyOS-Upgrade.md` and `UPGRADE-2.3-to-2.4.md`. To avoid overwriting your config before a backup is created, fetch just the script without modifying your working tree: +Use the automated v2.3 → v2.4 upgrade. See `ZaneyOS-Upgrade.md` and +`UPGRADE-2.3-to-2.4.md`. To avoid overwriting your config before a backup is +created, fetch just the script without modifying your working tree: - Git (recommended): + ```bash git -C ~/zaneyos fetch origin git -C ~/zaneyos show origin/main:upgrade-2.3-to-2.4.sh > ~/upgrade-2.3-to-2.4.sh chmod +x ~/upgrade-2.3-to-2.4.sh ``` + - Curl: + ```bash curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o ~/upgrade-2.3-to-2.4.sh chmod +x ~/upgrade-2.3-to-2.4.sh ``` -Then run the script: `~/upgrade-2.3-to-2.4.sh`. It will create a full backup before switching branches and migrate your hosts safely from the backup. + +Then run the script: `~/upgrade-2.3-to-2.4.sh`. It will create a full backup +before switching branches and migrate your hosts safely from the backup. **IMPORTANT:** -- Do NOT use the `fu` or `fr` aliases for this upgrade; the script uses a safe boot build. -- If you have made extensive modifications, do not run the script. Read the docs above and migrate manually instead. + +- Do NOT use the `fu` or `fr` aliases for this upgrade; the script uses a safe + boot build. +- If you have made extensive modifications, do not run the script. Read the docs + above and migrate manually instead.
@@ -887,13 +945,13 @@ It will be announced on the Zaney [Discord](https://discord.gg/W7efsSDS) server. ~/zaneyos/ ├── hosts/ # Folder where host configs are saved │ ├── default # Default host template - │ └── nixstation # Zaney's host + │ └── nixstation # Zaney's host ├── img/ # Images for README.md ├── modules/ # Core, HomeMgr, drivers config files │ └── drivers/ # AMD,NVIDA,Intel,VM config files │ └── core/ # Services, packages, fonts, etc │ └── home/ # Home Manager config files - │ ├── fastfetch/ # Fastfetch config + │ ├── fastfetch/ # Fastfetch config │ ├── hyprland/ # Hyrprland configs │ ├── rofi/ # rofi menu configs │ ├── scripts/ # screenshots, wallpaper, etc. @@ -907,9 +965,9 @@ It will be announced on the Zaney [Discord](https://discord.gg/W7efsSDS) server. │ ├── nvidia/ # NVIDIA discrete video config files │ ├── nvidia-laptop/ # NVIDIA Hybrid video config files │ └── vm/ # Virtual Machine config files - ├── wallpapers/ # Add your wallpapers here + ├── wallpapers/ # Add your wallpapers here ├── CHANGELOG.md # List of changes - ├── CONTRIBUTING.md # How you can help + ├── CONTRIBUTING.md # How you can help ├── FAQ.md # Frequently Asked Questions ├── flake.lock # Saves version info on all installed packages ├── flake.nix # flake that controls ZaneyOS config @@ -1052,7 +1110,7 @@ The keymap is in the `~/zaneyos/modules/home/yazi/keymap.toml` file roboto-mono symbola terminus_font - # NERD fonts + # NERD fonts nerd-fonts.0xproto nerd-fonts._3270 nerd-fonts.agave @@ -1248,7 +1306,7 @@ ALT is the defined META key for WezTerm ALT + t Open new Tab ALT + w Close current Tab ALT + n Move to next Tab -ALT + p Move to previous Tab +ALT + p Move to previous Tab -- Pane management ALT + v Create Vertical Split ALT + h Create Horizontal Split @@ -1343,9 +1401,7 @@ theme = Dracula
-** ---> 🪧 General NixOS related topics -** +** --> 🪧 General NixOS related topics **
**❄ What are Flakes in NixOS? ** @@ -1540,9 +1596,9 @@ Edit the `extraMonitorSettings` line. **Examples:** - Single Monitor: `extraMonitorSettings = "monitor=eDP-1,1920x1080@60,auto,1";` - Multiple Monitors: `extraMonitorSettings = " - monitor=eDP-1,1920x1080@60,auto,auto - monitor=HDMI-A-1,2560x1440@75,auto,auto - ";` + monitor=eDP-1,1920x1080@60,auto,auto + monitor=HDMI-A-1,2560x1440@75,auto,auto + ";` - For more complex, multi-monitor configurations, you may wish to use the GUI application, `nwg-displays` This will show your currently connected monitors @@ -1593,7 +1649,7 @@ packages. ... virt-viewer wget - ### My Apps ### + ### My Apps ### bottom dua emacs-nox @@ -1946,7 +2002,7 @@ stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg; ** How can I set a timer to change the wallpaper automatically? ** 1. Edit the `~/zaneyos/modules/home/hyprland/config.nix` file. -2. Comment out the line `sleep 1.5 && swww img ...` +2. Comment out the line `sleep 1.5 && awww img ...` 3. Add new line after that with `sleep 1 && wallsetter` ```json @@ -1954,13 +2010,13 @@ settings = { exec-once = [ "dbus-update-activation-environment --all --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" "systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP" - "killall -q swww;sleep .5 && swww init" + "killall -q awww;sleep .5 && awww init" "killall -q waybar;sleep .5 && waybar" "killall -q swaync;sleep .5 && swaync" "nm-applet --indicator" "lxqt-policykit-agent" "pypr &" - #"sleep 1.5 && swww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" + #"sleep 1.5 && awww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg" "sleep 1 && wallsetter" ]; ``` @@ -1993,24 +2049,34 @@ settings = {
For version v2.3 -Use the automated v2.3 → v2.4 upgrade. See ZaneyOS-Upgrade.md and UPGRADE-2.3-to-2.4.md. To avoid overwriting your config before a backup is created, fetch just the script without modifying your working tree: +Use the automated v2.3 → v2.4 upgrade. See ZaneyOS-Upgrade.md and +UPGRADE-2.3-to-2.4.md. To avoid overwriting your config before a backup is +created, fetch just the script without modifying your working tree: - Git (recommended): + ```bash git -C ~/zaneyos fetch origin git -C ~/zaneyos show origin/main:upgrade-2.3-to-2.4.sh > ~/upgrade-2.3-to-2.4.sh chmod +x ~/upgrade-2.3-to-2.4.sh ``` + - Curl: + ```bash curl -fsSL https://gitlab.com/zaney/zaneyos/-/raw/main/upgrade-2.3-to-2.4.sh -o ~/upgrade-2.3-to-2.4.sh chmod +x ~/upgrade-2.3-to-2.4.sh ``` -Then run the script: `~/upgrade-2.3-to-2.4.sh`. It will create a full backup before switching branches and migrate your hosts safely from the backup. + +Then run the script: `~/upgrade-2.3-to-2.4.sh`. It will create a full backup +before switching branches and migrate your hosts safely from the backup. **IMPORTANT:** -- Do NOT use the `fu` or `fr` aliases for this upgrade; the script uses a safe boot build. -- If you have made extensive modifications, do not run the script. Read the docs above and migrate manually instead. + +- Do NOT use the `fu` or `fr` aliases for this upgrade; the script uses a safe + boot build. +- If you have made extensive modifications, do not run the script. Read the docs + above and migrate manually instead.
@@ -2067,13 +2133,13 @@ It will be announced on the Zaney [Discord](https://discord.gg/W7efsSDS) server. ~/zaneyos/ ├── hosts/ # Folder where host configs are saved │ ├── default # Default host template - │ └── nixstation # Zaney's host + │ └── nixstation # Zaney's host ├── img/ # Images for README.md ├── modules/ # Core, HomeMgr, drivers config files │ └── drivers/ # AMD,NVIDA,Intel,VM config files │ └── core/ # Services, packages, fonts, etc │ └── home/ # Home Manager config files - │ ├── fastfetch/ # Fastfetch config + │ ├── fastfetch/ # Fastfetch config │ ├── hyprland/ # Hyrprland configs │ ├── rofi/ # rofi menu configs │ ├── scripts/ # screenshots, wallpaper, etc. @@ -2087,9 +2153,9 @@ It will be announced on the Zaney [Discord](https://discord.gg/W7efsSDS) server. │ ├── nvidia/ # NVIDIA discrete video config files │ ├── nvidia-laptop/ # NVIDIA Hybrid video config files │ └── vm/ # Virtual Machine config files - ├── wallpapers/ # Add your wallpapers here + ├── wallpapers/ # Add your wallpapers here ├── CHANGELOG.md # List of changes - ├── CONTRIBUTING.md # How you can help + ├── CONTRIBUTING.md # How you can help ├── FAQ.md # Frequently Asked Questions ├── flake.lock # Saves version info on all installed packages ├── flake.nix # flake that controls ZaneyOS config @@ -2226,7 +2292,7 @@ The keymap is in the `~/zaneyos/modules/home/yazi/keymap.toml` file roboto-mono symbola terminus_font - # NERD fonts + # NERD fonts nerd-fonts.0xproto nerd-fonts._3270 nerd-fonts.agave @@ -2423,7 +2489,7 @@ ALT is the defined META key for WezTerm ALT + t Open new Tab ALT + w Close current Tab ALT + n Move to next Tab -ALT + p Move to previous Tab +ALT + p Move to previous Tab -- Pane management ALT + v Create Vertical Split ALT + h Create Horizontal Split @@ -2518,9 +2584,7 @@ theme = Dracula
-** ---> 🪧 General NixOS related topics -** +** --> 🪧 General NixOS related topics **
**❄ What are Flakes in NixOS? ** diff --git a/README.es.md b/README.es.md index 0ae47bc..1e83376 100644 --- a/README.es.md +++ b/README.es.md @@ -4,36 +4,49 @@ ## ZaneyOS 🟰 Mejores Configs ❄️ NixOS -** Actualizado: 3 de junio de 2025 +\*\* Actualizado: 16 de enero de 2026 ZaneyOS es una forma sencilla de reproducir mi configuración en cualquier sistema NixOS. Incluye el fondo de pantalla, scripts, aplicaciones, archivos de configuración y más. - - -**Inspiración para la configuración de Waybar -[aquí](https://github.com/justinlime/dotfiles).** - - - -**Tercera opción de waybar** - - + +
+📸 Más capturas de pantalla + +### Temas de Waybar + + + + + +### Integración de Noctalia Shell + + + + + + + + + +### Características adicionales + + + + + +
+ +
+ ### Chuletas y Guías - Guía para Principiantes de Nix: [English](cheatsheets/nix-beginner-guide.md) | [Español](cheatsheets/nix-beginner-guide.es.md) - Guía de Personalización de Hyprland: [English](cheatsheets/hyprland-customization-guide.md) | [Español](cheatsheets/hyprland-customization-guide.es.md) -### Ten en cuenta: - -> **Este proyecto tiene un [Wiki](https://zaney.org/wiki/zaneyos-2.3/). ¡Aprende a usar ZaneyOS aquí!** -> **ddubs ha puesto mucho esfuerzo en el -> [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq), así que debería ser preciso. -> Sin embargo, si notas que algo está mal, crea un issue o contáctanos en Discord.** - #### 🍖 Requisitos - Debes estar ejecutando NixOS, versión 23.11+. @@ -69,13 +82,6 @@ Incluye el fondo de pantalla, scripts, aplicaciones, archivos de configuración - Muchas personas pacientes y con ganas de ayudar te apoyan usando ZaneyOS. - No dudes en pasar por el Discord para pedir ayuda. -
- -Hazte un favor y -[lee el wiki](https://zaney.org/wiki/zaneyos-2.3/). - -
- #### 📦 ¿Cómo instalo paquetes? - Puedes buscar en [Nix Packages](https://search.nixos.org/packages?) y @@ -89,19 +95,23 @@ Hazte un favor y - Siéntete libre de abrir un issue en el repo. Por favor etiqueta las solicitudes de funcionalidades comenzando el título con [feature request], ¡gracias! -- Contáctanos también en [Discord](https://discord.gg/2cRdBs8) para una respuesta potencialmente más rápida. - -- No olvides revisar el [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq) +- Contáctanos también en [Discord](https://discord.gg/XhZmNTnhtp) para una respuesta potencialmente más rápida. # Atajos de Hyprland -A continuación los atajos de Hyprland, en formato de referencia rápida. +A continuación los atajos de Hyprland, en formato de referencia rápida. La columna de la derecha muestra atajos específicos de **Noctalia Shell** (solo disponibles cuando `barChoice = "noctalia"`). -## Lanzamiento de aplicaciones + + + + + +
+ +## Atajos estándar + +### Lanzamiento de aplicaciones - `$modifier + Return` → Lanzar `terminal` +- `$modifier + Tab` → Alternar `Quickshell Overview` (visor de espacios con vistas en vivo) - `$modifier + K` → Listar atajos -- `$modifier + Shift + Return` → Lanzar `rofi-launcher` - `$modifier + Shift + W` → Abrir `web-search` - `$modifier + Alt + W` → Abrir `wallsetter` - `$modifier + Shift + N` → Ejecutar `swaync-client -rs` @@ -109,15 +119,14 @@ A continuación los atajos de Hyprland, en formato de referencia rápida. - `$modifier + Y` → Abrir `kitty` con `yazi` - `$modifier + E` → Abrir `emopicker9000` - `$modifier + S` → Tomar captura de pantalla -- `$modifier + D` → Abrir `Discord` +- `$modifier + Shift + D` → Abrir `Discord` - `$modifier + O` → Lanzar `OBS Studio` -- `$modifier + C` → Ejecutar `hyprpicker -a` +- `$modifier + Alt + C` → Selector de color - `$modifier + G` → Abrir `GIMP` -- `$modifier + V` → Historial del portapapeles con `cliphist` - `$modifier + T` → Alternar terminal con `pypr` -- `$modifier + M` → Abrir `pavucontrol` +- `$modifier + Alt + M` → Abrir `pavucontrol` -## Gestión de ventanas +### Gestión de ventanas - `$modifier + Q` → Cerrar ventana activa - `$modifier + P` → Alternar pseudo tiling @@ -127,30 +136,63 @@ A continuación los atajos de Hyprland, en formato de referencia rápida. - `$modifier + Alt + F` → Flotar todas las ventanas - `$modifier + Shift + C` → Salir de Hyprland -## Movimiento de ventanas +### Movimiento de ventanas -- `$modifier + Shift + ← / → / ↑ / ↓` → Mover ventana izq./der./arriba/abajo -- `$modifier + Shift + H / L / K / J` → Mover ventana izq./der./arriba/abajo -- `$modifier + Alt + ← / → / ↑ / ↓` → Intercambiar ventana izq./der./arriba/abajo -- `$modifier + Alt + 43 / 46 / 45 / 44` → Intercambiar ventana izq./der./arriba/abajo +- `$modifier + Shift + ← / → / ↑ / ↓` → Mover izq./der./arriba/abajo +- `$modifier + Shift + H / L / K / J` → Mover izq./der./arriba/abajo +- `$modifier + Alt + ← / → / ↑ / ↓` → Intercambiar izq./der./arriba/abajo -## Movimiento de foco +### Movimiento de foco - `$modifier + ← / → / ↑ / ↓` → Mover foco izq./der./arriba/abajo - `$modifier + H / L / K / J` → Mover foco izq./der./arriba/abajo -## Espacios de trabajo +### Espacios de trabajo - `$modifier + 1-10` → Cambiar al espacio 1-10 - `$modifier + Shift + Space` → Mover ventana a espacio especial - `$modifier + Space` → Alternar espacio especial - `$modifier + Shift + 1-10` → Mover ventana al espacio 1-10 -- `$modifier + Control + → / ←` → Cambiar espacio hacia adelante/atrás +- `$modifier + Control + → / ←` → Cambiar espacio adelante/atrás -## Ciclo de ventanas +### Ciclo de ventanas -- `Alt + Tab` → Ir a la siguiente ventana -- `Alt + Tab` → Traer la ventana activa al frente +- `Alt + Tab` → Ir a siguiente ventana / Traer activa al frente + + + +## 🎨 Atajos de Noctalia Shell + +_Disponibles cuando `barChoice = "noctalia"` en `variables.nix`_ + +- `$modifier + D` → Alternar iniciador +- `$modifier + Shift + Return` → Alternar iniciador +- `$modifier + M` → Menú de notificaciones +- `$modifier + V` → Gestor de portapapeles +- `$modifier + Alt + P` → Panel de configuración +- `$modifier + Shift + ,` → Panel de configuración +- `$modifier + Alt + L` → Bloquear pantalla +- `$modifier + Shift + Y` → Gestor de fondos +- `$modifier + X` → Menú de energía +- `$modifier + C` → Centro de control +- `$modifier + Ctrl + R` → Grabadora de pantalla + +### Iniciador Rofi (Modo Waybar) + +_Disponible cuando `barChoice = "waybar"` en `variables.nix`_ + +- `$modifier + D` → Lanzar Rofi +- `$modifier + Shift + Return` → Lanzar Rofi + +### Otras características + +- `$modifier + Shift + Return` (Waybar) → Iniciador de aplicaciones +- `$modifier + V` (Waybar) → Historial del portapapeles con `cliphist` + +
## Instalación: @@ -182,7 +224,7 @@ Luego: ![Comando del script de instalación de ZaneyOS](img/install-script.jpg) ``` -sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/stable-2.3/install-zaneyos.sh) +sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/main/install-zaneyos.sh) ``` #### El proceso de instalación se verá así: @@ -213,7 +255,7 @@ nix-shell -p git vim 2. Clona este repo y entra: ``` -cd && git clone https://gitlab.com/zaney/zaneyos.git -b stable-2.3 ~/zaneyos +cd && git clone https://gitlab.com/zaney/zaneyos.git -b main --depth=1 ~/zaneyos cd zaneyos También puedes ejecutar el script `install.sh` si quieres. @@ -238,10 +280,10 @@ git add . nixos-generate-config --show-hardware-config > hosts//hardware.nix ``` -7. Ejecuta esto para habilitar flakes e instalar, reemplazando hostname por el perfil (p. ej. `intel`, `nvidia`, `nvidia-laptop` o `vm`): +7. Ejecuta esto para habilitar flakes e instalar, reemplazando hostname por el perfil (p. ej. `intel`, `nvidia`, `nvidia-laptop`, `amd-hybrid` o `vm`): ``` -NIX_CONFIG="experimental-features = nix-command flakes" +NIX_CONFIG="experimental-features = nix-command flakes" sudo nixos-rebuild switch --flake .#profile ``` @@ -249,66 +291,13 @@ Ahora, cuando quieras reconstruir, tienes el alias `fr` que reconstruye el flake
-## Actualizar de ZaneyOS 2.3 a 2.4 - -> **🚀 IMPORTANTE:** Si ya tienes ZaneyOS 2.3, usa el sistema de actualización automatizado en lugar de reinstalar. - -### ✅ Proceso de actualización automatizado: - -ZaneyOS incluye un sistema de actualización completo que migra tu configuración de forma segura: - -```bash -cd ~/zaneyos -./upgrade-2.3-to-2.4.sh -``` - -### 🔍 ¿Qué hace el sistema de actualización? - -1. **Análisis previo**: Escaneo integral de tus personalizaciones -2. **Respaldo completo**: Copia total de tu configuración actual -3. **Migración automática**: Conserva todos tus ajustes y personalizaciones -4. **Actualización segura**: Usa la opción `boot` para evitar conflictos del gestor de acceso -5. **Reversión fácil**: Un solo comando si algo sale mal - -### 📋 ¿Qué se migra automáticamente? - -- ✅ Todas las configuraciones y variables de hosts -- ✅ Configuraciones de hardware -- ✅ Paquetes personalizados (globales y por host) -- ✅ Temas, fondos y ajustes de monitores -- ✅ Configuración de Git y preferencias personales -- ✅ Preferencias de terminal con habilitación automática - -### ⚠️ Qué requiere atención manual - -- Entradas personalizadas en flake.nix -- Archivos de configuración personal del shell (zshrc-personal.nix, etc.) -- Modificaciones de módulos personalizados - -### 📚 Documentación completa - -Para instrucciones detalladas, solución de problemas y seguridad: - -- **Lee**: `UPGRADE-2.3-to-2.4.md` en tu directorio zaneyos -- **Informe de análisis**: Guardado automáticamente como `~/zaneyos-upgrade-analysis-TIMESTAMP.txt` - -### 🔄 Reversión sencilla - -Si algo falla, vuelve a 2.3 fácilmente: - -```bash -cd ~/zaneyos -./upgrade-2.3-to-2.4.sh --revert -``` - ---- - ### Reconocimientos especiales: Gracias por toda su ayuda +- KoolDots https://github.com/LinuxBeginnings - Jakookit https://github.com/jakookit -- Justaguylinux https://github.com/drewgrif +- Justaguylinux https://codeberg.org/Justaguylinux - Jerry Starke https://github.com/JerrySM64 ## ¡Disfruta! diff --git a/README.md b/README.md index e4f8423..375ced2 100644 --- a/README.md +++ b/README.md @@ -4,24 +4,49 @@ ## ZaneyOS 🟰 Best ❄️ NixOS Configs -** Updated: June 3rd,2025 +\*\* Updated: January 16th, 2026 ZaneyOS is a simple way of reproducing my configuration on any NixOS system. This includes the wallpaper, scripts, applications, config files, and more. - +## Important Note on Noctalia -**Inspiration for the Waybar config -[here](https://github.com/justinlime/dotfiles).** +> The first time you login, screen will be blank SUPER + SHIFT + C to exit. +> Login in, noctalia will start from then on - - -**Third waybar option** - - + +
+📸 More Screenshots + +### Waybar Themes + + + + + +### Noctalia Shell Integration + + + + + + + + + +### Additional Features + + + + + +
+ +
+ ### Cheatsheets and Guides - Nix Beginner Guide: [English](cheatsheets/nix-beginner-guide.md) | @@ -30,17 +55,9 @@ This includes the wallpaper, scripts, applications, config files, and more. [English](cheatsheets/hyprland-customization-guide.md) | [Español](cheatsheets/hyprland-customization-guide.es.md) -### Please note: - -> **This project has a [Wiki](https://zaney.org/wiki/zaneyos-2.3/). Find out how -> to use ZaneyOS here!** **ddubs has put a lot of effort into the -> [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq) so it should be accurate. -> However, please if you notice that something is wrong with it create an issue -> or reach out to us on Discord.** - #### 🍖 Requirements -- You must be running on NixOS, version 23.11+. +- You must be running on NixOS, version 24.05+. - The `zaneyos` folder (this repo) is expected to be in your home directory. - You must have installed NIXOS using **GPT** parition with booting with **UEFI**. @@ -59,7 +76,7 @@ This includes the wallpaper, scripts, applications, config files, and more. #### 🏇 Optimized Workflow & Simple Yet Elegant Neovim - Using Hyprland for increased elegance, functionality, and efficiency. -- No massive NeoVIM project here. This is my simple, easy to understand, yet +- No massive NeoVIM project here, using `nixvim` for an incredible NeoVIM setup. With language support already added in. #### 🖥️ Multi Host & User Configuration @@ -77,13 +94,6 @@ This includes the wallpaper, scripts, applications, config files, and more. running ZaneyOS. - Feel free to reach out on the Discord for any help with anything. -
- -Please do yourself a favor and -[read the wiki](https://zaney.org/wiki/zaneyos-2.3/). - -
- #### 📦 How To Install Packages? - You can search the [Nix Packages](https://search.nixos.org/packages?) & @@ -98,20 +108,26 @@ Please do yourself a favor and - Please feel free to raise an issue on the repo, please label a feature request with the title beginning with [feature request], thank you! -- Contact us on [Discord](https://discord.gg/2cRdBs8) as well, for a potentially +- Contact us on [Discord](https://discord.gg/XhZmNTnhtp) as well, for a potentially faster response. -- Don't forget to checkout the [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq) - # Hyprland Keybindings -Below are the keybindings for Hyprland, formatted for easy reference. +Below are the keybindings for Hyprland, formatted for easy reference. The right +column shows keybindings that are specific to **Noctalia Shell** (only available +when `barChoice = "noctalia"`). -## Application Launching + + + + + +
+ +## Standard Keybindings + +### Application Launching - `$modifier + Return` → Launch `terminal` +- `$modifier + Tab` → Toggle `Quickshell Overview` (workspace overview with live previews) - `$modifier + K` → List keybinds -- `$modifier + Shift + Return` → Launch `rofi-launcher` - `$modifier + Shift + W` → Open `web-search` - `$modifier + Alt + W` → Open `wallsetter` - `$modifier + Shift + N` → Run `swaync-client -rs` @@ -119,15 +135,14 @@ Below are the keybindings for Hyprland, formatted for easy reference. - `$modifier + Y` → Open `kitty` with `yazi` - `$modifier + E` → Open `emopicker9000` - `$modifier + S` → Take a screenshot -- `$modifier + D` → Open `Discord` +- `$modifier + Shift + D` → Open `Discord` - `$modifier + O` → Launch `OBS Studio` -- `$modifier + C` → Run `hyprpicker -a` +- `$modifier + Alt + C` → Color Picker - `$modifier + G` → Open `GIMP` -- `$modifier + V` → Show clipboard history via `cliphist` - `$modifier + T` → Toggle terminal with `pypr` -- `$modifier + M` → Open `pavucontrol` +- `$modifier + Alt + M` → Open `pavucontrol` -## Window Management +### Window Management - `$modifier + Q` → Kill active window - `$modifier + P` → Toggle pseudo tiling @@ -137,19 +152,18 @@ Below are the keybindings for Hyprland, formatted for easy reference. - `$modifier + Alt + F` → Float all windows - `$modifier + Shift + C` → Exit Hyprland -## Window Movement +### Window Movement -- `$modifier + Shift + ← / → / ↑ / ↓` → Move window left/right/up/down -- `$modifier + Shift + H / L / K / J` → Move window left/right/up/down -- `$modifier + Alt + ← / → / ↑ / ↓` → Swap window left/right/up/down -- `$modifier + Alt + 43 / 46 / 45 / 44` → Swap window left/right/up/down +- `$modifier + Shift + ← / → / ↑ / ↓` → Move left/right/up/down +- `$modifier + Shift + H / L / K / J` → Move left/right/up/down +- `$modifier + Alt + ← / → / ↑ / ↓` → Swap left/right/up/down -## Focus Movement +### Focus Movement - `$modifier + ← / → / ↑ / ↓` → Move focus left/right/up/down - `$modifier + H / L / K / J` → Move focus left/right/up/down -## Workspaces +### Workspaces - `$modifier + 1-10` → Switch to workspace 1-10 - `$modifier + Shift + Space` → Move window to special workspace @@ -157,17 +171,51 @@ Below are the keybindings for Hyprland, formatted for easy reference. - `$modifier + Shift + 1-10` → Move window to workspace 1-10 - `$modifier + Control + → / ←` → Switch workspace forward/backward -## Window Cycling +### Window Cycling -- `Alt + Tab` → Cycle to next window -- `Alt + Tab` → Bring active window to top +- `Alt + Tab` → Cycle to next window / Bring active to top + + + +## 🎨 Noctalia Shell Keybindings + +_Available when `barChoice = "noctalia"` in `variables.nix`_ + +- `$modifier + D` → Launcher Toggle +- `$modifier + Shift + Return` → Launcher Toggle +- `$modifier + M` → Notifications Menu +- `$modifier + V` → Clipboard Manager +- `$modifier + Alt + P` → Settings Panel +- `$modifier + Shift + ,` → Settings Panel +- `$modifier + Alt + L` → Lock Screen +- `$modifier + Shift + Y` → Wallpaper Manager +- `$modifier + X` → Power Menu +- `$modifier + C` → Control Center +- `$modifier + Ctrl + R` → Screen Recorder + +### Rofi Launcher (Waybar Mode) + +_Available when `barChoice = "waybar"` in `variables.nix`_ + +- `$modifier + D` → Launch Rofi Launcher +- `$modifier + Shift + Return` → Launch Rofi Launcher + +### Other Features + +- `$modifier + Shift + Return` (Waybar) → Application Launcher +- `$modifier + V` (Waybar) → Clipboard History via `cliphist` + +
## Installation: > **⚠️ IMPORTANT:** These installation methods are for **NEW INSTALLATIONS > ONLY**. If you already have ZaneyOS installed and want to upgrade to v2.4, see -> the [Upgrade Instructions](#upgrading-from-zaneyos-23-to-24) below. Note: Do -> NOT use upgrade script at this time. It will be restored later. +> the [Upgrade Instructions](#upgrading-from-zaneyos-23-to-24) below. Note: +> There is an issue with upgrade script. It's been removed until it's fixed.
⬇️ Install with script (NEW INSTALLATIONS ONLY) @@ -197,7 +245,7 @@ Then: ![ZaneyOS Install Script Command](img/install-script.jpg) ``` -sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/stable-2.3/install-zaneyos.sh) +sh <(curl -L https://gitlab.com/Zaney/zaneyos/-/raw/main/install-zaneyos.sh) ``` #### The install process will look something like this: @@ -228,7 +276,7 @@ nix-shell -p git vim 2. Clone this repo & enter it: ``` -cd && git clone https://gitlab.com/zaney/zaneyos.git -b stable-2.3 ~/zaneyos +cd && git clone https://gitlab.com/zaney/zaneyos.git -b main --depth=1 ~/zaneyos cd zaneyos You can still run the `install.sh` script if you want to. @@ -243,93 +291,33 @@ cp -r hosts/default hosts/ git add . ``` -4. Edit `hosts//variables.nix`. +4. Edit `hosts//variables.nix` + ```nixos-generate-config --show-hardware-config > hosts//hardware.nix``` -5. Edit `flake.nix` and fill in your username, profile, and hostname. - -6. Generate your hardware.nix like so: - -``` -nixos-generate-config --show-hardware-config > hosts//hardware.nix ``` 7. Run this to enable flakes and install the flake replacing hostname with - profile. I.e. `intel`, `nvidia` `nvidia-laptop`, or `vm` + profile. I.e. `intel`, `nvidia`, `nvidia-laptop`, `amd-hybrid`, or `vm` ``` -NIX_CONFIG="experimental-features = nix-command flakes" + +NIX_CONFIG="experimental-features = nix-command flakes" sudo nixos-rebuild switch --flake .#profile + ``` Now when you want to rebuild the configuration you have access to an alias called `fr` that will rebuild the flake and you do not have to be in the `zaneyos` folder for it to work. -
- -## Upgrading from ZaneyOS 2.3 to 2.4 -- Do NOT use the upgrade script at this timel. - -> **🚀 IMPORTANT:** If you already have ZaneyOS 2.3 installed, use the automated -> upgrade system instead of reinstalling! - -### ✅ Automated Upgrade Process: - -ZaneyOS includes a comprehensive upgrade system that safely migrates your -configuration: - -```bash -cd ~/zaneyos -./upgrade-2.3-to-2.4.sh -``` - -### 🔍 What the Upgrade System Does: - -1. **Pre-Upgrade Analysis** - Comprehensive scan of your customizations -2. **Complete Backup** - Full backup of your current configuration -3. **Automatic Migration** - Preserves all your settings and customizations -4. **Safe Upgrade** - Uses `boot` option to prevent display manager conflicts -5. **Easy Revert** - One-command rollback if needed - -### 📋 What Gets Automatically Migrated: - -- ✅ All host configurations and variables -- ✅ Hardware configurations -- ✅ Custom packages (both global and per-host) -- ✅ Themes, wallpapers, and monitor settings -- ✅ Git configuration and personal settings -- ✅ Terminal preferences with automatic enabling - -### ⚠️ What Requires Manual Attention: - -- Custom flake.nix inputs -- Personal shell configuration files (zshrc-personal.nix, etc.) -- Custom module modifications - -### 📚 Complete Documentation: - -For detailed upgrade instructions, troubleshooting, and safety information: - -- **Read**: `UPGRADE-2.3-to-2.4.md` in your zaneyos directory -- **Analysis Report**: Saved automatically as - `~/zaneyos-upgrade-analysis-TIMESTAMP.txt` - -### 🔄 Easy Revert: - -If anything goes wrong, easily revert to 2.3: - -```bash -cd ~/zaneyos -./upgrade-2.3-to-2.4.sh --revert -``` - ---- - ### Special Recognitions: Thank you for all your assistance -- Jakookit https://github.com/jakookit -- Justaguylinux https://github.com/drewgrif +- KoolDots https://github.com/LinuxBeginnings +- JakKoolit https://github.com/Jakoolit +- Justaguylinux https://codeberg.org/Justaguylinux - Jerry Starke https://github.com/JerrySM64 ## Hope you enjoy! +``` diff --git a/WARP.md b/WARP.md new file mode 100644 index 0000000..abdb5a9 --- /dev/null +++ b/WARP.md @@ -0,0 +1,83 @@ +# WARP.md + +This file provides guidance to WARP (warp.dev) when working with code in this repository. + +Project: ZaneyOS — NixOS flake for desktop systems with per-host overrides, GPU/VM profiles, and an integrated Home Manager layer. + +Important repo expectations +|- This repo is expected at: ~/zaneyos (programs.nh.flake points here). If you keep it elsewhere, update modules/core/nh.nix accordingly. +|- Target OS: NixOS 23.11+; UEFI + GPT expected; systemd-boot is supported out of the box (see README for details). + +Common commands +|- Rebuild and switch (preferred via nh/zcli) + - fr # zsh alias → nh os switch --hostname + - fu # zsh alias → nh os switch --hostname --update + - zcli rebuild [--dry|--ask|--cores N|--verbose|--no-nom] + - zcli update [--dry|--ask|--cores N|--verbose|--no-nom] +|- Rebuild for next boot (safer for bigger changes) + - zcli rebuild-boot [same options] + - sudo nixos-rebuild boot --flake .# +|- Direct NixOS (without nh/zcli) + - sudo nixos-rebuild switch --flake .# +|- Validate the flake + - nix flake check +|- Format Nix files (nixfmt-rfc-style is included) + - find . -name "*.nix" -print0 | xargs -0 nixfmt +|- Configuration comparison (compare against upstream) + - ./modules/src/compare-zaneyos-config.sh # compares against official repo + - ./modules/src/compare-zaneyos-config.sh --branch stable-2.4 # specific branch +|- Host management (zcli) + - zcli update-host [hostname] [profile] # auto-detect if args omitted + - zcli add-host [profile] # copies hosts/default, can gen hardware.nix + - zcli del-host +|- Diagnostics and maintenance + - zcli diag # writes ~/diag.txt + - zcli cleanup # prunes generations (interactive) + - zcli trim # runs fstrim with confirmation +|- 2.3 → 2.4 upgrade (existing installs) + - ./upgrade-2.3-to-2.4.sh # automated analysis, backup, and upgrade + - ./upgrade-2.3-to-2.4.sh --revert + +Notes on profiles and hosts +|- Profiles represent hardware targets: amd, intel, nvidia, nvidia-laptop (intel+NVIDIA hybrid), amd-hybrid (AMD+NVIDIA hybrid), vm. +|- Use the profile in flake targets like .#vm or .#nvidia, or via nh's --hostname. +|- Host-specific settings live under hosts//; variables.nix holds UX and feature toggles: barChoice (noctalia or waybar), waybarChoice (when barChoice="waybar"), clock24h, etc. + +High-level architecture (big picture) +|- flake.nix + - Inputs: nixpkgs 25.11, home-manager 25.11, stylix, nvf, nix-flatpak, noctalia; nixvim and quickshell are included but currently inactive (uncommitted to outputs). + - Defines system, host, profile, username; constructs nixosConfigurations via mkNixosConfig. + - Each configuration imports profiles/. +- profiles//default.nix + - Imports host and stacks: ../../hosts/${host}, ../../modules/drivers, ../../modules/core. + - Toggles drivers and VM guest services per profile; the nvidia-laptop and amd-hybrid profiles consume Bus IDs from host variables. +- hosts// + - default.nix imports hardware.nix and host-packages.nix. + - variables.nix is the primary control surface (display manager, terminal/browser defaults, waybarChoice, stylix image, 24h clock, Thunar/printing/NFS flags, intel/nvidia Bus IDs, etc.). +|- modules/core + - Composes NixOS modules: boot, flatpak, fonts, hardware, network, nfs, nh, quickshell, packages, printing, display manager (greetd/sddm), security, services (PipeWire/SSH/Bluetooth/fstrim; smartd conditional), steam, stylix, syncthing, system (nix settings, locales, env), thunar, user (Home Manager), virtualization, xserver. + - quickshell.nix installs quickshell with Qt6 dependencies and required environment variables (needed for noctalia-shell). + - nh.nix enables nh and pins programs.nh.flake to ~/zaneyos. + - user.nix integrates Home Manager and creates users.${username}, passing { inputs, username, host, profile } to the home layer. +- modules/drivers + - AMD, Intel, NVIDIA, NVIDIA Prime, NVIDIA AMD-Hybrid, and VM guest services; nvidia-prime options (enable, intelBusID, nvidiaBusID) are consumed by the nvidia-laptop profile; nvidia-amd-hybrid options (enable, amdgpuBusID, nvidiaBusID) are consumed by the amd-hybrid profile. +|- modules/home + - Composes the user environment: Hyprland, bar/shell choice (noctalia-shell or Waybar via barChoice), Rofi, Yazi, terminals (Kitty/WezTerm/Ghostty/Alacritty toggles), Zsh/Bash config, Git, NVF/Neovim, OBS, swaync, scripts, Stylix, optional Doom Emacs/VSCodium/Helix. + - default.nix conditionally imports barModule: either noctalia.nix (when barChoice="noctalia") or waybarChoice (when barChoice="waybar"). + - noctalia.nix installs noctalia-shell and seeds ~/.config/quickshell/noctalia-shell from the package distribution. + - scripts/default.nix installs zcli; zcli wraps rebuild/update/boot, cleanup, diagnostics, host management, and Doom lifecycle. +- Shell aliases (zsh) + - fr and fu are defined in modules/home/zsh/default.nix, parameterized by the active profile. + +Key development choices +- Repo location matters: nh and zcli assume ~/zaneyos; move it and adjust modules/core/nh.nix. +- Validation is via nix flake check; there is no separate unit test suite. +- Formatting is via nixfmt-rfc-style (provided in system packages). + +Useful docs in-repo +- README.md: requirements, install and upgrade overview (including the 2.3→2.4 process). +- zcli.md: full CLI docs, commands, options, and examples. +- cheatsheets/project-guide.md: quick commands, architecture summary, and common workflows. +- cheatsheets/: Hyprland and terminal/editor quick references. + + diff --git a/cheatsheets/README.es.md b/cheatsheets/README.es.md new file mode 100644 index 0000000..7f4ec67 --- /dev/null +++ b/cheatsheets/README.es.md @@ -0,0 +1,66 @@ +[English](./README.md) | Español + +# Índice de Cheatsheets (ZaneyOS) +Estos documentos cubren tanto el uso general como la configuración específica definida en la configuración de NixOS "ZaneyOS". + +- Uso general: Consejos prácticos centrados en tareas y los principales flujos de trabajo. +- Específicos de ZaneyOS: Notas que reflejan cómo se configuran las herramientas en este repositorio (modules/home/*) para que el comportamiento coincida con su sistema. + +## 🔗 Enlaces Rápidos +- Emacs + - [Los 10 mejores consejos para empezar](emacs/emacs.getting-started.top10.md) + - [Explorador de archivos](emacs/emacs.file-explorer.cheatsheet.md) + - [Autocompletado de código](emacs/emacs.code-completion.cheatsheet.md) + - [Magit (Git)](emacs/emacs.magit.cheatsheet.md) + - [Markdown](emacs/emacs.markdown.cheatsheet.md) +- Ghostty + - [Cheatsheet de Ghostty](ghostty/ghostty.cheatsheet.md) +- Tmux + - [Cheatsheet de Tmux](tmux/tmux.cheatsheet.md) +- Alacritty + - [Cheatsheet de Alacritty](alacritty/alacritty.cheatsheet.md) +- Kitty + - [Cheatsheet de Kitty](kitty/kitty.cheatsheet.md) +- WezTerm + - [Cheatsheet de WezTerm](wezterm/wezterm.cheatsheet.md) +- Hyprland + - [Atajos de teclado](hyprland/hyprland.binds.cheatsheet.md) + - [Reglas de ventana](hyprland/hyprland.windowrules.cheatsheet.md) +- Yazi + - [Mapa de teclas](yazi/yazi.keymap.cheatsheet.md) + +## 📚 Cómo usar +- Navegue por el área que le interese (por ejemplo, Emacs, Ghostty). +- Comience con los documentos de "primeros pasos" o "consejos principales" para obtener resultados rápidos. +- Consulte las cheatsheets específicas de cada herramienta para los comandos diarios y luego verifique cualquier configuración específica de ZaneyOS. + +## 📂 Árbol de Directorios + +``` +cheatsheets/ +├── emacs/ +│ ├── emacs.code-completion.cheatsheet.md +│ ├── emacs.file-explorer.cheatsheet.md +│ ├── emacs.getting-started.top10.md +│ ├── emacs.magit.cheatsheet.md +│ └── emacs.markdown.cheatsheet.md +├── ghostty/ +│ └── ghostty.cheatsheet.md +├── tmux/ +│ └── tmux.cheatsheet.md +├── alacritty/ +│ └── alacritty.cheatsheet.md +├── kitty/ +│ └── kitty.cheatsheet.md +├── wezterm/ +│ └── wezterm.cheatsheet.md +├── hyprland/ +│ ├── hyprland.binds.cheatsheet.md +│ └── hyprland.windowrules.cheatsheet.md +└── yazi/ + └── yazi.keymap.cheatsheet.md +``` + +## 🛠️ Notas +- El cheatsheet de Ghostty refleja los atajos de teclado de modules/home/terminals/ghostty.nix (ZaneyOS). +- Los documentos de Emacs siguen el mismo estilo de markdown para mayor consistencia y una lectura rápida. diff --git a/cheatsheets/README.md b/cheatsheets/README.md index 23eee44..c4c901c 100644 --- a/cheatsheets/README.md +++ b/cheatsheets/README.md @@ -1,9 +1,10 @@ -# Cheatsheets Index (ddubsOS) +English | [Español](./README.es.md) -These documents cover both general usage and the specific configuration as defined in the NixOS configuration "ddubsOS". +# Cheatsheets Index (ZaneyOS) +These documents cover both general usage and the specific configuration as defined in the NixOS configuration "ZaneyOS". - General use: Practical, task-focused tips and top workflows. -- ddubsOS specifics: Notes reflecting how tools are configured in this repository (modules/home/*) so behavior matches your system. +- ZaneyOS specifics: Notes reflecting how tools are configured in this repository (modules/home/*) so behavior matches your system. ## 🔗 Quick Links - Emacs @@ -31,7 +32,7 @@ These documents cover both general usage and the specific configuration as defin ## 📚 How to use - Browse the area you care about (e.g., Emacs, Ghostty). - Start with the “getting started” or “top tips” docs for quick wins. -- Refer to tool-specific cheatsheets for day-to-day commands, then cross-check any ddubsOS-specific settings. +- Refer to tool-specific cheatsheets for day-to-day commands, then cross-check any ZaneyOS-specific settings. ## 📂 Directory Tree @@ -61,6 +62,5 @@ cheatsheets/ ``` ## 🛠️ Notes -- Ghostty cheatsheet reflects bindings from modules/home/terminals/ghostty.nix (ddubsOS). +- Ghostty cheatsheet reflects bindings from modules/home/terminals/ghostty.nix (ZaneyOS). - Emacs docs follow the same markdown style for consistency and quick scanning. - diff --git a/cheatsheets/add-gnome.md b/cheatsheets/add-gnome.md new file mode 100644 index 0000000..b36cdc5 --- /dev/null +++ b/cheatsheets/add-gnome.md @@ -0,0 +1,58 @@ +# Add GNOME Desktop (overview) + +This guide gives **basic steps** and **which files to edit** to add GNOME to ZaneyOS. + +In NixOS, you enable it through NixOS options in a module (a `.nix` file), then pick a display manager (login screen). +This repo already has **SDDM** (graphical) and **LY** (text) login support. You can keep using either — both can start GNOME sessions. + +## Files to edit (minimal list) + +1. `modules/core/default.nix` + - Import your new GNOME module so it becomes part of the system config. + +2. `modules/core/xserver.nix` + - GNOME needs `services.xserver.enable = true;` (this file currently disables X11). + +3. `modules/core/gnome.nix` (new file you create) + - Turn on GNOME’s desktop manager. + +4. `hosts//variables.nix` + - Make sure your `displayManager` is set to either `"sddm"` or `"tui"` (for LY), since those are already supported here. + +## Suggested minimal GNOME module (example) + +```nix path=null start=null +{ ... }: +{ + services.xserver = { + enable = true; + desktopManager.gnome.enable = true; + }; +} +``` + +## Where to import the GNOME module + +In `modules/core/default.nix`, add your GNOME file to the imports list: + +```nix path=null start=null +imports = [ + # ... + ./gnome.nix + # ... +]; +``` + +## Flatpak: GNOME Extensions Manager + +To add the Flatpak app **Extension Manager** (for GNOME extensions), edit `modules/core/flatpak.nix` and add its ID: + +```nix path=null start=null +services.flatpak.packages = [ + "com.mattjakeman.ExtensionManager" +]; +``` + +## `git add .` and rebuild + +Once you have the file created. In the ZaneyOS directory run `git add . ` then `zcli rebuild` diff --git a/cheatsheets/alacritty/alacritty.cheatsheet.es.md b/cheatsheets/alacritty/alacritty.cheatsheet.es.md new file mode 100644 index 0000000..19bd1eb --- /dev/null +++ b/cheatsheets/alacritty/alacritty.cheatsheet.es.md @@ -0,0 +1,23 @@ +[English](./alacritty.cheatsheet.md) | Español + +# Alacritty en ZaneyOS — Resumen y Cheatsheet +## 🚀 Resumen de modules/home/terminals/alacritty.nix + +- Programa + - Alacritty habilitado. + - Familia de fuentes (predeterminada): Maple NF; tamaño: 15. + - Estilos configurados: Regular, Negrita, Cursiva, Negrita Cursiva. + +--- + +## ⚙️ Opciones Predeterminadas (según configuración) + +Fuente +- normal: Maple NF Regular +- bold: Maple NF Negrita +- italic: Maple NF Cursiva +- bold_italic: Maple NF Negrita Cursiva +- size: 15 + +Notas +- Usa lib.mkDefault para la familia de fuentes, por lo que otros módulos pueden anularla. diff --git a/cheatsheets/alacritty/alacritty.cheatsheet.md b/cheatsheets/alacritty/alacritty.cheatsheet.md index 84164f0..6047f92 100644 --- a/cheatsheets/alacritty/alacritty.cheatsheet.md +++ b/cheatsheets/alacritty/alacritty.cheatsheet.md @@ -1,5 +1,6 @@ -# Alacritty on ddubsOS — Summary & Cheatsheet +English | [Español](./alacritty.cheatsheet.es.md) +# Alacritty on ZaneyOS — Summary & Cheatsheet ## 🚀 Summary of modules/home/terminals/alacritty.nix - Program diff --git a/cheatsheets/emacs/emacs.code-completion.cheatsheet.es.md b/cheatsheets/emacs/emacs.code-completion.cheatsheet.es.md new file mode 100644 index 0000000..1c4d7bc --- /dev/null +++ b/cheatsheets/emacs/emacs.code-completion.cheatsheet.es.md @@ -0,0 +1,129 @@ +[English](./emacs.code-completion.cheatsheet.md) | Español + +# Cheatsheet de Autocompletado y Búsqueda de Código en Doom Emacs +## 🚀 **Lo que Tienes (Como nvim-cmp + blink.cmp)** + +Si tu configuración de Doom incluye: +- **Company Mode** - Framework de autocompletado +- **LSP Mode** - Soporte para el Protocolo de Servidor de Lenguaje +- **Tree-sitter** - Análisis de sintaxis avanzado +- **Herramientas de búsqueda** - Búsqueda de documentación y definiciones + +## ⌨️ **Autocompletado de Código (Company)** + +### **Controles de Autocompletado:** +- `TAB` o `C-SPC` - **Aceptar autocompletado** +- `C-n` / `j` - **Siguiente autocompletado** (modo evil) +- `C-p` / `k` - **Anterior autocompletado** (modo evil) +- `C-w` - **Mostrar documentación** para el autocompletado +- `C-s` - **Buscar/filtrar autocompletados** +- `ESC` o `C-g` - **Cancelar autocompletado** + +### **Autocompletado Manual:** +- `M-/` - **Completar en el punto** (disparador manual) +- `C-M-/` - **Expandir abreviatura** + +## 🔍 **Búsqueda y Navegación de Código** + +### **Ir a Definición/Referencias:** +- `gd` - **Ir a la definición** (modo evil) +- `gD` - **Ir a la declaración** +- `gr` - **Ir a las referencias** +- `SPC c d` - **Buscar definición** +- `SPC c D` - **Buscar referencias** +- `SPC c i` - **Buscar implementaciones** + +### **Búsqueda de Documentación:** +- `K` - **Buscar documentación** (modo evil) +- `SPC c k` - **Buscar documentación** +- `SPC c K` - **Buscar en conjuntos de documentos** +- `C-h f` - **Describir función** +- `C-h v` - **Describir variable** + +### **Navegación de Símbolos:** +- `SPC c j` - **Saltar a símbolo en el búfer** +- `SPC c J` - **Saltar a símbolo en el proyecto** +- `SPC s i` - **Buscar símbolo** + +## 🛠️ **Características de LSP (Servidor de Lenguaje)** + +### **Acciones de LSP:** +- `SPC c a` - **Acciones de código** (refactorizar, arreglar, etc.) +- `SPC c r` - **Renombrar símbolo** +- `SPC c f` - **Formatear búfer/región** +- `SPC c o` - **Organizar importaciones** + +### **Navegación de Errores:** +- `]e` - **Siguiente error** +- `[e` - **Error anterior** +- `SPC c x` - **Listar errores** + +### **Información de LSP:** +- `SPC c l` - **Menú de LSP** +- `SPC c h` - **Mostrar información al pasar el ratón** +- `SPC c s` - **Mostrar firma** + +## 🎯 **Características Específicas del Lenguaje** + +### **C/C++ (clang-tools)** +- Autocompletado completo para funciones, variables, tipos +- Ir a la definición a través de archivos +- Comprobación de errores y diagnósticos +- Formateo de código con clang-format + +### **Nix (nil LSP)** +- Autocompletado del lenguaje Nix +- Documentación de funciones +- Comprobación de sintaxis +- Ir a la definición para expresiones de Nix + +### **JSON (vscode-json-languageserver)** +- Autocompletado basado en esquemas +- Validación y comprobación de errores +- Ir a la definición en archivos JSON + +## ⚡ **Consejos Profesionales** + +### **Búsqueda Difusa en Todo:** +- `SPC f f` - **Buscar archivos** +- `SPC /` - **Buscar en el proyecto** +- `SPC s s` - **Buscar en el búfer** +- `SPC p p` - **Cambiar de proyecto** + +### **Mejor Navegación:** +- `C-o` - **Retroceder** (después de saltar a la definición) +- `C-i` - **Avanzar** +- `SPC j j` - **Saltar a un carácter** (como easymotion) + +### **Ajustes de Autocompletado:** +- Los autocompletados aparecen después de 0.2 segundos de escribir +- Mínimo 1 carácter para activarse +- Muestra la documentación en una ventana emergente +- Funciona tanto con Company como con LSP + +## 🔧 **Solución de Problemas** + +### **Si el autocompletado no funciona:** +1. Comprueba si el servidor LSP se está ejecutando: `SPC c l` +2. Reinicia LSP: `SPC c l r` +3. Comprueba si hay errores de sintaxis: `SPC c x` + +### **Rendimiento:** +- Los servidores LSP se inician automáticamente cuando abres archivos compatibles +- El autocompletado está optimizado para una respuesta rápida +- Usa `SPC h r r` para recargar la configuración de Doom después de los cambios + +## 🚀 **Flujo de Trabajo de Inicio Rápido** + +1. **Abre un archivo de código** (`.c`, `.nix`, `.json`) +2. **Empieza a escribir** - los autocompletados aparecen automáticamente +3. **Navega con `j/k`** y **acepta con `TAB`** +4. **Usa `gd`** para saltar a las definiciones +5. **Usa `K`** para ver la documentación +6. **Usa `SPC c a`** para acciones de código + +## 📚 **Servidores de Lenguaje Incluidos** +- **C/C++**: `clang-tools` (clangd) +- **Nix**: `nil` +- **JSON**: `vscode-json-languageserver` +- ¡Se pueden añadir más por lenguaje según sea necesario! diff --git a/cheatsheets/emacs/emacs.code-completion.cheatsheet.md b/cheatsheets/emacs/emacs.code-completion.cheatsheet.md index d1c074a..ae6069d 100644 --- a/cheatsheets/emacs/emacs.code-completion.cheatsheet.md +++ b/cheatsheets/emacs/emacs.code-completion.cheatsheet.md @@ -1,5 +1,6 @@ -# Doom Emacs Code Completion & Lookup Cheatsheet +English | [Español](./emacs.code-completion.cheatsheet.es.md) +# Doom Emacs Code Completion & Lookup Cheatsheet ## 🚀 **What You Have (Like nvim-cmp + blink.cmp)** If your Doom config includes: diff --git a/cheatsheets/emacs/emacs.file-explorer.cheatsheet.es.md b/cheatsheets/emacs/emacs.file-explorer.cheatsheet.es.md new file mode 100644 index 0000000..36f95bb --- /dev/null +++ b/cheatsheets/emacs/emacs.file-explorer.cheatsheet.es.md @@ -0,0 +1,306 @@ +[English](./emacs.file-explorer.cheatsheet.md) | Español + +# Cheatsheet del Explorador de Archivos de Doom Emacs +## 🗂️ **¿Qué es Dired?** + +Dired (Directory Editor) es el gestor de archivos incorporado de Emacs que te permite navegar, gestionar y manipular archivos y directorios de manera eficiente. +- Navega por los directorios con el teclado +- Marca, copia, mueve y elimina archivos +- Ejecuta comandos en múltiples archivos a la vez +- Se integra con otras herramientas y búferes de Emacs + +## 📋 **Requisitos** +- Doom Emacs (Dired está incorporado) +- **Treemacs**: Debe estar habilitado en `~/.doom.d/init.el` (descomenta la línea `treemacs`) +- Herramientas opcionales para una funcionalidad mejorada: + - `rsync` - Sincronización y copia rápida de archivos + - `fd` o `find` - Búsqueda de archivos mejorada + - `rg` (ripgrep) o `ag` (the_silver_searcher) - Búsqueda rápida de texto + - `exa` o `lsd` - Listados de directorios mejorados + - `trash-cli` - Eliminación segura de archivos a la papelera + - `zip`/`unzip`, `tar`, `gzip` - Manejo de archivos comprimidos + +## ⌨️ **Abriendo Exploradores de Archivos** + +### **Dired (Gestor de Archivos Incorporado):** +- `SPC .` - **Abrir Dired** en el directorio actual +- `SPC f d` - **Buscar directorio** (abrir Dired en una ruta específica) +- `C-x d` - **Abrir Dired** (atajo clásico de Emacs) + +### **Navegación de Archivos del Proyecto:** +- `SPC SPC` - **Buscar archivo** en el proyecto +- `SPC f f` - **Buscar archivo** en cualquier lugar +- `SPC f r` - **Archivos recientes** +- `SPC p f` - **Buscar archivo** en el proyecto + +### **Exploradores en Estilo de Árbol:** +- `SPC o p` - **Alternar barra lateral del proyecto** (Treemacs) +- `SPC f t` - **Buscar archivo** en el árbol + +## 🧭 **Navegación en Dired** + +### **Movimiento Básico:** +- `j/k` o `n/p` - **Moverse arriba/abajo** entre archivos +- `h` - **Subir** un directorio (padre) +- `l` o `RET` - **Entrar en el directorio** o abrir archivo +- `^` - **Ir al directorio padre** +- `g` - **Refrescar** el listado del directorio + +### **Saltando:** +- `gg` - **Ir al principio** del listado +- `G` - **Ir al final** del listado +- `/` - **Buscar** por nombre de archivo/directorio +- `SPC s s` - **Buscar dentro** del directorio + +### **Información del Archivo:** +- `(` - **Alternar detalles** (mostrar/ocultar información del archivo) +- `s` - **Ordenar** archivos (por nombre, fecha, tamaño) +- `C-h m` - **Mostrar ayuda** para el modo actual + +## 📁 **Operaciones con Archivos** + +### **Abriendo Archivos:** +- `RET` - **Abrir archivo** en la ventana actual +- `o` - **Abrir archivo** en otra ventana +- `C-o` - **Abrir archivo** en otra ventana (mantener el cursor en Dired) +- `v` - **Ver archivo** (solo lectura) +- `f` - **Buscar archivo** (igual que RET) + +### **Creando Archivos y Directorios:** +- `+` - **Crear directorio** +- `SPC f c` - **Crear archivo** (cuando estás en el búfer de Dired) +- `C-x C-f` - **Buscar/crear archivo** (desde Dired) + +## 🏷️ **Marcando Archivos** + +### **Marcado Básico:** +- `m` - **Marcar archivo** para operaciones +- `u` - **Desmarcar archivo** +- `U` - **Desmarcar todos** los archivos +- `t` - **Alternar marcas** (marcar los no marcados, desmarcar los marcados) +- `* %` - **Marcar por patrón** de expresión regular + +### **Marcado Rápido:** +- `* .` - **Marcar por extensión** (ej., *.txt) +- `* /` - **Marcar directorios** +- `* @` - **Marcar enlaces simbólicos** +- `* *` - **Marcar ejecutables** + +### **Marcado Avanzado:** +- `% m` - **Marcar archivos** que coincidan con una expresión regular +- `% d` - **Marcar para eliminar** archivos que coincidan con una expresión regular +- `* c` - **Cambiar marcas** (cambiar una marca por otra) + +## ✂️ **Operaciones de Gestión de Archivos** + +### **Copiar, Mover, Eliminar:** +- `C` - **Copiar** archivos marcados (o el archivo bajo el cursor) +- `R` - **Renombrar/Mover** archivos marcados +- `D` - **Eliminar** archivos marcados inmediatamente +- `d` - **Marcar para eliminar** (usa `x` para ejecutar) +- `x` - **Ejecutar eliminaciones** (eliminar archivos marcados con `d`) + +### **Opciones de Eliminación:** +- `d` y luego `x` - **Eliminación segura** (marcar primero, luego ejecutar) +- `D` - **Eliminación inmediata** (omite el paso de marcar) +- **Integración con la papelera**: Si `trash-cli` está instalado, los archivos van a la papelera en lugar de ser eliminados permanentemente + +### **Operaciones Avanzadas:** +- `Z` - **Comprimir/descomprimir** archivos (usa `gzip`, `zip`, `tar` automáticamente) +- `A` - **Buscar** en archivos marcados (usa `grep` o `rg` si está disponible) +- `Q` - **Consultar y reemplazar** en archivos marcados +- `!` - **Ejecutar comando de shell** en archivos marcados +- `&` - **Ejecutar comando de shell asíncrono** en archivos marcados + +## 📋 **Copiando y Moviendo** + +### **Operaciones de Copia:** +- `C` - **Copiar archivos** (solicita el destino) +- Funciona con archivos marcados o un solo archivo bajo el cursor +- Usa `rsync` si está disponible para una copia más rápida y reanudable +- Admite la copia a diferentes unidades/particiones + +### **Operaciones de Mover/Renombrar:** +- `R` - **Renombrar/Mover** archivos +- Puede renombrar archivos individuales o mover múltiples archivos marcados +- Admite el movimiento entre directorios + +### **Consejos para Copiar/Mover:** +- Marca múltiples archivos primero, luego usa `C` o `R` +- El autocompletado con Tab funciona para las rutas de destino +- Usa rutas relativas (`.`, `..`) para una navegación rápida + +## 🔍 **Búsqueda y Filtro** + +### **Encontrando Archivos:** +- `/` - **Buscar** nombres de archivo en el listado actual +- `n/N` - **Siguiente/anterior** coincidencia de búsqueda + +### **Búsqueda Mejorada (con herramientas externas):** +- `A` - **Buscar dentro de los archivos** (usa `rg` > `ag` > `grep` en orden de prioridad) +- Mucho más rápido con `ripgrep` o `the_silver_searcher` +- Admite patrones de expresiones regulares y filtrado por tipo de archivo + +### **Filtrando la Visualización:** +- `(` - **Alternar** vista detallada +- `s` - **Ordenar** por diferentes criterios +- `C-u s` - **Ordenar** con opciones personalizadas + +### **Búsqueda de Contenido:** +- `A` - **Buscar dentro** de los archivos marcados +- `Q` - **Consultar y reemplazar** en los archivos marcados + +## 🔧 **Características Avanzadas** + +### **Wdired (Dired Editable):** +- `C-x C-q` - **Editar nombres de archivo** directamente (como renombrar) +- Edita los nombres de archivo como texto, luego `C-c C-c` para aplicar los cambios +- `C-c C-k` para cancelar las ediciones + +### **Múltiples Ventanas:** +- `o` - **Abrir en otra ventana** +- `C-o` - **Mostrar en otra ventana** (permanecer en Dired) +- `2` - **Dividir la ventana** verticalmente para dos vistas de Dired + +### **Subdirectorios:** +- `i` - **Insertar subdirectorio** en el mismo búfer +- `$` - **Ocultar/mostrar** el contenido del subdirectorio +- `M-$` - **Ocultar todos** los subdirectorios + +## 📊 **Comparación de Archivos** + +### **Operaciones de Diferencias:** +- `=` - **Comparar archivo** con otro +- `M-=` - **Comparar** archivos marcados entre sí +- Funciona con herramientas de diferencias externas + +## 🗜️ **Operaciones con Archivos Comprimidos** + +### **Compresión y Archivos:** +- `Z` - **Comprimir/descomprimir** detecta automáticamente el formato +- Admite: `.gz`, `.zip`, `.tar`, `.tar.gz`, `.tar.xz`, `.7z` +- Usa las herramientas apropiadas: `gzip`, `zip`, `tar`, `7z` + +### **Visualización de Archivos Comprimidos:** +- Abre archivos `.zip`, `.tar`, etc. directamente para navegar por su contenido +- Extrae archivos específicos de los archivos comprimidos + +## 🎛️ **Personalización y Ajustes** + +### **Opciones de Vista:** +- `(` - **Alternar** entre vista simple y detallada +- `s` - **Ciclar** entre los órdenes de clasificación (nombre, fecha, tamaño) +- Listados mejorados con `exa` o `lsd` si están disponibles + +### **Ajustes Útiles:** +- Dired reutiliza los búferes por defecto en Doom +- Actualización automática al cambiar los archivos +- Integración con los atajos de teclado del modo Evil + +## ⚡ **Treemacs (Explorador en Árbol)** + +### **Treemacs Básico:** +- `SPC o p` - **Alternar** la barra lateral de Treemacs +- `j/k` - **Navegar** arriba/abajo en el árbol +- `RET` - **Abrir archivo** o expandir/contraer directorio +- `TAB` - **Expandir/contraer** directorio + +### **Operaciones de Archivo en Treemacs:** +- `cf` - **Crear archivo** +- `cd` - **Crear directorio** +- `R` - **Renombrar** +- `d` - **Eliminar** +- `yy` - **Copiar** la ruta al portapapeles + +## 🚀 **Flujo de Trabajo de Inicio Rápido** + +### **Gestión Básica de Archivos:** +1. **Presiona `SPC .`** - Abre Dired en el directorio actual +2. **Navega con `j/k`** - Muévete entre los archivos +3. **Marca archivos con `m`** - Selecciona múltiples archivos +4. **Usa `C` para copiar** o `R` para mover/renombrar +5. **Presiona `g`** para refrescar cuando termines + +### **Operaciones de Archivo Eficientes:** +1. **Marca múltiples archivos** con `m` +2. **Ejecuta operaciones por lotes** (`C` para copiar, `R` para mover) +3. **Usa `!`** para ejecutar comandos de shell en los archivos marcados +4. **Alterna los detalles con `(`** para más/menos información + +## 📚 **Resumen de Atajos Esenciales** + +| Acción | Tecla | Descripción | +|--------|-----|-------------| +| Abrir Dired | `SPC .` | Abrir explorador de archivos | +| Navegar | `j/k` | Moverse arriba/abajo | +| Entrar/Abrir | `RET` o `l` | Abrir archivo/directorio | +| Directorio Padre | `h` o `^` | Subir un directorio | +| Marcar | `m` | Marcar archivo para operaciones | +| Copiar | `C` | Copiar archivos marcados | +| Mover/Renombrar | `R` | Mover o renombrar archivos | +| Eliminar | `d` y luego `x` | Marcar para eliminar, ejecutar | +| Crear Directorio | `+` | Crear nuevo directorio | +| Comprimir | `Z` | Comprimir/descomprimir | +| Buscar en Archivos | `A` | Buscar dentro de los archivos | +| Refrescar | `g` | Refrescar el listado del directorio | +| Ayuda | `?` | Mostrar comandos disponibles | + +## 🔧 **Solución de Problemas** + +### **Problemas Comunes:** +- **¿El búfer de Dired no se actualiza?** Presiona `g` para refrescar +- **¿No puedes ver los detalles del archivo?** Presiona `(` para alternar la vista detallada +- **¿Las operaciones son lentas?** Usa el marcado (`m`) para operaciones por lotes +- **¿Orden de clasificación incorrecto?** Presiona `s` para ciclar entre las opciones de clasificación + +### **Consejos de Rendimiento:** +- Instala `fd` para una búsqueda de archivos más rápida +- Instala `rg` (ripgrep) para una búsqueda de texto más rápida +- Usa `rsync` para una copia de archivos eficiente +- Considera `exa` o `lsd` para listados de directorios mejorados + +### **Obteniendo Ayuda:** +- `?` - **Ayuda contextual** en cualquier búfer de Dired +- `C-h m` - **Ayuda específica del modo** +- `SPC h d f dired` - **Documentación completa de Dired** + +## 📋 **Comparación: Dired vs Treemacs** + +### **Usa Dired cuando:** +- Gestionas múltiples archivos a la vez +- Necesitas información detallada de los archivos +- Realizas operaciones por lotes +- Trabajas con permisos/propiedad de archivos + +### **Usa Treemacs cuando:** +- Necesitas una vista rápida del proyecto +- Navegación de archivos simple +- Prefieres una estructura de árbol visual +- Necesitas una barra lateral persistente + +## 🛠️ **Integración con Herramientas Externas** + +### **Herramientas Recomendadas:** +- **`rsync`** - Copia de archivos rápida y fiable con capacidad de reanudación +- **`ripgrep` (rg)** - Búsqueda de texto extremadamente rápida, mucho más rápida que grep +- **`fd`** - Alternativa rápida a find con mejores valores predeterminados +- **`exa`** - Reemplazo moderno de ls con colores e integración con git +- **`trash-cli`** - Eliminación segura a la papelera en lugar de eliminación permanente +- **`7z`** - Maneja archivos 7zip y otros formatos de compresión + +### **Instalación (Debian/Ubuntu):** +```bash +sudo apt install rsync ripgrep fd-find exa trash-cli p7zip-full +``` + +## 🎯 **Consejos Profesionales** + +- **Operaciones por lotes**: Marca los archivos primero (`m`), luego ejecuta las operaciones +- **Navegación rápida**: Usa `/` para buscar archivos por nombre +- **Editar nombres de archivo**: Usa `C-x C-q` para el modo Wdired para renombrar múltiples archivos +- **Integración con la shell**: Usa `!` para ejecutar comandos de shell en los archivos +- **Múltiples directorios**: Usa `i` para mostrar subdirectorios en el mismo búfer +- **Eliminación segura**: Instala `trash-cli` para enviar archivos a la papelera en lugar de eliminarlos permanentemente +- **Búsqueda rápida**: Instala `ripgrep` para una búsqueda de texto ultrarrápida en los archivos + +Dired proporciona una experiencia completa de gestión de archivos que se integra bien con herramientas externas de Linux, haciendo que las operaciones con archivos sean eficientes y potentes. diff --git a/cheatsheets/emacs/emacs.file-explorer.cheatsheet.md b/cheatsheets/emacs/emacs.file-explorer.cheatsheet.md index b33bd75..01e8da2 100644 --- a/cheatsheets/emacs/emacs.file-explorer.cheatsheet.md +++ b/cheatsheets/emacs/emacs.file-explorer.cheatsheet.md @@ -1,5 +1,6 @@ -# Doom Emacs File Explorer Cheatsheet +English | [Español](./emacs.file-explorer.cheatsheet.es.md) +# Doom Emacs File Explorer Cheatsheet ## 🗂️ **What is Dired?** Dired (Directory Editor) is Emacs' built-in file manager that allows you to navigate, manage, and manipulate files and directories efficiently. diff --git a/cheatsheets/emacs/emacs.getting-started.top10.es.md b/cheatsheets/emacs/emacs.getting-started.top10.es.md new file mode 100644 index 0000000..bc952a9 --- /dev/null +++ b/cheatsheets/emacs/emacs.getting-started.top10.es.md @@ -0,0 +1,276 @@ +[English](./emacs.getting-started.top10.md) | Español + +# Las 10 Cosas Principales que los Nuevos Usuarios de Doom Emacs Deberían Saber +## 🚀 **Primeros Pasos con Doom Emacs** + +¡Bienvenido a Doom Emacs! Aquí están las 10 cosas más esenciales que todo nuevo usuario debería dominar para ser productivo rápidamente. + +--- + +## 1. 🗝️ **Domina la Tecla Líder: `SPC`** + +**La tecla Espacio es tu puerta de entrada a todo en Doom Emacs.** + +- `SPC` se llama la "tecla líder" - abre menús para casi todas las acciones +- Después de presionar `SPC`, verás sugerencias útiles que muestran los comandos disponibles +- Los comandos están organizados lógicamente: `SPC f` para archivos, `SPC g` para git, `SPC p` para proyectos + +**Comandos esenciales para empezar:** + +- `SPC f f` - Buscar/abrir archivos +- `SPC f s` - Guardar archivo actual +- `SPC q q` - Salir de Emacs +- `SPC h` - Menú de ayuda (¡muy importante!) + +**Consejo Profesional:** Si olvidas lo que sigue, simplemente presiona `SPC` y espera - ¡Doom te mostrará las opciones! + +--- + +## 2. 📁 **Navega por los Archivos como un Profesional** + +**La navegación de archivos es fundamental para la productividad.** + +- `SPC .` - **Abrir explorador de archivos** (Dired) en el directorio actual +- `SPC f f` - **Buscar archivo** en cualquier parte de tu sistema +- `SPC f r` - **Archivos recientes** en los que has trabajado +- `SPC SPC` - **Buscar archivo en el proyecto actual** (¡súper útil!) + +📋 _Consulta la guía completa: `emacs.file-explorer.cheatsheet.md`_ + +**Flujo de trabajo rápido:** + +1. Abre el directorio de tu proyecto en la terminal +2. Inicia Emacs: `emacs` (o `emacsclient -c` para GUI, `et` para TTY) +3. Usa `SPC .` para explorar archivos o `SPC SPC` para encontrar archivos rápidamente + +--- + +## 3. ⌨️ **Entiende el Modo Evil (Atajos de Teclado de Vim)** + +**Doom Emacs usa atajos de teclado al estilo de Vim por defecto.** + +**Movimiento básico (en modo Normal):** + +- `h j k l` - Izquierda, abajo, arriba, derecha +- `w` - Saltar a la siguiente palabra +- `b` - Saltar una palabra hacia atrás +- `gg` - Ir al principio del archivo +- `G` - Ir al final del archivo + +**Cambio de modo:** + +- `i` - Entrar en modo de Inserción (para escribir texto) +- `ESC` - Volver al modo Normal +- `v` - Modo Visual (para seleccionar texto) + +**Si no estás familiarizado con Vim:** ¡No te asustes! Puedes aprender gradualmente. Lo básico anterior te ayudará a empezar. + +--- + +## 4. 🔍 **Busca y Reemplaza Eficientemente** + +**Encontrar y cambiar texto es una tarea diaria.** + +- `/` - Buscar hacia adelante en el búfer actual +- `?` - Buscar hacia atrás en el búfer actual +- `n/N` - Resultado de búsqueda siguiente/anterior +- `SPC s s` - Buscar en el búfer actual (interactivo) +- `SPC s p` - Buscar en todo el proyecto +- `SPC s r` - Buscar y reemplazar en el búfer actual + +**Para búsquedas en todo el proyecto:** `SPC s p` es increíblemente poderoso para encontrar código en todo tu proyecto. + +--- + +## 5. 🗂️ **Trabaja con Búferes y Ventanas** + +**Los búferes son archivos abiertos, las ventanas son cómo los ves.** + +**Gestión de búferes:** + +- `SPC b b` - Cambiar entre búferes abiertos +- `SPC b k` - Matar (cerrar) el búfer actual +- `SPC b s` - Guardar el búfer actual + +**Gestión de ventanas:** + +- `SPC w v` - Dividir la ventana verticalmente +- `SPC w s` - Dividir la ventana horizontalmente +- `SPC w c` - Cerrar la ventana actual +- `SPC w w` - Cambiar entre ventanas +- `C-h j/k/h/l` - Navegar entre ventanas (estilo Vim) + +**Piénsalo de esta manera:** Puedes tener muchos archivos abiertos (búferes) pero solo ver algunos de ellos a la vez (ventanas). + +--- + +## 6. 🛠️ **Configura y Personaliza Doom** + +**Doom es altamente configurable, pero empieza de forma sencilla.** + +**Archivos clave que debes conocer:** + +- `~/.doom.d/config.el` - Tu configuración personal +- `~/.doom.d/init.el` - Habilitar/deshabilitar módulos de Doom +- `~/.doom.d/packages.el` - Añadir paquetes adicionales + +**Comandos esenciales:** + +- `SPC h r r` - Recargar la configuración de Doom +- `SPC h d h` - Ayuda y documentación de Doom +- `doom doctor` - Comprobar si hay problemas de configuración (ejecutar en la terminal) +- `doom upgrade` - Actualizar Doom (ejecutar en la terminal) + +**Empieza poco a poco:** No intentes personalizar todo de una vez. Usa primero los valores predeterminados de Doom y luego ajusta las cosas gradualmente. + +--- + +## 7. 📝 **Domina los Conceptos Básicos de Edición de Texto** + +**Comandos de edición esenciales que funcionan en cualquier modo.** + +**En modo Normal (Evil):** + +- `x` - Eliminar el carácter bajo el cursor +- `dd` - Eliminar la línea entera +- `yy` - Copiar (yank) la línea entera +- `p` - Pegar después del cursor +- `u` - Deshacer +- `C-r` - Rehacer + +**En modo de Inserción:** + +- `C-w` - Eliminar palabra hacia atrás +- `C-u` - Eliminar hasta el principio de la línea + +**Selección y manipulación:** + +- `v` - Iniciar selección visual +- `V` - Seleccionar la línea entera +- `d` - Eliminar el texto seleccionado +- `y` - Copiar el texto seleccionado + +--- + +## 8. 💻 **Usa la Autocompletación de Código y las Funciones del Lenguaje** + +**Doom viene con un excelente soporte de código de fábrica.** + +**Autocompletación:** + +- Simplemente empieza a escribir - las terminaciones aparecen automáticamente +- `TAB` - Aceptar la terminación +- `C-n/C-p` o `j/k` - Navegar por las opciones de terminación + +**Navegación de código:** + +- `gd` - Ir a la definición +- `gr` - Encontrar referencias +- `K` - Mostrar documentación +- `SPC c a` - Acciones de código (refactorizar, arreglar, etc.) + +📋 _Consulta la guía completa: `emacs.code-completion.cheatsheet.md`_ + +**Lenguajes soportados:** La mayoría de los lenguajes populares funcionan de fábrica (Python, JavaScript, C/C++, Rust, Go, etc.) + +--- + +## 9. 📚 **Usa el Sistema de Ayuda Incorporado** + +**Doom tiene una excelente documentación incorporada.** + +- `SPC h` - **Menú principal de ayuda** +- `SPC h d h` - **Ayuda específica de Doom** +- `SPC h k` - **Describir tecla** (¿qué hace esta tecla?) +- `SPC h f` - **Describir función** +- `SPC h v` - **Describir variable** +- `C-h m` - **Mostrar ayuda para el modo actual** + +**Cuando estés perdido:** Presiona `SPC h` y explora. El sistema de ayuda es completo y siempre está disponible. + +**Consejo Profesional:** Si presionas una combinación de teclas y no sabes qué pasó, usa `SPC h l` para ver los comandos recientes. + +--- + +## 10. 🔧 **Aprende la Integración con Git (Magit)** + +**Magit es una de las mejores interfaces de Git disponibles en cualquier lugar.** + +- `SPC g g` - Abrir el estado de Magit (¡tu comando principal de Git!) +- `s` - Preparar archivos o fragmentos +- `c c` - Confirmar cambios +- `P P` - Empujar al remoto +- `F F` - Traer del remoto + +📋 _Consulta la guía completa: `emacs.magit.cheatsheet.md`_ + +**Flujo de trabajo básico:** + +1. `SPC g g` - Ver qué ha cambiado +2. `s` en los archivos para prepararlos +3. `c c` para confirmar (escribe el mensaje, luego `C-c C-c`) +4. `P P` para empujar + +**Por qué es esencial:** Si trabajas con Git, Magit transformará tu flujo de trabajo. Es visual, rápido e increíblemente poderoso. + +--- + +## 🎯 **Lista de Verificación de Inicio Rápido** + +Una vez que hayas leído lo anterior, prueba este flujo de trabajo de 5 minutos: + +1. ✅ **Abre Doom:** `emacs` en la terminal +2. ✅ **Encuentra un archivo:** `SPC f f` y abre cualquier archivo de texto +3. ✅ **Edita algo:** Presiona `i`, escribe texto, presiona `ESC` +4. ✅ **Guarda:** `SPC f s` +5. ✅ **Abre el explorador de archivos:** `SPC .` +6. ✅ **Obtén ayuda:** `SPC h` +7. ✅ **Divide la ventana:** `SPC w v` +8. ✅ **Cambia de búfer:** `SPC b b` +9. ✅ **Busca en el proyecto:** `SPC s p` (si estás en un proyecto) +10. ✅ **Sal:** `SPC q q` + +--- + +## 📖 **Próximos Pasos: Profundiza** + +Una vez que te sientas cómodo con lo básico anterior: + +1. **Lee las hojas de trucos específicas:** + - `emacs.file-explorer.cheatsheet.md` - Gestión de archivos + - `emacs.code-completion.cheatsheet.md` - Funciones de codificación + - `emacs.magit.cheatsheet.md` - Integración con Git + - `emacs.markdown.cheatsheet.md` - Edición de Markdown + +2. **Personaliza gradualmente:** Empieza a ajustar tu `config.el` +3. **Aprende tu lenguaje:** Explora las funciones específicas del lenguaje +4. **Únete a la comunidad:** Discord de Doom, Reddit, discusiones de GitHub + +--- + +## 🆘 **Cuando Estés Atascado** + +**Comandos de emergencia:** + +- `C-g` - Cancelar el comando actual (como presionar ESC) +- `SPC q q` - Salir de Emacs +- `SPC h d h` - Ayuda de Doom +- `:q` - Salir del búfer actual (comando de Vim) + +**Recuerda:** Todo experto fue una vez un principiante. No intentes aprender todo de una vez. Domina estas 10 cosas primero, luego explora gradualmente funciones más avanzadas. + +**El consejo más importante:** Usa `SPC` y explora los menús. ¡Doom está diseñado para ser descubrible - deja que te guíe! + +--- + +## 🎓 **Filosofía de Aprendizaje** + +**Empieza con flujos de trabajo, no con funciones:** En lugar de memorizar cada atajo de teclado, aprende flujos de trabajo completos para las tareas que haces a diario (editar archivos, confirmar código, buscar en proyectos). + +**Usa primero los valores predeterminados:** Los valores predeterminados de Doom son excelentes. Resiste la tentación de personalizar todo de inmediato. + +**Una cosa a la vez:** Domina la navegación de archivos antes de sumergirte en funciones de código avanzadas. Construye tus habilidades de forma incremental. + +**Practica a diario:** Usa Doom para el trabajo real, incluso si al principio eres más lento. La memoria muscular se desarrolla con la práctica. + +¡Bienvenido a Doom Emacs! 🚀 diff --git a/cheatsheets/emacs/emacs.getting-started.top10.md b/cheatsheets/emacs/emacs.getting-started.top10.md index 3405622..8ae5f12 100644 --- a/cheatsheets/emacs/emacs.getting-started.top10.md +++ b/cheatsheets/emacs/emacs.getting-started.top10.md @@ -1,5 +1,6 @@ -# Top 10 Things New Doom Emacs Users Should Know +English | [Español](./emacs.getting-started.top10.es.md) +# Top 10 Things New Doom Emacs Users Should Know ## 🚀 **Getting Started with Doom Emacs** Welcome to Doom Emacs! Here are the 10 most essential things every new user @@ -42,7 +43,7 @@ will show you the options! **Quick workflow:** 1. Open your project directory in terminal -2. Start Emacs: `emacs` or `doom run` +2. Start Emacs: `emacs` (or `emacsclient -c` for GUI, `et` for TTY) 3. Use `SPC .` to browse files or `SPC SPC` to quickly find files --- diff --git a/cheatsheets/emacs/emacs.magit.cheatsheet.es.md b/cheatsheets/emacs/emacs.magit.cheatsheet.es.md new file mode 100644 index 0000000..15e23e1 --- /dev/null +++ b/cheatsheets/emacs/emacs.magit.cheatsheet.es.md @@ -0,0 +1,276 @@ +[English](./emacs.magit.cheatsheet.md) | Español + +# Cheatsheet de Magit para Doom Emacs +## 🚀 **¿Qué es Magit?** + +Magit es una herramienta extremadamente poderosa para gestionar tu proyecto de Git. + +- Flujos de trabajo de Git visuales e interactivos +- Prepara para confirmación (stage) fragmentos (hunks), líneas o archivos completos con facilidad +- Confirma (commit), empuja (push), trae (pull), fusiona (merge), reorganiza (rebase) - todo desde menús intuitivos +- Ve el estado de tu repositorio de un vistazo + +## 📋 **Requisitos** + +- Git instalado en tu sistema +- Doom Emacs con Magit habilitado (incluido por defecto) +- Estar trabajando dentro de un repositorio de Git + +## ⌨️ **Abriendo Magit** + +### **Interfaz Principal de Magit:** + +- `SPC g g` - **Estado de Magit** (¡tu comando principal!) +- `SPC g d` - **Despacho de archivos de Magit** +- `SPC g f` - **Comandos de archivo de Magit** +- `SPC g l` - **Registro (log) de Magit** +- `SPC g b` - **Culpar (blame) de Magit** + +## 🎯 **El Búfer de Estado de Magit** (Tu Centro de Mando) + +### **Navegación:** + +- `j/k` o `n/p` - **Moverse arriba/abajo** entre secciones +- `TAB` - **Expandir/contraer** la sección bajo el cursor +- `M-TAB` - **Expandir/contraer** todas las secciones +- `g` - **Refrescar** el búfer de estado + +### **Resumen de Secciones:** + +``` +Archivos sin seguimiento - Archivos que no están en Git +Cambios sin preparar - Archivos modificados no preparados para confirmación +Cambios preparados - Archivos listos para confirmar +Confirmaciones recientes - Tu historial de confirmaciones +Aliijos (Stashes) - Tu trabajo en progreso guardado +``` + +## 📝 **Preparando y Despreparando (Staging & Unstaging)** + +### **Preparar Archivos:** + +- `s` - **Preparar** archivo/fragmento bajo el cursor +- `S` - **Preparar todos** los cambios sin preparar +- `i` - **Ignorar** archivo (añadir a .gitignore) + +### **Despreparar Archivos:** + +- `u` - **Despreparar** archivo/fragmento bajo el cursor +- `U` - **Despreparar todos** los cambios preparados + +### **Descartar Cambios:** + +- `k` - **Descartar** cambios en el archivo/fragmento bajo el cursor +- `K` - **Descartar todos** los cambios en el directorio de trabajo + +### **Preparando Fragmentos y Líneas:** + +- `RET` o `SPC` - **Mostrar diferencias (diff)** del archivo bajo el cursor +- En la vista de diferencias: + - `s` - **Preparar fragmento** bajo el cursor + - `u` - **Despreparar fragmento** bajo el cursor + - `k` - **Descartar fragmento** bajo el cursor + - `+/-` - **Mostrar más/menos** líneas de contexto + +## 💾 **Confirmando (Committing)** + +### **Crear Confirmaciones:** + +- `c c` - **Confirmar** (abre el búfer de mensaje de confirmación) +- `c a` - **Enmendar** la última confirmación +- `c e` - **Extender** la última confirmación (sin cambio de mensaje) +- `c w` - **Reescribir** el mensaje de la última confirmación +- `c f` - **Arreglar (fixup)** una confirmación +- `c s` - **Aplastar (squash)** una confirmación + +### **En el Búfer de Mensaje de Confirmación:** + +- `C-c C-c` - **Finalizar confirmación** +- `C-c C-k` - **Cancelar confirmación** +- `M-p/M-n` - **Mensaje de confirmación anterior/siguiente** del historial + +## 🌿 **Ramas y Cambio (Branching & Switching)** + +### **Operaciones con Ramas:** + +- `b b` - **Cambiar de rama** (checkout) +- `b c` - **Crear nueva rama** +- `b n` - **Crear rama** desde el HEAD actual +- `b s` - **Crear rama** y cambiar a ella +- `b r` - **Renombrar rama** +- `b k` - **Eliminar rama** + +### **Ramas Remotas:** + +- `b a` - **Establecer rama de seguimiento (upstream)** para la rama actual +- `b u` - **Establecer rama de seguimiento** y empujar + +## 🔄 **Operaciones Remotas** + +### **Traer y Actualizar (Fetch & Pull):** + +- `f f` - **Traer** desde el remoto predeterminado +- `f a` - **Traer desde todos** los remotos +- `F F` - **Actualizar** desde la rama de seguimiento +- `F u` - **Actualizar desde la rama de seguimiento** (rebase) + +### **Empujar (Push):** + +- `P P` - **Empujar** a la rama de seguimiento +- `P u` - **Empujar y establecer rama de seguimiento** +- `P f` - **Forzar empuje** (¡úsalo con cuidado!) +- `P t` - **Empujar etiquetas** + +## 📚 **Viendo Historial y Registros** + +### **Vistas de Registro:** + +- `l l` - **Mostrar registro** para la rama actual +- `l o` - **Mostrar registro** para otras ramas +- `l h` - **Mostrar registro** para HEAD +- `l a` - **Mostrar registro** para todas las ramas +- `l f` - **Mostrar registro** para el archivo bajo el cursor + +### **En la Vista de Registro:** + +- `RET` - **Mostrar detalles** de la confirmación +- `d d` - **Mostrar diferencias** para la confirmación +- `c c` - **Crear nueva confirmación** +- `r r` - **Revertir confirmación** + +## 🔍 **Diferencias y Comparaciones** + +### **Comandos de Diferencias:** + +- `d d` - **Diferencias del directorio de trabajo** vs preparado +- `d s` - **Diferencias de lo preparado** vs HEAD +- `d u` - **Diferencias de los cambios sin preparar** +- `d r` - **Diferencias de un rango** entre confirmaciones + +### **En las Vistas de Diferencias:** + +- `j/k` - **Navegar** entre fragmentos +- `n/p` - **Archivo siguiente/anterior** +- `TAB` - **Alternar** visibilidad de la sección de diferencias +- `+/-` - **Aumentar/disminuir** líneas de contexto + +## 🔧 **Reorganizando y Fusionando (Rebasing & Merging)** + +### **Fusionar:** + +- `m m` - **Fusionar** rama +- `m a` - **Abortar fusión** +- `m c` - **Continuar fusión** + +### **Reorganizar:** + +- `r i` - **Reorganización interactiva** +- `r r` - **Reorganizar** rama +- `r a` - **Abortar reorganización** +- `r c` - **Continuar reorganización** + +### **Durante la Reorganización Interactiva:** + +- `j/k` - **Moverse** entre confirmaciones +- `p` - **Elegir (pick)** confirmación (predeterminado) +- `r` - **Reescribir (reword)** mensaje de confirmación +- `e` - **Editar (edit)** confirmación +- `s` - **Aplastar (squash)** confirmación +- `f` - **Arreglar (fixup)** confirmación +- `d` - **Descartar (drop)** confirmación + +## 📦 **Aliijos (Stashing)** + +### **Operaciones con Aliijos:** + +- `z z` - **Alijar** los cambios actuales +- `z i` - **Alijar** con mensaje +- `z a` - **Aplicar alijo** +- `z p` - **Sacar alijo** (aplicar y eliminar) +- `z k` - **Descartar alijo** +- `z l` - **Listar alijos** + +## 🏷️ **Etiquetas (Tags)** + +### **Operaciones con Etiquetas:** + +- `t t` - **Crear etiqueta** +- `t a` - **Crear etiqueta anotada** +- `t k` - **Eliminar etiqueta** +- `t p` - **Empujar etiqueta** + +## ⚡ **Consejos Profesionales y Flujos de Trabajo** + +### **Flujo de Trabajo Diario de Git:** + +1. `SPC g g` - **Abrir estado de Magit** +2. Revisar cambios, preparar con `s` +3. `c c` - **Confirmar cambios** +4. `P P` - **Empujar al remoto** + +### **Trucos de Usuario Avanzado:** + +- Usa `M-x magit-find-file` para abrir rápidamente archivos del historial de Git +- `SPC g f s` - **Preparar archivo actual** sin abrir Magit +- `SPC g f u` - **Despreparar archivo actual** +- `SPC g f d` - **Mostrar diferencias del archivo** + +### **Granularidad de la Preparación:** + +- Prepara archivos completos con `s` en el búfer de estado +- Prepara fragmentos individuales entrando en la vista de diferencias (`RET`) y luego `s` +- Prepara líneas individuales seleccionando una región en la diferencia y luego `s` + +### **Buenas Prácticas de Confirmación:** + +- Usa `c c` para confirmaciones normales +- Usa `c a` para arreglar tu última confirmación +- Usa `c f` para crear confirmaciones de arreglo para una reorganización interactiva posterior + +## 🔧 **Solución de Problemas** + +### **Problemas Comunes:** + +- **¿Magit no se abre?** Asegúrate de estar en un repositorio de Git +- **¿Rendimiento lento?** Prueba `M-x magit-refresh` o reinicia Emacs +- **¿Conflictos de fusión?** Magit resalta los conflictos - resuélvelos y usa `m c` + +### **Obteniendo Ayuda:** + +- `?` - **Mostrar ayuda** en cualquier búfer de Magit +- `C-h m` - **Mostrar ayuda del modo** +- `SPC h d m magit` - **Documentación completa de Magit** + +## 🚀 **Flujo de Trabajo de Inicio Rápido** + +1. **Navega a tu repositorio de Git** en Doom Emacs +2. **Presiona `SPC g g`** - Abre el estado de Magit +3. **Prepara archivos** con `s`, revisa las diferencias con `RET` +4. **Confirma** con `c c`, escribe el mensaje, finaliza con `C-c C-c` +5. **Empuja** con `P P` + +## 📚 **Resumen de Atajos Esenciales** + +| Acción | Tecla | Descripción | +| --------- | --------- | -------------------- | +| Estado | `SPC g g` | Abrir estado de Magit| +| Preparar | `s` | Preparar archivo/fragmento | +| Despreparar| `u` | Despreparar archivo/fragmento | +| Confirmar | `c c` | Crear confirmación | +| Empujar | `P P` | Empujar a la rama de seguimiento | +| Actualizar| `F F` | Actualizar desde la rama de seguimiento | +| Rama | `b b` | Cambiar de rama | +| Registro | `l l` | Mostrar registro | +| Diferencias| `d d` | Mostrar diferencias | +| Alijar | `z z` | Alijar cambios | +| Ayuda | `?` | Mostrar ayuda contextual | + +## 🎉 **Por Qué Magit es Increíble** + +- **Visual**: Ve todo el estado de tu repositorio de un vistazo +- **Interactivo**: Prepara fragmentos, líneas o archivos con simples pulsaciones de teclas +- **Rápido**: Navega por las operaciones de Git más rápido que cualquier CLI +- **Potente**: Accede a todas las funciones de Git a través de menús intuitivos +- **Integrado**: Funciona perfectamente con Doom Emacs y el modo Evil + +**Consejo Profesional**: Una vez que aprendas Magit, ¡nunca más querrás usar Git desde la línea de comandos! 🚀 diff --git a/cheatsheets/emacs/emacs.magit.cheatsheet.md b/cheatsheets/emacs/emacs.magit.cheatsheet.md index 0ccc062..96d2a2f 100644 --- a/cheatsheets/emacs/emacs.magit.cheatsheet.md +++ b/cheatsheets/emacs/emacs.magit.cheatsheet.md @@ -1,5 +1,6 @@ -# Doom Emacs Magit Cheatsheet +English | [Español](./emacs.magit.cheatsheet.es.md) +# Doom Emacs Magit Cheatsheet ## 🚀 **What is Magit?** Magit is an extremely powerful tool for managing your Git project diff --git a/cheatsheets/emacs/emacs.markdown.cheatsheet.es.md b/cheatsheets/emacs/emacs.markdown.cheatsheet.es.md new file mode 100644 index 0000000..2e3c315 --- /dev/null +++ b/cheatsheets/emacs/emacs.markdown.cheatsheet.es.md @@ -0,0 +1,86 @@ +[English](./emacs.markdown.cheatsheet.md) | Español + +# Cheatsheet de Markdown para Doom Emacs +## 📝 **Primeros Pasos** +- Abre cualquier archivo `.md` - Doom habilita automáticamente `markdown-mode` +- Obtendrás resaltado de sintaxis, sangría adecuada y características específicas de markdown + +## ⌨️ **Comandos Clave de Markdown** (con atajos de Evil/Vim) + +### **Formato de Texto:** +- `SPC m b` - Texto en **negrita** +- `SPC m i` - Texto en *cursiva* +- `SPC m c` - `Código en línea` +- `SPC m C` - Bloque de código +- `SPC m s` - ~~Tachado~~ + +### **Encabezados:** +- `SPC m h` - Insertar encabezado (solicita el nivel 1-6) +- `SPC m H` - Insertar encabezado con estilo de subrayado + +### **Listas:** +- `SPC m l` - Insertar elemento de lista no ordenada +- `SPC m L` - Insertar elemento de lista ordenada + +### **Enlaces e Imágenes:** +- `SPC m l l` - Insertar enlace +- `SPC m l i` - Insertar imagen +- `SPC m l u` - Insertar URL + +### **Navegación:** +- `]]` - Siguiente encabezado +- `[[` - Encabezado anterior +- `SPC m o` - Abrir esquema/tabla de contenidos + +## 👁️ **Vista Previa en Vivo** +- `SPC m p` - Vista previa en el navegador +- `SPC m P` - Exportar a HTML + +## 📊 **Tablas** +- `SPC m t` - Comandos de tabla +- `SPC m t t` - Insertar tabla +- `TAB` - Navegar entre celdas +- `S-TAB` - Navegar hacia atrás entre celdas + +## 🎯 **Atajos Útiles de Evil en Markdown** +- `TAB` - Ciclar el plegado de encabezados +- `S-TAB` - Ciclar el plegado globalmente +- `RET` - Seguir enlaces +- `M-RET` - Insertar nuevo elemento de lista + +## 🧪 **Ejemplos de Prueba** + +### Formato de Muestra +Este es **texto en negrita** y este es *texto en cursiva*. + +Aquí hay algo de `código en línea` y un bloque de código: + +```bash +# Ejemplo de bloque de código +echo "¡Hola desde markdown!" +``` + +### Lista de Muestra +- [ ] Elemento de casilla de verificación 1 +- [x] Casilla de verificación completada +- Punto de viñeta normal + +### Tabla de Muestra +| Característica | Atajo | Descripción | +|----------------|---------|--------------------------| +| Negrita | SPC m b | Poner texto en negrita | +| Cursiva | SPC m i | Poner texto en cursiva | +| Vista Previa | SPC m p | Vista previa en el navegador | + +## 🚀 **Consejos Profesionales** +1. Usa `SPC m o` para obtener una vista de esquema para la navegación +2. `TAB` en los encabezados para plegar/desplegar secciones +3. `RET` en los enlaces para seguirlos +4. Usa `SPC m p` para previsualizar tu markdown en un navegador +5. Crea listas de verificación con la sintaxis `- [ ]` + +## 📚 **Referencia Rápida** +- Todos los comandos de markdown comienzan con `SPC m` +- Usa `SPC m ?` o `C-h m` para ver todos los comandos disponibles +- Navegación entre encabezados: `]]` (siguiente) y `[[` (anterior) +- Alternar plegado: `TAB` (local) y `S-TAB` (global) diff --git a/cheatsheets/emacs/emacs.markdown.cheatsheet.md b/cheatsheets/emacs/emacs.markdown.cheatsheet.md index 0e91631..43b8017 100644 --- a/cheatsheets/emacs/emacs.markdown.cheatsheet.md +++ b/cheatsheets/emacs/emacs.markdown.cheatsheet.md @@ -1,5 +1,6 @@ -# Doom Emacs Markdown Cheatsheet +English | [Español](./emacs.markdown.cheatsheet.es.md) +# Doom Emacs Markdown Cheatsheet ## 📝 **Getting Started** - Open any `.md` file - Doom automatically enables `markdown-mode` - You'll get syntax highlighting, proper indentation, and markdown-specific features diff --git a/cheatsheets/emacs/emacs.nix.cheatsheet.es.md b/cheatsheets/emacs/emacs.nix.cheatsheet.es.md new file mode 100644 index 0000000..f92b0cc --- /dev/null +++ b/cheatsheets/emacs/emacs.nix.cheatsheet.es.md @@ -0,0 +1,45 @@ +Español | [English](./emacs.nix.cheatsheet.md) + +# Guía Rápida: Doom Emacs + Nix + +Esta guía enumera los comandos de Nix y los atajos configurados en tu Doom Emacs. + +## Requisitos +- Módulo de Doom habilitado: `(nix +tree-sitter +lsp)` en `~/.doom.d/init.el` +- Paquetes instalados (en `~/.doom.d/packages.el`): `nix`, `nix-update`, `nixos-options` +- Herramientas Nix disponibles en el sistema: `nix`, `nixfmt` (o tu formateador preferido) +- Opcional pero recomendado: `nil` (LSP de Nix) + +## Convenciones de teclas (Leader) +- `SPC` = tecla líder de Doom +- `SPC m` = menú del modo mayor (contextual al buffer actual, p. ej., buffers Nix) + +## Atajos para Nix +- `SPC m f` → `nix-format-buffer` — Formatea el buffer Nix actual (usa `nixfmt` por defecto) +- `SPC m b` → `nix-build` — Construye la derivación/expresión actual +- `SPC m s` → `nix-shell` — Abre un `nix-shell` +- `SPC m u` → `nix-unpack` — Desempaqueta una fuente de Nix +- `SPC m r` → `nix-repl-show` — Muestra información de símbolo en el REPL de Nix +- `SPC m U` → `nix-update-fetch` — Actualiza fetchers/hashes en expresiones Nix +- `SPC m o` → `+nix/lookup-option` — Busca una opción de NixOS (requiere `:tools lookup` y `nixos-options`) + +## Referencia de comandos +- `nix-format-buffer`: Formatea el buffer usando `nixfmt`. + - Configuración: `(setq nix-nixfmt-bin "nixfmt")`. + - Consejo: ¿Prefieres otro formateador? Instálalo y ajusta `nix-nixfmt-bin` (p. ej., `"alejandra"` o `"nixpkgs-fmt"`). +- `nix-build`: Inicia una construcción para el archivo/contexto actual. +- `nix-shell`: Abre un shell de desarrollo derivado de la expresión Nix actual. +- `nix-unpack`: Desempaqueta la fuente de una derivación (útil para inspeccionar fuentes). +- `nix-repl-show`: Muestra información de símbolo desde una sesión del REPL de Nix. +- `nix-update-fetch`: Actualiza atributos de fetcher (rev, sha256, etc.). +- `+nix/lookup-option`: Salta a la documentación de una opción de NixOS usando la integración con `nixos-options`. + +## Consejos +- Asegúrate de estar editando un archivo `.nix` para que `SPC m` (modo mayor) esté disponible. +- Para funciones LSP (documentación, autocompletado, diagnósticos), verifica que el servidor `nil` esté instalado y activo. + +## Solución de problemas +- ¿Comandos no disponibles en Emacs? Ejecuta `~/.emacs.d/bin/doom sync` y reinicia Emacs. +- ¿El formateador no funciona? Verifica que `nixfmt` (u otro) esté en tu PATH y que `nix-nixfmt-bin` coincida con su nombre. +- ¿La búsqueda de opciones no funciona? Asegúrate de tener `nixos-options` instalado y que `:tools lookup` esté habilitado en Doom. + diff --git a/cheatsheets/emacs/emacs.nix.cheatsheet.md b/cheatsheets/emacs/emacs.nix.cheatsheet.md new file mode 100644 index 0000000..fa59dce --- /dev/null +++ b/cheatsheets/emacs/emacs.nix.cheatsheet.md @@ -0,0 +1,45 @@ +English | [Español](./emacs.nix.cheatsheet.es.md) + +# Doom Emacs + Nix Cheatsheet + +This guide lists the Nix commands and keybindings configured in your Doom Emacs. + +## Requirements +- Doom module enabled: `(nix +tree-sitter +lsp)` in `~/.doom.d/init.el` +- Packages installed (via `~/.doom.d/packages.el`): `nix`, `nix-update`, `nixos-options` +- Nix tooling available on system: `nix`, `nixfmt` (or your preferred formatter) +- Optional but recommended: `nil` (Nix LSP) + +## Leader key conventions +- `SPC` = Doom leader +- `SPC m` = Major mode menu (contextual to current buffer, e.g., Nix buffers) + +## Nix keybindings +- `SPC m f` → `nix-format-buffer` — Format current Nix buffer (uses `nixfmt` by default) +- `SPC m b` → `nix-build` — Build the current derivation / expression +- `SPC m s` → `nix-shell` — Open a `nix-shell` +- `SPC m u` → `nix-unpack` — Unpack a Nix source +- `SPC m r` → `nix-repl-show` — Show symbol info in Nix REPL +- `SPC m U` → `nix-update-fetch` — Update fetchers/hashes in Nix expressions +- `SPC m o` → `+nix/lookup-option` — Lookup NixOS option (requires `:tools lookup` and `nixos-options`) + +## Command reference +- `nix-format-buffer`: Formats the current buffer using `nixfmt`. + - Configured via `(setq nix-nixfmt-bin "nixfmt")`. + - Tip: Prefer a different formatter? Install it and set `nix-nixfmt-bin` accordingly (e.g., `"alejandra"` or `"nixpkgs-fmt"`). +- `nix-build`: Triggers a build for the current file/context. +- `nix-shell`: Opens a development shell derived from the current Nix expression. +- `nix-unpack`: Unpacks the source for a derivation (useful to inspect sources). +- `nix-repl-show`: Displays symbol info from a Nix REPL session. +- `nix-update-fetch`: Updates fetcher attributes (rev, sha256, etc.). +- `+nix/lookup-option`: Jumps to documentation for a NixOS option using `nixos-options` integration. + +## Tips +- Ensure you are editing a `.nix` file so the `SPC m` (major mode) bindings are available. +- For LSP features (hover docs, completion, diagnostics), make sure the `nil` language server is installed and running. + +## Troubleshooting +- Commands not found in Emacs? Run `~/.emacs.d/bin/doom sync`, then restart Emacs. +- Formatter not working? Verify `nixfmt` (or chosen formatter) is on your PATH and `nix-nixfmt-bin` matches its name. +- Option lookup not working? Ensure `nixos-options` is installed and Doom’s `:tools lookup` is enabled. + diff --git a/cheatsheets/ghostty/ghostty.cheatsheet.es.md b/cheatsheets/ghostty/ghostty.cheatsheet.es.md new file mode 100644 index 0000000..01e8cd9 --- /dev/null +++ b/cheatsheets/ghostty/ghostty.cheatsheet.es.md @@ -0,0 +1,123 @@ +[English](./ghostty.cheatsheet.md) | Español + +# Ghostty en ZaneyOS — Resumen y Cheatsheet +## 🚀 Resumen de modules/home/terminals/ghostty.nix + +- Programa + - Ghostty habilitado con el paquete de Nix: pkgs.ghostty + - Integraciones de shell: Fish, Zsh, Bash + - clearDefaultKeybinds = true (todos los atajos se definen explícitamente a continuación) + +- Apariencia + - Título: ZaneyOS-GhosTTY + - TERM: xterm-256color + - Tema: oscuro: catppuccin-mocha; claro: catppuccin-mocha + - Tema de la ventana: oscuro + - Fuente: Maple Mono NF, tamaño 12 + - Ajuste de altura de celda: +10% + - Opacidad del fondo: 1.00 (opaco) + - Radio de desenfoque del fondo: 60 + - Estilo del cursor: barra + - Colores de selección: fondo #2d3f76, frente #c8d3f5 + - Opacidad de división sin foco: 0.5 + - Posición de terminal rápida: centro + +- Ventana y Comportamiento + - Tamaño de ventana predeterminado: 110x32 (columnas x filas) + - Confirmar cierre de superficie: false + - Esperar después del comando: false + - Integración de shell: detectar; características: cursor, sudo + - Estado de guardado de ventana: siempre + - Instancia única de GTK: true + - Ratón: ocultar al escribir: true + +- Atajos de Teclado (esquema de prefijo Super/Alt) + - El acorde personalizado tipo líder usa Alt+s y luego la tecla, ej. alt+s>c + - Portapapeles estándar y tamaño de fuente con acordes Ctrl+Shift + - Pestañas, divisiones, navegación, zoom, ecualizar definidos a continuación + +--- + +## 🗝️ Cheatsheet de Atajos de Teclado + +Portapapeles +- Ctrl+Shift+C — copy_to_clipboard +- Ctrl+Shift+V — paste_from_clipboard + +Tamaño de fuente +- Ctrl+Shift+= (más) — increase_font_size:1 +- Ctrl+Shift+- (menos) — decrease_font_size:1 +- Ctrl+Shift+0 — reset_font_size + +Sesión +- Alt+s r — reload_config +- Alt+s x — close_surface +- Alt+s n — new_window + +Pestañas +- Alt+s c — new_tab +- Alt+s Shift+L — next_tab +- Alt+s Shift+H — previous_tab +- Alt+s , — move_tab:-1 +- Alt+s . — move_tab:+1 +- Alt+s 1..9 — goto_tab:N + +Divisiones +- Alt+s \ — new_split:right +- Alt+s - — new_split:down +- Alt+s j — goto_split:bottom +- Alt+s k — goto_split:top +- Alt+s h — goto_split:left +- Alt+s l — goto_split:right +- Alt+s z — toggle_split_zoom +- Alt+s e — equalize_splits + +Notas +- clearDefaultKeybinds = true significa que solo los anteriores están activos. +- La notación Alt+s> denota un acorde de dos teclas: mantén presionado Alt, presiona s, luego la siguiente tecla. + +--- + +## ⚙️ Referencia de Opciones Predeterminadas (según configuración) + +Terminal y ventana +- term: xterm-256color +- window-width: 110 +- window-height: 32 +- window-theme: dark +- window-save-state: always +- gtk-single-instance: true +- quick-terminal-position: center + +Apariencia +- theme: catppuccin-mocha (oscuro y claro mapeados a mocha) +- font-family: Maple Mono NF +- font-size: 12 +- adjust-cell-height: 10% +- background-opacity: 1.00 +- background-blur-radius: 60 +- selection-background: #2d3f76 +- selection-foreground: #c8d3f5 +- cursor-style: bar +- unfocused-split-opacity: 0.5 + +Comportamiento +- confirm-close-surface: false +- mouse-hide-while-typing: true +- wait-after-command: false +- shell-integration: detect +- shell-integration-features: cursor,sudo + +Integraciones +- Integraciones de Fish, Zsh, Bash habilitadas + +--- + +## 📝 Notas de Estilo/Formato + +Este cheatsheet refleja el estilo de tus cheatsheets de Emacs: +- Encabezados de sección claros con emoji +- Listas con viñetas con descripciones concisas +- Bloques cortos de "Notas" para comportamientos especiales + +Si lo deseas, puedo enlazar esto desde un índice central o agregar más consejos de Ghostty (temas, indicadores de rendimiento, solución de problemas). diff --git a/cheatsheets/ghostty/ghostty.cheatsheet.md b/cheatsheets/ghostty/ghostty.cheatsheet.md index f7c069f..ad1634b 100644 --- a/cheatsheets/ghostty/ghostty.cheatsheet.md +++ b/cheatsheets/ghostty/ghostty.cheatsheet.md @@ -1,5 +1,6 @@ -# Ghostty on ddubsOS — Summary & Cheatsheet +English | [Español](./ghostty.cheatsheet.es.md) +# Ghostty on ZaneyOS — Summary & Cheatsheet ## 🚀 Summary of modules/home/terminals/ghostty.nix - Program @@ -8,7 +9,7 @@ - clearDefaultKeybinds = true (all bindings are explicitly defined below) - Appearance - - Title: ddubsOS-GhosTTY + - Title: ZaneyOS-GhosTTY - TERM: xterm-256color - Theme: dark: catppuccin-mocha; light: catppuccin-mocha - Window theme: dark diff --git a/cheatsheets/hyprland-customization-guide.es.md b/cheatsheets/hyprland-customization-guide.es.md index 4c45e75..74c7605 100644 --- a/cheatsheets/hyprland-customization-guide.es.md +++ b/cheatsheets/hyprland-customization-guide.es.md @@ -11,7 +11,7 @@ Preferido (específico de ZaneyOS): - Nota: el alias `fr` está obsoleto. Método manual de respaldo (funciona en cualquier instalación): -- Desde la raíz del repo, reemplaza PROFILE por tu perfil (intel, nvidia, nvidia-laptop, vm): +- Desde la raíz del repo, reemplaza PROFILE por tu perfil (intel, nvidia, nvidia-laptop, amd-hybrid, vm): - `sudo nixos-rebuild switch --flake .#PROFILE` --- diff --git a/cheatsheets/hyprland-customization-guide.md b/cheatsheets/hyprland-customization-guide.md index a6dc93d..481b8f9 100644 --- a/cheatsheets/hyprland-customization-guide.md +++ b/cheatsheets/hyprland-customization-guide.md @@ -11,7 +11,7 @@ Preferred (ZaneyOS-specific): - Note: The `fr` alias is deprecated. Manual backup method (works anywhere): -- From the repo root, replace PROFILE with your profile (intel, nvidia, nvidia-laptop, vm): +- From the repo root, replace PROFILE with your profile (intel, nvidia, nvidia-laptop, amd-hybrid, vm): - `sudo nixos-rebuild switch --flake .#PROFILE` --- @@ -161,3 +161,4 @@ Example: Float Thunar always - Make one change at a time and rebuild to validate. - Keep a terminal open during experiments in case your launcher keybind changes. - If something breaks, reboot and choose a previous generation in the boot menu. + diff --git a/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.es.md b/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.es.md new file mode 100644 index 0000000..95b2bae --- /dev/null +++ b/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.es.md @@ -0,0 +1,213 @@ +# Cómo tematizar o añadir Waybars en ZaneyOS + +Esta guía muestra cómo ZaneyOS selecciona y configura Waybar, cómo añadir tu propio módulo de Waybar y cómo personalizar fuentes, tamaños, colores, iconos, widgets y layout. También indica dónde colocar scripts y una nota crítica sobre git add para evitar fallos de rebuild. + +## Módulos Waybar disponibles +Guardados en modules/home/waybar/: +- waybar-tony.nix +- waybar-ddubs.nix +- waybar-ddubsos-v1.nix +- waybar-dwm.nix +- waybar-curved.nix +- waybar-simple.nix +- waybar-ddubs-2.nix +- waybar-mecha.nix +- waybar-dwm2.nix +- waybar-nekodyke.nix +- Jerry-waybar.nix + +## Dónde seleccionas tu Waybar +Selecciona el módulo en hosts/default/variables.nix vía waybarChoice. Ejemplo (extracto real): +```nix path=/home/dwilliams/ZaneyOS/hosts/default/variables.nix start=73 + # Set Waybar + # Includes alternates such as: + # Comment out the current choice and uncomment the one you want + #waybarChoice = ../../modules/home/waybar/waybar-curved.nix; + #waybarChoice = ../../modules/home/waybar/Jerry-waybars.nix; + #waybarChoice = ../../modules/home/waybar/waybar-simple.nix; + #waybarChoice = ../../modules/home/waybar/waybar-mecha.nix; + #waybarChoice = ../../modules/home/waybar/waybar-nekodyke.nix; + #waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix; + waybarChoice = ../../modules/home/waybar/waybar-tony.nix; + #waybarChoice = ../../modules/home/waybar/waybar-ddubs-2.nix; +``` +Notas: +- Asegúrate de que la ruta coincide con un archivo real bajo modules/home/waybar/. Por ejemplo, la lista incluye Jerry-waybar.nix (singular) pero el comentario muestra Jerry-waybars.nix (plural). Usa el nombre correcto para evitar errores de build. + +## CRÍTICO: usa git add o fallará el rebuild +Cuando añadas un archivo Waybar o scripts que use, debes prepararlos con git antes de reconstruir, o Nix no verá esas rutas y fallará la build. +- Ejemplo: +```bash path=null start=null +# Añade tu módulo y scripts +git add modules/home/waybar/my-waybar.nix modules/home/waybar/scripts/my-widget.sh +# Commit (opcional pero recomendado) +git commit -m "Add my Waybar module and widget script" +``` + +## Cómo están estructurados los módulos Waybar aquí +- Exponen un módulo de Home Manager que define programs.waybar.settings (config estilo JSON) y programs.waybar.style (CSS). +- Copian scripts auxiliares a ~/.config/waybar/scripts desde un directorio compartido scripts. + +Ejemplo: waybar-tony.nix copia scripts y define config y CSS de Waybar: +```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=15 + # Configure & Theme Waybar (Tony) + home.file = builtins.listToAttrs (map + (name: { + name = ".config/waybar/scripts/" + name; + value = { + source = "${scriptsDir}/${name}"; + executable = true; + }; + }) + scripts); + + programs.waybar = { + enable = true; + package = pkgs.waybar; + settings = [ + { + layer = "top"; + position = "top"; + height = 30; + spacing = 4; + modules-left = [ + "custom/startmenu" "hyprland/workspaces" "custom/sep" "tray" "custom/sep" "hyprland/window" "custom/sep" + ]; + modules-center = [ "custom/sep" "idle_inhibitor" "custom/notification" "custom/sep" ]; + modules-right = [ "custom/sep" "pulseaudio" "network" "cpu" "memory" "clock" "custom/sep" "custom/power" ]; + # ... component configs ... + } + ]; + style = concatStrings [ + '' + @define-color bg #1a1b26; + @define-color fg #a9b1d6; + * { font-family: "JetBrainsMono Nerd Font", monospace; font-size: 16px; font-weight: bold; } + window#waybar { background-color: @bg; color: @fg; } + #workspaces button { padding: 0 6px; color: @cyn; } + #clock { color: @cyn; border-bottom: 4px solid @cyn; } + #pulseaudio { color: @blu; border-bottom: 4px solid @blu; } + #idle_inhibitor.activated { color: @grn; border-bottom: 4px solid @grn; } + '' + ]; + }; +``` +Puntos clave: +- El layout se controla con modules-left, modules-center y modules-right. +- La configuración de cada módulo (p. ej., hyprland/workspaces, pulseaudio) va en el mismo objeto. +- El CSS controla tipografías, tamaños, colores, bordes y espaciado. +- scriptsDir = ./scripts relativo al archivo; se instalan en ~/.config/waybar/scripts y se marcan como ejecutables. + +## Añadir tu propio Waybar (paso a paso) +1) Copia un módulo como base: +```bash path=null start=null +cp modules/home/waybar/waybar-simple.nix modules/home/waybar/my-waybar.nix +``` +2) (Opcional) Añade scripts auxiliares en modules/home/waybar/scripts/. +3) Apunta variables.nix a tu módulo: +```nix path=/home/dwilliams/ZaneyOS/hosts/default/variables.nix start=81 + #waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix; + waybarChoice = ../../modules/home/waybar/waybar-tony.nix; + #waybarChoice = ../../modules/home/waybar/waybar-ddubs-2.nix; +``` +Cámbialo a: +```nix path=null start=null +waybarChoice = ../../modules/home/waybar/my-waybar.nix; +``` +4) Prepara los archivos antes de reconstruir (crítico): +```bash path=null start=null +git add modules/home/waybar/my-waybar.nix modules/home/waybar/scripts/* +``` +5) Reconstruye como siempre. + +## Ejemplos de personalización +1) Cambiar tipografía y tamaño (CSS) +```css path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=207 +* { + font-family: "JetBrainsMono Nerd Font", monospace; + font-size: 16px; + font-weight: bold; +} +``` +2) Mover widgets izquierda/centro/derecha +```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-simple.nix start=28 +modules-center = [ "hyprland/workspaces" ]; +modules-left = [ "custom/startmenu" "custom/arrow6" "pulseaudio" "cpu" "memory" "idle_inhibitor" "custom/arrow7" "hyprland/window" ]; +modules-right = [ "custom/arrow4" "custom/hyprbindings" "custom/arrow3" "custom/notification" "custom/arrow3" "custom/power" "battery" "custom/arrow2" "tray" "custom/arrow1" "clock" ]; +``` +3) Cambiar colores y estilos de botones +```css path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=218 +#workspaces button { + padding: 0 6px; + color: @cyn; + background: transparent; + border-bottom: 3px solid @bg; +} +#workspaces button.active { + color: @cyn; + border-bottom: 3px solid @mag; +} +``` +4) Añadir iconos o cambiar etiquetas +```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-ddubs.nix start=104 +"pulseaudio" = { + format = "{icon} {volume}% {format_source}"; + format-icons = { + headphone = ""; + default = [ "" "" "" ]; + }; +}; +``` +5) Añadir un widget que ejecute un script +```nix path=null start=null +"custom/mywidget" = { + exec = "~/.config/waybar/scripts/my-widget.sh"; + return-type = "json"; + interval = 5; + format = "{}"; + on-click = "kitty -e my-tool"; +}; +``` +6) Hacer la barra flotante o acoplada +```nix path=null start=null +settings = [ + { + layer = "top"; + position = "top"; + mode = "overlay"; + # ... + } +]; +``` +```css path=null start=null +window#waybar { + background: rgba(0, 0, 0, 0.6); + margin: 6px 10px; + border-radius: 12px; +} +``` + +## Dónde guardar scripts usados por widgets +```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-ddubs.nix start=14 +home.file = builtins.listToAttrs (map (name: { + name = ".config/waybar/scripts/" + name; + value = { source = "${scriptsDir}/${name}"; executable = true; }; +}) scripts); +``` +Copia todo desde ./scripts a ~/.config/waybar/scripts y marca ejecutable. + +## Solución de problemas +- Fallo de ruta: asegúrate de hacer git add de los archivos nuevos. +- Nombre incorrecto en variables.nix: usa exactamente el nombre real. +- Iconos faltan: instala una Nerd Font (p. ej., JetBrainsMono Nerd Font) y selecciónala en CSS. +- Widgets faltan: confírmalos en modules-left/center/right y su bloque de config. + +## Receta rápida +1) Crea modules/home/waybar/my-waybar.nix (copia uno y edítalo) +2) Añade scripts en modules/home/waybar/scripts/ +3) En variables.nix: +```nix path=null start=null +waybarChoice = ../../modules/home/waybar/my-waybar.nix; +``` +4) git add de los archivos +5) Reconstruye. diff --git a/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.md b/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.md new file mode 100644 index 0000000..154b680 --- /dev/null +++ b/cheatsheets/hyprland/How-to-theme-or-add-waybars-in-ddubsos.md @@ -0,0 +1,254 @@ +# How to theme or add Waybars in ZaneyOS + +This guide shows how ZaneyOS selects and configures Waybar, how to add your own Waybar module, and how to customize fonts, sizes, colors, icons, widgets, and layout. It also calls out where to put scripts and a critical note about git add to avoid rebuild failures. + + +## Current Waybar modules available +Saved in modules/home/waybar/: +- waybar-tony.nix +- waybar-ddubs.nix +- waybar-ddubsos-v1.nix +- waybar-dwm.nix +- waybar-curved.nix +- waybar-simple.nix +- waybar-ddubs-2.nix +- waybar-mecha.nix +- waybar-dwm2.nix +- waybar-nekodyke.nix +- Jerry-waybar.nix +- waybar-TheBlackDon.nix + + +## Where you select your Waybar +Select the Waybar module in hosts/default/variables.nix via waybarChoice. Example (actual excerpt): +```nix path=/home/dwilliams/ZaneyOS/hosts/default/variables.nix start=73 + # Set Waybar + # Includes alternates such as: + # Comment out the current choice and uncomment the one you want + #waybarChoice = ../../modules/home/waybar/waybar-curved.nix; + #waybarChoice = ../../modules/home/waybar/Jerry-waybars.nix; + #waybarChoice = ../../modules/home/waybar/waybar-simple.nix; + #waybarChoice = ../../modules/home/waybar/waybar-mecha.nix; + #waybarChoice = ../../modules/home/waybar/waybar-nekodyke.nix; + #waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix; + waybarChoice = ../../modules/home/waybar/waybar-tony.nix; + #waybarChoice = ../../modules/home/waybar/waybar-ddubs-2.nix; +``` +Notes: +- Ensure the file path matches an actual file name under modules/home/waybar/. For example, the list includes Jerry-waybar.nix (singular), but the commented example shows Jerry-waybars.nix (plural). Use the actual filename to avoid build errors. + + +## CRITICAL: git add or rebuild will fail +When you add a new Waybar file or any scripts it uses, you must stage them in git before rebuilding, or Nix will not see those paths and the build will fail. +- Example: +```bash path=null start=null +# Add your new module and scripts +git add modules/home/waybar/my-waybar.nix modules/home/waybar/scripts/my-widget.sh +# Commit (optional but recommended) +git commit -m "Add my Waybar module and widget script" +``` + + +## How Waybar modules are structured here +Most Waybar modules follow this pattern: +- They expose a Home Manager module that sets programs.waybar.settings (JSON-like config) and programs.waybar.style (CSS). +- They also copy any helper scripts to ~/.config/waybar/scripts via a shared scripts directory. + +Example: waybar-tony.nix copies scripts and sets Waybar config and CSS: +```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=15 + # Configure & Theme Waybar (Tony) + home.file = builtins.listToAttrs (map + (name: { + name = ".config/waybar/scripts/" + name; + value = { + source = "${scriptsDir}/${name}"; + executable = true; + }; + }) + scripts); + + programs.waybar = { + enable = true; + package = pkgs.waybar; + settings = [ + { + layer = "top"; + position = "top"; + height = 30; + spacing = 4; + modules-left = [ + "custom/startmenu" "hyprland/workspaces" "custom/sep" "tray" "custom/sep" "hyprland/window" "custom/sep" + ]; + modules-center = [ "custom/sep" "idle_inhibitor" "custom/notification" "custom/sep" ]; + modules-right = [ "custom/sep" "pulseaudio" "network" "cpu" "memory" "clock" "custom/sep" "custom/power" ]; + # ... component configs ... + } + ]; + style = concatStrings [ + '' + @define-color bg #1a1b26; + @define-color fg #a9b1d6; + * { font-family: "JetBrainsMono Nerd Font", monospace; font-size: 16px; font-weight: bold; } + window#waybar { background-color: @bg; color: @fg; } + #workspaces button { padding: 0 6px; color: @cyn; } + #clock { color: @cyn; border-bottom: 4px solid @cyn; } + #pulseaudio { color: @blu; border-bottom: 4px solid @blu; } + #idle_inhibitor.activated { color: @grn; border-bottom: 4px solid @grn; } + '' + ]; + }; +``` + +Key takeaways: +- Layout is controlled by modules-left, modules-center, and modules-right arrays. +- Individual module settings (e.g., hyprland/workspaces, pulseaudio) are configured under the same top-level object. +- CSS controls fonts, sizes, colors, borders, and spacing. +- scriptsDir = ./scripts relative to the module file; any files inside that directory are installed into ~/.config/waybar/scripts and made executable. + + +## Add your own Waybar module (step-by-step) +1) Copy an existing module as a starting point, e.g.: +```bash path=null start=null +cp modules/home/waybar/waybar-simple.nix modules/home/waybar/my-waybar.nix +``` +2) (Optional) Add any helper scripts your widgets will use into modules/home/waybar/scripts/ (they will be installed to ~/.config/waybar/scripts automatically by modules using scriptsDir = ./scripts). +3) Point variables.nix to your new module: +```nix path=/home/dwilliams/ZaneyOS/hosts/default/variables.nix start=81 + #waybarChoice = ../../modules/home/waybar/waybar-ddubs.nix; + waybarChoice = ../../modules/home/waybar/waybar-tony.nix; + #waybarChoice = ../../modules/home/waybar/waybar-ddubs-2.nix; +``` +Change the active line to: +```nix path=null start=null +waybarChoice = ../../modules/home/waybar/my-waybar.nix; +``` +4) Stage your files before rebuilding (critical): +```bash path=null start=null +git add modules/home/waybar/my-waybar.nix modules/home/waybar/scripts/* +``` +5) Rebuild as you normally do for ZaneyOS. + + +## Customization examples +Below are quick edits you can make, demonstrated using existing modules. + +1) Change font family and size (CSS) +- In waybar-tony.nix: +```css path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=207 +* { + font-family: "JetBrainsMono Nerd Font", monospace; + font-size: 16px; + font-weight: bold; +} +``` +Change font-family and font-size to your preference. + +2) Move widgets left/center/right +- In any module, edit modules-left, modules-center, modules-right arrays. For example in waybar-simple.nix: +```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-simple.nix start=28 +modules-center = [ "hyprland/workspaces" ]; +modules-left = [ "custom/startmenu" "custom/arrow6" "pulseaudio" "cpu" "memory" "idle_inhibitor" "custom/arrow7" "hyprland/window" ]; +modules-right = [ "custom/arrow4" "custom/hyprbindings" "custom/arrow3" "custom/notification" "custom/arrow3" "custom/power" "battery" "custom/arrow2" "tray" "custom/arrow1" "clock" ]; +``` +Just reorder or move entries between arrays to place widgets where you want. + +3) Change colors and button styles +- In waybar-tony.nix, CSS color variables and workspace button styling: +```css path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-tony.nix start=218 +#workspaces button { + padding: 0 6px; + color: @cyn; + background: transparent; + border-bottom: 3px solid @bg; +} +#workspaces button.active { + color: @cyn; + border-bottom: 3px solid @mag; +} +``` +Adjust colors (e.g., @cyn, @mag) or borders as desired. You can also define your own @define-color variables at the top of the CSS block. + +4) Add icons or change labels +- Many modules set format and format-icons. Example (pulseaudio) in waybar-ddubs.nix: +```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-ddubs.nix start=104 +"pulseaudio" = { + format = "{icon} {volume}% {format_source}"; + format-icons = { + headphone = ""; + default = [ "" "" "" ]; + }; +}; +``` +Replace icons with Nerd Font glyphs you prefer. + +5) Add a new widget that runs a script +- Waybar custom modules can execute scripts and display the output. Put your script in modules/home/waybar/scripts/ and configure a custom module: +```nix path=null start=null +"custom/mywidget" = { + exec = "~/.config/waybar/scripts/my-widget.sh"; + return-type = "json"; # or "text" depending on your script + interval = 5; # seconds + format = "{}"; # how to render the output + on-click = "kitty -e my-tool"; +}; +``` +- Scripts placed in modules/home/waybar/scripts/ are installed to ~/.config/waybar/scripts and marked executable by modules that include the home.file mapping. + +6) Make the bar floating or docked +- Waybar supports a mode field; CSS margins/transparency give a floating look: +```nix path=null start=null +settings = [ + { + layer = "top"; + position = "top"; + mode = "overlay"; # overlay (floats), or "dock" (reserves space), or "invisible" + # ... + } +]; +``` +- CSS for floating effect: +```css path=null start=null +window#waybar { + background: rgba(0, 0, 0, 0.6); + margin: 6px 10px; /* space from screen edges */ + border-radius: 12px; +} +``` + +7) Known Waybar modules you’ll see in ZaneyOS configs +- Hyprland modules: hyprland/workspaces, hyprland/window, wlr/taskbar (wlroots taskbar) +- System modules: clock, tray, cpu, memory, network, disk, battery, bluetooth, backlight, idle_inhibitor, mpris, temperature, pulseaudio +- Custom modules: custom/* (e.g., custom/power, custom/notification, custom/startmenu, etc.) + + +## Where to store scripts that widgets call +- Place scripts under modules/home/waybar/scripts/. +- Many Waybar modules here include: +```nix path=/home/dwilliams/ZaneyOS/modules/home/waybar/waybar-ddubs.nix start=14 +home.file = builtins.listToAttrs (map (name: { + name = ".config/waybar/scripts/" + name; + value = { source = "${scriptsDir}/${name}"; executable = true; }; +}) scripts); +``` +This copies all files from ./scripts (next to the module file) to ~/.config/waybar/scripts and makes them executable, so your Waybar configuration can reference them as ~/.config/waybar/scripts/