:warning: <samp>README</samp>

This repository is no longer actively maintained as I no longer use Linux for daily use. Use at your own risk.

:herb: <samp>INFORMATION</samp> <img alt="" align="right" src="https://badges.pufler.dev/visits/janleigh/dotfiles?style=for-the-badge&color=A7D9B2&logoColor=white&labelColor=1C2325"/>

Thanks for dropping by! This is my personal repository of my dotfiles.

The setup section will guide you through a step-by-step installation process.

Here are more information about my setup:

Window Manager: bspwm
Terminal: alacritty
Shell: zsh
Panel: eww
Compositor: picom
Editor: neovim
Browser: firefox
Notification Daemon: dunst
File Manager: thunar
Application Launcher: rofi

:wrench: <samp>SETUP</samp>

<table align="right"> <tr> <th align="center"> <sup><sub>:warning: WARNING :warning:</sub></sup> </th> </tr> <tr> <td align="center"> <sup> <sub> <samp> THIS DOTFILES IS CONFIGURED AT 1366x768 WITH 96 DPI!<br> SOME STUFF MIGHT BREAK ON LOWER OR HIGHER <p align="center"> RESOLUTIONS BUT WILL STILL WORK! </p> </samp> </sub> </sup> </td> </tr> </table>

This is step-by-step how to install these dotfiles. Just R.T.F.M.

First of all, this repository contains submodules. Ensure they are updated before installing.

Make sure to have Git LFS installed since it's being used for the wallpaper submodule.

 $ git clone --recurse-submodules https://github.com/janleigh/dotfiles.git
 $ cd dotfiles && git submodule update --remote --merge

<samp><kbd>I.</kbd> INSTALLATION (DEPENDENCIES)<samp>

<details> <summary><strong>Arch Linux (and other Arch-based distributions)</strong></summary>

Assuming your AUR Helper is paru.

 $ paru -S --needed bspwm sxhkd rofi neovim alacritty viewnior picom-arian8j2-git brightnessctl \
           playerctl hsetroot maim jq xclip imagemagick dunst i3lock-color xdo giph \ 
           jgmenu redshift blueman bluetoothctl

</details> <details> <summary><strong>Debian (and other Debian-based distributions) <kbd>UPDATES NEEDED</kbd></strong></summary>

 $ sudo apt install --no-install-recommends bspwm sxhkd rofi neovim alacritty viewnior \
                  picom brightnessctl playerctl mpd mpdris2 hsetroot maim jq xclip \
                  imagemagick xdo jgmenu

For i3-lock and giph, you need to build it from source.

i3lock

 $ sudo apt install autoconf gcc make pkg-config libpam0g-dev libcairo2-dev libfontconfig1-dev \
                  libxcb-composite0-dev libev-dev libx11-xcb-dev libxcb-xkb-dev libxcb-xinerama0-dev \
                  libxcb-randr0-dev libxcb-image0-dev libxcb-util0-dev libxcb-xrm-dev libxkbcommon-dev \
                  libxkbcommon-x11-dev libjpeg-dev

 $ git clone https://github.com/Raymo111/i3lock-color.git
 $ cd i3lock-color

 $ ./build.sh

 $ ./install-i3lock-color.sh

giph

 $ sudo apt install ffmpeg xdotools

 $ git clone https://github.com/phisch/giph.git
 $ cd giph
 $ sudo make install

</details> <details> <summary><strong>Other Independent Linux Distributions</strong></summary>

The Linux philosophy is ‘Laugh in the face of danger’.
Oops. Wrong One. ‘Do it yourself’.

- Linus Torvalds

</details>

<samp><kbd>II.</kbd> INSTALLATION (DOTFILES)<samp>

Then after the dependencies are installed, copy the files to it's respective folders.

<details> <summary><strong>Fonts</strong></summary>

NOTE: Only important fonts has been listed on the table above.

 $ cp -r ./etc/fonts/* $HOME/.local/share/fonts

</details>  </details> <details> <summary><strong>Configuration Files and Binaries</strong></summary>

rsync method <kbd>RECOMMENDED</kbd>
```
 $ mkdir -p $HOME/.config/ && rsync -avxHAXP cfg/ $HOME/.config
 $ mkdir -p $HOME/.local/bin/ && rsync -avxHAXP --exclude 'bin/usr/' bin/ $HOME/.local/bin/

 # To make tabbed and chwb2 to work, you must move it to /usr/local/bin.
 $ sudo rsync -avxHAXP bin/usr/ /usr/local/bin/
```
WARNING: Ensure the rsync command must be correct as above.

| Options | Function | | ----------- | ----------------------------------------------------- | | -a | Archive mode | | -v | Verbose mode | | -x | Don't cross filesystem boundaries | | -H | Preserve hard links | | -A | Preserve ACLs/permissions | | -X | Preserve extended attributes | | -P | Show progress during transfer | | --exclude | Exclude files matching PATTERN |

cp method

 $ mkdir -p $HOME/.config/ && cp -r ./cfg/* $HOME/.config/
 $ mkdir -p $HOME/.local/bin/ && cp -r ./bin/* $HOME/.local/bin/

 # To make tabbed and chwb2 to work, you must move it to /usr/local/bin.
 $ sudo mv $HOME/.local/bin/usr/* /usr/local/bin/

DIFFERENCES

cp is for duplicating stuff and by default only ensures files have unique full path names.

rsync is for synchronizing stuff and uses size and timestamp of files to decide if they should be replaced.

I also recommend to not delete the dotfiles directory after cloning to make upgrades easier.

</details>

<samp><kbd>III.</kbd> INSTALLATION (FINALIZING)<samp>

Once finished copying the files, you might want to finalize the changes to your system.

<details> <summary><strong>Regenerating font cache</strong></summary>

This ensures all existing caches are cleared and regenerated for all installed fonts.

 $ fc-cache -v

</details> <details> <summary><strong>Finalizing installation</strong></summary>

Lastly, log out from your current desktop session and log in into bspwm.

If you're using ~/.xinitrc, simply add the following line at the end.

 exec bspwm

</details>

:rocket: <samp>MISCELLANEOUS</samp>

GTK and Icon Theme
<details> <summary><strong>See</strong></summary>

You can find the custom GTK theme here. You can then apply it by changing the value of gtk-theme-name to janleigh-phocus on your GTK3 config.

For the icon theme, you can install Zafiro Icons icon theme since it suits the GTK theme.

</details>
Cursor Theme
<details> <summary><strong>See</strong></summary>

You can install volantes-cursors or [phinger-cursors

Dotfiles

Install / Use

README

:warning: <samp>README</samp>

:herb: <samp>INFORMATION</samp> <img alt="" align="right" src="https://badges.pufler.dev/visits/janleigh/dotfiles?style=for-the-badge&color=A7D9B2&logoColor=white&labelColor=1C2325"/>

:wrench: <samp>SETUP</samp>

<samp><kbd>I.</kbd> INSTALLATION (DEPENDENCIES)<samp>

<samp><kbd>II.</kbd> INSTALLATION (DOTFILES)<samp>

<samp><kbd>III.</kbd> INSTALLATION (FINALIZING)<samp>

:rocket: <samp>MISCELLANEOUS</samp>