|
2 days ago | |
---|---|---|
bin | 2 days ago | |
env.d | 5 days ago | |
feh | 2 years ago | |
filecat | 7 months ago | |
foot | 3 weeks ago | |
git | 4 days ago | |
i3 | 4 days ago | |
mpv | 1 year ago | |
mutt | 10 months ago | |
nano | 10 months ago | |
tmux | 4 days ago | |
README.md | 1 week ago | |
Xresources | 3 weeks ago | |
env | 1 week ago | |
install | 2 days ago | |
profile | 1 week ago | |
xinitrc | 5 months ago |
README.md
Personal dotconfig
This repository is for synchronizing my shell and i3 settings across machines.
The checkout location is $XDG_CONFIG_HOME
, which is usually equal to $HOME/.config
.
There is an ./install
script that sets up some symlinks.
For programs that look into $XDG_CONFIG_HOME
on their own, no symlink is needed.
POSIX-compatible shells
The ~/.profile
symlink serves as entry point during any login operation.
It is pointing to the profile
file of this repo.
And login shell is supposed to source it.
The env
file serves as config file for interactive shells.
Its function is to ensure a consistent setup across bourne shell variants.
It makes sure the following environment variables have sensible values:
- XDG_CONFIG_HOME:
Points to the checkout location of this repository.
The
profile
detects this by following the~/.profile
symlink if not present. - XDG_RUNTIME_DIR: Location for sockets, fifo's and pid files.
- ENV: Location of the env file for interactive shells.
The PATH variable is updated to contain the bin
directory.
Bash and Zsh have own entrypoints, they are automatically set up as symlinks by the ./install
script if the respective shell is configured as login shell.
Per-machine overrides
Machine-specific fixes can be placed in env.d/
or profile.d/
.
Use in shell scripts
Shell scripts started from background daemons like cron or init won't have the environment variables resulting from the login process and profile
.
Appending -l
to the end of their shebang line will cause the executing shell to undergo this process and, in turn, also load the settings from profile
.
Xorg with startx
For this to work, a symlink ~/.xinitrc
pointing to the xinitrc
file needs to be created.
xinitrc
does alot of things:
- load xresources
- set keyboard layout + xmodmap fixes
- start a sample terminal window to guess an appropiate font size
- fill background with a pixel lattice
- start i3 or fall back to xfce or plain terminal emulator
Xorg with Display Manager
This requires manual scripting.
A custom ~/.xsession
or ~/.xsessionrc
chains to xinitrc
, possibly after sourcing the profile
to load the environment variables.
i3
i3 respects $XDG_CONFIG_HOME
on its own and reads its config from i3/config
.
The setup is simple. All windows run maximized, only one bar at the top displays the titles of all windows. Windows are switched between by using the left Alt-Key and WASD, moved by additionally holding shift. A new terminal is launched using Alt+Enter.
x-terminal-emulator
The repo overrides the system x-terminal-emulator
with its own.
Depending on whats available, xterm or urxvt is launched, with a fallback to the system-wide script if none was found.
Both of these terminal emulators are configured with the same Xresources and are configured to behave similar.
xdg-open
This repo ships an own xdg-open
overriding the system one.
It runs the view
script in a new terminal window / tmux pane.
view
itself contains complex logic to display the contents of the url to me, usually via feh, mpv or by chaining to firefox.
This includes displaying files of unknown type via hexdump, or showing text files via less
.
It also degrades nicely in functionality when there is no Xorg available, by resorting to command line programs.