Skip to content
🔮 Awesome, Customable Zsh Starter Kit 🌠🌠
Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
autoload Add: update zsh-help Oct 9, 2019
completion Fix: completion Jun 23, 2019
lib
BlaCk-Void-Zsh.sh Fix: #11 Install Problem in CentOS Jan 18, 2020
BlaCk-Void.zlogin Fix: zsh-compile execute timing Jun 25, 2019
BlaCk-Void.zshenv
BlaCk-Void.zshrc Feature: Custom plugins Dec 28, 2019
BlaCk-Void.ztheme
LICENSE Initial commit Apr 29, 2018
README.org
install_font.sh Fix: chmod Dec 28, 2019

README.org

BlaCk Void Zsh

Awesome Zsh Setting.

https://i.imgur.com/043POEf.png

Korean Docs

Table of Contents

1. Feature.

Sample Video

https://user-images.githubusercontent.com/25581533/66270473-11e99980-e88f-11e9-83ac-3838bc0d6a56.png

1.1 Powerful View.

More Theme, More Information: Wiki:Customize

Prompt.

Powerline Theme https://user-images.githubusercontent.com/25581533/53680999-40fec200-3d26-11e9-8ca5-5c3723e6acdf.png The prompt consists of two lines.
The upper line is for displaying information, and the lower line is for writing commands.

  • Upper Line
    • Left: account info, root user, using ssh, directory lotation, write permission, vcs info
    • Right: result status, background job, command execution time, history, zsh load time
  • Lower Line
    • Syntax highlight, Auto Suggestion.
    • When auto suggestion comes up, you can complete with right(→) arrow key.

Simple Theme https://user-images.githubusercontent.com/25581533/55165124-306c2b00-51b0-11e9-9871-9ee998ed5bbd.png

  • Upper Line
    • directory lotation, vcs info, account info, write permission, root user, command execution time
  • Lower Line
    • Left: prompt conditional , writing commands
      • Syntax highlight, Auto Suggestion.
      • When auto suggestion comes up, you can complete with right(→) arrow key.
    • Right: background job, result status

[Experimental]How to cutomize or switch?

  • Copy file to your home.
    • cp $BVZSH/BlaCk-Void.ztheme ~/.ztheme && Customize!!
  • export BVZSH_THEME=’THEME MODE’
    • Restrictions: Work only in ~/.ztheme
  • THEME MODE list: auto, powerline, simple, powerline-single, simple-single
    • auto: Default is powerline.
      When not support xterm or 256 color, simple theme Activate.
  • COLOR MODE list: auto, flex, fixed
    • auto: Deafault is fixed.
      When not support xterm or 256 color, flex color Activate.
  • Icon MODE list: auto, nerd, powerline
    • auto: Deafault is nerd.
      When ssh or root, powerline icon Activate.
  • FAQ: Why do not you support zsh-theme anymore? || Can not change during use?
    This isn’t supported by powerlevel10k.

Git.

The interaction with Git is easy compared to the file manager.

https://user-images.githubusercontent.com/25581533/53680863-67236280-3d24-11e9-826b-ae88fc345177.pnghttps://user-images.githubusercontent.com/25581533/53680866-6ab6e980-3d24-11e9-8ad1-3cd6b087ee36.pnghttps://user-images.githubusercontent.com/25581533/53680870-6c80ad00-3d24-11e9-8a1e-0171231299d9.png
https://user-images.githubusercontent.com/25581533/53680872-6ee30700-3d24-11e9-9e77-36707397151a.pnghttps://user-images.githubusercontent.com/25581533/53680874-74d8e800-3d24-11e9-804d-9f2eb16c370f.pnghttps://user-images.githubusercontent.com/25581533/53680876-76a2ab80-3d24-11e9-8d72-56c85a3e8bf2.png

In turn

Source - Add any file - Modify file
Staging - Commit - Push

1.2 Easy Command Input.

More Features: Wiki:Features

Auto Pair.

https://user-images.githubusercontent.com/25581533/53681046-f29df300-3d26-11e9-8299-cdf4d189fa1d.png Match parentheses, quotes, etc.

Fix.

