Need help with wincent?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

wincent
890 Stars 86 Forks Other 4.1K Commits 2 Opened issues

Description

💾 Dot-files

Services available

!
?

Need anything else?

Contributors list

# 4,831
Vim
React
Electro...
graphiq...
4111 commits
# 120
ESLint
Rails
React
ecmascr...
3 commits
# 110,595
HTML
clipper
iterm2
Redux
2 commits
# 94,733
CSS
Jekyll
spacema...
tmux
1 commit
# 25,559
cakephp
cakephp...
TypeScr...
clipper
1 commit
# 145,359
excel
ooxml
Svelte
vuejs
1 commit
# 693,236
dotfile...
tmux
Vim
clipper
1 commit
# 36,630
Vue.js
React
clipper
iterm2
1 commit
# 645,958
inverse...
prototy...
Vim
clipper
1 commit

"dotfiles" and system configuration

Features

Dotfiles

A set of dotfiles that I've been tweaking and twiddling since the early 2000s (under version control since 2009). Characteristics include:

  • Sane Vim pasting via bracketed paste mode.
  • Write access to local clipboard from local and remote hosts, inside and outside of tmux (via Clipper).
  • Full mouse support (pane/split resizing, scrolling, text selection) in Vim and tmux.
  • Focus/lost events for Vim inside tmux.
  • Cursor shape toggles on entering Vim.
  • Italics in the terminal.
  • Bundles a (not-excessive) number of useful Vim plug-ins.
  • Conservative Vim configuration (very few overrides of core functionality; most changes are unobtrusive enhancements; some additional functionality exposed via
     and 
     mappings.
  • Relatively restrained Zsh config, Bash-like but with a few Zsh perks, such as right-side prompt, auto-cd hooks, command elapsed time printing and such.
  • Unified color-handling (across iTerm2 and Vim) via Base16 Shell.
  • Encrypted versioning of files with sensitive content (via git-cipher).
  • Comprehensive Hammerspoon config.

Homebrew

On macOS, the "homebrew" aspect installs a bunch of useful software.

Keyboard customization

On macOS, we use Karabiner-Elements, and on Linux, we use Interception Tools and a few other pieces to make the following changes:

  • Make Caps Lock serve as Backspace (when tapped) and Left Control (when chorded with another key). When held down alone, Caps Lock fires repeated Backspace events.
  • Make Return serve as Return (when tapped) and Right Control (when chorded with another key). When held down alone, Return fires repeated Return events.
  • Maps Control-I to F6 (only in MacVim and the terminal) so that it can be mapped independently from Tab in Vim.
  • Toggle Caps Lock on by tapping both Shift keys simultaneously.
  • Makes the function keys on my external Realforce keyboard behave like the "media" keys on Apple's keyboards.

And these only on macOS:

  • Swap Option and Command keys on my external Realforce keyboard.
  • Make the "application" key (extra modifier key on right-hand side) behave as "fn" on Realforce keyboard.
  • Make "pause" (at far-right of function key row) behave as "power" (effectively, sleep) on Realforce keyboard.
  • Adds a "SpaceFN" layer that can be activated by holding down Space while hitting other keys; I use this to make the cursor keys available on or near the home row in any app.

Zsh

Functions

  • ag
    : Transparently wraps the
    ag
    executable so as to provide a centralized place to set defaults for that command (seeing as it has no "rc" file).
  • bounce
    : bounce the macOS Dock icon if the terminal is not in the foreground.
  • color
    : change terminal and Vim color scheme.
  • fd
    : "find directory" using fast
    bfs
    and
    sk
    ; automatically
    cd
    s into the selected directory.
  • fh
    : "find [in] history"; selecting a history item inserts it into the command line but does not execute it.
  • history
    : overrides the (tiny) default history count.
  • jump
    (aliased to
    j
    ): to jump to hashed directories.
  • regmv
    : bulk-rename files (eg.
    regmv '/\.tif$/.tiff/' *
    ).
  • scratch
    : create a random temporary scratch directory and
    cd
    into it.
  • tick
    : moves an existing time warp (eg.
    tick +1h
    ); see
    tw
    below for a description of time warp.
  • tmux
    : wrapper that reattches to pre-existing sessions, or creates new ones based on the current directory name; additionally, looks for a
    .tmux
    file to set up windows and panes (note that the first time a given
    .tmux
    file is encountered the wrapper asks the user whether to trust or skip it).
  • tw
    ("time warp"): overrides
    GIT_AUTHOR_DATE
    and
    GIT_COMMITTER_DATE
    (eg.
    tw -1d
    ).

Prompt

Zsh is configured with the following prompt:

Visible here are:

  • Concise left-hand prompt consisting of:
  • Extended right-hand size prompt which auto-hides when necessary to make room for long commands and contains:
    • Duration of previous command in adaptive units (seconds, minutes, hours, days, depending on duration).
    • Current version control branch name.
    • Current version control worktree status using colors that match those used in
      git status
      :
      • Green dot indicates staged changes.
      • Red dot indicates unstaged changes.
      • Blue dot indicates untracked files.
    • Full version of current working directory (again, abbreviating
      $HOME
      to
      ~
      ).

Nested shells are indicated with additional prompt characters. For example, one nested shell:

Two nested shells:

Root shells are indicated with a different color prompt character and the word "root":

Nesting within a root shell is indicated like this:

Two nested shells:

If the last command exited with a non-zero status (usually indicative of an error), a yellow exclamation is shown:

If there are background processes, a yellow asterisk is shown:

Dependencies

  • tmux 3.2 or later.
  • Neovim or Vim 8.0 or later with Ruby and Python support (although there's a reasonable amount of feature detection in order to degrade gracefully).
  • Relatively recent Zsh.
  • Relatively recent Git.
  • Clipper for transparent access to the local system clipboard.
  • On macOS, iTerm2. Additionally, only the latest version of macOS (although at the time of writing, I'm still on High Sierra) gets actively tested.
  • Ruby.
  • Adobe Source Code Pro or any other fixed-width font that includes the Powerline glyphs.

Platform status

| Platform | Status | | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | macOS | :1stplacemedal: Currently the most tested platform, as well as the one with most aspects (because macOS 10.13 "High Sierra" is my daily driver both at home and at work) | | Arch Linux | :2ndplacemedal: Less tested, fewer aspects involved, but likely to evolve in the future as I experiment with moving, at least partially, to Arch Linux | | Red Hat Linux and related (eg. CentOS) | :3rdplacemedal: Less tested, fewer aspects involved, but in the past this was the distro I used full-time at work |

Installation

Clone

macOS

git clone --recursive https://github.com/wincent/wincent.git

Arch Linux

sudo pacman -Syu
sudo pacman -S git ruby tmux vim
git clone --recursive https://github.com/wincent/wincent.git
  • git
    : In order to clone the repo.
  • ruby
    : So that git-cipher can run (also used to build Command-T).
  • tmux
    : Just for comfort (eg. so you can see scrollback).
  • vim
    : Because the Vim aspect needs Vim (it runs
    vim
    to do a
    :helptags
    update).

Install

⚠️ WARNING: There are lots of different things that can be installed or configured (see the "aspects" directory). Unless you want your machine to be exactly like mine — which is unlikely — you probably don't want to install everything. Maybe you don't even want everything in the "dotfiles" and "vim" aspects. Please inspect the contents of each aspect before proceeding to install it; you may even be better off just looking at the configuration files and stealing the bits that you find interesting or useful (everything is in the public domain, unless otherwise indicated).

At the time of writing, these are the aspects, which you can expect to change over time:

  • On macOS only:
    • automator: Scripts for use with Automator
    • automount: Sets up macOS's automount facility
    • backup: Backup scripts
    • cron: Sets up cron files
    • defaults: Sets up defaults (ie. preferences) on macOS
    • fonts: Installs Source Code Pro font files
    • homebrew: Installs and updates Homebrew
    • iterm: Dynamic profiles for iTerm
    • karabiner: Configures Karabiner-Elements (keyboard customization).
    • launchd: Configures launchd
    • node: Installs Node.js
    • ruby: Installs Ruby gems
    • ssh: Manages local SSH config
    • tampermonkey: Sets up UserScripts
  • On Linux only:
    • aur: Installs packages from the Arch User Repository.
    • interception: Sets up Interceptions Tools (keyboard customization).
    • locale: Sets up /etc/locale.conf
    • pacman: Installs packages via the Pacman package manager
    • systemd: Set up services that run from systemd
  • On both macOS and Linux:
    • dotfiles: Creates symlinks in \$HOME to the dotfiles in this repo
    • meta: Tests the configuration framework
    • shell: Sets the use shell to zsh
    • terminfo: Sets up terminfo database entries for italics and 256-color support
    • vim: Configures Vim

Examples

./install dotfiles vim      # Just install "dotfiles" and "vim" stuff.
./install dotfiles          # Just install "dotfiles".
./install dotfiles --step   # Prompt for confirmation at each step.
./install dotfiles --check  # Do a dry-run, showing what would be changed.
./install                   # Install everything.
./install --help            # Info on installing specific rol

This sets up a local Node environment using n, and then uses Fig to copy the dotfiles and configure the machine.

Note: Given that

~/.gitconfig
is included with these dotfiles, any local modifications or overrides that you apply should be added to
~/.gitconfig.local
instead; for example:
git config --file ~/.gitconfig.local user.name "John Doe"
git config --file ~/.gitconfig.local user.email [email protected]

Troubleshooting

General troubleshooting

There are a few useful

./install
options:
# Run in "check" (dry-run) mode.
./install --check

Show debugging information during the run.

./install --debug

Confirm each task before running it (--step), and begin

execution from a specific task (--start-at-task) in a

specific aspect ("dotfiles").

./install --step --start='make directories' dotfiles

License

Unless otherwise noted, the contents of this repo are in the public domain. See the LICENSE for details.

Authors

The repo is written and maintained by Greg Hurrell <[email protected]>. Other contributors that have submitted patches include, in alphabetical order:

  • Anton Kastritskiy
  • Joe Lencioni
  • Jonathan Wilkins
  • Keng Kiat Lim
  • Mark Stenglein
  • Matthew Byrne
  • Michael Lohmann
  • Stone C. Lasley
  • Victor Igor
  • Zac Collier

This list produced with:

:read !git shortlog -s HEAD | grep -v 'Greg Hurrell' | cut -f 2-3 | sed -e 's/^/- /'

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.