{"id":18508866,"url":"https://github.com/flaport/home","last_synced_at":"2025-04-09T20:50:58.809Z","repository":{"id":37498835,"uuid":"167529579","full_name":"flaport/home","owner":"flaport","description":"My Portable Linux Home Folder","archived":false,"fork":false,"pushed_at":"2024-10-17T17:59:30.000Z","size":13577,"stargazers_count":17,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-20T02:45:06.833Z","etag":null,"topics":["arch","bash","config","configuration","debian","distro","dotfiles","dots","gnu","gnu-linux","linux","neovim","nvim","python","python-scripts","scripts","shell","shell-scripts","ubuntu","zsh"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flaport.png","metadata":{"files":{"readme":".github/readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-25T10:26:21.000Z","updated_at":"2024-10-17T17:59:33.000Z","dependencies_parsed_at":"2024-06-04T07:45:53.072Z","dependency_job_id":"b8af5ecf-8179-452c-9190-01b7690985f8","html_url":"https://github.com/flaport/home","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flaport%2Fhome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flaport%2Fhome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flaport%2Fhome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flaport%2Fhome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flaport","download_url":"https://codeload.github.com/flaport/home/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248111957,"owners_count":21049576,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arch","bash","config","configuration","debian","distro","dotfiles","dots","gnu","gnu-linux","linux","neovim","nvim","python","python-scripts","scripts","shell","shell-scripts","ubuntu","zsh"],"created_at":"2024-11-06T15:15:40.018Z","updated_at":"2025-04-09T20:50:58.783Z","avatar_url":"https://github.com/flaport.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# home\n\nA Portable Linux Home Folder to feel right at home in any distribution.\n\na.k.a _my [dotfiles](#list-of-configs) + [bootstrapping scripts](../.install) for Arch and Debian_\n\na.k.a _highly opinionated configurations for anything I ever used._\n\n![arch + dwm](home.gif)\n\n#### what you're seeing\n\n- [My dwm fork](https://github.com/flaport/dwm) with clickable [status bar](../.scripts/dwm/dwm_status).\n- [Adaptive theming](../.scripts/x/xcs) for TUIs, GTK apps and QT apps.\n- [Neovim](https://github.com/neovim/neovim) opened at the [Arch Linux bootstrapping script](../.install/arch_install).\n- [ViFM](https://github.com/vifm/vifm) + [ueberzug](https://github.com/seebye/ueberzug) image previews.\n- [Conky](https://github.com/brndnmtthws/conky) system monitor showing [weather information](../.scripts/weather/update_weather), [todo-lists](../.scripts/nvim/todo) and [appointments](../.calcurse/apts).\n- [Picom](https://github.com/yshui/picom) compositor for window transparency, shadows and blur.\n- [lsd](https://github.com/Peltoche/lsd) aliased as ls.\n- [Custom zsh prompt](../.zshrc).\n- [Distrotube wallpapers](https://gitlab.com/dwt1/wallpapers).\n- [CLI-visualizer](https://github.com/dpayne/cli-visualizer) for audio visualization.\n- [Dunst](../.config/dunst/dunstrc) notifications.\n\n## How does this work?\n\nMy home folder _is_ my dotfiles git repo. However, by default no new\nfiles will be tracked because the [.gitignore](../.gitignore) file\ncontains a single `*`. To start tracking a file, simply `git add` them\nwith the `-f` flag:\n\n```\n    git add -f new-file-to-track\n```\n\n## Installation instructions\n\nAlthough, the settings are universal, I recommend [Arch Linux](https://archlinux.org) as\ndistribution. Instructions on how to install Arch Linux can be found\n[here](../.install/readme.md).\n\nTo try out these configs, it's best to start from a completely empty\nhome folder. Then initialize the home folder as a git repository:\n\n```\ngit init .\n```\n\nadd this git repository (or your fork) as origin:\n\n```\ngit remote add origin http://github.com/flaport/home\n```\n\npull the repository:\n\n```\ngit pull origin master\n```\n\nif you want to be able to push your changes to your remote repository, then set up the\nmaster branch to track the master branch at origin\n\n```\ngit branch --set-upstream-to=origin/master master\n```\n\npull in all git submodules for custom builds\n\n```\ngit submodule update --init --recursive\n```\n\n[optional but recommended] If you're on Arch Linux, install my recommended programs with\nthe following bootstrapping script: `~/.install/arch_install`. Installing the\nrecommended programs will make sure the configs and scripts work properly. This script\nwon't re-install programs that are already on the system and hence is pretty fast after\nits first run.  Edit the file to your liking first.\n\n```\n~/.install/arch_install\n```\n\n[completely optional] I'm using python a lot. I have a similar bootstrapping script with\nmy preferred Anaconda installation. Edit the file to your liking first.\n\n```\n~/.install/python_install\n```\n\n## List of configs\n\nA non-exhaustive list of configurations and script this repository has to offer:\n\n- [app files](../.local/share/applications/)\n- [app defaults](../.config/mimeapps.list/)\n- [alacritty](../.config/alacritty/alacritty.yml) · a terminal with GPU acceleration + [scripts](../.scripts/alacritty/)\n- [albert](../.config/albert/albert.confg) · a GTK based application launcher\n- [askpass](../.scripts/askpass) · custom GTK pinentry\n- [autojump](../.scripts/autojump/) · jump to folders in the cli.\n- [bash](../.bashrc) · shell\n- [broot](../.config/broot/) · terminal file browser\n- [castero](../.config/castero/castero.conf) · a TUI for podcasts\n- [cat](../.scripts/cat/) · concatenate files\n- [chromium](../.config/chromium-flags.conf) · the famous browser\n- [conda](../.condarc) · python package manager\n- [conky](../.config/conky/) · system monitor\n- [contacts](../.scripts/contact) · simple scripts to mange iCal contacts\n- [ctags](../.ctags) · used for tag jumping in vim\n- [dmenu](https://github.com/flaport/dmenu) · application launcher ([rofi](../.config/rofi) alternative) + [much more](../.scripts/dmenu)\n- [dragon](../.scripts/dragon/d) · dragon drag-and-drop aliased to `d`.\n- [dunst](../.config/dunst/) · notifications\n- [dwm](../.scripts/dwm/) · startup and status bar script\n- [emacs](../.emacs.d/) · editor and more\n- [eslint](../.eslintrc) · javascript linting\n- [firefox](../.scripts/browser/) · the best browser\n- [fish](../.config/fish/) · shell\n- [flameshot](../.config/Dharkael/) · a very capable screenshot program + [scripts](../.scripts/flameshot/)\n- [fontconfig](../.config/fontconfig) · default fonts and other font settings\n- [fstab](../.extra/fstab) · an fstab example\n- [fzf](../.scripts/fzf) · the fuzzy file finder\n- [ghostscript](../.scripts/ghostscript/) · the low level pdf editor\n- [git](../.gitconfig) · source control + many convenience [scripts](../.scripts/git/)\n- [gnupg](../.gnupg/) · gpg agent\n- [gtk 2.0](../.config/gtk-2.0/) · gtk theming\n- [gtk 3.0](../.config/gtk-3.0/) · gtk theming\n- [hosts](../.extra/hosts) · a hosts file example\n- [inkscape](../.scripts/inkscape) · custom scripts using the incscape CLI\n- [ipython](../.ipython/profile_default/) · interactive python shell\n- [joplin](../.config/joplin/) · note taking app + some basic [scripts](../.scripts/joplin/)\n- [jupyter](../.jupyter/) · notebook server for python (and others) + [scripts](../.scripts/jupyterhubopen)\n- [kvantum](../.config/Kvantum/) · qt theming + [scripts](../.scripts/kvantum/)\n- [latexmk](../.latexmkrc) · latex build settings\n- [lockscreen](../.scripts/lockscreen/) · custom scripts handling screenlocks and more\n- [ls](../.scripts/ls) · ls aliased to lsd if no arguments given\n- [lxappearance](../.scripts/lxappearance/) · GTK theme chooser\n- [matplotlib](../.config/matplotlib/) · python plotting + [scripts](../.scripts/matplotlib)\n- [mouse cursor](../.icons/default/index.theme) · configuration\n- [mpv](../.config/mpv/) · media player + [scripts](../.scripts/mpv/)\n- [nemo](../.local/share/nemo/actions/) · file browser + [scripts](../.scripts/nemo/)\n- [neofetch](../.config/neofetch/) · system information\n- [newsboat](../.config/newsboat/) · an RSS reader TUI\n- [nextcloud](../.config/Nextcloud/) · nextcloud client\n- [nvim](../.config/nvim/) · neovim: the terminal text editor + [scripts](../.scripts/nvim/)\n- [open-octet-stream](../.scripts/octet-stream/) · custom script to open 'octet-stream' (binary) files.\n- [openvpn](../.config/openvpn/) · vpn tool\n- [picom](../.config/picom/) · compositor + [alpha script](../.scripts/x/alpha) to change transparency from cli + [custom scripts](../.scripts/picom/).\n- [qt5ct](../.config/qt5ct/) · qt theming\n- [qutebrowser](../.config/qutebrowser/) · qt based web browser with vim keybindings\n- [rename](../.scripts/rename/) · a simple script to batch rename files with vim\n- [rofi](../.config/rofi/) · application launcher ([dmenu](https://github.com/flaport/dmenu) alternative) + [much more](../.scripts/dmenu)\n- [spotifyd](../.config/spotifyd) · the headless spotify daemon (used in conjuction with spotify-tui)\n- [spotify-tui](../.config/spotify-tui) · the spotify TUI + [scripts](../.scripts/spotify-tui/)\n- [sxhkd](../.config/sxhkd/) · keyboard shortcuts\n- [sxiv](../.config/sxiv/) · the simple X image viewer\n- [syncthing](../.config/syncthing/) · file synchronization between devices\n- [termdown](../.scripts/termdown) · the terminal countdown timer\n- [tmux](../.tmux.conf) · terminal multiplexer\n- [transmission-daemon](../.config/transmission-daemon/) · transmission torrent daemon + [scripts](../.scripts/transmission/)\n- [ueberzug](../.scripts/ueberzug/) · the terminal image overlayer\n- [vifm](../.config/vifm/) · terminal file browser with vim keybindings + [scripts](../.scripts/vifm/)\n- [vimb](../.config/vimb/) · web browser with vim keybindings (does not seem to work very well for me)\n- [vimfx](../.config/vimfx/) · vim keybindings for firefox (requires [legacyfox patch](https://github.com/girst/LegacyFox))\n- [vis](../.config/vis/) · music cli visualizer\n- [vscode](../.config/Code%20-%20OSS/) · code editor\n- [wallpaper](../.scripts/wallpaper) · a custom script to set wallpapers using `feh`.\n- [wallpaper](../.scripts/wallpaper/) · scripts to set wallpaper\n- [weather](../.scripts/weather/) · custom weather scripts\n- [webapp](../.scripts/webapps/) · custom scripts to open webpages as webapps.\n- [xdg-open](../.scripts/xdg-open/) · custom scripts related to `xdg-open`, such as `o` aliased to `xdg-open`.\n- [xinit](../.xinitrc) · x session starter\n- [xrandr](../.scripts/screenlayout/) · screenlayout [convenience scripts](../.scripts/screenlayout/) + [screenlayout selector](../.scripts/dmenu/dmenu_screenlayout).\n- [xresources](../.config/Xresources) · colorschemes + [xcs script](../.scripts/x/xcs)\n- [x](../.scripts/x) · custom scripts to configure X\n- [zathura](../.config/zathura/) · pdf reader + [scripts](../.scripts/zathura)\n- [zsh](../.zshrc) · my preferred shell\n\n## List of custom builds\n\nFurthermore, this repository contains submodules for the following builds:\n\n- [My dwm fork](https://github.com/flaport/dwm) my window manager + [scripts](../.scripts/dwm)\n- [My dmenu fork](https://github.com/flaport/dmenu) my application launcher ([and much more](../.scripts/dmenu))\n- [My st fork](https://github.com/flaport/st) my terminal\n- [My scroll fork](https://github.com/flaport/scroll) dependency of st to enable terminal scrolling\n\n## License\n\n© flaport 2020 - [GPLv3](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflaport%2Fhome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflaport%2Fhome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflaport%2Fhome/lists"}