https://user-images.githubusercontent.com/25581533/53681092-96879e80-3d27-11e9-80ca-73bc56150ec9.png If you can’t find the command, suggest a correction.
If the execution is not done properly, just typing ’fuck’. It will suggest.

Display Info.

https://user-images.githubusercontent.com/25581533/53681099-b4ed9a00-3d27-11e9-9388-cde276b64686.png Commands that can be abbreviated are indicated by a Alias tip.
If you press ’<TAB>’ while typing command, it is recommended to divide by category.

https://user-images.githubusercontent.com/25581533/53681069-3db80600-3d27-11e9-8e6c-89f8cb71bd96.pnghttps://user-images.githubusercontent.com/25581533/53681119-0564f780-3d28-11e9-9afd-35c7e0e03044.png

You can search history by pressing the up(↑) arrow key.

Integration with Fzf.

https://user-images.githubusercontent.com/25581533/53681129-334a3c00-3d28-11e9-97b1-b0cd56aac3af.png

  • Ctrl+t: File, Directory select.(Multiple selecting use <TAB>)
  • Ctrl+r: History select.
  • Alt+c: Directory select.
  • Command ** +<TAB>: Select after vi ** as input.
  • ssh, telnet, kill, unset, export..etc with integration.

Please refer to fzf for more information.

Git.

Very simple to use git.

  • c: commit
  • a: add
  • p: push
  • u: pull
  • r: remote
  • s: status

Git X Fzf https://user-images.githubusercontent.com/25581533/57051067-a0436900-6cba-11e9-93bb-df84b795d0b2.png glo screenshot.

  • ga: git add
  • glo: git log
  • gi: gitignore
  • gd: git diff
  • gcf: git checkout
  • gss: git stash
  • gclean: git clean

Etc.

https://user-images.githubusercontent.com/25581533/53681139-4ceb8380-3d28-11e9-8e92-9549302afdc0.png

  • bookmark [mark]:Bookmark to [mark].
  • jump [mark]:Move to [mark].
  • showmarks [mark]:Show [mark]’s directory.
  • deletemark [mark]:Delete [mark].
  • cd <dots>: Move to the upper directory by the number of <dots>.
  • j [keyword]: Move to [keyword] similar directory.

1.3 Terminal Utility.

Internet Tools.

https://user-images.githubusercontent.com/25581533/53681148-6ee50600-3d28-11e9-909c-674b0b359ebb.png

  • prettyping: Show pretty ping.
  • ip-info: Show ip info.

Terminal Image Viewer.

https://user-images.githubusercontent.com/25581533/53681154-80c6a900-3d28-11e9-8510-385e49f173f2.png Show image like preview.
You can use with command img

Useage: img FILE_NAME TIME
(TIME default 2s)

img Feature

  • Supported: Konsole, Xterm, Urxvt, Terminology, Yakuake, Terminal.app
  • Unsupported: Terminator, Hyper, Tilix, gnome terminal, Guake, LXterminal, Putty, Alacritty

for unsupported Terminals
use tiv or fim

Weather.

https://user-images.githubusercontent.com/25581533/53681166-a6ec4900-3d28-11e9-80d3-a010cba7fa83.png Useage:
weather or weather LOCALE LANGUAGE(option)

Default Language: Your system’s language

Map.

https://user-images.githubusercontent.com/25581533/53681169-abb0fd00-3d28-11e9-9cf1-85bf29227ab2.png Useage:
map

2. Install.

2.1 Supported Platforms.

  • Linux

Debin-based(Ubuntu, Debian, Mint, ..), RPM-based(Fedora, CentOS, Redhat, ..), Pacman-based(Arch, Manjaro, Antergos, ..)

  • Others

Mac, FreeBSD-based

  • Requirements
    • bash
  • Install
git clone https://github.com/black7375/BlaCk-Void-Zsh.git ~/.zsh
bash ~/.zsh/BlaCk-Void-Zsh.sh

Then, terminal font set to one of Nerd Fonts (font install’s 1 option is hack nerd font) && restart.

When you want to use with awesome tmux, Check BlaCk-Void-Tmux

