My personal dotfiles.
Explore the docs »
Report Bug
·
Request Feature
- About the Project
- Getting Started
- Usage
- Miscellanea
- Roadmap
- Contributing
- License
- Contact
- Acknowledgements
This repo hosts my personal dotfiles.
To get a local copy up and running follow these simple steps.
- macOS
brew install bat exa fd fzf git git-delta htop ncdu neovim ripgrep sqlparse \
tig tldr tmux tree universal-ctags watch z zplug
- Clone the repo
git clone https://github.com/akarizm/dotfiles.git
- Install dotfiles
cd dotflies && ./init.zsh
Usage: ./init.zsh [-d | --diff] [-f | --force] [-h | --help] [-V | --version] [program ...]
Environment:
DIFF hide/show changes between files if they are different (default: 0 ; values: 0, 1)
FORCE overwrite or not existing files if they are different (default: 0 ; values: 0, 1)
Options:
-d, --diff, --no-diff show/hide changes between files if they are different
-f, --force, --no-force overwrite or not existing files if they are different
-h, --help print this help
-V, --version print the version number"
Add support for other dotfiles by editing init.zsh
. You have six functions
at your disposal:
link SOURCE [DOTFILE]
to create a symlink fromSOURCE
toDOTFILE
copy SOURCE [DOTFILE]
to copy theSOURCE
file to theDOTFILE
destinationdecipher SOURCE [DOTFILE]
to copy an encryptedSOURCE
file to theDOTFILE
destinationrlink DIRECTORY SOURCE [DOTFILE]
recursively linkSOURCE
toDOTFILE
inDIRECTORY
subdirectoriesrcopy DIRECTORY SOURCE [DOTFILE]
recursively copySOURCE
toDOTFILE
inDIRECTORY
subdirectoriesrdecipher DIRECTORY SOURCE [DOTFILE]
recursively decipherSOURCE
toDOTFILE
inDIRECTORY
subdirectories
NOTE: The last argument is optional. If it is missing, it will be forged from
the file name SOURCE
prefixed with a period.
A caching policy is also available to avoid useless computations:
caching_policy DIRECTORY
returns true if the cache is obslolete.
By providing your program selection, you can update a subset of the available
configuration. For example, to choose only zsh and git, just call ./init.zsh zsh git
and that's it.
init.zsh
andfunctions.zsh
contain ZSH syntax which is not Bash compatible:functions.zsh
contains BSD-based specific regex syntax3
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE
for more information.
François Vantomme - @akarzim
Project Link: https://github.com/akarizm/dotfiles