Sean (ANGRYxScotsman)
2fcd7cf878
* Add Hugo build artifacts to .gitignore Ignore docs/public/, docs/resources/, and docs/.hugo_build.lock so generated Hugo output is never accidentally committed. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Add Hugo site infrastructure for Linutil docs Adds the Hugo configuration, theme module (hextra), layout shortcodes, i18n strings, static assets (favicons, nav logo), and archetype template needed to build the documentation site. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Add docs site homepage Adds the root _index.md with badges, the quick-start curl command, and an important-note callout about frequent updates. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Add user guide content pages for Linutil Rewrites all user guide sections from Winutil (Windows) content to accurate Linutil (Linux) documentation: - _index.md: overview, feature summary, quick links - getting-started.md: how to run, install options, TUI navigation, keyboard shortcuts - store/_index.md: application installation guide with category tables - tweaks/_index.md: distro-specific system setup (Arch, Fedora, Debian, Ubuntu, Alpine) - features/_index.md: security, gaming, emulators, and utilities reference - updates/_index.md: how to keep Linutil up to date - automation/_index.md: TOML config file usage and use-case examples Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Add FAQ, known issues, and contributing guide pages - faq.md: answers for general usage, running, scripts, contributing, and updates - KnownIssues.md: documents terminal size, rendering, distro support, Nvidia, and Cargo update issues - CONTRIBUTING.md: full contributing guide based on .github/CONTRIBUTING.md, formatted for the docs site Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Add developer reference section and architecture docs - dev/_index.md: landing page for the developer reference section - dev/architecture.md: comprehensive architecture doc covering workspace layout, data model (Tab/ListNode/Command), tab_data.toml format, task list flags, preconditions system, script embedding via include_dir!, the script execution pipeline (PTY/vt100/tui-term), TUI layout and focus state machine, config file parsing, and key dependencies Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docgen: write walkthrough to docs/content/userguide/walkthrough.md - Rename generated file from userguide.md to walkthrough.md to better reflect that it is an auto-generated script reference/walkthrough - Update USER_GUIDE path to docs/content/userguide/walkthrough.md so cargo xtask docgen writes to the correct Hugo content location - Update automation guide link to point to ../walkthrough/ Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: remove unused Winutil screenshot assets All images in docs/assets/images/ were Winutil (Windows) screenshots copied over from the Winutil docs. None are referenced by any content file. Keeping only favicon.png and navlogo.png at the assets root, which are used by hugo.toml. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Update CNAME * updated hugo configs * docs: add preview.gif to homepage via Hugo mount Mount .github/preview.gif directly into Hugo's static pipeline using includeFiles so only the gif is exposed (no workflows or other .github files). This means any update to .github/preview.gif is automatically reflected on the site without any manual copying. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * added workflow * Delete docs/assets/navlogo.png can change this to something else * Delete navlogo.png * Update docs.yaml * Update hugo.toml * Update _index.md * fix typo --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
3.4 KiB
3.4 KiB
title, weight
| title | weight |
|---|---|
| System Setup | 3 |
The System Setup section contains distro-specific and general configuration scripts to get your Linux system set up quickly. These scripts handle driver installation, package manager configuration, desktop environments, and more.
Distro-Specific Setup
Arch Linux
| Script | Description |
|---|---|
| Arch Server Setup | Minimal Arch server install in under 5 minutes |
| Hyprland (JaKooLit) | Install JaKooLit's Hyprland configuration |
| Paru AUR Helper | Install the paru AUR helper |
| Yay AUR Helper | Install the yay AUR helper |
| Install Chaotic-AUR | Add the Chaotic-AUR repo for prebuilt AUR packages |
| Nvidia Drivers + HW Accel | Install and configure Nvidia drivers with hardware acceleration |
| Omarchy Rice by DHH | Simplified Hyprland config by DHH |
| Linux Neptune (SteamDeck) | Valve's fork of the Linux kernel for Steam Deck |
| Virtualization | Install QEMU, Libvirt, and Virt-Manager |
Fedora
| Script | Description |
|---|---|
| Configure DNF | Optimize DNF for parallel downloads |
| RPM Fusion | Add RPM Fusion free and non-free repositories |
| Multimedia Codecs | Install multimedia codecs with RPM Fusion |
| Nvidia Proprietary Drivers | Install proprietary Nvidia drivers |
| Hyprland (JaKooLit) | Install JaKooLit's Hyprland configuration |
| Virtualization | Enable virtualization via DNF |
| Btrfs Assistant + Snapper | Btrfs snapshots with grub-btrfs integration |
| Upgrade Fedora Release | Upgrade system to the next Fedora release |
Debian
| Script | Description |
|---|---|
| Hyprland (JaKooLit) | Install JaKooLit's Hyprland configuration |
Ubuntu
| Script | Description |
|---|---|
| Hyprland (JaKooLit) | Install JaKooLit's Hyprland configuration |
| Full System Cleanup | Remove unused packages, clear cache, empty trash |
| Full System Update | Update all packages to the latest available |
| Gaming Dependencies | Install gaming dependencies across distros |
| Global Theme | Install and configure a global desktop theme |
| Remove Snaps | Remove Snap and prevent it from reinstalling |
| Build Prerequisites | Install software build dependencies |
| TTY Fonts | Set the default TTY font to Terminus 32 Bold |
Alpine
| Script | Description |
|---|---|
| Alpine Update | Upgrade Alpine to the latest stable or edge release |
Desktop Environment Setup
These scripts work across distros and let you install or uninstall full desktop environments and window managers interactively.
Install Desktop Environment
An interactive menu lets you choose from:
Desktop Environments: GNOME, KDE Plasma, XFCE, Cinnamon, MATE, Budgie, LXQt, LXDE
Window Managers: i3, Sway, DWM, Awesome, BSPWM, Openbox, Fluxbox
Uninstall Desktop Environment
The reverse operation — interactively select which DE or WM to remove.
General System Scripts
These scripts work across all distributions:
| Script | Description |
|---|---|
| Full System Update | Update all packages using your distro's package manager |
| Full System Cleanup | Clear package caches, temp files, and trash |
| Gaming Dependencies | Install dependencies needed for gaming on Linux |
| Build Prerequisites | Install common software build dependencies |
Tip
Always run a Full System Update before installing new software or applying major configuration changes.