https://github.com/cyrof/dotfiles-i3
My personal i3wm configuration files for a clean, efficient, and minimalist workflow.
https://github.com/cyrof/dotfiles-i3
archlinux dotfiles-linux i3wm i3wm-config linux tiling-window-manager
Last synced: 29 days ago
JSON representation
My personal i3wm configuration files for a clean, efficient, and minimalist workflow.
- Host: GitHub
- URL: https://github.com/cyrof/dotfiles-i3
- Owner: Cyrof
- License: apache-2.0
- Created: 2024-11-20T08:33:45.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-01-01T14:22:26.000Z (10 months ago)
- Last Synced: 2025-01-21T11:45:09.008Z (9 months ago)
- Topics: archlinux, dotfiles-linux, i3wm, i3wm-config, linux, tiling-window-manager
- Language: Shell
- Homepage:
- Size: 34.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `~/.dotfiles-i3`
This repository contains the configuration files for my environment, organised under a single `.config/` directory. Each subfolder holds settings for a specific application and includes its own `README.md` with detailed setup and customisation instructions.
## Repository Structure
``` bash
.
├── .config
│ ├── i3
│ ├── kitty
│ ├── nvim
│ ├── picom
│ ├── polybar
│ └── rofi
├── .gitignore
├── LICENSE
├── README.md
└── .stow-local-ignore
```
## Prerequisites
Install the following packages (example for Arch Linux):
``` bash
sudo pacman -S i3-gaps kitty neovim picom polybar rofi
```
Make sure you have **GNU Stow** Installed for symlinking:
``` bash
sudo pacman -S stow
```
## Installation
1. **Clone** this repo:
``` bash
git clone https://github.com/Cyrof/dotfiles-i3.git
```
2. **Create** or switch to your home `.config` target:
``` bash
cd ~/dotfiles-i3
```
3. **Symlink** the entire `.config` folder into your `$HOME`:
``` bash
stow -v --target="$HOME" .config
```
4. **Reload** or restart your applications:
``` bash
# i3 example
i3-msg reload
```
## Quick Start
- **i3**: Mod + Return opens Kitty, Mod + D opens Rofi.
- **Neovim**: Launch via `nvim`, then run `:Lazy sync` to install plugins.
- **Polybar**: Auto-started with the provided `launch.sh` script.
- **Picom** & **Rofi**: Automatically loaded by i3 on startup.
Each folder's `README.md` has full details on customisation, keybindings, and troubleshooting.