ModernDark - Dotfiles to create an almost full-fledged desktop based on i3 window manager.

Showcase

2024-10-31.19-40-24.mp4

Read before installing

• Tested on an Asus F555L laptop with:
  • Fedora Workstation 39
  • Fedora Everything 39 & 40
• Made for use with one 1920x1080 monitor. Adjustments may be neccessary for higher/lower resolutions and/or more monitors.
• Make sure to read every part of this README to minimize any obstacles during installation.

Programs

Most of the necessary programs are listed in the dropdown below. If you don't want to use a specific program, you can substitute the program and edit the configs to reflect those changes. If there is a mistake in this list, make an issue so I can fix it as soon as possible.

Program/package list

---

• i3
• autotiling

---

• kitty
• neofetch
• picom

---

• polybar
• rofi
• rofi-calc
• dunst notification daemon

---

• mate-polkit (substitute for a different polkit if desired)

---

• slock (screen locker)
• xss-lock (sleep lock)

---

• unclutter-xfixes (autohide mouse cursor)
• xmousepasteblock (if needed)

---

• pulseaudio-utils (pactl needed) & pavucontrol
• playerctl (polybar)
• cava (for polybar)

---

• NetworkManager & nmtui & nm-applet
• blueman-applet & bluetoothctl & bluetui

---

• maim
• shadower (fancy screenshot effects)
• xclip (screenshot copy)

---

• nitrogen (wallpaper)

---

• clipse (clipboard history)

---

• xev
• xwininfo
• xdotool

---

• Ubuntu Nerd Font (substitute for other nerd fonts if desired)

---

Installation

Requirements:

• GNU Stow

Follow these steps:

• Clone repository into your home folder, and make sure its name is ".dotfiles". git clone https://github.com/windowschips/i3dotfiles.git ~/.dotfiles
• Change directory into it. cd ~/.dotfiles
• Run "stow.sh". This will symlink the important configs to their locations. ./stow.sh
• Login into i3! - startx or use your display manager

Post-install

Some basic keybinds are:

• Super + Q : Open kitty terminal
• Super + Space : Apps menu
• Super + R : Reload desktop
• Super + Shift + S : Screenshot area
• Super + Ctrl + S : Screenshot fullscreen
• Super + Alt + S : Screenshot fullscreen (3 seconds delay)
• The rest can be viewed in the i3 config (~/.dotfiles/layout/i3/config).

You should:

• Set the wallpaper in nitrogen
• Create a file named .owm-key in ~, and change the weather location in ~/.dotfiles/layout/polybar/weather-plugin.sh
• Set up themes, cursors and icons of your choice.

Credits

Milad Fakurian on Unsplash for all wallpapers included

Aditya Shakya (adi1090x) for Rofi menus