Chris Titus Tech's MacOS Utility

macutil 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/mac | sh

Dev branch not setup

CLI arguments

View available options by running:

macutil --help

For installer options:

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

⬇️ Installation

macutil is also available as a package in various repositories:

cargo install macutil_tui

Configuration

macutil 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

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

💖 Support

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

🎓 Documentation

For comprehensive information on how to use macutil, visit the macutil 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 macutil Roadmap

Docs are now here

🏅 Thanks to All Contributors

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

📜 Contributor Milestones

• 2024/07 - Original macutil 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