psoxizsh/README.md

2.5 KiB

pSoxIzsh

About this

Over the years I have collect various bits from various locations. I often share what I have done with work colleagues and finally made this repository so people can pull the latest.

This is optimized by default for dark terminals, and contains configurations for use with

  • zsh >= v5.8
  • neovim >= v0.9
  • tmux >= 3.2

All of these have standard setting but can be customized by using optional include files. Please read the following configs

  • vimrc
  • init.lua
  • zshrc
  • tmux/tmux.conf

and look at the include files to check for overrides.

Looks

For the best appearance I have tested the latest versions of

  • Konsole
  • Microsoft Terminal
  • WezTerm
  • Kitty (the Linux version, not the on based of putty)
  • Alacritty (Windows and Linux)

I have previously used this on iTerm2 on MacOS but not recently.

I also use the Iosevka Term Curly font on both Linux and Windows with ligatures enabled where possible.

Updates

If you already have an installation cd to the ~/.psoxizsh or /etc/psoxizsh as root directory and make sure you have not make any changes. If you have stash them and then run the following commands.


(
    git pull --recurse-submodules=yes
    git submodule foreach git fetch --all --prune
    git submodule update --remote --rebase
    git pull --recurse-submodules=yes
)

src

Install

User


git clone --recurse-submodules --recursive https://git.st8l.com/dolysis/psoxizsh.git ~/.psoxizsh

# This should work on Linux.  It is not tested on MacOS or Windows
~/.psoxizsh/fresh-system

Root - System Wide


# Make sure you are root
git clone --recurse-submodules --recursive https://git.st8l.com/dolysis/psoxizsh.git /etc/psoxizsh

# This should work on Linux.  It is not tested on MacOS or Windows
# for each user that wants to use this as the user run this command
/etc/psoxizsh/fresh-system

Configure NeoVim

Make sure you have neovim (tested on v0.9.x, v0.10.x) installed and after starting zsh check that the following variable are set by typing

You will need to install neovim, nodejs and npm to get the full use of vim

Just start neovim (nvim) and wait for it to finish. After that quit and it should be ready to use.

You can also use: nvim --headless '+Lazy! sync' +TSUpdate +qa to sync all plugins without opening neovim.

See the default entrypoint (init.lua) for more details on how to configure your local setup further.

nvim ~/.config/nvim/init.lua

Enjoy