0xNiri

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #llm #golang #rust #macos #awesome #vue #awesome-list #mcp #openai #open-source

(★ 71)

Personal dots for NiriWM

0xNiri Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

```text
   ____       _   ___      _ 
  / __ \_  __/ | / (_)____(_)
 / / / / |/_/  |/ / / ___/ /
/ /_/ />  </ /|  / / /  / /
\____/_/|_/_/ |_/_/_/  /_/
```

Personal dotfiles for the [Niri](https://github.com/YaLTeR/niri) Wayland compositor.

## Preview

https://github.com/user-attachments/assets/1c32cad1-fdbe-4d2e-bb4a-81acc03eaf0a

## Features

- Waybar auto-hide script.
- Auto-generate application color scheme from wallpaper.
- Full desktop-like experience on a minimal **Niri** setup.

## Tools & Utilities

## Installation

> [!NOTE]
> This setup is intended for Arch-based distributions.

### Automated [Under Developement]

> [!WARNING]
> Manual Installation is recommended. This is still under development.

> [!NOTE]
> This may overwrite your existing config. Backup your old config files.

```bash
git clone https://github.com/rickinshah/0xNiri.git ~/0xNiri
cd ~/0xNiri
chmod +x install.sh
./install.sh
```

### Manual

#### 1. Clone the repo
```bash
git clone https://github.com/rickinshah/0xNiri.git ~/0xNiri
cd ~/0xNiri
```

#### 2. Install required packages

##### Install `yay`
```bash
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git ~/yay
cd ~/yay
makepkg -si
rm -rf ~/yay
```

##### Install packages
```bash
yay -S --needed --noconfirm - < ~/0xNiri/packages.list
```

##### Install optional packages
```bash
yay -S --needed --noconfirm - < ~/0xNiri/optional-packages.list
```

#### 3. Set `fish` as default shell
```bash
chsh -s /bin/fish
```

#### 4. Setup config files
```fish
cp -r ~/0xNiri/.config/. ~/.config/
```

#### 5. Setup scripts

##### Move scripts to `~/.local/share/bin`
```fish
mkdir -p ~/.local/share/bin
cp -r ~/0xNiri/bin/. ~/.local/share/bin
```

##### Add `~/.local/share/bin` to `PATH` variable
```fish
fish_add_path -a ~/.local/share/bin
```

> [!WARNING]
> Some keybindings or systemd services may not work if `~/.local/share/bin` is not added to your `PATH` variable.

#### 6. Start the essential startup applications. [Refer to this section](#startup-applications)

#### 7. `Logout` or `Restart`

#### 8. Post Installation

##### Set GTK Theme
```fish
gsettings set org.gnome-desktop.interface gtk-theme "'adw-gtk3-dark'"
```

##### Set Wallpaper
```fish
set-wallpaper ~/.config/niri/wallpaper.jpg
```

## Startup Applications

Startup applications are managed using `systemd` — as recommended in [official Niri documentation](https://github.com/YaLTeR/niri/wiki/Example-systemd-Setup)

Custom unit files are stored in: `~/.config/systemd/user`

### Essential Services

### Optional Services

#### Enable services with:
```fish
systemctl --user add-wants niri.service <service>.service
```

#### For example:
```fish
systemctl --user add-wants niri.service waybar.service
systemctl --user add-wants niri.service syshud.service
```

## Useful Locations

#### Go through following locations to make your life easier.

- Configs - `~/.config`
- Scripts - `~/.local/share/bin`
- Services - `~/.config/systemd/user`

## Credits

- [Icon Theme](https://github.com/catppuccin/papirus-folders)
- [Matugen](https://github.com/InioX/matugen)
- [Matugen Configs](https://github.com/InioX/matugen-themes)

0xNiri

0xNiri Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

0xNiri

0xNiri Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README