Excalith Dotfiles

Features

• Fully customizable installation depending on OS
• The installer is seperated from configs and install scripts
• A dotfiles manager for post-install maintenance
• Has post-install scripts for configuring git, ssh and gpg
• Requires git commands for syncing without fancy dotfile managers

Uses

• Supports bash, zsh, fish, cmd and powershell with starship shell prompt and has tmux support except for cmd and powershell
• Replaces default terminal with Alacritty

Installation

Caution

If you have no idea what a dotfile is all about, please do not simply run these commands. They will override your configurations with my configurations and install bunch of packages.

Depending on your OS, copy and paste the code to start installation. This code will download my dotfiles and start setup depending on your OS.

MacOS 12.0 Monterey (and above)

bash -c "$(curl -LsS https://raw.github.com/excalith/.dotfiles/main/scripts/setup.sh)"

Ubuntu 22.04 Jammy Jellyfish (and above)

bash -c "$(wget --no-cache -qO - https://raw.github.com/excalith/.dotfiles/main/scripts/setup.sh)"

Arch Linux

bash -c "$(wget --no-cache -qO - https://raw.github.com/excalith/.dotfiles/main/scripts/setup.sh)"

Lite Version

This is a minimal installation for Termux app on Android.

bash -c "$(curl -LsS https://raw.github.com/excalith/.dotfiles/main/system/lite/install.sh)"

Windows (10 and above)

Windows

Allow remote scripts to run

# Allows you to run the script from remote
Set-ExecutionPolicy Bypass -Scope Process

# Allows you to run scripts locally
Set-ExecutionPolicy RemoteSigned -Force
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

Download the dotfiles and start setup

Invoke-Expression (Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/excalith/.dotfiles/main/scripts/setup.ps1').Content

Reset Execution Policy

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted

WSL Ubuntu

To install packages for WSL Ubuntu, run the following command on WSL terminal.

bash -c "$(wget --no-cache -qO - https://raw.github.com/excalith/.dotfiles/main/scripts/setup.sh)"

Post-Installation

Optionally, if you want to set upstream with this repository, you can run the following command.

# Initialize git repository
git init

# Add this repository as remote
git remote add origin [email protected]:excalith/.dotfiles.git

# Fetch the main branch
git fetch origin main

# Reset the dotfiles folder and replace with main branch
git reset --hard origin/main

Using Dotfiles

After installing the dotfiles, you can pretty much start using these configurations right away.

• All changes to configuration files will be recognized by git as modified within dotfiles folder except for the config files created with .local suffix.
• You can use dotfiles command for dotfile manager script for running maintenance commands.

Making Your Own Dotfiles

If you want to create your own dotfiles based on my configuration, you should

1. Fork or download this repository
2. Update setup script with your repository settings (do not change the preset .dotfiles path)
3. Change the configurations and packages as you wish
4. Push your changes to your own repository
5. Run setup bash commands

Credits

This dotfiles repository is a heavily knocked-off inspired version of beautiful Cătălin’s dotfiles. You should probably check it out!

I have modified this dotfiles with my own taste of config files and added a bunch of helpers and utilities to install packages, extensions etc. from different sources that I trust. I tried to seperate installation system and OS-spesific configurations as much as I can, so it would be easier to implement new OS setups which I might do later.

License

The code is available under the MIT license.