home

A Portable Linux Home Folder to feel right at home in any distribution.

a.k.a my dotfiles + bootstrapping scripts for Arch and Debian

a.k.a highly opinionated configurations for anything I ever used.

what you're seeing

My dwm fork with clickable status bar.
Adaptive theming for TUIs, GTK apps and QT apps.
Neovim opened at the Arch Linux bootstrapping script.
ViFM + ueberzug image previews.
Conky system monitor showing weather information, todo-lists and appointments.
Picom compositor for window transparency, shadows and blur.
lsd aliased as ls.
Custom zsh prompt.
Distrotube wallpapers.
CLI-visualizer for audio visualization.
Dunst notifications.

How does this work?

My home folder is my dotfiles git repo. However, by default no new files will be tracked because the .gitignore file contains a single *. To start tracking a file, simply git add them with the -f flag:

    git add -f new-file-to-track

Installation instructions

Although, the settings are universal, I recommend Arch Linux as distribution. Instructions on how to install Arch Linux can be found here.

To try out these configs, it's best to start from a completely empty home folder. Then initialize the home folder as a git repository:

git init .

add this git repository (or your fork) as origin:

git remote add origin http://github.com/flaport/home

pull the repository:

git pull origin master

if you want to be able to push your changes to your remote repository, then set up the master branch to track the master branch at origin

git branch --set-upstream-to=origin/master master

pull in all git submodules for custom builds

git submodule update --init --recursive

[optional but recommended] If you're on Arch Linux, install my recommended programs with the following bootstrapping script: ~/.install/arch_install. Installing the recommended programs will make sure the configs and scripts work properly. This script won't re-install programs that are already on the system and hence is pretty fast after its first run. Edit the file to your liking first.

~/.install/arch_install

[completely optional] I'm using python a lot. I have a similar bootstrapping script with my preferred Anaconda installation. Edit the file to your liking first.

~/.install/python_install

List of configs

A non-exhaustive list of configurations and script this repository has to offer:

app files
app defaults
alacritty · a terminal with GPU acceleration + scripts
albert · a GTK based application launcher
askpass · custom GTK pinentry
autojump · jump to folders in the cli.
bash · shell
broot · terminal file browser
castero · a TUI for podcasts
cat · concatenate files
chromium · the famous browser
conda · python package manager
conky · system monitor
contacts · simple scripts to mange iCal contacts
ctags · used for tag jumping in vim
dmenu · application launcher (rofi alternative) + much more
dragon · dragon drag-and-drop aliased to d.
dunst · notifications
dwm · startup and status bar script
emacs · editor and more
eslint · javascript linting
firefox · the best browser
fish · shell
flameshot · a very capable screenshot program + scripts
fontconfig · default fonts and other font settings
fstab · an fstab example
fzf · the fuzzy file finder
ghostscript · the low level pdf editor
git · source control + many convenience scripts
gnupg · gpg agent
gtk 2.0 · gtk theming
gtk 3.0 · gtk theming
hosts · a hosts file example
inkscape · custom scripts using the incscape CLI
ipython · interactive python shell
joplin · note taking app + some basic scripts
jupyter · notebook server for python (and others) + scripts
kvantum · qt theming + scripts
latexmk · latex build settings
lockscreen · custom scripts handling screenlocks and more
ls · ls aliased to lsd if no arguments given
lxappearance · GTK theme chooser
matplotlib · python plotting + scripts
mouse cursor · configuration
mpv · media player + scripts
nemo · file browser + scripts
neofetch · system information
newsboat · an RSS reader TUI
nextcloud · nextcloud client
nvim · neovim: the terminal text editor + scripts
open-octet-stream · custom script to open 'octet-stream' (binary) files.
openvpn · vpn tool
picom · compositor + alpha script to change transparency from cli + custom scripts.
qt5ct · qt theming
qutebrowser · qt based web browser with vim keybindings
rename · a simple script to batch rename files with vim
rofi · application launcher (dmenu alternative) + much more
spotifyd · the headless spotify daemon (used in conjuction with spotify-tui)
spotify-tui · the spotify TUI + scripts
sxhkd · keyboard shortcuts
sxiv · the simple X image viewer
syncthing · file synchronization between devices
termdown · the terminal countdown timer
tmux · terminal multiplexer
transmission-daemon · transmission torrent daemon + scripts
ueberzug · the terminal image overlayer
vifm · terminal file browser with vim keybindings + scripts
vimb · web browser with vim keybindings (does not seem to work very well for me)
vimfx · vim keybindings for firefox (requires legacyfox patch)
vis · music cli visualizer
vscode · code editor
wallpaper · a custom script to set wallpapers using feh.
wallpaper · scripts to set wallpaper
weather · custom weather scripts
webapp · custom scripts to open webpages as webapps.
xdg-open · custom scripts related to xdg-open, such as o aliased to xdg-open.
xinit · x session starter
xrandr · screenlayout convenience scripts + screenlayout selector.
xresources · colorschemes + xcs script
x · custom scripts to configure X
zathura · pdf reader + scripts
zsh · my preferred shell

List of custom builds

Furthermore, this repository contains submodules for the following builds:

My dwm fork my window manager + scripts
My dmenu fork my application launcher (and much more)
My st fork my terminal
My scroll fork dependency of st to enable terminal scrolling