linutil/README.md
Adam Perkowski c0a9820c32
Add package installation instructions to the docs and README (#605)
* Added Arch Linux

* Added cargo

* update & add to README

* fixed typos

Co-authored-by: nnyyxxxx <nnyyxxxx@users.noreply.github.com>

---------

Co-authored-by: nnyyxxxx <nnyyxxxx@users.noreply.github.com>
2024-09-22 11:38:32 -05:00

4.7 KiB
Raw Permalink Blame History

Chris Titus Tech's Linux Utility

Version GitHub Downloads (specific asset, all releases)

Crates.io Version linutil AUR Version linutil-bin AUR Version

Preview

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:

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

Dev branch

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

⬇️ Installation

Linutil is also available as a package in various repositories:

Packaging status

Arch Linux

Linutil can be installed on Arch Linux with three different AUR packages:

  • linutil - Stable release compiled from source
  • linutil-bin - Stable release pre-compiled
  • linutil-git - Compiled from the last commit (not recommended)

by running:

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

Replace <package> with your preferred package.

If you use yay, paru or any other AUR Helper, it's even simplier:

paru -S linutil

Replace paru with your preferred helper and linutil with your preferred package.

Cargo

Linutil can be installed via Cargo with:

cargo install linutil

Note that crates installed using cargo install require manual updating with cargo install --force (update functionality is included in LinUtil)

💖 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.

Official LinUtil Roadmap

🏅 Thanks to All Contributors

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

Contributors

📜 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