2.2 Others.

  • Requirements
  • Install
    • Git Clone
      git clone https://github.com/black7375/BlaCk-Void-Zsh.git ~/.zsh && cd ~/.zsh
    • zplugin(replace antigen)
      sh -c "$(curl -fsSL https://raw.githubusercontent.com/zdharma/zplugin/master/doc/install.sh)"
              
    • nerdfont(powerline support font)
      git clone https://github.com/ryanoasis/nerd-fonts.git
      cd nerd-fonts && ./install.sh
      cd ..
              

      or
      Install font from Nerd Fonts.

    • Add to .zshrc

      Source File[Recommend]
      echo "source BlaCk-Void.zshrc" >> ~/.zshrc

      or Link
      ln -svf BlaCk-Void.zshrc ~/.zshrc

      or Copy(Can’t zsh-update)
      cp -v BlaCk-Void.zshrc ~/.zshrc

    • Zsh Shell Set
      sudo chsh -s /usr/bin/zsh

      or
      sudo chsh -s $(which zsh)

    • Terminal set

    Terminal font set to one of Nerd Fonts && restart.

2.3 Update.

zsh-update: BVZSH, plugin manger, plugins update.
font-update: Nerdfont Update

3. Info.

3.1 Theme.

3.2 Plugins.

Plugin Manager

Default Repo (robbyrussell’s oh-my-zsh).

Lib

Plugin

  • Autojump: Enables Autojump if installed with homebrew, macports or debian/ubuntu package.
  • Command Not Found: This plugin uses the command-not-found package for zsh to provide suggested packages to be installed if a command cannot be found.
  • FZF: This plugin enables junegunn’s fzf fuzzy auto-completion and key bindings.
  • Git: Adds a lot of git aliases and functions for pulling for dealing with the current branch.
  • Gitfast: This plugin adds completion for Git, using the zsh completion from git.git folks, which is much faster than the official one from zsh.
  • Pip: pip - completion plugin for the pip command.
  • Sudo: ESC twice: Puts sudo in front of the current command, or the last one if the command line is empty.
  • Thefuck: The Fuck plugin — magnificent app which corrects your previous console command.
  • Tmux Provides aliases for Tmux.
  • Tmuxinator: Completions for tmuxinator.
  • Urltools: Provides two aliases to URL-encode(urlencode) and URL-decode(urldecode) strings.

Custom Repo

  • Zsh 256 Color: This ZSH plugin enhances the terminal environment with 256 colors.
  • Alias Tips: Help remembering those shell aliases and Git aliases you once defined.
  • Zsh Async: Because your terminal should be able to perform tasks asynchronously without external tools!
  • Zsh Autosuggestions: Fish-like fast/unobtrusive autosuggestions for zsh.
  • Zsh Autopair: A simple plugin that auto-closes, deletes and skips over matching delimiters in zsh intelligently
  • Zsh Completions: Additional completion definitions for Zsh.
  • Enhancd: A next-generation cd command with an interactive filter.
  • Fast Syntax Highlighting: Feature rich syntax highlighting for Zsh.
  • Forgit: Forgit is a utility tool for git taking advantage of fuzzy finder fzf.
  • Fzf Widgets: ZLE widgets of fzf.
  • Zsh Git Smart Commands: Wrappers for common git commands so they can be used in aliases very efficiently.
  • h: A command line tool to highlight terms
  • Zsh History Substring Search: Fish-like history search feature.
  • Zsh Interactive Cd: Press tab for completion as usual with fzf.
  • Zsh Lazyenv: Environments for lazy load commands and speed up start up time of zsh.
  • Zsh Marks: A port of Bashmarks (simple bookmarking plugin by Todd Werth) for oh-my-zsh
  • Zsh Notify: Desktop notifications for long-running commands in zsh.
  • TLDR: Simplified and community-driven man pages http://tldr-pages.github.io/
  • up: Move to the upper directory by the number of <dots>.

3.3 My Terminal Environment.

  • OS: Kubuntu 18.10
  • Terminal: Konsole
  • Font: Hack Nerd Font
  • Color Scheme: Breeze
You can’t perform that action at this time.