Carch

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

Preview 👀

Currently Supports Arch or Fedora Based Distros.

About

What the hell is this script?

Good question! It's just a bunch of simple bash scripts anyone can run by picking options. You'll see categories like system, terminal, desktop, development, etc. Inside each, there are script names — like in terminal, you'll find Kitty, alacritty, and more. When you run one, it installs the package and sets up my minimal and clean config. That's it. Just pick, run, and it does the rest for you — all through a nice TUI built with ratatui.

Note

Yeah, the script does everything by itself, but it might not work on every system.
If your setup is a bit different, some stuff might break.
Just check the preview in the menu to see what the script actually does.

Yeah, most scripts work fine, but if you find any bugs, drop a bug report.
Got ideas or features to add? Open a feature request anytime!

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

How to use?

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

Choose one of the following version to try Carch:

⭐ Stable Version [ Latest Release ]

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

🧪 Dev Version [ Pre-Release ]

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

Install Script

You can install Carch permanently on your system using our install script:

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

You can also use these options:

# Update existing installation
bash <(curl -L https://chalisehari.com.np/carchinstall) --update

# Uninstall Carch
bash <(curl -L https://chalisehari.com.np/carchinstall) --uninstall

📦 Cargo Crate

Carch is available on crates.io.

If you want to install Carch on your Arch or Fedora system, you can use the Cargo Crate.

First, install dependencies:

Arch Linux

sudo pacman -S --noconfirm figlet fzf cargo rust

Fedora Linux

sudo dnf install figlet fzf cargo rust -y

Then, install Carch with Cargo:

cargo install carch

Once that's done, you can run it by typing carch in your terminal.

Tip

If carch doesn't run, add Cargo's bin directory to your PATH:

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

Commands

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

carch --help

Roadmap

Check the full roadmap in the docs.

Contributing

PRs & contributions are welcome! Read the contributing guide first.

Code of Conduct

We want a welcoming environment for everyone. Please follow our code of conduct.

Contributors

Thanks to everyone who contributed — reporting bugs, providing feedback, or submitting PRs.

Inspiration

• ChrisTitusTech linutil
• ml4w — his scripting logic is awesome.
• Ideas from many other people along the way.

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!