warbacon / zunder-zsh

⚡ A minimalistic zsh configuration with sane defaults.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

⚡ Zunder-zsh

Zunder-zsh is a minimalistic zsh configuration with sane defaults.

Preview

🚩 Goals

  • Straightforward transition from bash.
  • Quick and trouble-free installation.
  • Responsive typing.
  • Fastest possible startup time without sacrificing functionality.
  • Provide only completely necessary functionality and be easy to extend.

💡 Features

  • Syntax highlighting and autosuggestions.
  • Automatic installation.
  • Sensible keybindings.
  • Smarter completions.
  • Exa integration.
  • Integrated advanced plugin manager. See Zinit.

Plugins

Aliases

Alias Description
ll Long list directory contents. Uses exa if installed.
la List directory contents with hidden files. Uses exa if installed.
lla Long list directory contents with hidden files. Uses exa if installed.
lt Displays the directory tree in the current directory. Needs exa.

trash-cli will be used if installed to prevent permanent deletions when running rm.

🤔 Why should I use it?

Zunder-zsh has been designed so that any user can use it almost instantly without having to learn new things, just run the script and you are ready to go. There are no unnecessary things and everything works fast.

Zunder-zsh vs Oh My Zsh

Oh My Zsh is a framework, zunder-zsh isn't. This means that while Oh My Zsh requires you to configure your shell how they want, zunder-zsh doesn't, since its level of abstraction is very low, making it so that anyone can understand what is happening behind the scenes and can be modified in the way you prefer.

That means that zunder-zsh doesn't support updates, as is designed so that any user can modify the configuration as desired. However, if you are a user who makes very few modifications, you can use a method to upgrade directly without losing your custom settings. See File Structure.

💊 Compatibility

Although zunder-zsh can run on any POSIX-compliant operating system, the installation script will have more functionality on the following operating systems:

  • Arch Linux and derivatives (EndeavourOS, Manjaro, etc.).
  • Debian and derivatives (Ubuntu, Linux Mint, etc.).
  • Fedora and derivatives (NobaraOS, Ultramarine Linux, etc.).
  • OpenSUSE and derivatives (Tumbleweed, Leap, GeckoLinux, etc.).
  • Void Linux.
  • MacOS.
  • Android (using termux).

Works also in wsl, but syntax highlighting will be disabled because it produces input lag when typing.

🚀 Getting started

Nerd fonts

Depending on your operating system, the required icons will be installed if needed, but may require additional configuration.

If you don't see the icons correctly and don't want to complicate your life, you can install a Nerd Font and set it as default on your terminal.

I recommend JetBrainsMono Nerd Font

You can use Termux:Styling on Android and set as font, for example, Fira Code.

Installation

  1. Clone this repository locally:

    git clone https://github.com/warbacon/zunder-zsh.git
  2. Enter the cloned repository and run the install script:

    cd ./zunder-zsh
    ./install.sh

📁 File Structure

~
├──/.zsh_history  <- zsh history
├──/.zshenv       <- environment variables
├──/.zshrc        <- main configuration
│
├──/.config/zunder-zsh [optional]
│           ├── after.zsh       <- loads after main config
│           └── before.zsh      <- loads before main config
│
├──/.cache/zsh
│          ├── .zcompdump       <- completions cache
│          └── .zcompdump.zwc   <- compiled version
│
└──/.local/share/zinit          <- installed plugins
                 └── ...

The ~/.config/zunder-zsh directory and its files are not created automatically. They are intended to extend zunder-zsh easily without modifying the main configuration.

  • before.zsh loads after the Zinit initialization but before all the main configuration. Here, you should write additional plugins you want to add and zunder-zsh specific options.

  • after.zsh loads after all the main configuration. Here, you should write all your additional configurations.

🎨 Customizing zunder-zsh

Zunder-zsh specific options

Important

These variables must be set in your before.zsh!

Usage:

# ~/.config/zunder-zsh/before.zsh

DISABLE_AUTOSUGGESTIONS=true    # zsh-autosuggestions will be disabled
Variable Description Default value
DISABLE_AUTOSUGGESTIONS Disables zsh-autosuggestions. "" (true in Linux tty)
DISABLE_EXA Disables exa/eza integration. ""
DISABLE_SYNTAX_HIGHLIGHTING Disables fast-syntax-highlighting. "" (true in WSL)
DISABLE_ZUNDER_PROMPT Disables zunder-prompt. ""
ZUNDER_PROMPT_CHAR Sets the zunder-prompt char symbol. "❯"

Exa integration

Zunder-zsh will enable exa integration automatically if exa is installed. You must install exa or eza manually for this to happen. You can You can force it to be disabled by setting DISABLE_EXA to true in your before.zsh.

Fzf integration

You need to install fzf manually

zinit snippet https://raw.githubusercontent.com/junegunn/fzf/master/shell/key-bindings.zsh

This enables the integration of fzf into zsh, making it possible to use the following keybindings:

Keybinding Description
Ctrl+r Search history of shell commands.
Ctrl+t List files and folders in current directory.
Alt+c Fuzzy change directory.

🔧 Troubleshooting

If you find any error in zunder-zsh, I would appreciate if you open an issue and I will try to help you as soon as possible.

If you didn't like it or want to go back to your previous configuration, you can run the uninstall.sh script located in this same repository:

./uninstall.sh

Additionally, if you used previously another shell, you can revert it using the following command:

sudo usermod -s $(which bash) $USER

You can change bash for the shell of your choice.

Man command highlighting as error in Arch Linux

Info here.

🤝 I need you

If you encounter any issue or have any suggestions, please don't hesitate to contact me. I'm open to any discussion and I'll be happy to help!

About

⚡ A minimalistic zsh configuration with sane defaults.

License:MIT License


Languages

Language:Shell 100.0%