My personalized dotfiles and configs for Windows 10 ⚙️
Some commands require extra dependencies which are unavailable in some platforms. You may need to install them manually.
Those dependencies are listed below:
Note that only Homebrew package is maintained by the git-extras developers directly. Other packages are maintained by the distribution’s packagers or third-party volunteers.
$ sudo $apt_pref update
$ sudo $apt_pref install git-extras
$ sudo dnf install git-extras
Substitute your OpenSUSE version in the command below (in this case we are considering OpenSUSE 15.1):
$ sudo zypper ar https://download.opensuse.org/repositories/devel:/tools:/scm/openSUSE_Leap_15.1/devel:tools:scm.repo
and install it:
$ sudo zypper in -y git-extras
$ sudo yum install git-extras
$ sudo apt-get install git-extras
$ nix-env -i git-extras
Abdullah has written a Pkgfile for his beloved distro.
$ brew install git-extras
Installing from Homebrew will not give you the option omit certain git-extras if they conflict with existing git aliases. To have this option, build from source.
First, please install Git for Windows 2.x from ‘https://github.com/git-for-windows/git/releases’.
Second, clone the git-extras repo into any folder you like.
git clone https://github.com/tj/git-extras.git
# checkout the latest tag (optional)
git checkout $(git describe --tags $(git rev-list --tags --max-count=1))
After that, execute the install.cmd in the command prompt. If you installed
git as admin, you need to run this prompt as admin, too. Per default, it finds
a Git for Windows 2.x if it’s in the path (first path in where git.exe wins)
or installed in the default location %ProgramFiles%\Git. The fallback is
C:\SCM\PortableGit. If you didn’t install git into one of these dirs, you have
to supply the path for the install location, e.g. if git is installed
in c:\git:
install.cmd "C:\git"
Last, to use git summary and git ignore-io, you need to copy
column.exe from a msys2 installation from folder-your-msys2-installed/usr/bin
to folder-your-git-installed/usr/bin or wait for git 2.7.1, which will include column.exe.
$ pkg install git-extras
Use the instructions to build from source below. Make sure you are using gmake (GNU make) instead of make.
Read Dependencies and ensure they are installed.
Obtain the git-extras source by cloning its GitHub repo or downloading a tarball of a release. Then install it by doing make install from the source tree.
$ git clone https://github.com/tj/git-extras.git
$ cd git-extras
# checkout the latest tag
$ git checkout $(git describe --tags $(git rev-list --tags --max-count=1))
$ [sudo] make install
By default, git-extras is installed under /usr/local. To install it at an
alternate location, specify a PREFIX when calling make.
# Non-root users can install under their home directory
make install PREFIX=$HOME/software
# For third-party software kept under /opt
make install PREFIX=/opt
If you want to relocate the bulk of the installation but still have configuration
files installed to the system /etc dir or other alternate location, you can
specify SYSCONFDIR in addition to PREFIX.
$ sudo make install PREFIX=/usr/local SYSCONFDIR=/etc
See the Makefile for details on advanced configuration options.
One-liner:
curl -sSL https://git.io/git-extras-setup | sudo bash /dev/stdin
Zplugin can install git-extras by using:
zplugin ice as"program" pick"$ZPFX/bin/git-*" src"etc/git-extras-completion.zsh" make"PREFIX=$ZPFX"
zplugin light tj/git-extras
$ZPFX is ~/.zplugin/polaris by default. Use zplugin update tj/git-extras to update.
This method installs in $HOME, so you don’t need to ask administrator to install package.
If you installed git-extras with a package manager, use that package manager’s tools to update it.
If you installed git-extras from source, you can run git-extras update to update it to the latest release. Be aware that this may lose any configuration options you specified during the original installation.
Enjoy git-extras!