* 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>
* Mirrored gaming changes
* Added game emulators for Playstation 1 and 2, Nintendo Gameboy, DS, GameCube, Wii, Switch, and RetroArch
* Added docs
* removed ghostty from user guide
* added flatpak check before installing
* used only AURHelper for Arch
* Update retroarch.sh
fixed misspelling on melondsds-bin and xmv
* Added new emulators
* Updated TOML file
* fixed typo and script error
* modified game emulators to install GUI versions and changed a few that were having issues on Arch
* Updated pcsxr depends, removed yabause, updated docs
* removed accidental character
* Added .cache cleanup for removal
* fixed shell check double qoute errors
* Added gopher64 and organized emulates based on company
* Removed pcsxr (Fails to install), Play! set to flatpak for Arch due to failing install, removed mesen 2 as it is not ready for production
* Changed retroarch melonds core to proper core
* fixed accidental comment on line in play-emu.sh
* Added --clearafter arguement to remove cache. This will save space for those who have smaller drives
* fixed cleanafter which was spelled wrong
---------
Co-authored-by: Nick A <namato@deloitte.com>
* Mirrored gaming changes
* Added GIMP, pinta, darktable, krita, mypaint, Inkscape, Scribus, OpenShot, Olive, Synfig Studio, Natron, Blender, Ardour, Audacity, Tenacity, Handbrake
* Fixed typo in Fallout76
* removed fallout changes
* Separated Installers
* removed empty file, added items to TOML file, renamed from adobe alternatives to design-tools
* Fived Olive install check
* Fixed installed checks for some tools
* updated check for AUR to include paru
* Fixed issue with heading being bash rather than sh
* Added Uninstallers
* updated docs
* Update gimp.sh
fixed AUR install which would install pinta by mistake
* Removed unsupported package manager comment when installing with FlatPak
* removed ghostty from user guide
* added flatpak check before installing
* Switched to using the checkAURHelper to check for yay/paru or install yay
* Removed redundency
* Added --clearafter arguement to remove cache. This will save space for those who have smaller drives
* fixed cleanafter which was spelled wrong
---------
Co-authored-by: Nick A <namato@deloitte.com>
* Added Tor Browser to Web Browsers tab.
* Ran cargo xtask docgen
* removed unnecessary double quotes in tor-browser.sh
Co-authored-by: JEEVITHA KANNAN K S <ksjeevithakannan123@gmail.com>
* Add desktop environment and compile setup scripts to tab_data.toml
- Introduced scripts for installing and uninstalling various desktop environments and window managers.
* Update userguide.md to include new applications and scripts for desktop environment management
* refactor: use common-script.sh functions
* refactor: remove BASHISMs
* fix: quote pkg_manager in cleanup commands for safety
* Remove color codes
* added new WM options
* Fix shell check and a few errors in WM install
---------
Co-authored-by: Phoenix Mark Hale <m.werthammer@online.de>
Co-authored-by: Phoenix Mark Hale <69822350+phoenixhaleofficial@users.noreply.github.com>
Co-authored-by: JEEVITHA KANNAN K S <ksjeevithakannan123@gmail.com>
Co-authored-by: Chris Titus <contact@christitus.com>
* Added cursor to tab_data
* Fixed data entry
* Added message to indicate the program was installed
* Removed install message, verified the URL's were correct (does not download through browser, needs curl or wget)
* Updated DOCS
* Fixed URLs to get latest version of files for apt and dnf
* Updated userguide using docgen
* Update core/tabs/applications-setup/developer-tools/cursor.sh
Co-authored-by: adam <adas1per@protonmail.com>
* Update docs/userguide.md
Co-authored-by: adam <adas1per@protonmail.com>
* Update core/tabs/applications-setup/tab_data.toml
Co-authored-by: adam <adas1per@protonmail.com>
* Update core/tabs/applications-setup/developer-tools/cursor.sh
Co-authored-by: adam <adas1per@protonmail.com>
* Fixed shellcheck errors
* Possibly fixed posix compliant issue
* Updated userguide with docgen
* remove ghostty from userguide
* Update core/tabs/applications-setup/developer-tools/cursor.sh
Co-authored-by: adam <adas1per@protonmail.com>
* Update core/tabs/applications-setup/developer-tools/cursor.sh
Co-authored-by: adam <adas1per@protonmail.com>
* Update core/tabs/applications-setup/developer-tools/cursor.sh
Co-authored-by: adam <adas1per@protonmail.com>
* Update core/tabs/applications-setup/developer-tools/cursor.sh
Co-authored-by: adam <adas1per@protonmail.com>
* Added a way to just install cursor from the repos if it already exists.
* Fixed switch statement
* Update core/tabs/applications-setup/developer-tools/cursor.sh
Co-authored-by: adam <me@adamperkowski.dev>
* Update core/tabs/applications-setup/developer-tools/cursor.sh
Co-authored-by: adam <me@adamperkowski.dev>
* apt-search was causing issues for installing, removed it entired. Same with dnf search
---------
Co-authored-by: adam <adas1per@protonmail.com>
Co-authored-by: adam <me@adamperkowski.dev>
* Feat: Add support for installation of Chaotic-AUR in Linutil
* Add code comments for easier understanding, add docs for the new feature, plus menu entry rewording.
* Run docgen
* Rewrite to preferred code style
* Fix some typos with $ESCALATION_TOOL Replace "$PACKAGER"-key with pacman-key
* Apply formatting shfmt
* switch echo to printf for posix compliance.
---------
Co-authored-by: Chris Titus <contact@christitus.com>
* Added Install HP Printer Drivers script
* added documentation
* applied suggestion to script
* updated to use hplip for arch
* Update core/tabs/utils/printers/install-hp-printer-drivers.sh
trying the github way to see if accepts it
Co-authored-by: Jared Cervantes <76603258+Jaredy899@users.noreply.github.com>
* Update core/tabs/utils/printers/install-hp-printer-drivers.sh
trying the github way to see if accepts it
Co-authored-by: Jared Cervantes <76603258+Jaredy899@users.noreply.github.com>
---------
Co-authored-by: Jared Cervantes <76603258+Jaredy899@users.noreply.github.com>
* Add basic script to install Epson printer drivers in Arch, Debian, and Fedora.
* Add I to the task_list for this script.
* Update core/tabs/utils/printers/install-epson-printer-drivers.sh
Co-authored-by: JEEVITHA KANNAN K S <ksjeevithakannan123@gmail.com>
* Update userguide.md based on adam's documentation update.
* Add description to tab_data.toml for the printer addition.
* Fix typo, oops.
* Actually generate the updated userguide.
* Add installation of CUPS as a pre-requisite for Epson printer drivers as well as standalone script for other printer drivers to be added in the future.
* Update core/tabs/utils/printers/install-cups.sh
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* Update core/tabs/utils/printers/install-epson-printer-drivers.sh
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* Update core/tabs/utils/tab_data.toml
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* Update core/tabs/utils/tab_data.toml
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* Update docs after changes.
---------
Co-authored-by: JEEVITHA KANNAN K S <ksjeevithakannan123@gmail.com>
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* feat: Add automation based on config file
* docs: add configuration to the manpage & README
* update roadmap
---------
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
Co-authored-by: Chris Titus <contact@christitus.com>
* Btrfs Assistant(+snapper), grub-btrfs Setup added
Adds fedora-btrfs-assistant.sh, updates tab_data and documentation.
* updated doc, ta_data and sh
* enable grub-btrfsd service added
* updated some wording in notices.
* updated wording and add prompts for actions
* added fix for a possible grub error
also some more enhancements and wording improvements.
* user action removed
reinstall snapper action removed because removing and reinstalling snapper is a very unlikely action. and also snapper can't handle ./snapsots folder in the disk after reinstalling: "creating btrfs subvolume .snapshots failed since it already exists".
* firs snapshot order changed
home snapshot taken first because it's config can be saved to first root snapshot.
* better explanations in user prompts
* improved y/n loop
* formatting improvements
* formatting improvement
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* formatting improvement
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* Update task list
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* removed a inline comment
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* removed an unnececary inline comment
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* removed an unnececary inline comment
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* improved sed -i
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* improved sed -i
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* improved sed -i
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* newlines removed from tab_data.toml
Co-authored-by: Nyx <nnyyxxxx@protonmail.com>
* btrfs detection moved to toml
Co-authored-by: Nyx <nnyyxxxx@protonmail.com>
* data.preconditions added - escalation tool used
* $PACKAGER replaced with dnf
* re-added packager
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* re-added packager
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* usergide updated with docgen
* typo fix
---------
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
Co-authored-by: Nyx <nnyyxxxx@protonmail.com>
* Added support for installing podman
* removed llm comment
* Added podman to userguide
* Added support for install pythona and pip in case of missing. changed pip install to rootless install
* changed installing podman-compose with pip to packagemanager
* Update core/tabs/applications-setup/podman-setup.sh
Only install Podman if it is not installed already.
Co-authored-by: nyx <nnyyxxxx@protonmail.com>
* Update core/tabs/applications-setup/podman-setup.sh
Only install podman-compose if it is not installed already.
Co-authored-by: nyx <nnyyxxxx@protonmail.com>
* added podman-compose install option
* split podman install into podman and podman-compose
* Update core/tabs/applications-setup/podman-setup.sh
Co-authored-by: nyx <nnyyxxxx@protonmail.com>
* Update core/tabs/applications-setup/podman-setup.sh
Co-authored-by: nyx <nnyyxxxx@protonmail.com>
* Update core/tabs/applications-setup/podman-compose-setup.sh
Co-authored-by: nyx <nnyyxxxx@protonmail.com>
* Update core/tabs/applications-setup/podman-compose-setup.sh
Co-authored-by: nyx <nnyyxxxx@protonmail.com>
* Update core/tabs/applications-setup/podman-compose-setup.sh
Removed redundant quotes
Co-authored-by: JEEVITHA KANNAN K S <ksjeevithakannan123@gmail.com>
* Update core/tabs/applications-setup/podman-setup.sh
Removed redundant quotes
Co-authored-by: JEEVITHA KANNAN K S <ksjeevithakannan123@gmail.com>
---------
Co-authored-by: nyx <nnyyxxxx@protonmail.com>
Co-authored-by: JEEVITHA KANNAN K S <ksjeevithakannan123@gmail.com>
Co-authored-by: Chris Titus <contact@christitus.com>
* implement dynamic auto updating word wrapping functionality
* run fmt
* remove dupe space
* run fmt
* add remove comments back
* fix compilation errors
* run fmt
* run docgen
* run docgen
* fix conflicts
* run cargo xtask docgen
* use boolean rather than enum
---------
Co-authored-by: nyx <nnyyxxxx@users.noreply.github.com>
* Terminus Fonts TTY Setup
* Update the dectection of the Terminus Fonts
* Undo the Commit
* Update Fedora Path
* Fixing Fedora issues
* Fix Fedora issues
* Switch to another method
* Fix Debian Message and Add Change to Terminus Font after Applied
* Update tty command
* Randomly trying things to see if it work or not
* Adding Debug messages
* Remove Debug Command and specifiy tty terminal
* Fix the setfont issue
* Set only tty1 to terminus font
* Execute using sudo
* Remove Debug Messages
* Add comment for easy to understand
* Update core/tabs/system-setup/tab_data.toml
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* Update core/tabs/system-setup/tab_data.toml
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* Update the Docs and Fixing the Typo by @adamperkowski
* From Utilitys to System Setup
* Update core/tabs/system-setup/tab_data.toml
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
* Remove Comments
---------
Co-authored-by: Adam Perkowski <adas1per@protonmail.com>
Sean (ANGRYxScotsman)