Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/excalith/.dotfiles
My MacOS, Ubuntu, Arch Linux, Windows and WSL dotfiles with a custom installer and various helpers
https://github.com/excalith/.dotfiles
apt arch bash brew debian dotfiles fish linux macos neovim shell starship starship-prompt tmux ubuntu windows wsl zsh
Last synced: 22 days ago
JSON representation
My MacOS, Ubuntu, Arch Linux, Windows and WSL dotfiles with a custom installer and various helpers
- Host: GitHub
- URL: https://github.com/excalith/.dotfiles
- Owner: excalith
- License: mit
- Created: 2023-01-14T09:30:29.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-23T09:16:54.000Z (3 months ago)
- Last Synced: 2024-12-23T02:32:17.353Z (about 1 month ago)
- Topics: apt, arch, bash, brew, debian, dotfiles, fish, linux, macos, neovim, shell, starship, starship-prompt, tmux, ubuntu, windows, wsl, zsh
- Language: Shell
- Homepage:
- Size: 26.3 MB
- Stars: 20
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
Excalith Dotfiles
## Features
- Fully customizable installation depending on OS
- The [installer](scripts/) is seperated from configs and install scripts
- A [dotfiles manager](bin/dotfiles/main.sh) 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
bash -c "$(curl -LsS https://raw.github.com/excalith/.dotfiles/main/scripts/setup.sh)"
```
### Ubuntu 22.04 Jammy Jellyfish (and above)
```bash
bash -c "$(wget --no-cache -qO - https://raw.github.com/excalith/.dotfiles/main/scripts/setup.sh)"
```
### Arch Linux
```bash
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
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
```ps
# 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
```ps
Invoke-Expression (Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/excalith/.dotfiles/main/scripts/setup.ps1').Content
```
Reset Execution Policy
```ps
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted
```
#### WSL Ubuntu
To install packages for WSL Ubuntu, run the following command on WSL terminal.
```bash
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.
```bash
# 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](scripts/setup.sh) 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](https://github.com/alrra/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](LICENSE).