Welcome to the Dotarchy manual. This documentation provides a guide to understanding, installing, and using the Dotarchy dotfiles.

Source code

This repository contains installation and configuration scripts for Arch Linux and macOS. The goal is to automate the setup of applications, fonts, development tools, and user configurations.

The main goal is to have a modular and easy-to-maintain system that can be quickly set up on a new machine.

⚠️ The Hyprland setup is massively extracted/inspired from the excellent Omarchy project by @dhh.

Hyprland Keybindings reference

Installation #

To set up Dotarchy on your system, follow these steps:

1. Clone the Repository: Start by cloning the Dotarchy repository to your local machine using the following command:

   git clone https://github.com/c4software/dotarchy.git ~/dotarchy
   

2. Run the Setup Script: Navigate to the cloned directory and execute the setup script. This script will automatically detect your operating system and install the necessary packages and configurations.

   cd ~/dotarchy
   ./setup.sh
   

3. Follow On-Screen Instructions: The setup script may prompt you for additional input or confirmation during the installation process. Follow the on-screen instructions to complete the setup.

Install only specific parts #

If you want to install only specific parts of Dotarchy, such as the Hyprland setup on Arch Linux, you can navigate to the relevant directory and run the dedicated setup script. For example:

cd ~/dotarchy/
(source /install/hyprland/setup.sh && setup)

Only update Hyprland configuration #

To update only the Hyprland configuration files without installing packages, you can run:

./update.sh

Dotfiles and Hyprland update #

To update the dotfiles and Hyprland setup, run:

./update.sh --all

Check your setup #

You can run ./dotarchy-doctor.sh to check if your current setup is correct and if all necessary components are installed.