#bash #system #cli #rust

app carch

A Simple Script to Make Linux System Setups Easier 🧩

13 stable releases

Uses new Rust 2024

new 4.3.3 Apr 14, 2025
4.3.2 Apr 13, 2025
4.2.6 Mar 31, 2025

#394 in Command line utilities

Download history 77/week @ 2025-02-24 225/week @ 2025-03-03 247/week @ 2025-03-10 262/week @ 2025-03-17 174/week @ 2025-03-24 254/week @ 2025-03-31 198/week @ 2025-04-07

927 downloads per month

Custom license

335KB
8K SLoC

Shell 5.5K SLoC // 0.0% comments Rust 2.5K SLoC // 0.0% comments

Carch

A Simple Script That May Help You Automate Linux System Setups.

Preview πŸ‘€

Preview

Currently Supports Arch or Fedora Based Distros.

GitHub Issues Github Prs Github Commit Github Star Github Fork Carch Downloads Crates Carch Docs

About

What the heck is this script btw? Good question ! It's none other than a collections of bash script designed to be simple enough for anyone. Like, anyone can simply run it by selecting the options. What the heck does this actually do? You will see different scripts on the menu, separated or defined as categories like system, terminal, desktop, development.. etc. As for the categories, there you will see script names β€” like in terminal you will see something like Kitty, alacritty, and so on. Then when you actually run the script, it will install package as well as apply my preconfigured setup that is minimal, beautiful, and simple enough for everyone to use. Same as you will find different scripts there β€” just choose and run. The script will handle everything for you in just a few clicks, like installing a window manager or any other thing you find in the menu.

Note

Yeah, the script is fully automated, but that doesn't mean it will work on every machine or system. Maybe your system has some very specific preconfigured setup, so maybe the script will not work there. As in the menu, you can see the preview of the scripts β€” you can always walk around to see what the script actually does.

Yeah, most scripts are stable, but if you find any bugs, errors, or anything else, please open a bug report.
Or if you have any feature suggestions or improvements from your side, you're always welcome to open a feature request too.

Btw, I highly recommend checking out the Carch docs for more details.

Live Test 🎯

You can run or use Carch directly without installing it on your system.

Note

⚑ Make sure to have the figlet and fzf packages already installed.

Arch

sudo pacman -S --noconfirm figlet fzf

Fedora

sudo dnf install figlet fzf -y

Choose one of the following commands to try Carch:

⭐ Stable Version [ Latest Release ]

bash <(curl -L https://chalisehari.com.np/carch)

πŸ§ͺ Dev Version [ Latest Commits ]

bash <(curl -L https://chalisehari.com.np/carchdev)

Installation

Carch mainly supports two mainline distributions: Arch and Fedora Linux. For installation, run the following command in your terminal:

Arch Linux

bash <(curl -L https://chalisehari.com.np/arch)

Fedora Linux

bash <(curl -L https://chalisehari.com.np/fedora)

Yeah, it supports Arch and Fedora-based distros too. But if you get stuck in some problem, feel free to give feedback on the issues tab.

πŸ“¦ Cargo Crate

Carch is available on Cargo Crate too.

This can be the simplest installation method for both Arch and Fedora if you have Rust installed.

You'll need a few dependencies before installing:

Arch Linux

sudo pacman -S --noconfirm figlet rust cargo fzf

Fedora Linux

sudo dnf install figlet rust cargo fzf -y

Now, install Carch using Cargo:

cargo install carch

Once installed, simply type carch in your terminal to run it.

Tip

If typing carch doesn’t execute, make sure you have added the Cargo bin directory to your shell's PATH. Depending on whether you're using bash, zsh, or fish, add the following to your profile

export PATH="$HOME/.cargo/bin:$PATH"

Commands

Carch supports some commands too. You can view them by running:

carch --help

Roadmap

You can find the full roadmap in the Carch documentation

Contributing

PRs & any type of contributions are welcome. Before contributing, first read the contributing guide

Code of Conduct

We make sure everyone has a welcoming environment for using Carch, as well as contributing or doing any other stuff. So make sure to follow our code of conduct

Contributors

We thank everyone who has contributed to Carch in various ways β€” reporting bugs, giving feedback for improvements, or contributing to Carch through PRs.

Contributors

Inspiration

Likewise, this project was created as a casual bash script as I was just tinkering here and there with scripting. Then after some time, I thought, why not make this script something useful to me or anyone else who wants to use it?

My main inspiration to shape this project is:

Reach Me

Got a question or feedback? Hit me up via:

Telegram β€’ Discord β€’ Email


Carch is MIT licensed, so you're free to fork and use it as you like. Thank you!

Dependencies

~6–16MB
~215K SLoC