Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/hynduf/dotfiles

Aesthetic Dotfiles for my Arch Linux rabbit hole 🐇
https://github.com/hynduf/dotfiles
arch-linux bspwm dotfiles linux neovim obsidian polybar rice rofi
Last synced: 22 days ago
JSON representation
Aesthetic Dotfiles for my Arch Linux rabbit hole 🐇
Host: GitHub
URL: https://github.com/hynduf/dotfiles
Owner: HynDuf
License: gpl-3.0
Created: 2022-05-29T15:37:40.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-06-10T01:37:16.000Z (5 months ago)
Last Synced: 2024-10-14T07:40:52.891Z (22 days ago)
Topics: arch-linux, bspwm, dotfiles, linux, neovim, obsidian, polybar, rice, rofi
Language: CSS
Homepage:
Size: 60 MB
Stars: 302
Watchers: 4
Forks: 13
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project

README

        
 ━━━━━━  ❖  ━━━━━━ 




[![stars](https://img.shields.io/github/stars/HynDuf7/dotfiles?color=C9CBFF&labelColor=1A1B26&style=for-the-badge)](https://github.com/HynDuf7/dotfiles/stargazers)

[![size](https://img.shields.io/github/repo-size/HynDuf7/dotfiles?color=9ece6a&labelColor=1A1B26&style=for-the-badge)](https://github.com/HynDuf7/dotfiles)

[![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2FHynDuf7%2Fdotfiles&label=View&labelColor=%231a1b26&countColor=%23e0af68)](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2FHynDuf7%2Fdotfiles)

[![license](https://img.shields.io/github/license/HynDuf7/dotfiles?color=FCA2AA&labelColor=1A1B26&style=for-the-badge)](https://github.com/HynDuf7/dotfiles/blob/main/LICENSE.md)





# HynDuf's dotfiles

> [!IMPORTANT]

> I have migrated everything to NixOS, so this is no longer maintained and might not work out of the box. See my latest [NixOS configs](https://github.com/HynDuf/nixos-conf) for more up-to-date configurations of the programs.

## :pencil: Table of contents

- [:herb: About](#about)

- [:camera: Showcase](#showcase)

    - [Overview](#overview) 

    - [Rofi Utils](#rofi-utils)

    - [Fonts](#fonts)

- [:wrench: Set up](#setup)

    - [Preinstall](#preinstall)

    - [Dependency](#dependency)

    - [Background Wallpaper](#background-wallpaper)

    - [Firefox](#firefox)

    - [Obsidian](#obsidian)

    - [Polybar](#polybar)

    - [Dunst](#dunst)

    - [Rofi and Eww](#rofi-and-eww)

    - [Picom](#picom)

    - [Sxhkd Keybindings](#sxhkd-keybindings)

    - [Others](#others)

- [:tada: Credits](#credits)



## :herb: About







Thanks for dropping by! 

This is my personal repository for my Arch dotfiles (always WIP)

Here are some information about my setup: 

- Window Manager: [`bspwm`](https://github.com/baskerville/bspwm)

- Compositor: [`picom`](https://github.com/pijulius/picom)

- Terminal: [`kitty`](https://github.com/kovidgoyal/kitty)

- Shell: [`zsh`](https://www.zsh.org/)

- Editor: [`neovim`](https://github.com/neovim/neovim) ([`nvchad`](https://nvchad.github.io/))

- Panel: [`polybar`](https://github.com/polybar/polybar)

- Notification Manager: [`dunst`](https://github.com/dunst-project/dunst)

- Application Launcher: [`rofi`](https://github.com/davatorium/rofi)

- File Manager: [`ranger`](https://github.com/ranger/ranger)



## :camera: Showcase



### Overview

Here are some details about programs in the screenshots:

- **Color schemes**: a combination of [`catppuccin`](https://github.com/catppuccin) and [`tokyonight`](https://github.com/zatchheems/tokyo-night-alacritty-theme/blob/main/tokyo-night.yaml)

- **Theme**: [`catppuccin gtk`](https://github.com/catppuccin/gtk) and [`catppuccin cursor`](https://github.com/catppuccin/cursors)

- **System fetch**: a bash script taken somewhere on **r/unixporn** ([`bin/sysfetch`](https://github.com/HynDuf7/dotfiles/blob/main/bin/sysfetch))

- **Audio visualizer**: [`cava`](https://github.com/karlstav/cava)

- **Eww calendar**: [`calendar`](https://github.com/HynDuf7/dotfiles/tree/main/.config/eww)

- **File manager**: [`ranger`](https://github.com/ranger/ranger) with [`ranger devicons`](https://github.com/alexanderjeurissen/ranger_devicons) and [`ueberzug`](https://github.com/seebye/ueberzug) image previewer

- **Pipes script**: [`pipes.sh`](https://github.com/pipeseroni/pipes.sh)

- **Notification center**: [`script`](https://github.com/HynDuf7/dotfiles/blob/main/bin/noticenter) combine [`rofi configuration`](https://github.com/HynDuf7/dotfiles/blob/main/.config/rofi/themes/noticenter.rasi) with [`dunst notification logger`](https://github.com/HynDuf7/dotfiles/blob/main/bin/dunst-logger) (~~copied~~ inspired by [`Barbaross/Nebula dotfiles`](https://gitlab.com/Barbaross/Nebula))

- **Discord theme**: [`tokyonight theme`](https://betterdiscord.app/theme/Tokyo%20Night) (taken from BetterDiscord theme store)

- **Firefox**: [`beautiful custom css theme`](https://github.com/AmadeusWM/dotfiles-hyprland#firefox) by [`AmadeusWM`](https://github.com/AmadeusWM) and [`Github`](https://github.com/catppuccin/github), [`Youtube`](https://github.com/catppuccin/youtube) Stylus theme.

- **Note-taking**: [`obsidian`](https://obsidian.md/) with [`AnuPpuccin`](https://github.com/AnubisNekhet/AnuPpuccin) theme (with 40+ plugins).

- **Flashcards study**: [`anki`](https://apps.ankiweb.net/) with Catppuccin theme and some additional plugins

- **Text editor**: [`neovim`](https://github.com/neovim/neovim) with [`nvchad`](https://nvchad.github.io/) ([`custom folder`](https://github.com/HynDuf7/dotfiles/tree/main/.config/nvim/lua/custom))

- **PDF reader**: 

    - [`zathura`](https://github.com/pwmt/zathura) with [`catppuccin theme`](https://github.com/catppuccin/zathura) (and some color configs)

    - [`zotero`](https://github.com/zotero/zotero) with additional plugins

- **Spotify theme**: [`spicetify`](https://spicetify.app/docs/getting-started) with [`catppuccin theme`](https://github.com/catppuccin/spicetify)

- **Screen lock**: [`script`](https://github.com/HynDuf7/dotfiles/blob/main/bin/screen-lock) using [`i3lock-color`](https://github.com/Raymo111/i3lock-color)

![overview-1](assets/preview-1.png)

![overview-2](assets/preview-2.png)

![overview-3](assets/showcase-discord-ranger.png)

![overview-4](assets/showcase-firefox.png)

![overview-5](assets/showcase-english.png)

![overview-6](assets/showcase-neovim.png)

![overview-7](assets/showcase-obsidian.png)

![overview-8](assets/showcase-zotero-obsidian.png)

![overview-9](assets/showcase-spotify.png)

![overview-10](assets/showcase-screen-lock.png)





### Rofi Utils

These rofi configurations are highly based on [adi1090x/rofi](https://github.com/adi1090x/rofi) (it's not like I just copied it and changed some colors or anything :flushed:)



##### Rofi app launchers, directory menu and windows menu

![app-menu](assets/app-menu.png)

![directory-menu](assets/directory-menu.png)

![windows-menu](assets/windows-menu.png)



##### Rofi calculator, emoji selector and wifi menu

![calculator](assets/calculator.png)

![emoji-menu](assets/emoji-menu.png)

![wifi-menu](assets/wifi-menu.png)



##### Rofi power menu

![rofi-power-menu](assets/rofi-power-menu.png)





### Fonts

- [`JetBrainsMono Nerd Font`](https://github.com/jtbx/jetbrainsmono-nerdfont)

- [`Iosevka Nerd Font`](https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/Iosevka)

- [`FiraCode`](https://github.com/tonsky/FiraCode) (for `lxappearance` font theme)

- [`Material Icon and Feathers`](https://github.com/Murzchnvok/polybar-collection#prerequisites) (for polybar)



## :wrench: Set up

:warning: **Note**: This configuration was made for my Laptop (Arch-based distribution specifically), so some things might not work on yours, in that case, please try if you can fix that up as much as possible, or you can open an issue for help :smile:.

This was made for a `1920x1080` and `75` dpi screen.

Most programs can be installed and used easily by following guides from their own GitHub (I already added as many links as possible). Some other harder ones I'll state below.





### Preinstall

Just to be tidy, create a folder for your about-to-download packages as you would want to delete redundant things afterward.

```sh

mkdir ~/Downloads

cd ~/Downloads

```

Clone my dotfiles in advance for later uses (`~/Downloads/dotfiles`):

```sh

git clone https://github.com/HynDuf7/dotfiles

```

Let's set up the necessary scripts. Copy them to yours and grant execute permission (You don't need all the scripts. You can keep only the ones you need):

```sh

cp -r ~/Downloads/dotfiles/bin ~/bin

chmod +x ~/bin/*

```

Add that `~/bin` folder to your `$PATH` as well, in your `.bashrc` or `.zshrc` add the following:

```sh

export PATH="$HOME/bin:$PATH"

```

After that, `source ~/.zshrc` (or `source ~/.bashrc`) to update it though.





### Dependency

First, we need `yay` and `git` (if you haven't had them):

```sh

sudo pacman -S --needed git base-devel

git clone https://aur.archlinux.org/yay.git

cd yay

makepkg -si

```

Then let's install all the needed packages:

```sh

yay -S bspwm brightnessctl dunst eww-git feh i3lock-color nerd-fonts-jetbrains-mono polybar pomo papirus-icon-theme ranger rofi rofi-calc rofi-emoji sxhkd ttf-fira-code ttf-iosevka-nerd ueberzug xdotool

```





### Background Wallpaper

Copy the wallpapers into your `~/Pictures` folder:

```sh

cp -r ~/Downloads/dotfiles/wallpapers ~/Pictures

```

We will use `feh` to set up the wallpaper.

Add the following into your `~/.config/bspwm/bspwmrc` (see [`mine`](https://github.com/HynDuf7/dotfiles/blob/main/.config/bspwm/bspwmrc)):

```sh

feh --bg-fill ~/Pictures/hollow-knight.png &

```





### Firefox

I used the [beautiful custom css theme](https://github.com/AmadeusWM/dotfiles-hyprland#firefox) made by [AmadeusWM](https://github.com/AmadeusWM).

You can see how to install it on his dotfiles linked above.

My [firefox custom chrome](https://github.com/HynDuf/dotfiles/tree/main/.config/firefox/chrome) folder isn't exactly like his. I have added the shortcut `Super + Z` to toggle expand the vertical side tab. If you want do the same, see [this reddit thread](https://www.reddit.com/r/unixporn/comments/zbbp7z/comment/iyu36r6/?utm_source=share&utm_medium=web2x&context=3) for hints.

![overview-11](assets/showcase-firefox-tab.png)





### Obsidian

I love Obsidian. It plays an important role in changing my life. I have templates for all kinds of things and it helps me organize my knowledge and life a lot easier.

I haven't included any thing about Obsidian here yet. But I will create a repo for my Obsidian workflow soon. Follow me for further details.

![overview-12](assets/showcase-obsidian-daily.png)

![overview-12](assets/showcase-obsidian-graph.png)

![overview-12](assets/showcase-obsidian-notes.png)





### Polybar

![polybar](assets/polybar.png)

Firstly, let's install `Material Icon and Feathers` for our `polybar` icons.

```sh

mkdir ~/.fonts

cd ~/Downloads

git clone https://github.com/Murzchnvok/polybar-collection

cp -r ./polybar-collection/fonts/* ~/.fonts/

fc-cache -fv

```

Copy my `polybar` setup into yours:

```sh

cp -r ~/Downloads/dotfiles/.config/polybar ~/.config/polybar

```

Enable autostart `polybar` when starting `bspwm`:

```sh

chmod +x ~/.config/polybar/launch.sh

```

Then add this to your `~/.config/bspwm/bspwmrc` (see [`mine`](https://github.com/HynDuf7/dotfiles/blob/main/.config/bspwm/bspwmrc))

```sh

$HOME/.config/polybar/launch.sh &

```

:warning: Note: My `~/.config/bspwm/bspwmrc` file is not for straight copying. There are many things that are personal and unrelated (can cause confusion if you don't understand what they are for). Use it responsibly.

:exclamation: Note: The below section in the `polybar` is from [`pomo`](https://github.com/kevinschoon/pomo) package which is a pomodoro timer. When running, it would update in the `polybar`.

![pomo](assets/pomo.png)

![pomo-1](assets/pomo-1.png)

There are the [`network`](https://github.com/polybar/polybar/wiki/Module:-network) module and [`battery`](https://github.com/polybar/polybar/wiki/Module:-battery) module that might need to be changed accordingly to your machine. See the `polybar` wiki link given.





### Dunst

Copy my `dunst` configuration into yours:

```sh

cp -r ~/Downloads/dotfiles/.config/dunst ~/.config/dunst

```

Add `dunst` startup to your `~/.config/bspwm/bspwmrc` (see [`mine`](https://github.com/HynDuf7/dotfiles/blob/main/.config/bspwm/bspwmrc)):

```sh

dunst -conf $HOME/.config/dunst/dunstrc &

```





### Rofi and Eww

Copy my `rofi` and `eww` configuration into yours:

```sh

cp -r ~/Downloads/dotfiles/.config/rofi ~/.config/rofi

cp -r ~/Downloads/dotfiles/.config/eww ~/.config/eww

```

In my `~/.config/sxhkd/sxhkdrc` file, you can see some related keybindings:

```

super + c

    rofi -show drun -theme "$HOME/.config/rofi/themes/app-launcher.rasi"

super + alt + z

	~/bin/powermenu

super + shift + c

    rofi -show calc -modi calc -theme "$HOME/.config/rofi/themes/calc.rasi"

super + shift + x

    ~/bin/noticenter

super + shift + z

    ~/bin/wifimenu

super + shift + f

    ~/bin/calendar-launcher

super + shift + e

    rofi -modi emoji -show emoji -theme "$HOME/.config/rofi/themes/emojimenu.rasi"

```

From those, you can imply that the command to run the rofi utils are (Bind it to your key mappings or use my [`sxhkdrc`](https://github.com/HynDuf7/dotfiles/blob/main/.config/sxhkd/sxhkdrc)):

- App launcher/Directory menu/Windows menu:

    ```sh

    rofi -show drun -theme "$HOME/.config/rofi/themes/app-launcher.rasi"

    ```

    There are some [`rofi keybindings`](https://github.com/HynDuf7/dotfiles/blob/main/.config/rofi/config.rasi) that you can learn to use to navigate.

- Calculator (remember the package `rofi-calc` we have already downloaded at [Dependency](#dependency)):

    ```sh

    rofi -show calc -modi calc -theme "$HOME/.config/rofi/themes/calc.rasi"

    ```

- Emoji selector (package `rofi-emoji`):

    ```sh

    rofi -modi emoji -show emoji -theme "$HOME/.config/rofi/themes/emojimenu.rasi"

    ```

- Power menu:

    ```sh

    ~/bin/powermenu

    ```

- Notification center:

    ```sh

    ~/bin/noticenter

    ```

- Wifi menu:

    ```sh

    ~/bin/wifimenu

    ```

- Calendar (This is `eww` widgets and not rofi):

    ```sh

    ~/bin/calendar-launcher

    ```

:exclamation: In case the background image on the input bar doesn't appear, double check that you have done copied all the images to your `~/Pictures` folder in [Background Wallpaper](#background-wallpaper). All the `rofi` themes used this [background image](https://github.com/HynDuf7/dotfiles/blob/main/wallpapers/hollow.jpg).





### Picom

:exclamation: I have changed to default `picom` (install through normal `yay -S picom`) for calmer experience. If you still want fancy animations, please proceed. 

This is a `picom` fork with splendid animations, so we have to build it on our own.

First install all the dependencies required to build the compositor:

```sh

yay -S libconfig libev libxdg-basedir pcre pixman xcb-util-image xcb-util-renderutil hicolor-icon-theme libglvnd libx11 libxcb libxext libdbus asciidoc uthash

```

Then let's build it:

```sh

cd ~/Downloads

git clone https://github.com/pijulius/picom.git

cd picom/

meson --buildtype=release . build --prefix=/usr -Dwith_docs=true

sudo ninja -C build install

```

Copy my `picom` configuration into yours:

```sh

cp -r ~/Downloads/dotfiles/.config/picom ~/.config/picom

```

Then enable `picom` start-up when starting `bspwm` by adding this to your `~/.config/bspwm/bspwmrc` (see [`mine`](https://github.com/HynDuf7/dotfiles/blob/main/.config/bspwm/bspwmrc))

```sh

picom &

```

:exclamation: Set your bspwm border to `0` for better experience with this `picom` fork.





### Sxhkd Keybindings

This is some main keybindings in my [`sxhkdrc keybindings`](https://github.com/HynDuf7/dotfiles/blob/main/.config/sxhkd/sxhkdrc) if you happen to use it:

|Action|Keybinding|

|---|---|

|App launcher|super + c|

|Toggle polybar|super + x|

|Terminal|super + Return|

|Restart bspwm|super + alt + r|

|Reload sxhkd|super + Esc|

|Close program|super + w|

|Quit bspwm|super + alt + q|

|Increase/Decrease brightness|super + F10/F11|

|Increase/Decrease volume|super + shift + F10/F11|





### Others

For other ones please follow the link to the application you want to install and do it on your own. I believe you can do it in no time. Good luck :wink:

:exclamation: In case you are desperately stuck, open an issue. I would consider updating additional guides for the ones you need.



## :tada: Credits

- `README.md` inspired by [janleigh/dotfiles](https://github.com/janleigh/dotfiles) and [beyond9thousand/dotfiles](https://github.com/beyond9thousand/dotfiles)

- [siduck](https://github.com/siduck) for the incredible [nvchad](https://github.com/NvChad/NvChad) and for helping out all the time

- [r/unixporn](https://www.reddit.com/r/unixporn/) for endless inspiration