flocon/README.org

45 lines
2.9 KiB
Org Mode
Raw Normal View History

2023-06-01 12:18:22 +00:00
#+TITLE: my dotfiles
2023-06-01 12:27:33 +00:00
2023-06-01 12:18:22 +00:00
[[./screenshots/desktop.png]]
[[./screenshots/desktop-terminals.png]]
2023-06-19 12:32:56 +00:00
These are my personal dotfiles for configuring my workstation. I use [[https://www.gnu.org/software/stow/][stow]] to manage them, hence why everything is under its own module, so I can use ~stow */~ to symlink them to the right place.
2023-06-19 12:35:46 +00:00
This configuration uses git submodules in order to pull some plugins and to integrate my Emacs config in a separate repository, so make sure to initialize them before trying to install it (installation instructions below).
2023-06-19 12:26:05 +00:00
* Installing
You could install it on any Linux distribution that you want, but I recommend Arch Linux as there is a file containing a list of required packages installable via pacman or your favorite AUR helper.
2023-06-01 11:56:35 +00:00
2023-06-19 12:31:35 +00:00
- Clone the config in your home directory ~git clone git@github.com:nezia1/dotfiles.git ~/.dotfiles~
2023-06-19 12:35:46 +00:00
- Initialize submodules with ~git submodule update --init~
2023-06-19 12:31:35 +00:00
- If you're using Arch Linux, install the packages with ~sudo pacman -S < packages~ or using your favorite AUR helper
2023-06-19 12:35:46 +00:00
- ~stow */~ to symlink everything to the right place
2023-06-19 14:49:41 +00:00
- ~fisher update~ to install fish plugins
2023-06-19 12:35:46 +00:00
2023-06-01 11:56:35 +00:00
* Theme
I use [[https://github.com/catppuccin/catppuccin][catppuccin]] as my theme (the mocha variant). I love the soothing pastel colors. The GTK theme and the Qt5 theme are also configured to be used with supported applications.
* Shell setup
I use [[https://github.com/fish-shell/fish-shell][fish]] as my interactive shell, but I still keep [[https://www.gnu.org/software/bash/][bash]] as my non-interactive shell for compatibility purposes, as some pieces of software that I use require the user to have a POSIX compliant shell. This is why I have a bash module, where I setup everything that I want to have non-interactively and interactively and if running interactively, have it start a fish session.
It also keeps variables set in .profile, since we're starting fish from bash.
2023-06-19 14:49:41 +00:00
2023-06-01 11:56:35 +00:00
* Software used
- Operating system: [[https://archlinux.org/][Arch Linux]]
- Window manager: [[https://hyprland.org][Hyprland]]
- Status bar: [[https://github.com/Alexays/Waybar][Waybar]]
- Application launcher: [[https://sr.ht/~scoopta/wofi/][wofi]]
- Terminal emulator: [[https://github.com/kovidgoyal/kitty][kitty]]
- Shell: [[https://github.com/fish-shell/fish-shell][fish]]
2023-06-01 11:56:35 +00:00
- Text editor: [[https://www.gnu.org/software/emacs/][Emacs]]
- Notification daemon: [[https://github.com/dunst-project/dunst][dunst]]
2023-06-02 13:52:01 +00:00
- Password manager: [[https://www.passwordstore.org/][pass]]
2023-06-01 11:56:35 +00:00
2023-06-01 12:29:28 +00:00
Hyprland is configured to use a random wallpaper from the ~$HOME/.dotfiles~ directory, so you need to have your wallpapers in it.
2023-06-01 11:56:35 +00:00
2023-06-01 12:18:22 +00:00
* Services and timers
The user-services module contains different systemd daemons and timers that you might or might not need depending on your specific use-case:
2023-06-01 09:26:29 +00:00
2023-06-02 13:52:01 +00:00
- sync: a systemd timer that synchronizes my org directory using [[https://rclone.org/][rclone]] to a remote called drive (runs every 5 minutes)