https://github.com/voidashi/.dotfiles

Dotfiles backup tooling and files
https://github.com/voidashi/.dotfiles

dotfiles dotfiles-automation dotfiles-linux dotfiles-manager dotfiles-setup linux

Last synced: about 1 month ago
JSON representation

Dotfiles backup tooling and files

• Host: GitHub
• URL: https://github.com/voidashi/.dotfiles
• Owner: voidashi
• License: mit
• Created: 2024-05-22T06:34:48.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-09T22:31:17.000Z (over 1 year ago)
• Last Synced: 2025-02-09T23:25:14.431Z (over 1 year ago)
• Topics: dotfiles, dotfiles-automation, dotfiles-linux, dotfiles-manager, dotfiles-setup, linux
• Language: Lua
• Homepage:
• Size: 264 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🖥️ Zen Linux Dotfiles

*A curated collection of minimal, performant, and aesthetic Linux configurations*

[![Linux](https://img.shields.io/badge/OS-Linux-informational?style=flat&logo=linux&logoColor=white)](https://www.linux.org/)

[![Arch](https://img.shields.io/badge/Distro-Arch_Linux-informational?style=flat&logo=arch-linux&logoColor=white)](https://archlinux.org/)

[![License](https://img.shields.io/badge/License-MIT-green?style=flat)](LICENSE)

![Hyprland Screenshot 1](docs/screenshot1.png)

![Hyprland Screenshot 2](docs/screenshot2.png)

## 📦 Features

### **Core Components**

- Window Managers: Hyprland + Sway (Wayland)

- Terminals: Ghostty • Alacritty • Kitty • Foot

- Shell: Fish with Starship prompt

- Editor: Neovim

- System: Bottom • Dunst • Waybar • Wofi

### **Key Configurations**

- Unified theming (Kanagawa Dragon)

- Performance-optimized WM rules

- Battery-friendly power management

- Context-aware workspace layouts

- Seamless clipboard integration

### **Automation Tools**

- `backup-configs.sh` - Smart config synchronization

- `install-packages.sh` - Cross-distro package installer

- 1-click restore for new installations

## 🚀 Installation

### Quick Start (For Brave Souls)

```bash

git clone https://github.com/voidashi/.dotfiles.git ~/.dotfiles

cd ~/.dotfiles

# Install packages

./scripts/install-packages.sh install

# Install configs

./scripts/backup-configs.sh install

```

**Note:** Review config files before running install scripts!

## 🗂️ Structure

```

.

├── .config/               # Main config directory

│   ├── hypr/            # Hyprland window manager

│   ├── nvim/            # Neovim IDE setup

│   ├── fish/            # Fish shell configuration

│   └── ...              # Other app configs

├── scripts/              # Maintenance utilities

├── wallpapers/           # Curated desktop backgrounds

...

```

## 🔧 Customization

1. Edit `scripts/config_files.conf` to select tracked configurations

2. Modify `scripts/packages.conf` to add/remove applications

## 🤝 Contributing

Found a bug? Have an improvement?  

- Open an issue for feature requests

- Submit PRs for well-documented fixes

- Share your modified configs in Discussions

## 📜 License

MIT Licensed - See [LICENSE](LICENSE) for details

---

*Inspired by the Linux ricing community • Built with ❤️ and too much coffee*