4 releases (stable)
new 25.1.10 | Jan 10, 2025 |
---|---|
24.9.28 | Sep 28, 2024 |
24.9.22-1 | Sep 22, 2024 |
24.9.19 | Sep 20, 2024 |
#36 in Filesystem
140 downloads per month
380KB
9K
SLoC
Chris Titus Tech's Linux Utility
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
Linutil supports various command-line arguments to customize its behavior. Here are some common arguments you can use:
-c, --config <CONFIG>
: Path to the configuration file.--override-validation
: Show all available options, disregarding compatibility checks (UNSAFE).--size-bypass
: Bypass the terminal size limit.-y, --skip-confirmation
: Skip confirmation prompt before executing commands.-t, --theme <THEME>
: Set the theme to use in the application [default:default
] [possible values:default
,compatible
].-h, --help
: Print help.
For more detailed usage, run:
curl -fsSL https://christitus.com/linux | sh -s -- --help
linutil --help
β¬οΈ Installation
Linutil is also available as a package in various repositories:
Arch Linux
Linutil can be installed on Arch Linux with three different AUR packages:
linutil
- Stable release compiled from sourcelinutil-bin
- Stable release pre-compiledlinutil-git
- Compiled from the last commit (not recommended)
by running:
git clone https://aur.archlinux.org/<package>.git
cd <package>
makepkg -si
Replace <package>
with your preferred package.
If you use yay, paru or any other AUR Helper, it's even simpler:
paru -S linutil
Replace paru
with your preferred helper and linutil
with your preferred package.
OpenSUSE
Linutil can be installed on OpenSUSE with:
sudo zypper install linutil
Cargo
Linutil can be installed via Cargo with:
cargo install linutil_tui
Note that crates installed using cargo install
require manual updating with cargo install --force
(update functionality is included in LinUtil)
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
)
Example config:
# example_config.toml
auto_execute = [
"Fastfetch",
"Alacritty",
"Kitty"
]
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 @adamperkowski
- 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
Dependencies
~25β37MB
~789K SLoC