ChrisTitusTech/linutil

Chris Titus Tech's Linux Utility

The above preview was generated with the help of vhs, give them a :star:!

Linutil is a distro-agnostic toolbox designed to simplify everyday Linux tasks. It helps you set up applications and optimize your system for specific use cases. The utility is actively developed in Rust 🦀, providing performance and reliability.

[!NOTE] Since the project is still in active development, you may encounter some issues. Please consider submitting feedback if you do.

💡 Usage

To get started, pick which branch you would like to use, then run the command in your terminal:

Stable Branch (Recommended)

curl -fsSL https://christitus.com/linux | sh

Dev branch

curl -fsSL https://christitus.com/linuxdev | sh

CLI arguments

View available options by running:

linutil --help

For installer options:

curl -fsSL https://christitus.com/linux | sh -s -- --help

⬇️ Installation

Linutil is also available as a package in various repositories:

git clone https://aur.archlinux.org/<package>.git
cd <package>
makepkg -si

paru -S linutil

sudo zypper install linutil

cargo install linutil_tui

Configuration

Linutil supports configuration through a TOML config file. Path to the file can be specified with --config (or -c).

Available options:

• auto_execute - A list of commands to execute automatically (can be combined with --skip-confirmation)
• skip_confirmation - Boolean ( Equal to --skip-confirmation)
• size_bypass - Boolean ( Equal to --size-bypass )

Example config:

# example_config.toml

auto_execute = [
    "Fastfetch",
    "Alacritty",
    "Kitty"
]

skip_confirmation = true
size_bypass = true

linutil --config /path/to/example_config.toml

💖 Support

If you find Linutil helpful, please consider giving it a ⭐️ to show your support!

🎓 Documentation

For comprehensive information on how to use Linutil, visit the Linutil Official Documentation.

🛠 Contributing

We welcome contributions from the community! Before you start, please review our Contributing Guidelines to understand how to make the most effective and efficient contributions.

Docs are now here

🏅 Thanks to All Contributors

Thank you to everyone who has contributed to the development of Linutil. Your efforts are greatly appreciated, and you're helping make this tool better for everyone!

📜 Contributor Milestones

• 2024/07 - Original Linutil Rust TUI was developed by @JustLinuxUser.
• 2024/09 - TabList (Left Column) and various Rust Core/TUI Improvements developed by @lj3954
• 2024/09 - Cargo Publish, AUR, Rust, and Bash additions done by @koibtw
• 2024/09 - Rust TUI Min/Max, MultiSelection, and Bash additions done by @jeevithakannan2
• 2024/09 - Various bash updates and standardization done by @nnyyxxxx
• 2024/09 - Multiple bash script additions done by @guruswarupa
• 2026/01 - TUI Refresh with Logo by @Abs313a
• 2026/03 - Linutil docs website creation by @seanh1995