🌱 Mintstrap

Mintstrap is a set of modular bash scripts to automate Linux Mint post-installation configuration with Cinnamon. It is specially optimized for developer productivity, visual comfort, and performance on modern and older Intel hardware (Haswell+).

The project follows a "DEB-first" philosophy, preferring native packages for stability and integration, while using Flatpak for applications that are not available in official repositories or when a newer version is desired.

Features

• Modular Architecture: Install everything or pick and choose the components you need.
• Performance Tuned: Optimizes system settings, kernel parameters, and Cinnamon effects for a responsive experience.
• Developer Ready: Installs a comprehensive suite of development tools, SDKs, and containerization engines.
• Visual Comfort: Configures dark themes, fonts, and a night light to reduce eye strain.
• Idempotent: Scripts can be re-run safely without causing issues.

🔧 Installation

You can install Mintstrap with a single command using the bootstrap script. This will clone the repository to ~/.local/share/mintstrap and add a symlink to ~/.local/bin.

curl -fsSL https://raw.githubusercontent.com/lucasbt/mintstrap/main/bootstrap.sh | bash

After installation, you must restart your terminal or source your shell's configuration file:

source ~/.bashrc

📖 Basic Usage

Mintstrap is controlled via a simple command-line interface.

List Available Modules

To see all the components you can install, run:

mintstrap list

Install Modules

You can install all modules in the recommended order by running:

mintstrap install all

Alternatively, you can install one or more specific modules:

mintstrap install system packages dev-tools

Other Commands

• mintstrap status: View system information.
• mintstrap config: Open the configuration file in your default editor.
• mintstrap self-update: Pull the latest changes from the Git repository.
• mintstrap help: Display the help message.

⚙️ Configuration

You can customize Mintstrap's behavior by editing the .env file. The easiest way to do this is by running:

mintstrap config

This file contains variables to control which drivers are used, which versions of SDKs are installed, and which features are enabled.

🧩 Modules

Mintstrap is divided into the following modules:

Priority	Module	Description
1	system	Base system tuning, kernel parameters, and APT configuration.
2	packages	Essential DEB packages and common applications.
3	intel-graphics	Optimized drivers for Intel GPUs.
4	cinnamon	Performance and visual settings for the Cinnamon desktop.
5	anti-fatigue	Dark theme and night light settings for visual comfort.
6	dev-tools	A comprehensive suite of development tools and SDKs.
7	flatpak	Curated applications from Flathub.
8	media-fonts-icons	Multimedia codecs, extra fonts, and icon themes.

🤝 Contributing

Contributions are welcome! Please see the CONTRIBUTING.md file for more details.

📝 License

This project is licensed under the MIT License. See the LICENSE file for details.