alexforsale/dotfiles

#+options: ':nil *:t -:t ::t <:t H:3 \n:nil ^:t arch:headline
#+options: author:t broken-links:nil c:nil creator:nil
#+options: d:(not "LOGBOOK") date:t e:t email:nil f:t inline:t num:nil
#+options: p:nil pri:nil prop:nil stat:t tags:t tasks:t tex:t
#+options: timestamp:t title:t toc:t todo:t |:t
#+title: My Collection of dotfiles in one place!
#+date: <2022-06-04 Sat>
#+author: Kristian Alexander P
#+email: alexforsale@yahoo.com
#+language: en
#+select_tags: export
#+exclude_tags: noexport
#+creator: Emacs 29.0.50 (Org mode 9.5.2)
#+cite_export:
#+property: EXPORT_FILE_NAME: index.html
#+setupfile: https://fniessen.github.io/org-html-themes/org/theme-readtheorg.setup
#+HTML_HEAD: <style> #content{max-width:1800px;}</style>
#+HTML_HEAD: <style> p{max-width:800px;}</style>
#+HTML_HEAD: <style> li{max-width:800px;}</style>
#+export_file_name: index.html

• The Dotfiles
  This is my personal dotfiles repository. All submodules (and also this repository) is meant to be [[https://www.gnu.org/software/stow/manual/stow.html][stowed]] (a method of symbolic linking). For now each submodule is pointed to their respective /main/ branch.

Perhaps the other feature of this repository (and also all the submodules) is /github pages/ generation automated [[https://github.com/features/actions][using actions]], see the =.github/workflows/publish.yml= file on each repository for more detail.
** Submodules

*** [[https://alexforsale.github.io/dotfiles-shells/][Common Shell Initialization]]
[[https://github.com/alexforsale/dotfiles-shells/actions/workflows/publish.yml/badge.svg]]

#+caption: my .profile
[[./assets/img/profile-2025-05-17_14-41.png][file:./assets/img/profile-2025-05-17_14-41.png]]

For all the common [[https://en.wikipedia.org/wiki/POSIX][POSIX-compliant]] shells (if you're using a common modern GNU/Linux distribution, chances are the system shells is POSIX-compliant). I've tested this with various GNU/Linux distributions, and also some BSD distributions. This repository contains the necessary environment variables needed are loaded when I logged in. I've also incorporate this for [[https://en.wikipedia.org/wiki/GNU_Guix][GNU Guix]], but /guix/ is forever changing, and I'm not currently use it for my daily distro.

• source code: https://github.com/alexforsale/dotfiles-shells/
  *** [[https://alexforsale.github.io/dotfiles-bash/][bash]]

[[https://github.com/alexforsale/dotfiles-bash/actions/workflows/publish.yml/badge.svg]]

#+caption: bash version
[[./assets/img/bash-2025-05-17_14-44.png][file:./assets/img/bash-2025-05-17_14-44.png]]

The second repository I stowed on every machines that using /bash/. I actually have configuration for most of the other shells (including /fish/), but /bash/ is always my favorite.

• source code: https://github.com/alexforsale/dotfiles-bash/
  *** [[https://alexforsale.github.io/dotfiles-fish/][fish]]

[[https://github.com/alexforsale/dotfiles-fish/actions/workflows/publish.yml/badge.svg]]

#+caption: alacritty running fish
[[./assets/img/fish-2025-05-17_14-37.png][file:./assets/img/fish-2025-05-17_14-37.png]]

Not my main /shell/, only when I want to feel like a /zsh/ user without using [[https://ohmyz.sh/][oh-my-zsh]].

• source code: https://github.com/alexforsale/dotfiles-fish/
  *** [[https://alexforsale.github.io/dotfiles-tmux/][Tmux]]

[[https://github.com/alexforsale/dotfiles-tmux/actions/workflows/publish.yml/badge.svg]]

#+caption: replace /Emacs/ with /vim/, and it's literally my only way of using tmux
[[./assets/img/tmux-2025-04-23_20-14.png][file:./assets/img/tmux-2025-04-23_20-14.png]]

tmux is a terminal multiplexer. It lets you switch easily between several programs in one terminal, detach them (they keep running in the background) and reattach them to a different terminal[fn:1].
This is handy when I'm connecting to a remote machine via /ssh/, and starting tmux in the remote. This way, even if my connection is suddenly interrupted or lost I can simply reconnect the ssh, and reattach my previous /tmux/ session.

• source code: https://github.com/alexforsale/dotfiles-tmux/
  *** [[https://alexforsale.github.io/dotfiles-x/][Xorg Configuration]]

[[https://github.com/alexforsale/dotfiles-x/actions/workflows/publish.yml/badge.svg]]

For my machine that doesn't work well with [[https://en.wikipedia.org/wiki/Wayland_(protocol)][wayland]]. To be fair, Xorg is kinda convoluted, so I have settings for machines that uses a [[https://en.wikipedia.org/wiki/X_display_manager][display manager]], and also for one that only uses [[https://wiki.archlinux.org/title/Xinit][xinit]].

• source code: https://github.com/alexforsale/dotfiles-x/
  *** [[https://alexforsale.github.io/dotfiles-i3/][i3]]

[[https://github.com/alexforsale/dotfiles-i3/actions/workflows/publish.yml/badge.svg]]

The first [[https://en.wikipedia.org/wiki/Window_manager][window manager]] I installed whenever I needed a graphical environment.
#+caption: i3wm workspace
[[./assets/img/i3-wm-2025-04-24_03-54.png][file:./assets/img/i3-wm-2025-04-24_03-54.png]]

• source code: https://github.com/alexforsale/dotfiles-i3/
  *** [[https://alexforsale.github.io/dotfiles-hyprland/][Hyprland]]

[[https://github.com/alexforsale/dotfiles-hyprland/actions/workflows/publish.yml/badge.svg]]

#+caption: Hyprland
[[https://github.com/alexforsale/dotfiles-hyprland/raw/main/assets/img/Hyprland.png]]

Another window manager that I really like, a bit resource intensive but the really pleases me. Updated frequently, so really need to check their [[https://wiki.hyprland.org/][wiki]] whenever an update breaks my configuration.

• source code: https://github.com/alexforsale/dotfiles-hyprland/
  *** [[https://alexforsale.github.io/dotfiles-rofi/][Rofi]]

[[https://github.com/alexforsale/dotfiles-rofi/actions/workflows/publish.yml/badge.svg]]

#+caption: rofi
[[https://alexforsale.github.io/dotfiles-rofi/assets/img/rofi-menu-2025-04-24_01-33.png]]

A window switcher, application launcher and dmenu replacement.

• source code: https://github.com/alexforsale/dotfiles-rofi/
  *** [[https://alexforsale.github.io/dotfiles-dunst/][Dunst]]

[[https://github.com/alexforsale/dotfiles-dunst/actions/workflows/publish.yml/badge.svg]]

#+caption: dunst
[[./assets/img/dunst-2025-05-07_12-40.png]]
Lightweight and customizable notification daemon.

• source code: https://github.com/alexforsale/dotfiles-dunst/
  *** [[https://alexforsale.github.io/dotfiles-conky/][Conky]]
  #+caption: conky system monitor
  [[https://alexforsale.github.io/dotfiles-conky/assets/img/conky-system-2025-05-16_20-28.png]]

a system monitor software for the X Window System, Wayland and other things, too. It is available for GNU/Linux and FreeBSD. It is free software released under the terms of the GPL license. Conky is able to monitor many system variables including CPU, memory, swap, disk space, temperature, top, upload, download, system messages, and much more. It is extremely configurable.

• source code: https://github.com/alexforsale/dotfiles-conky/
  *** [[https://gitlab.com/alexforsale/wallpapers][Wallpapers]]

#+caption: wallpapers
[[./assets/img/wallpaper-2025-05-17_14-25.png][file:./assets/img/wallpaper-2025-05-17_14-25.png]]

Various wallpapers I found over the internet. The only repository not on /github/.

• How to install
  First question is: why? The second is: Do you use Emacs? All the source code for my /dotfiles/ and also this readme is written in [[https://en.wikipedia.org/wiki/Org-mode][org-mode]], and needs to be tangled from each /org-mode/ file in order to generate the code. After that, I use GNU stow for symbolic-linking each configuration to the actual location (usually in =/.config/= or =/.local/=). So it's really not a straight forward process.
• Footnotes

[fn:1] https://github.com/tmux/tmux/wiki