extern/ohmyzsh
1
0
Fork 1
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-11-22 07:43:31 +01:00
Code Issues Packages Projects Releases Wiki Activity

Run markdown linting

Marc Cornellà 2021-09-29 16:40:54 +02:00
parent 2e8050a127
commit 3f737b2dbe
No known key found for this signature in database
GPG Key ID: 0314585E776A9C1B
18 changed files with 656 additions and 282 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
Articles.md

@ -1,6 +1,7 @@
Here are a collection of blog posts and articles that mention Oh My Zsh. Here are a collection of blog posts and articles that mention Oh My Zsh.
If you know of any that are missing, feel free to contribute! :-) If you know of any that are missing, feel free to contribute! :-)
- [[Setup your Mac with Zsh for Web development|https://medium.com/@vdeantoni/setting-up-your-mac-for-web-development-in-2020-659f5588b883]] - [[Setup your Mac with Zsh for Web development|https://medium.com/@vdeantoni/setting-up-your-mac-for-web-development-in-2020-659f5588b883]]
- [[Oh-my-zsh install 2018 Tutorial|https://medium.com/wearetheledger/oh-my-zsh-made-for-cli-lovers-installation-guide-3131ca5491fb]] - [[Oh-my-zsh install 2018 Tutorial|https://medium.com/wearetheledger/oh-my-zsh-made-for-cli-lovers-installation-guide-3131ca5491fb]]
- [[Badassify your terminal and shell|http://jilles.me/badassify-your-terminal-and-shell/]] - [[Badassify your terminal and shell|http://jilles.me/badassify-your-terminal-and-shell/]]
@ -24,4 +25,4 @@ If you know of any that are missing, feel free to contribute! :-)
- [May the 'command line' be with you](https://rachelcarmena.github.io/2019/05/26/may-the-command-line-be-with-you.html) - [May the 'command line' be with you](https://rachelcarmena.github.io/2019/05/26/may-the-command-line-be-with-you.html)
- [My Terminal Setup + Zsh](https://dev.to/aspittel/my-terminal-setup-iterm2--zsh--30lm) - [My Terminal Setup + Zsh](https://dev.to/aspittel/my-terminal-setup-iterm2--zsh--30lm)
- [A Huge List of Useful Keyboard Shortcuts](https://medium.com/better-programming/a-definitive-guide-to-all-the-shortcuts-for-new-rubyists-a365a590d16e)--Oh-My-zsh at the end - [A Huge List of Useful Keyboard Shortcuts](https://medium.com/better-programming/a-definitive-guide-to-all-the-shortcuts-for-new-rubyists-a365a590d16e)--Oh-My-zsh at the end
- [Powering up your terminal in Mac](https://programmerabroad.com/powering-up-your-terminal-in-mac/) - [Powering up your terminal in Mac](https://programmerabroad.com/powering-up-your-terminal-in-mac/)

4
Cheatsheet.md

@ -259,7 +259,6 @@ You also find these commands in Dash as a Cheat-sheet.
| _sc-enable NAME_ | enable the NAME process to start at boot | | _sc-enable NAME_ | enable the NAME process to start at boot |
| _sc-disable NAME_ | disable the NAME process at boot | | _sc-disable NAME_ | disable the NAME process at boot |
## Rails ## Rails
### Rails Aliases ### Rails Aliases
@ -278,7 +277,6 @@ You also find these commands in Dash as a Cheat-sheet.
| _rsd_ | rails server --debugger | | _rsd_ | rails server --debugger |
| _rsp_ | rails server --port | | _rsp_ | rails server --port |
### RAILS_ENV Aliases ### RAILS_ENV Aliases
| Alias | Command | | Alias | Command |
@ -297,4 +295,4 @@ You also find these commands in Dash as a Cheat-sheet.
| `z foo/` | `cd` into relative path | | `z foo/` | `cd` into relative path |
| `z ..` | `cd` one level up | | `z ..` | `cd` one level up |
| `z -` | `cd` into previous directory | | `z -` | `cd` into previous directory |
| `zi foo ` | `cd` with interactive selection (using `fzf`) | | `zi foo` | `cd` with interactive selection (using `fzf`) |

40
Code-Style-Guide.md

@ -15,11 +15,13 @@ Maximum line length is 80 characters.
If you have to write strings that are longer than 80 characters, this should be done with a "here document" or an embedded newline if possible. Literal strings that have to be longer than 80 chars and can't sensibly be split are okay, but it's strongly preferred to find a way to make it shorter. If you have to write strings that are longer than 80 characters, this should be done with a "here document" or an embedded newline if possible. Literal strings that have to be longer than 80 chars and can't sensibly be split are okay, but it's strongly preferred to find a way to make it shorter.
##### _Bad:_ ##### _Bad:_
```shell ```shell
long_string_1="I am an exceptionalllllllllllly looooooooooooooooooooooooooooooooooooooooong string." long_string_1="I am an exceptionalllllllllllly looooooooooooooooooooooooooooooooooooooooong string."
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
cat <<END; cat <<END;
I am an exceptionalllllllllllly I am an exceptionalllllllllllly
@ -28,6 +30,7 @@ END
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
long_string_2="I am an exceptionalllllllllllly long_string_2="I am an exceptionalllllllllllly
looooooooooooooooooooooooooooooooooooooooong string." looooooooooooooooooooooooooooooooooooooooong string."
@ -35,18 +38,20 @@ long_string_2="I am an exceptionalllllllllllly
### Pipelines ### Pipelines
Pipelines should be split one per line if they don't all fit on one line. Pipelines should be split one per line if they don't all fit on one line.
If a pipeline all fits on one line, it should be on one line. If a pipeline all fits on one line, it should be on one line.
If not, it should be split at one pipe segment per line with the pipe on the newline and a 2 space indent for the next section of the pipe. This applies to a chain of commands combined using '|' as well as to logical compounds using '||' and '&&'. If not, it should be split at one pipe segment per line with the pipe on the newline and a 2 space indent for the next section of the pipe. This applies to a chain of commands combined using '|' as well as to logical compounds using '||' and '&&'.
##### _Bad:_ ##### _Bad:_
```shell ```shell
command1 | command2 | command3 | command4 | command5 | command6 | command7 command1 | command2 | command3 | command4 | command5 | command6 | command7
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
command1 \ command1 \
| command2 \ | command2 \
@ -55,30 +60,35 @@ command1 \
``` ```
##### _Good:_ All fits on one line ##### _Good:_ All fits on one line
```shell ```shell
command1 | command2 command1 | command2
``` ```
### Use environment variables ### Use environment variables
When possible, use environment variables instead of shelling out to a command. When possible, use environment variables instead of shelling out to a command.
##### _Bad:_ ##### _Bad:_
```shell ```shell
$(pwd) $(pwd)
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
$PWD $PWD
``` ```
TODO: Add a list of all environment variables you can use. TODO: Add a list of all environment variables you can use.
### If / For / While ### If / For / While
Put `; do` and `; then` on the same line as the `while`, `for` or `if`. Put `; do` and `; then` on the same line as the `while`, `for` or `if`.
##### _Good:_ ##### _Good:_
```shell ```shell
for dir in ${dirs_to_cleanup}; do for dir in ${dirs_to_cleanup}; do
if [[ -d "${dir}/${ORACLE_SID}" ]]; then if [[ -d "${dir}/${ORACLE_SID}" ]]; then
@ -103,12 +113,14 @@ done
Meaningful self-documenting names should be used. If the variable name does not make it reasonably obvious as to the meaning of the variable, appropriate comments should be added. Meaningful self-documenting names should be used. If the variable name does not make it reasonably obvious as to the meaning of the variable, appropriate comments should be added.
##### _Bad:_ ##### _Bad:_
```shell ```shell
local TitleCase="" local TitleCase=""
local camelCase="" local camelCase=""
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
local snake_case="" local snake_case=""
``` ```
@ -116,11 +128,13 @@ local snake_case=""
Uppercase strings are reserved for global variables. (WARNING: In functions, only variables explicitly declared as local like `local foo=""` are really local.) Uppercase strings are reserved for global variables. (WARNING: In functions, only variables explicitly declared as local like `local foo=""` are really local.)
##### _Bad:_ ##### _Bad:_
```shell ```shell
local UPPERCASE="" local UPPERCASE=""
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
UPPERCASE="" UPPERCASE=""
``` ```
@ -128,11 +142,13 @@ UPPERCASE=""
Variable names should not clobber command names, such as `dir` or `pwd`. Variable names should not clobber command names, such as `dir` or `pwd`.
##### _Bad:_ ##### _Bad:_
```shell ```shell
local pwd="" local pwd=""
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
local pwd_read_in="" local pwd_read_in=""
``` ```
@ -140,6 +156,7 @@ local pwd_read_in=""
Variable names for loop indexes should be named similarly to any variable you're looping through. Variable names for loop indexes should be named similarly to any variable you're looping through.
##### _Good:_ ##### _Good:_
```shell ```shell
for zone in ${zones}; do for zone in ${zones}; do
something_with "${zone}" something_with "${zone}"
@ -151,6 +168,7 @@ done
Ensure that local variables are only seen inside a function and its children by using `local` or other `typeset` variants when declaring them. This avoids polluting the global name space and inadvertently setting or interacting with variables that may have significance outside the function. Ensure that local variables are only seen inside a function and its children by using `local` or other `typeset` variants when declaring them. This avoids polluting the global name space and inadvertently setting or interacting with variables that may have significance outside the function.
##### _Bad:_ ##### _Bad:_
```shell ```shell
function func_bad() { function func_bad() {
global_var=37 # Visible only within the function block global_var=37 # Visible only within the function block
@ -166,6 +184,7 @@ echo "global_var = $global_var" # global_var = 37
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
func_good() { func_good() {
local local_var="" local local_var=""
@ -185,6 +204,7 @@ echo "global_var = $global_var" # move function result to global scope
In the next example, lots of global variables are used over and over again, but the script "unfortunately" works anyway. The `parse_json()` function does not even return a value and the two functions shares their variables. You could also write all this without any function; this would have the same effect. In the next example, lots of global variables are used over and over again, but the script "unfortunately" works anyway. The `parse_json()` function does not even return a value and the two functions shares their variables. You could also write all this without any function; this would have the same effect.
##### _Bad:_ with global variables ##### _Bad:_ with global variables
```shell ```shell
#!/bin/bash #!/bin/bash
@ -229,6 +249,7 @@ echo "foobar: $counter - $i"
In shell scripts, it is less common that you really want to reuse the functionality, but the code is much easier to read if you write small functions with appropriate return values and parameters. In shell scripts, it is less common that you really want to reuse the functionality, but the code is much easier to read if you write small functions with appropriate return values and parameters.
##### _Good:_ with local variables ##### _Good:_ with local variables
```shell ```shell
#!/bin/zsh #!/bin/zsh
@ -281,11 +302,13 @@ echo "foobar: $counter - $i"
All caps, separated with underscores, declared at the top of the file. Constants and anything exported to the environment should be capitalized. All caps, separated with underscores, declared at the top of the file. Constants and anything exported to the environment should be capitalized.
##### _Constant:_ ##### _Constant:_
```shell ```shell
readonly PATH_TO_FILES='/some/path' readonly PATH_TO_FILES='/some/path'
``` ```
##### _Constant and environment:_ ##### _Constant and environment:_
```shell ```shell
declare -xr ORACLE_SID='PROD' declare -xr ORACLE_SID='PROD'
``` ```
@ -324,6 +347,7 @@ Lower-case, with underscores to separate words. Parentheses are required after t
The opening brace should appear on the same line as the function name. The opening brace should appear on the same line as the function name.
##### _Bad:_ ##### _Bad:_
```shell ```shell
function my_bad_func { function my_bad_func {
... ...
@ -331,6 +355,7 @@ function my_bad_func {
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
my_good_func() { my_good_func() {
... ...
@ -341,6 +366,7 @@ my_good_func() {
Private or utility functions should be prefixed with an underscore: Private or utility functions should be prefixed with an underscore:
##### _Good:_ ##### _Good:_
```shell ```shell
_helper-util() { _helper-util() {
... ...
@ -352,6 +378,7 @@ _helper-util() {
After a script or function terminates, a `$?` from the command line gives the exit status of the script, that is, the exit status of the last command executed in the script, which is, by convention, 0 on success or an integer in the range 1 - 255 on error. After a script or function terminates, a `$?` from the command line gives the exit status of the script, that is, the exit status of the last command executed in the script, which is, by convention, 0 on success or an integer in the range 1 - 255 on error.
##### _Bad:_ ##### _Bad:_
```shell ```shell
my_bad_func() { my_bad_func() {
# didn't work with zsh / bash is ok # didn't work with zsh / bash is ok
@ -370,6 +397,7 @@ my_bad_func() {
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
my_good_func() { my_good_func() {
# didn't work with zsh / bash is ok # didn't work with zsh / bash is ok
@ -395,16 +423,19 @@ my_good_func() {
Always check return values and give informative error messages. For unpiped commands, use `$?` or check directly via an if statement to keep it simple. Use nonzero return values to indicate errors. Always check return values and give informative error messages. For unpiped commands, use `$?` or check directly via an if statement to keep it simple. Use nonzero return values to indicate errors.
##### _Bad:_ ##### _Bad:_
```shell ```shell
mv "${file_list}" "${dest_dir}/" mv "${file_list}" "${dest_dir}/"
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
mv "${file_list}" "${dest_dir}/" || exit 1 mv "${file_list}" "${dest_dir}/" || exit 1
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
if ! mv "${file_list}" "${dest_dir}/"; then if ! mv "${file_list}" "${dest_dir}/"; then
echo "Unable to move ${file_list} to ${dest_dir}" >&2 echo "Unable to move ${file_list} to ${dest_dir}" >&2
@ -413,6 +444,7 @@ fi
``` ```
##### _Good:_ use "$?" to get the last return value ##### _Good:_ use "$?" to get the last return value
```shell ```shell
mv "${file_list}" "${dest_dir}/" mv "${file_list}" "${dest_dir}/"
if [[ "$?" -ne 0 ]]; then if [[ "$?" -ne 0 ]]; then
@ -430,11 +462,13 @@ Use `$(command)` instead of backticks.
Nested backticks require escaping the inner ones with `\`. The `$(command)` format doesn't change when nested and is easier to read. Nested backticks require escaping the inner ones with `\`. The `$(command)` format doesn't change when nested and is easier to read.
##### _Bad:_ ##### _Bad:_
```shell ```shell
var="`command \`command1\``" var="`command \`command1\``"
``` ```
##### _Good:_ ##### _Good:_
```shell ```shell
var="$(command "$(command1)")" var="$(command "$(command1)")"
``` ```
@ -447,4 +481,4 @@ Eval is evil! Eval munges the input when used for assignment to variables and ca
- [Shell Style Guide](https://google.github.io/styleguide/shell.xml) - [Shell Style Guide](https://google.github.io/styleguide/shell.xml)
- [BASH Programming - Introduction HOW-TO](http://tldp.org/HOWTO/Bash-Prog-Intro-HOWTO.html) - [BASH Programming - Introduction HOW-TO](http://tldp.org/HOWTO/Bash-Prog-Intro-HOWTO.html)
- [Linux kernel coding style](https://www.kernel.org/doc/Documentation/process/coding-style.rst) - [Linux kernel coding style](https://www.kernel.org/doc/Documentation/process/coding-style.rst)

8
Contribution-Technical-Practices.md

@ -25,6 +25,7 @@ _This supposes that you have Oh-My-Zsh installed already in `$ZSH` (default:_ `~
_All the following uses_ `<name>` _for the remote name, but you can use something else._ _All the following uses_ `<name>` _for the remote name, but you can use something else._
- **3.** Go to your local install directory and add your own repository as a remote - **3.** Go to your local install directory and add your own repository as a remote
```shell ```shell
cd $ZSH cd $ZSH
git remote add <name> git@github.com:<name>/oh-my-zsh.git git remote add <name> git@github.com:<name>/oh-my-zsh.git
@ -39,17 +40,20 @@ git remote add <name> git@github.com:<name>/oh-my-zsh.git
### Maintained fork setup ### Maintained fork setup
- **3.** Go to your local install directory and rename the origin remote to "upstream" - **3.** Go to your local install directory and rename the origin remote to "upstream"
```shell ```shell
cd $ZSH cd $ZSH
git remote rename origin upstream git remote rename origin upstream
``` ```
- **4.** Then set your own repository as the origin remote - **4.** Then set your own repository as the origin remote
```shell ```shell
git remote add origin git@github.com:<name>/oh-my-zsh.git git remote add origin git@github.com:<name>/oh-my-zsh.git
``` ```
**Upgrading:** **Upgrading:**
- **Upstream:** when you want to get the latest upgrades from the original repository (_aka_ upstream), simply `git pull upstream master`; you may have to solve conflicts with your own changes of course; when you are satisfied with the update you can `git push origin master`. - **Upstream:** when you want to get the latest upgrades from the original repository (_aka_ upstream), simply `git pull upstream master`; you may have to solve conflicts with your own changes of course; when you are satisfied with the update you can `git push origin master`.
- **Origin:** when you want to get the latest upgrades from your own fork (_aka_ origin), simply `git pull --rebase origin master`; you may have to solve conflicts with your local changes of course; when you are satisfied with the update you can `git push --force origin master`. - **Origin:** when you want to get the latest upgrades from your own fork (_aka_ origin), simply `git pull --rebase origin master`; you may have to solve conflicts with your local changes of course; when you are satisfied with the update you can `git push --force origin master`.
@ -68,6 +72,7 @@ _The following uses_ `my-new-pr` _for the branch name, but you can use something
### Simple contribution PRs ### Simple contribution PRs
- **1.** Any new PR must start from a clean upstream tree - **1.** Any new PR must start from a clean upstream tree
```shell ```shell
git checkout origin/master git checkout origin/master
git checkout -b my-new-pr git checkout -b my-new-pr
@ -76,6 +81,7 @@ git checkout -b my-new-pr
You are now on your dedicated PR branch. Time to commit some changes! You are now on your dedicated PR branch. Time to commit some changes!
- **2.** Send your commits - **2.** Send your commits
```shell ```shell
git push <name> my-new-pr git push <name> my-new-pr
``` ```
@ -89,6 +95,7 @@ You can now go to GitHub and create the PR.
### Maintained fork PRs ### Maintained fork PRs
- **1.** Any new PR must start from a clean upstream tree - **1.** Any new PR must start from a clean upstream tree
```shell ```shell
git checkout upstream/master git checkout upstream/master
git checkout -b my-new-pr git checkout -b my-new-pr
@ -97,6 +104,7 @@ git checkout -b my-new-pr
You are now on your dedicated PR branch. Time to commit some changes! You are now on your dedicated PR branch. Time to commit some changes!
- **2.** Send your commits - **2.** Send your commits
```shell ```shell
git push origin my-new-pr git push origin my-new-pr
``` ```

18
Customization.md

@ -8,7 +8,7 @@ Initially `$ZSH_CUSTOM` points to oh-my-zsh's `custom` directory. Whatever you p
Let's say you created your own plugin `foobar` and want to add it to your configuration. Let's say you created your own plugin `foobar` and want to add it to your configuration.
##### _~/.zshrc_ ##### `~/.zshrc`
```shell ```shell
plugins=(git bundler foobar) plugins=(git bundler foobar)
@ -16,7 +16,7 @@ plugins=(git bundler foobar)
Then, create a `foobar` directory inside the `plugins` folder and an initialization script to launch your plugin. This script has to follow a naming convention, as all plugin files must have an ending of `.plugin.zsh`. Your file tree should look like this: Then, create a `foobar` directory inside the `plugins` folder and an initialization script to launch your plugin. This script has to follow a naming convention, as all plugin files must have an ending of `.plugin.zsh`. Your file tree should look like this:
``` ```text
$ZSH_CUSTOM $ZSH_CUSTOM
└── plugins └── plugins
└── foobar └── foobar
@ -25,7 +25,7 @@ $ZSH_CUSTOM
### Overriding an existing plugin ### Overriding an existing plugin
Also follow these steps if you want to override plugins that ship with your oh-my-zsh installation. To override a plugin with a custom version, put your custom version at `$ZSH_CUSTOM/plugins/<plugin_name>/`. For example, if it's the rvm plugin you want to override, create the directory `custom/plugins/rvm` and place a file called `rvm.plugin.zsh` inside of it. Also follow these steps if you want to override plugins that ship with your oh-my-zsh installation. To override a plugin with a custom version, put your custom version at `$ZSH_CUSTOM/plugins/<plugin_name>/`. For example, if it's the rvm plugin you want to override, create the directory `custom/plugins/rvm` and place a file called `rvm.plugin.zsh` inside of it.
This method will override the entire plugin: your custom plugin files will be loaded *instead* of the files from the original plugin. This method will override the entire plugin: your custom plugin files will be loaded *instead* of the files from the original plugin.
@ -43,7 +43,7 @@ Adding and customizing your own themes pretty much works the same as with plugin
Themes are located in a `themes` folder and must end with `.zsh-theme`. The basename of the file is the name of the theme. Themes are located in a `themes` folder and must end with `.zsh-theme`. The basename of the file is the name of the theme.
``` ```text
$ZSH_CUSTOM $ZSH_CUSTOM
└── themes └── themes
└── my_awesome_theme.zsh-theme └── my_awesome_theme.zsh-theme
@ -63,7 +63,8 @@ If you don't change its filename, your `.zshrc` file can stay the same: `ZSH_THE
oh-my-zsh's internals are defined in its `lib` directory. To change them, just create a file inside the `custom` directory (its name doesn't matter, as long as it has a `.zsh` ending) and start customizing whatever you want. Unsatisfied with the way `git_prompt_info()` works? Write your own implementation! oh-my-zsh's internals are defined in its `lib` directory. To change them, just create a file inside the `custom` directory (its name doesn't matter, as long as it has a `.zsh` ending) and start customizing whatever you want. Unsatisfied with the way `git_prompt_info()` works? Write your own implementation!
##### _$ZSH_CUSTOM/my_patches.zsh_ ##### `$ZSH_CUSTOM/my_patches.zsh`
```shell ```shell
function git_prompt_info() { function git_prompt_info() {
# prove that you can do better # prove that you can do better
@ -78,14 +79,15 @@ You can also fully override an existing `lib/*.zsh` file by providing a `$ZSH_CU
If you don't want to use the built-in `custom` directory itself, just change the path of `$ZSH_CUSTOM` inside your `.zshrc` to a directory of your own liking. Everything will be fine as long as you adhere to the conventional file hierarchy. If you don't want to use the built-in `custom` directory itself, just change the path of `$ZSH_CUSTOM` inside your `.zshrc` to a directory of your own liking. Everything will be fine as long as you adhere to the conventional file hierarchy.
##### _~/.zshrc_ ##### `~/.zshrc`
```shell ```shell
ZSH_CUSTOM=$HOME/my_customizations ZSH_CUSTOM=$HOME/my_customizations
``` ```
File tree inside of your home directory: File tree inside of your home directory:
``` ```text
$HOME $HOME
└── my_customizations └── my_customizations
├── my_lib_patches.zsh ├── my_lib_patches.zsh
@ -98,4 +100,4 @@ $HOME
## Version control of customizations ## Version control of customizations
By default, git is set to ignore the custom directory, so that oh-my-zsh's update process does not interfere with your customizations. If you want to use a version control system like git for your personal changes, just initialize your own repository inside the `custom` directory (`git init`), or point `$ZSH_CUSTOM` to another directory you have under version control. By default, git is set to ignore the custom directory, so that oh-my-zsh's update process does not interfere with your customizations. If you want to use a version control system like git for your personal changes, just initialize your own repository inside the `custom` directory (`git init`), or point `$ZSH_CUSTOM` to another directory you have under version control.

51
Design.md

@ -1,5 +1,5 @@
This page is a description of the current architecture and design of oh-my-zsh. This page is a description of the current architecture and design of oh-my-zsh.
This is a work in progress: we don't think there's anything outright wrong in it, but much may still be left out. This is a work in progress: we don't think there's anything outright wrong in it, but much may still be left out.
@ -12,12 +12,12 @@ What oh-my-zsh provides:
- Configuration of zsh itself, enabling advanced features - Configuration of zsh itself, enabling advanced features
- Theming - Theming
- Extra shell functionality & terse shortcuts - Extra shell functionality & terse shortcuts
- e.g. dir navigation - e.g. dir navigation
- Integration with third party programs and commands - Integration with third party programs and commands
- Completion, aliases, and auxiliary functions - Completion, aliases, and auxiliary functions
- Both OS-specific stuff and applications/utilities - Both OS-specific stuff and applications/utilities
- Auto-starting programs - Auto-starting programs
- e.g. the gpg-agent plugin - e.g. the gpg-agent plugin
It seems that plugins can get arbitrarily powerful and do whatever they want, so the user should understand what a given plugin does before enabling it. It seems that plugins can get arbitrarily powerful and do whatever they want, so the user should understand what a given plugin does before enabling it.
@ -30,6 +30,7 @@ These are variables that base OMZ (excluding any plugins) uses. I've read throug
At initialization time: At initialization time:
In oh-my-zsh.sh: In oh-my-zsh.sh:
- `ZSH` - path to .oh-my-zsh (not zsh) installation - `ZSH` - path to .oh-my-zsh (not zsh) installation
- `plugins` - user-provided list of plugins to load - `plugins` - user-provided list of plugins to load
- `ZSH_CUSTOM` – path to the oh-my-zsh (not zsh itself) customization dir - `ZSH_CUSTOM` – path to the oh-my-zsh (not zsh itself) customization dir
@ -45,9 +46,9 @@ In oh-my-zsh.sh:
- `ZSH_VERSION` - `ZSH_VERSION`
- `ZDOTDIR` - `ZDOTDIR`
- Standard Unix environment variables - Standard Unix environment variables
- `HOME` - `HOME`
- `HOST` - `HOST`
- `OSTYPE` - `OSTYPE`
The only required one is `$ZSH`. The rest either have defaults, or undef is fine and has an expected behavior. (Though if $plugins is unset, the git plugin won't get loaded. Will that break stuff?) All these `ZSH_*` variables are OMZ-specific, not standard `zsh` stuff. Except for `ZSH_VERSION`, which is a standard parameter provided by `zsh`. The only required one is `$ZSH`. The rest either have defaults, or undef is fine and has an expected behavior. (Though if $plugins is unset, the git plugin won't get loaded. Will that break stuff?) All these `ZSH_*` variables are OMZ-specific, not standard `zsh` stuff. Except for `ZSH_VERSION`, which is a standard parameter provided by `zsh`.
@ -56,6 +57,7 @@ The only required one is `$ZSH`. The rest either have defaults, or undef is fine
In oh-my-zsh.sh: In oh-my-zsh.sh:
At init: At init:
- `SHORT_HOST` - `SHORT_HOST`
- `LSCOLORS` - `LSCOLORS`
- `SCREEN_NO` - `SCREEN_NO`
@ -68,23 +70,26 @@ At init:
- `BG` - `BG`
At init (defaults if not provided): At init (defaults if not provided):
- `ZSH_CUSTOM` - defaults to `$ZSH/custom` - `ZSH_CUSTOM` - defaults to `$ZSH/custom`
- `ZSH_CACHE_DIR` - defaults to `$ZSH/cache` - `ZSH_CACHE_DIR` - defaults to `$ZSH/cache`
- `ZSH_COMPDUMP` - `ZSH_COMPDUMP`
- `ZSH_SPECTRUM_TEXT` - `ZSH_SPECTRUM_TEXT`
Modified at init: Modified at init:
- `fpath` - `fpath`
- `LC_CTYPE` - `LC_CTYPE`
Leaks: Leaks:
- `custom_config_file` - `custom_config_file`
### Variables plugins use ### Variables plugins use
- `URLTOOLS_METHOD` - plugins/urltools uses it to manually select node/php/perl/python/etc - `URLTOOLS_METHOD` - plugins/urltools uses it to manually select node/php/perl/python/etc
## Oh-My-Zsh Initialization ## ## Oh-My-Zsh Initialization
Oh-my-zsh is initialized for the current `zsh` session by sourcing `$ZSH/oh-my-zsh.sh`. This is typically done from `.zshrc`, and the oh-my-zsh installation process modifies the user's `.zshrc` to do so. Oh-my-zsh is initialized for the current `zsh` session by sourcing `$ZSH/oh-my-zsh.sh`. This is typically done from `.zshrc`, and the oh-my-zsh installation process modifies the user's `.zshrc` to do so.
@ -101,22 +106,22 @@ The basic steps of the oh-my-zsh initialization process are as follows. Note tha
The initialization steps in detail: The initialization steps in detail:
- Check for updates - Check for updates
- Runs in a separate `zsh` process - Runs in a separate `zsh` process
- Does not load OMZ, so it's independent and doesn't use any OMZ files - Does not load OMZ, so it's independent and doesn't use any OMZ files
- Update `$fpath`: Add functions/ and completions/ - Update `$fpath`: Add functions/ and completions/
- (even though they don't exist in the current codebase) - (even though they don't exist in the current codebase)
- Set `$ZSH_CUSTOM` and `$ZSH_CACHE_DIR` - Set `$ZSH_CUSTOM` and `$ZSH_CACHE_DIR`
- Load lib ("config") files - Load lib ("config") files
- Discovers and sources all lib files, in alphabetical order, respecting custom overrides - Discovers and sources all lib files, in alphabetical order, respecting custom overrides
- Load custom user code - Load custom user code
- Source each `$ZSH_CUSTOM/*.zsh` file, in alphabetical order - Source each `$ZSH_CUSTOM/*.zsh` file, in alphabetical order
- Pre-load plugins (add to `$fpath`, but don't source) - Pre-load plugins (add to `$fpath`, but don't source)
- Set `$SHORT_HOST` - Set `$SHORT_HOST`
- Initialize Completion support - Initialize Completion support
- Set `$ZSH_COMPDUMP` - Set `$ZSH_COMPDUMP`
- Run `compinit`, using dump file - Run `compinit`, using dump file
- Load plugins - Load plugins
- Source each plugin specified in `$plugins`, in the order specified - Source each plugin specified in `$plugins`, in the order specified
- Load theme - Load theme
## Customization ## Customization
@ -128,6 +133,7 @@ Overriding internals can be done by adding `*.zsh` files to the `$ZSH_CUSTOM` ro
It's not documented in the _Customization_ page, but `$ZSH_CUSTOM/lib/*.zsh` do override the corresponding internals lib files. If a custom one is present, it is sourced instead of the one in the distribution. It's not documented in the _Customization_ page, but `$ZSH_CUSTOM/lib/*.zsh` do override the corresponding internals lib files. If a custom one is present, it is sourced instead of the one in the distribution.
So, you can: So, you can:
- Override lib/* files on a per-file basis (loaded instead of the base file of the same name) - Override lib/* files on a per-file basis (loaded instead of the base file of the same name)
- Add arbitrary customization code that runs later and can redefine any function or variable from the core - Add arbitrary customization code that runs later and can redefine any function or variable from the core
- Override plugins and themes on a per-plugin/theme basis (loaded instead of base) - Override plugins and themes on a per-plugin/theme basis (loaded instead of base)
@ -144,6 +150,7 @@ The [Customization](https://github.com/ohmyzsh/ohmyzsh/wiki/Customization) wiki
Oh-my-zsh plugins extend the core functionality of oh-my-zsh. Oh-my-zsh plugins extend the core functionality of oh-my-zsh.
Plugins provide functionality in the following areas: Plugins provide functionality in the following areas:
- Completion definitions - Completion definitions
- Functions - Functions
- Aliases - Aliases
@ -163,6 +170,7 @@ OMZ turns on the `prompt_subst` shell option, and OMZ themes assume it is enable
Themes set a variety of variables to control the appearance of the zsh prompt. They may also install hook functions. These variables are read by core OMZ functions like `git_prompt_info()` and used to modify their behavior and style their output. Themes set a variety of variables to control the appearance of the zsh prompt. They may also install hook functions. These variables are read by core OMZ functions like `git_prompt_info()` and used to modify their behavior and style their output.
Things themes do: Things themes do:
- Set `$PROMPT`, `$RPROMPT`, and related variables - Set `$PROMPT`, `$RPROMPT`, and related variables
- Set `$LSCOLORS` and `$LS_COLORS` - Set `$LSCOLORS` and `$LS_COLORS`
- Define hook functions - Define hook functions
@ -176,6 +184,7 @@ These variables are set by themes to control the prompt's appearance and other c
- `ZSH_THEME_SCM_PROMPT_PREFIX` – used in `bzr_prompt_info()` from `lib/bzr.sh` - `ZSH_THEME_SCM_PROMPT_PREFIX` – used in `bzr_prompt_info()` from `lib/bzr.sh`
git_prompt_info(): git_prompt_info():
- `ZSH_THEME_GIT_PROMPT_PREFIX` - `ZSH_THEME_GIT_PROMPT_PREFIX`
- `ZSH_THEME_GIT_PROMPT_SUFFIX` - `ZSH_THEME_GIT_PROMPT_SUFFIX`
- `ZSH_THEME_GIT_COMMITS_AHEAD_PREFIX` - `ZSH_THEME_GIT_COMMITS_AHEAD_PREFIX`
@ -199,15 +208,18 @@ git_prompt_info():
- `ZSH_THEME_GIT_PROMPT_UNTRACKED` - `ZSH_THEME_GIT_PROMPT_UNTRACKED`
nvm_prompt_info(): nvm_prompt_info():
- `ZSH_THEME_NVM_PROMPT_PREFIX` - `ZSH_THEME_NVM_PROMPT_PREFIX`
- `ZSH_THEME_NVM_PROMPT_SUFFIX` - `ZSH_THEME_NVM_PROMPT_SUFFIX`
rvm_prompt_info(): rvm_prompt_info():
- `ZSH_THEME_RVM_PROMPT_PREFIX` - `ZSH_THEME_RVM_PROMPT_PREFIX`
- `ZSH_THEME_RVM_PROMPT_SUFFIX` - `ZSH_THEME_RVM_PROMPT_SUFFIX`
- `ZSH_THEME_RVM_PROMPT_OPTIONS` - `ZSH_THEME_RVM_PROMPT_OPTIONS`
lib/termsupport.zsh: lib/termsupport.zsh:
- `ZSH_THEME_TERM_TAB_TITLE_IDLE` - `ZSH_THEME_TERM_TAB_TITLE_IDLE`
- `ZSH_THEME_TERM_TITLE_IDLE` - `ZSH_THEME_TERM_TITLE_IDLE`
@ -221,6 +233,7 @@ Other `ZSH_THEME_*` variables may be used by different themes and plugins. The p
Some per-theme custom variables: Some per-theme custom variables:
In bureau.zsh-theme: In bureau.zsh-theme:
- `ZSH_THEME_GIT_PROMPT_STAGED` - `ZSH_THEME_GIT_PROMPT_STAGED`
- `ZSH_THEME_GIT_PROMPT_UNSTAGED` - `ZSH_THEME_GIT_PROMPT_UNSTAGED`
- `ZSH_THEME_GIT_PROMPT_UNTRACKED` - `ZSH_THEME_GIT_PROMPT_UNTRACKED`
@ -245,7 +258,7 @@ Although some existing themes set `$chpwd` or `$precmd`, it's probably better fo
### Loading themes ### Loading themes
The oh-my-zsh theme mechanism is designed to load a theme once per session, during OMZ initialization. The oh-my-zsh theme mechanism is designed to load a theme once per session, during OMZ initialization.
The theme mechanism does not provide a way to unload themes. The values for `PROMPT`, `RPROMPT`, `ZSH_THEME_*`, and hooks do not get reset. Thus, you can hack in support for switching themes during a session, but it is not clean: when you switch themes, you can get leftover settings from previously loaded themes and end up with a combination of themes. The theme mechanism does not provide a way to unload themes. The values for `PROMPT`, `RPROMPT`, `ZSH_THEME_*`, and hooks do not get reset. Thus, you can hack in support for switching themes during a session, but it is not clean: when you switch themes, you can get leftover settings from previously loaded themes and end up with a combination of themes.

14
External-plugins.md

@ -1,14 +1,17 @@
## A list of plugins that don't come bundled with oh-my-zsh ## A list of plugins that don't come bundled with oh-my-zsh
There is no restriction for adding your plugin into zsh bundle (unlike [themes](https://github.com/ohmyzsh/ohmyzsh/wiki/External-themes)) but the rationale for creating this page is next: There is no restriction for adding your plugin into zsh bundle (unlike [themes](https://github.com/ohmyzsh/ohmyzsh/wiki/External-themes)) but the rationale for creating this page is next:
* sometimes you're not really sure if your plugin will not harm (e.g. it can break something). * sometimes you're not really sure if your plugin will not harm (e.g. it can break something).
### Installation ### Installation
It should be clear from [this](https://github.com/ohmyzsh/ohmyzsh/wiki/Customization#overriding-and-adding-plugins). It should be clear from [this](https://github.com/ohmyzsh/ohmyzsh/wiki/Customization#overriding-and-adding-plugins).
### The plugins ### The plugins
#### Custom git plugin #### Custom git plugin
Fixes some inconsistencies in the default git plugin that make the aliases more intuitive, while adding some other useful functions. Fixes some inconsistencies in the default git plugin that make the aliases more intuitive, while adding some other useful functions.
You can get it from [here](https://github.com/davidde/git). You can get it from [here](https://github.com/davidde/git).
@ -26,7 +29,7 @@ You can get it from [here](https://gist.github.com/oshybystyi/475ee7768efc03727f
GPG encrypted, Internet synchronized Zsh history using Git. GPG encrypted, Internet synchronized Zsh history using Git.
You can get it from [here](https://github.com/wulfgarpro/history-sync). You can get it from [here](https://github.com/wulfgarpro/history-sync).
#### Doge Say #### Doge Say
@ -42,7 +45,7 @@ And get your doge [here](https://github.com/txstc55/dogesay/blob/master/dogesay.
Give tab-completions to `z`. Give tab-completions to `z`.
[![](https://github.com/changyuheng/fz/blob/master/fz-demo.gif)](https://github.com/changyuheng/fz/blob/master/fz-demo.gif) [![fz demo](https://github.com/changyuheng/fz/raw/master/fz-demo.gif)](https://github.com/changyuheng/fz/blob/master/fz-demo.gif)
Get it [here](https://github.com/changyuheng/fz). Get it [here](https://github.com/changyuheng/fz).
@ -52,16 +55,21 @@ Get it [here](https://github.com/changyuheng/fz).
**Maintainer:** [guiferpa](https://github.com/guiferpa) **Maintainer:** [guiferpa](https://github.com/guiferpa)
##### Description ##### Description
This plugin show platforms version This plugin show platforms version
##### Support ##### Support
[Nodejs](https://nodejs.org), [NPM](https://www.npmjs.com), [Docker](https://www.docker.com), [Go](https://golang.org), [Python](https://www.python.org), [Elixir](https://elixir-lang.org) and [Ruby](https://www.ruby-lang.org) [Nodejs](https://nodejs.org), [NPM](https://www.npmjs.com), [Docker](https://www.docker.com), [Go](https://golang.org), [Python](https://www.python.org), [Elixir](https://elixir-lang.org) and [Ruby](https://www.ruby-lang.org)
##### Demo ##### Demo
![Demo](https://raw.githubusercontent.com/guiferpa/aterminal/master/images/demo.gif) ![Demo](https://raw.githubusercontent.com/guiferpa/aterminal/master/images/demo.gif)
#### [xxh](https://github.com/xxh/xxh) - bring Oh My Zsh wherever you go through the SSH #### [xxh](https://github.com/xxh/xxh) - bring Oh My Zsh wherever you go through the SSH
Some users may want to use Oh My Zsh during the SSH connections. There is [xxh project](https://github.com/xxh/xxh) that allows bring Zsh with Oh My Zsh framework to the remote host without any installations, root access or affection on the host. Some users may want to use Oh My Zsh during the SSH connections. There is [xxh project](https://github.com/xxh/xxh) that allows bring Zsh with Oh My Zsh framework to the remote host without any installations, root access or affection on the host.
#### [zshnotes](https://github.com/jameshgrn/zshnotes) #### [zshnotes](https://github.com/jameshgrn/zshnotes)
A small, tidy, lightweight notes app that creates a daily text file and timestamps every line of added text A small, tidy, lightweight notes app that creates a daily text file and timestamps every line of added text

286
External-themes.md

@ -34,11 +34,7 @@ Author: [@sebastianpulido](https://github.com/sebastianpulido)
The **new Kali Linux** console adapted to Ubuntu (and maybe any distro)! The **new Kali Linux** console adapted to Ubuntu (and maybe any distro)!
``` > To install it, it is as easy as running the single INSTALLER.sh file.
To install it, it is as easy as running the single INSTALLER.sh file
```
![](https://camo.githubusercontent.com/55706d89bdbb484c6a54b7476311c7ccf218bcc96752caa0a11eb1664983c03b/68747470733a2f2f63646e2e636c697070792e67672f636c697070792f37663265303964322d653238302d343434302d623464392d3665346438383730313939332f633138353166362e676966)
* Install: [how to install](https://github.com/alejandromume/ubunly-zsh-theme#install) * Install: [how to install](https://github.com/alejandromume/ubunly-zsh-theme#install)
@ -48,7 +44,8 @@ To install it, it is as easy as running the single INSTALLER.sh file
--- ---
#### bigpath #### bigpath
![](https://preview.redd.it/ie39emm3bl461.png?width=1230&format=png&auto=webp&s=418d6c1a143bd4506bb3c161264606375ed5050e)
![bigpath screenshot](https://preview.redd.it/ie39emm3bl461.png?width=1230&format=png&auto=webp&s=418d6c1a143bd4506bb3c161264606375ed5050e)
This theme can show your username, your current directory + the one before, git information (branch and unstaged/uncommited changes), and the current time. This theme can show your username, your current directory + the one before, git information (branch and unstaged/uncommited changes), and the current time.
Pink dot means unstaged, purple dot means uncommitted. Pink dot means unstaged, purple dot means uncommitted.
@ -57,6 +54,7 @@ Author: [@Tesohh](https://github.com/Tesohh)
[Repo](https://github.com/Tesohh/omzbigpath) [Repo](https://github.com/Tesohh/omzbigpath)
--- ---
#### ✏️✅ emoji #### ✏️✅ emoji
emoji theme for [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh/). simplified *robbyrussell* and replaced git prompt symbol with emoji for better clarity. Works fine on Macs. emoji theme for [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh/). simplified *robbyrussell* and replaced git prompt symbol with emoji for better clarity. Works fine on Macs.
@ -72,12 +70,15 @@ Then change current theme to emoji ```ZSH_THEME=emoji``` in your ```~/.zshrc```.
Activate a new theme with ```$ source ~/.zshrc```. Activate a new theme with ```$ source ~/.zshrc```.
##### Syntax ##### Syntax
- ```➜ current_dir (git_branch) <emoji indicator>```
- ✏️ Git prompt is dirty (uncommitted files) * ```➜ current_dir (git_branch) <emoji indicator>```
- ✅ Git prompt is clean (committed)
* ✏️ Git prompt is dirty (uncommitted files)
* ✅ Git prompt is clean (committed)
##### Issues ##### Issues
- ✏️ emoji is breaking cursor potion to the right hover on the first character on Crostini terminal
* ✏️ emoji is breaking cursor potion to the right hover on the first character on Crostini terminal
source: [repo](https://github.com/masaakifuruki/emoji.zsh-theme) source: [repo](https://github.com/masaakifuruki/emoji.zsh-theme)
@ -120,17 +121,18 @@ author: [@masaakifuruki](https://github.com/masaakifuruki)
</p></a> </p></a>
**Quick start** **Quick start**
```shell ```shell
npm install -g typewritten npm install -g typewritten
# then reload zsh # then reload zsh
``` ```
**Features** **Features**
- Asynchronous git info
- 100% customizable
- Actively maintained
- [Thorough documentation](https://typewritten.dev)
* Asynchronous git info
* 100% customizable
* Actively maintained
* [Thorough documentation](https://typewritten.dev)
Repository: [typewritten.zsh](https://github.com/reobin/typewritten) Repository: [typewritten.zsh](https://github.com/reobin/typewritten)
@ -139,13 +141,13 @@ Documentation: [typewritten.dev](https://typewritten.dev)
Author: [@reobin](https://github.com/reobin) Author: [@reobin](https://github.com/reobin)
--- ---
#### guezwhoz #### guezwhoz
![guezwhoz](https://github.com/guesswhozzz/guezwhoz-scheme/blob/main/demos/completer-zsh-demo.gif?raw=true) ![guezwhoz](https://github.com/guesswhozzz/guezwhoz-scheme/blob/main/demos/completer-zsh-demo.gif?raw=true)
- Single git status marker for Visual Studio Code and Git cli * Single git status marker for Visual Studio Code and Git cli
- Interactive `Tab` completer * Interactive `Tab` completer
source: [repo](https://github.com/guesswhozzz/guezwhoz-zshell) source: [repo](https://github.com/guesswhozzz/guezwhoz-zshell)
@ -154,6 +156,7 @@ author: [@guesswhozzz](https://github.com/guesswhozzz)
--- ---
#### Aphrodite Theme #### Aphrodite Theme
![Aphrodite Terminal Theme](https://user-images.githubusercontent.com/11278181/56094804-29972500-5edf-11e9-90a4-ffafdc58d3d7.png) ![Aphrodite Terminal Theme](https://user-images.githubusercontent.com/11278181/56094804-29972500-5edf-11e9-90a4-ffafdc58d3d7.png)
Minimalistic Aphrodite theme does not have any visual noise. Displays only the necessary information: current user, hostname, working directory, git branch if exists. Looks great both with dark and white terminals. Minimalistic Aphrodite theme does not have any visual noise. Displays only the necessary information: current user, hostname, working directory, git branch if exists. Looks great both with dark and white terminals.
@ -162,7 +165,9 @@ See [repository](https://github.com/win0err/aphrodite-terminal-theme) for source
Author: [@win0err](https://github.com/win0err) Author: [@win0err](https://github.com/win0err)
--- ---
#### MacOS Terminal #### MacOS Terminal
<h3 align="center"><a href="https://github.com/alejandromume/macos-zsh-theme">MacOS Terminal</a></h3> <h3 align="center"><a href="https://github.com/alejandromume/macos-zsh-theme">MacOS Terminal</a></h3>
<p align="center"> <p align="center">
@ -202,6 +207,7 @@ The minimal MacOS terminal brought to ZSH
* Author: [@alejandromume](https://github.com/alejandromume) * Author: [@alejandromume](https://github.com/alejandromume)
--- ---
#### short #### short
<img src=https://github.com/nikhilkmr300/omz-themes/blob/master/images/short.png width=640> <img src=https://github.com/nikhilkmr300/omz-themes/blob/master/images/short.png width=640>
@ -210,6 +216,7 @@ If long prompts annoy you, this theme is for you!
It does away with the long path after the username, and retains only the basename of the current working directory in the prompt. It does away with the long path after the username, and retains only the basename of the current working directory in the prompt.
Features: Features:
* Colored input to shell to easily differentiate it from the output of commands. * Colored input to shell to easily differentiate it from the output of commands.
* No annoying long prompts. * No annoying long prompts.
* Option to keep/hide the virtual environment name. * Option to keep/hide the virtual environment name.
@ -226,6 +233,7 @@ Author: [@nikhilkmr300](https://github.com/nikhilkmr300)
<img src=https://github.com/nikhilkmr300/omz-themes/blob/master/images/matte-black-yellow-line.png width=640> <img src=https://github.com/nikhilkmr300/omz-themes/blob/master/images/matte-black-yellow-line.png width=640>
Features: Features:
* Colored input to shell to easily differentiate it from the output of commands. * Colored input to shell to easily differentiate it from the output of commands.
* Current git branch being checked out indicated at the end of the prompt. * Current git branch being checked out indicated at the end of the prompt.
* Option to keep/hide the virtual environment name. * Option to keep/hide the virtual environment name.
@ -243,6 +251,7 @@ Author: [@nikhilkmr300](https://github.com/nikhilkmr300)
<img src=https://github.com/nikhilkmr300/omz-themes/blob/master/images/color-input-line.png width=640> <img src=https://github.com/nikhilkmr300/omz-themes/blob/master/images/color-input-line.png width=640>
Features: Features:
* Colored input to shell to easily differentiate it from the output of commands. * Colored input to shell to easily differentiate it from the output of commands.
* Current git branch being checked out indicated at the end of the prompt. * Current git branch being checked out indicated at the end of the prompt.
* Option to keep/hide the virtual environment name. * Option to keep/hide the virtual environment name.
@ -264,6 +273,7 @@ Powerline looking zsh theme with rvm prompt, git status and branch, current time
Influenced heavily by agnoster's theme and jeremyFreeAgent's theme Influenced heavily by agnoster's theme and jeremyFreeAgent's theme
Author: [@maverick9000](https://github.com/maverick9000) Author: [@maverick9000](https://github.com/maverick9000)
#### Daivasmara #### Daivasmara
![Daivasmara Theme](https://raw.githubusercontent.com/Daivasmara/daivasmara.zsh-theme/master/media/Screenshot%20from%202020-04-30%2016-12-27.png) ![Daivasmara Theme](https://raw.githubusercontent.com/Daivasmara/daivasmara.zsh-theme/master/media/Screenshot%20from%202020-04-30%2016-12-27.png)
@ -274,7 +284,6 @@ Source: [daivasmara.zsh-theme](https://github.com/Daivasmara/daivasmara.zsh-them
Author: [@Daivasmara](https://github.com/Daivasmara) Author: [@Daivasmara](https://github.com/Daivasmara)
--- ---
#### Ducula #### Ducula
@ -284,7 +293,7 @@ Author: [@Daivasmara](https://github.com/Daivasmara)
* Job status: Indicates if jobs are running in the background :coffee: (idea from agnoster theme) * Job status: Indicates if jobs are running in the background :coffee: (idea from agnoster theme)
* Username abbreviations: Uses a different username if the corresponding mapping was set (idea from dieter theme) * Username abbreviations: Uses a different username if the corresponding mapping was set (idea from dieter theme)
* Hostname abbreviations: Uses a different hostname if the corresponding mapping was set (idea from dieter theme) * Hostname abbreviations: Uses a different hostname if the corresponding mapping was set (idea from dieter theme)
* Virtual environments: Shows the name of activated virtual environment via ${VIRTUAL_ENV} * Virtual environments: Shows the name of activated virtual environment via ${VIRTUAL_ENV}
* Current path: Displays the full current working directory * Current path: Displays the full current working directory
* Return status: Shows the error return code (:bat:/:duck:) * Return status: Shows the error return code (:bat:/:duck:)
* Git messages: Uses `git_super_status` from the git-prompt plugin * Git messages: Uses `git_super_status` from the git-prompt plugin
@ -308,6 +317,7 @@ Author: [@rafaelsq](https://github.com/rafaelsq/)
--- ---
#### Reggae Theme #### Reggae Theme
![Reggae Terminal Theme](https://i.imgur.com/lQaaWvX.png) ![Reggae Terminal Theme](https://i.imgur.com/lQaaWvX.png)
See [gist](https://gist.github.com/mgimenez/ae1cde0b637e844da885cb093a916126) for source. See [gist](https://gist.github.com/mgimenez/ae1cde0b637e844da885cb093a916126) for source.
@ -315,7 +325,9 @@ See [gist](https://gist.github.com/mgimenez/ae1cde0b637e844da885cb093a916126) fo
Author: [@mgimenez](https://github.com/mgimenez/) Author: [@mgimenez](https://github.com/mgimenez/)
--- ---
### Intika Theme ### Intika Theme
![img](https://github.com/Intika-Linux-Apps/Oh-My-Zsh-Intika/raw/master/capture.png) ![img](https://github.com/Intika-Linux-Apps/Oh-My-Zsh-Intika/raw/master/capture.png)
See [repo](https://github.com/Intika-Linux-Apps/Oh-My-Zsh-Intika/blob/master/themes/intika.zsh-theme) for source. See [repo](https://github.com/Intika-Linux-Apps/Oh-My-Zsh-Intika/blob/master/themes/intika.zsh-theme) for source.
@ -323,7 +335,9 @@ See [repo](https://github.com/Intika-Linux-Apps/Oh-My-Zsh-Intika/blob/master/the
Author: [Intika](https://github.com/intika) Author: [Intika](https://github.com/intika)
--- ---
### Philthy Theme ### Philthy Theme
![img](https://imgur.com/am1MIxH.gif) ![img](https://imgur.com/am1MIxH.gif)
See [repo](https://gist.github.com/philFernandez/56f8953722285834cc9000ffcfe103f4#file-philthy-zsh-theme) for source. See [repo](https://gist.github.com/philFernandez/56f8953722285834cc9000ffcfe103f4#file-philthy-zsh-theme) for source.
@ -331,18 +345,22 @@ See [repo](https://gist.github.com/philFernandez/56f8953722285834cc9000ffcfe103f
Author: [Phil Fernandez](https://github.com/philFernandez) (philFernandez) Author: [Phil Fernandez](https://github.com/philFernandez) (philFernandez)
--- ---
### Minimal Improved theme ### Minimal Improved theme
![Minimal Improved theme for ZSH](https://raw.githubusercontent.com/gdsrosa/minimal_improved/master/minimal_improved_theme.png) ![Minimal Improved theme for ZSH](https://raw.githubusercontent.com/gdsrosa/minimal_improved/master/minimal_improved_theme.png)
See [repo](https://github.com/gdsrosa/minimal_improved) See [repo](https://github.com/gdsrosa/minimal_improved)
Author: [@gdsrosa](https://github.com/gdsrosa) Author: [@gdsrosa](https://github.com/gdsrosa)
--- ---
#### kmac theme #### kmac theme
![kmac theme for ZSH](https://github.com/koreymacdougall/config_files/blob/master/deprecated_files/kmac-zsh-theme-ss.png) ![kmac theme for ZSH](https://github.com/koreymacdougall/config_files/blob/master/deprecated_files/kmac-zsh-theme-ss.png)
Simple theme that cleanly shows: Simple theme that cleanly shows:
username@host:pwd $ username@host:pwd $
See [repository](https://github.com/koreymacdougall/config_files/blob/master/deprecated_files/kmac.oh-my-zsh-theme) for source. See [repository](https://github.com/koreymacdougall/config_files/blob/master/deprecated_files/kmac.oh-my-zsh-theme) for source.
Author: [@koreymacdougall](https://github.com/koreymacdougall) Author: [@koreymacdougall](https://github.com/koreymacdougall)
@ -350,25 +368,26 @@ Author: [@koreymacdougall](https://github.com/koreymacdougall)
--- ---
#### Fishy2 #### Fishy2
![fishy2 zsh](https://github.com/akinjide/fishy2/raw/master/images/Screen%20Shot%202017-04-20%20at%2010.46.49%20AM.png) ![fishy2 zsh](https://github.com/akinjide/fishy2/raw/master/images/Screen%20Shot%202017-04-20%20at%2010.46.49%20AM.png)
See [repository](https://github.com/akinjide/fishy2) for source. See [repository](https://github.com/akinjide/fishy2) for source.
Author: [@akinjide](https://github.com/akinjide) Author: [@akinjide](https://github.com/akinjide)
*** ---
#### abaykan #### abaykan
![abaykan](https://abaykan.com/server/abaykan.zsh-theme~.png)<br> ![abaykan](https://abaykan.com/server/abaykan.zsh-theme~.png)<br>
See [repository](https://github.com/abaykan/Mine/blob/master/abaykan.zsh-theme) for source. See [repository](https://github.com/abaykan/Mine/blob/master/abaykan.zsh-theme) for source.
Author: [@abaykan](https://github.com/abaykan) Author: [@abaykan](https://github.com/abaykan)
*** ---
#### Oxide #### Oxide
![oxide zsh](https://files.dikiaap.id/img/dotfiles/zsh.png) ![oxide zsh](https://files.dikiaap.id/img/dotfiles/zsh.png)
See [repository](https://github.com/dikiaap/dotfiles) for source. See [repository](https://github.com/dikiaap/dotfiles) for source.
@ -376,6 +395,7 @@ See [repository](https://github.com/dikiaap/dotfiles) for source.
Author: [@dikiaap](https://github.com/dikiaap) Author: [@dikiaap](https://github.com/dikiaap)
#### Windows CMD #### Windows CMD
![windows cmd](https://raw.githubusercontent.com/juliavallina/windows-zsh-theme/master/screenshot.gif) ![windows cmd](https://raw.githubusercontent.com/juliavallina/windows-zsh-theme/master/screenshot.gif)
See [repository](https://github.com/juliavallina/windows-zsh-theme) for source. See [repository](https://github.com/juliavallina/windows-zsh-theme) for source.
@ -392,7 +412,8 @@ author: [@sobolevn](https://github.com/sobolevn)
#### xxf #### xxf
![xxf](https://i.ibb.co/rtGyPRs/Wechat-IMG230.png) ![xxf](https://i.ibb.co/rtGyPRs/Wechat-IMG230.png)
- Show Current commit shorten hash and message
* Show Current commit shorten hash and message
See [Gist](https://gist.github.com/xfanwu/18fd7c24360c68bab884) for source. See [Gist](https://gist.github.com/xfanwu/18fd7c24360c68bab884) for source.
author: [@xfanwu](https://github.com/xfanwu) author: [@xfanwu](https://github.com/xfanwu)
@ -415,6 +436,7 @@ See [Repo](https://github.com/bhilburn/powerlevel9k) for source & documentation.
author: [@bhilburn](https://github.com/bhilburn) author: [@bhilburn](https://github.com/bhilburn)
#### powerlevel10k #### powerlevel10k
![powerlevel10k theme](https://camo.githubusercontent.com/80ec23fda88d2f445906a3502690f22827336736/687474703a2f2f692e696d6775722e636f6d2f777942565a51792e676966) ![powerlevel10k theme](https://camo.githubusercontent.com/80ec23fda88d2f445906a3502690f22827336736/687474703a2f2f692e696d6775722e636f6d2f777942565a51792e676966)
Powerlevel10k is a backward-compatible reimplementation of the popular Powerlevel9k theme (see above) with 10-100 times better performance. When given the same configuration options it will generate the same prompt. Powerlevel10k is a backward-compatible reimplementation of the popular Powerlevel9k theme (see above) with 10-100 times better performance. When given the same configuration options it will generate the same prompt.
@ -433,32 +455,34 @@ Bullet Train is a oh-my-zsh shell theme based on the Powerline Vim plugin. It ai
It currently shows: It currently shows:
- Current Python virtualenv * Current Python virtualenv
- Current Ruby version and gemset, through RVM * Current Ruby version and gemset, through RVM
- Current Node.js version, through NVM * Current Node.js version, through NVM
- Git status * Git status
- Timestamp * Timestamp
- Current directory * Current directory
- Background jobs * Background jobs
- Exit code of last command * Exit code of last command
See [Repo](https://github.com/caiogondim/bullet-train-oh-my-zsh-theme) for source See [Repo](https://github.com/caiogondim/bullet-train-oh-my-zsh-theme) for source
author: [@caiogondim](https://github.com/caiogondim) author: [@caiogondim](https://github.com/caiogondim)
#### Cordial #### Cordial
[![cordial](https://raw.githubusercontent.com/stevelacy/cordial-zsh-theme/master/screenshot.png)](https://raw.githubusercontent.com/stevelacy/cordial-zsh-theme/master/screenshot.png) [![cordial](https://raw.githubusercontent.com/stevelacy/cordial-zsh-theme/master/screenshot.png)](https://raw.githubusercontent.com/stevelacy/cordial-zsh-theme/master/screenshot.png)
See [repository](https://github.com/stevelacy/cordial-zsh-theme) for source. See [repository](https://github.com/stevelacy/cordial-zsh-theme) for source.
Additional setup: Additional setup:
- Install [node.js](https://nodejs.org/) to parse `package.json` files
* Install [node.js](https://nodejs.org/) to parse `package.json` files
#### Gitster #### Gitster
![gitster theme](http://recordit.co/1Y5XxMkXFl.gif) ![gitster theme](http://recordit.co/1Y5XxMkXFl.gif)
When in a git repo, it shows the location from the git's root folder. When in a git repo, it shows the location from the git's root folder.
When not in a git repo, it shows from home, `~`. When not in a git repo, it shows from home, `~`.
See my dotfiles [repo](https://github.com/shashankmehta/dotfiles/blob/master/thesetup/zsh/.oh-my-zsh/custom/themes/gitster.zsh-theme) for source. See my dotfiles [repo](https://github.com/shashankmehta/dotfiles/blob/master/thesetup/zsh/.oh-my-zsh/custom/themes/gitster.zsh-theme) for source.
@ -502,13 +526,13 @@ Author: [@fjpalacios](https://github.com/fjpalacios)
It currently shows: It currently shows:
- Git status * Git status
- 🕕 Time * 🕕 Time
- `~/Desktop` Working directory * `~/Desktop` Working directory
- > where you type your cmds * > where you type your cmds
- `✹git:master` **color : Red** unstaged commit * `✹git:master` **color : Red** unstaged commit
- `git:master` **color: White** committed files * `git:master` **color: White** committed files
- `○` shows if current directory is a git folder || git branch * `○` shows if current directory is a git folder || git branch
See [repository](https://github.com/akinjide/chi) for source. See [repository](https://github.com/akinjide/chi) for source.
@ -517,9 +541,10 @@ Author: [@akinjide](https://github.com/akinjide)
#### Haribo theme #### Haribo theme
![haribotheme](http://fooo.biz/images/haribo_omz_theme.png) ![haribotheme](http://fooo.biz/images/haribo_omz_theme.png)
- Works with most console fonts
- simple git status * Works with most console fonts
- timestamp * simple git status
* timestamp
See [Repo](https://github.com/haribo/omz-haribo-theme) for source See [Repo](https://github.com/haribo/omz-haribo-theme) for source
@ -536,10 +561,11 @@ author: [Schminitz](https://github.com/schminitz)/[@Schminitz](https://twitter.c
#### Odin theme #### Odin theme
![odin](https://github.com/tylerreckart/odin/raw/master/images/preview.gif) ![odin](https://github.com/tylerreckart/odin/raw/master/images/preview.gif)
- Git focused development.
- A clean and distraction free programming environment. * Git focused development.
- Know the status of your repository throughout the development process * A clean and distraction free programming environment.
- tmux and git configuration files included with the theme * Know the status of your repository throughout the development process
* tmux and git configuration files included with the theme
See [odin](https://github.com/tylerreckart/odin) for source. See [odin](https://github.com/tylerreckart/odin) for source.
author: [@tylerreckart](https://github.com/tylerreckart) author: [@tylerreckart](https://github.com/tylerreckart)
@ -547,11 +573,12 @@ author: [@tylerreckart](https://github.com/tylerreckart)
#### HYPERZSH theme #### HYPERZSH theme
![hyperzsh](https://raw.githubusercontent.com/tylerreckart/hyperzsh/master/screenshots/demo.gif) ![hyperzsh](https://raw.githubusercontent.com/tylerreckart/hyperzsh/master/screenshots/demo.gif)
- Git status
- Timestamp * Git status
- Current directory * Timestamp
- Background jobs * Current directory
- Exit code of last command * Background jobs
* Exit code of last command
See [hyperzsh](https://github.com/tylerreckart/hyperzsh) for source. See [hyperzsh](https://github.com/tylerreckart/hyperzsh) for source.
@ -560,6 +587,7 @@ author: [@tylerreckart](https://github.com/tylerreckart)
### Hyper Oh-My-ZSH ### Hyper Oh-My-ZSH
![Hyper Oh-My-ZSH](https://user-images.githubusercontent.com/1252570/43366555-1a7e5eb2-9383-11e8-89d5-98b255968bdb.png) ![Hyper Oh-My-ZSH](https://user-images.githubusercontent.com/1252570/43366555-1a7e5eb2-9383-11e8-89d5-98b255968bdb.png)
* Oh-My-ZSH theme based on hyper terminal default theme 😎 * Oh-My-ZSH theme based on hyper terminal default theme 😎
source: [here](https://github.com/willmendesneto/hyper-oh-my-zsh) source: [here](https://github.com/willmendesneto/hyper-oh-my-zsh)
@ -568,6 +596,7 @@ author: [@willmendesneto](https://github.com/willmendesneto)
#### Lambda (Mod) theme #### Lambda (Mod) theme
![Screenshot](https://raw.githubusercontent.com/halfo/lambda-mod-zsh-theme/master/screenshot.png) ![Screenshot](https://raw.githubusercontent.com/halfo/lambda-mod-zsh-theme/master/screenshot.png)
* A simple yet elegant theme with git focused development. * A simple yet elegant theme with git focused development.
See [lambda-mod](https://github.com/halfo/lambda-mod-zsh-theme/) for source. See [lambda-mod](https://github.com/halfo/lambda-mod-zsh-theme/) for source.
@ -576,6 +605,7 @@ author: [@halfo](https://github.com/halfo)
#### Hedgehog theme #### Hedgehog theme
![hedgehog](http://i.imgur.com/GTbKcj5.gif) ![hedgehog](http://i.imgur.com/GTbKcj5.gif)
* Simple, no-nonsense and clean, with support for git and return codes. * Simple, no-nonsense and clean, with support for git and return codes.
source: [here](https://gist.github.com/hedgehog1029/dfbb7e66511e2c399157) source: [here](https://gist.github.com/hedgehog1029/dfbb7e66511e2c399157)
@ -591,6 +621,7 @@ author: [@skuridin](https://github.com/skuridin)
#### classyTouch Theme #### classyTouch Theme
![classyTouch](https://raw.githubusercontent.com/pr0tocol/classyTouch_oh-my-zsh/master/classyTouch.png) ![classyTouch](https://raw.githubusercontent.com/pr0tocol/classyTouch_oh-my-zsh/master/classyTouch.png)
* A very minimal, clean theme with git support. * A very minimal, clean theme with git support.
source: [here](https://github.com/yarisgutierrez/classyTouch_oh-my-zsh) source: [here](https://github.com/yarisgutierrez/classyTouch_oh-my-zsh)
@ -688,11 +719,11 @@ AgnosterZak is a oh-my-zsh shell theme based on the Powerline Vim plugin & Agnos
It currently shows: It currently shows:
- Battery Life (in case of the laptop is not charging) * Battery Life (in case of the laptop is not charging)
- Current Date & Time * Current Date & Time
- Current directory * Current directory
- Git status * Git status
- User & Host status * User & Host status
See [Repo](https://github.com/zakaziko99/agnosterzak-ohmyzsh-theme) for source See [Repo](https://github.com/zakaziko99/agnosterzak-ohmyzsh-theme) for source
@ -709,6 +740,7 @@ source: [Repo](https://github.com/marszall87/nodeys-zsh-theme) for source
author: [@marszall87](https://github.com/marszall87) author: [@marszall87](https://github.com/marszall87)
#### Ciacho #### Ciacho
![Ciacho theme](https://dl.dropboxusercontent.com/u/6741388/ciacho-zsh-theme.png) ![Ciacho theme](https://dl.dropboxusercontent.com/u/6741388/ciacho-zsh-theme.png)
Ciacho is theme based on agnoster. Ciacho is theme based on agnoster.
@ -717,8 +749,8 @@ See [Repo](https://github.com/Ciacho/ciacho-ohmyzsh-theme) for source.
author: [@Ciacho](https://github.com/Ciacho/) author: [@Ciacho](https://github.com/Ciacho/)
#### igorsilva #### igorsilva
![igorsilva theme](https://raw.githubusercontent.com/igor9silva/zsh-theme/master/igorsilva.gif) ![igorsilva theme](https://raw.githubusercontent.com/igor9silva/zsh-theme/master/igorsilva.gif)
##### What it shows ##### What it shows
@ -733,11 +765,13 @@ See [Repo](https://github.com/igor9silva/zsh-theme) for source.
author: [@igor9silva](https://github.com/igor9silva/) author: [@igor9silva](https://github.com/igor9silva/)
#### nt9 #### nt9
![nt9 theme](https://raw.githubusercontent.com/lenguyenthanh/nt9-oh-my-zsh-theme/master/nt9.png) ![nt9 theme](https://raw.githubusercontent.com/lenguyenthanh/nt9-oh-my-zsh-theme/master/nt9.png)
A clean, distraction free and git focused development theme. A clean, distraction free and git focused development theme.
##### It currently shows: ##### It currently shows:
* Show the location from git's root folder (when in a git repo) or show from home `~` * Show the location from git's root folder (when in a git repo) or show from home `~`
* Show current sha() * Show current sha()
* Show current branch name * Show current branch name
@ -749,11 +783,13 @@ See [Repo](https://github.com/lenguyenthanh/nt9-oh-my-zsh-theme) for source.
author: [@lenguyenthanh](https://github.com/lenguyenthanh) author: [@lenguyenthanh](https://github.com/lenguyenthanh)
#### jovial #### jovial
![jovial theme](https://github.com/zthxxx/jovial/raw/master/docs/jovial-preview.png) ![jovial theme](https://github.com/zthxxx/jovial/raw/master/docs/jovial-preview.png)
pretty face, feel more jovial with this theme. pretty face, feel more jovial with this theme.
##### It currently shows: It currently shows:
* Show Host and User * Show Host and User
* Show current path * Show current path
* Show development environment segment * Show development environment segment
@ -774,19 +810,19 @@ geometry is a minimalistic, fully customizable zsh prompt theme.
##### What it does: ##### What it does:
- work asynchronously to speed up the prompt * work asynchronously to speed up the prompt
- display current git branch * display current git branch
- display git state of the repo and time since last commit * display git state of the repo and time since last commit
- tell you whether you need to pull, push or if you're mid-rebase * tell you whether you need to pull, push or if you're mid-rebase
- display the number of conflicting files and total number of conflicts * display the number of conflicting files and total number of conflicts
- display the running time of long running commands * display the running time of long running commands
- optionally display random colors based on your hostname * optionally display random colors based on your hostname
- give you a custom, colorizable prompt symbol * give you a custom, colorizable prompt symbol
- change the prompt symbol color depending on the last command exit status * change the prompt symbol color depending on the last command exit status
- show virtualenv and docker machine data * show virtualenv and docker machine data
- set the terminal title to current command and directory * set the terminal title to current command and directory
- fully customizable, allowing you to change anything through environment variables * fully customizable, allowing you to change anything through environment variables
- make you the coolest hacker in the whole Starbucks * make you the coolest hacker in the whole Starbucks
See [repo](https://github.com/frmendes/geometry) for source. We welcome any contributions! See [repo](https://github.com/frmendes/geometry) for source. We welcome any contributions!
@ -840,6 +876,7 @@ See [repo](https://github.com/dannynimmo/punctual-zsh-theme) for installation.
By [Danny](https://github.com/dannynimmo). By [Danny](https://github.com/dannynimmo).
#### Staples #### Staples
![Screenshot of Staples](https://github.com/dersam/staples/blob/master/sample.png?raw=true) ![Screenshot of Staples](https://github.com/dersam/staples/blob/master/sample.png?raw=true)
A modified version of the Bureau theme with context-sensitive tags, ssh status, and last exit code coloring. A modified version of the Bureau theme with context-sensitive tags, ssh status, and last exit code coloring.
@ -849,6 +886,7 @@ See [repo](https://github.com/dersam/staples) for source.
Author: [@dersam](https://github.com/dersam) Author: [@dersam](https://github.com/dersam)
#### Bunnyruni #### Bunnyruni
![Screenshot of Bunnyruni](https://raw.githubusercontent.com/jopcode/oh-my-zsh-bunnyruni-theme/master/bunnyruni.gif) ![Screenshot of Bunnyruni](https://raw.githubusercontent.com/jopcode/oh-my-zsh-bunnyruni-theme/master/bunnyruni.gif)
Simple, clean, and beautiful theme inspired in my fovorite themes, functions and colors. Simple, clean, and beautiful theme inspired in my fovorite themes, functions and colors.
@ -866,7 +904,6 @@ Single-line boring/traditional prompt without distracting colours, providing ext
See [repo](https://github.com/xfxf/zsh-theme-traditional-plus) for source. See [repo](https://github.com/xfxf/zsh-theme-traditional-plus) for source.
Author: [@xfxf](https://github.com/xfxf) Author: [@xfxf](https://github.com/xfxf)
#### oh-wonder #### oh-wonder
![screenshot](https://cloud.githubusercontent.com/assets/6545467/19431231/3c2bfa60-9475-11e6-98f7-312c749186cf.png) ![screenshot](https://cloud.githubusercontent.com/assets/6545467/19431231/3c2bfa60-9475-11e6-98f7-312c749186cf.png)
@ -876,10 +913,9 @@ Just another funky theme.
See [repo](https://gist.github.com/kaushik94/a54e128869c0c82bdbed31d56c710daa) for source. See [repo](https://gist.github.com/kaushik94/a54e128869c0c82bdbed31d56c710daa) for source.
Author: [@kaushik94](https://gist.github.com/kaushik94) Author: [@kaushik94](https://gist.github.com/kaushik94)
#### rafiki-zsh #### rafiki-zsh
![](https://www.dropbox.com/s/u08c2zofducjvh9/rafiki-zsh-2.png?raw=1) ![screenshot](https://www.dropbox.com/s/u08c2zofducjvh9/rafiki-zsh-2.png?raw=1)
A zsh friend to watch over you. A zsh friend to watch over you.
@ -896,7 +932,6 @@ source: [Repo](https://github.com/marszall87/lambda-pure) for source
author: [@marszall87](https://github.com/marszall87) author: [@marszall87](https://github.com/marszall87)
#### Imperator / Imperator Root #### Imperator / Imperator Root
![imperator theme](https://raw.githubusercontent.com/LinuxGogley/Linux-Mods/master/Shell-Themes/Screenshot_2016-11-28_17-48-18.png) ![imperator theme](https://raw.githubusercontent.com/LinuxGogley/Linux-Mods/master/Shell-Themes/Screenshot_2016-11-28_17-48-18.png)
@ -941,7 +976,6 @@ See [Repo](https://github.com/eendroroy/alien) for source & documentation.
author: [@eendroroy](https://github.com/eendroroy) author: [@eendroroy](https://github.com/eendroroy)
#### alien-minimal #### alien-minimal
[![asciicast](http://asciinema.org/a/264037.svg)](https://asciinema.org/a/264037) [![asciicast](http://asciinema.org/a/264037.svg)](https://asciinema.org/a/264037)
@ -960,8 +994,8 @@ See [Repo](https://github.com/eendroroy/alien-minimal) for source & documentatio
author: [@eendroroy](https://github.com/eendroroy) author: [@eendroroy](https://github.com/eendroroy)
#### Imp #### Imp
![Screenshot of Imp](https://raw.githubusercontent.com/igormp/Imp/master/imp.png) ![Screenshot of Imp](https://raw.githubusercontent.com/igormp/Imp/master/imp.png)
Simple theme based on [Zork](https://github.com/Bash-it/bash-it/wiki/Themes#zork). Simple theme based on [Zork](https://github.com/Bash-it/bash-it/wiki/Themes#zork).
@ -970,8 +1004,8 @@ See [repo](https://github.com/igormp/Imp) for source and install instructions.
Author: [@igormp](https://github.com/igormp) Author: [@igormp](https://github.com/igormp)
#### Omega #### Omega
![Screenshot of Omega Minimal](https://raw.githubusercontent.com/Section214/zsh-omega/master/screenshots/minimal.png) ![Screenshot of Omega Minimal](https://raw.githubusercontent.com/Section214/zsh-omega/master/screenshots/minimal.png)
A clean, minimal theme. A clean, minimal theme.
@ -980,10 +1014,11 @@ See [repo](https://github.com/Section214/zsh-omega) for source and install instr
Author: [@igormp](https://github.com/igormp) Author: [@igormp](https://github.com/igormp)
#### Docker-ZSH #### Docker-ZSH
This theme is pretty much based on the 'bureau' theme. It has been extended by a `DOCKER_HOST` live view, This theme is pretty much based on the 'bureau' theme. It has been extended by a `DOCKER_HOST` live view,
so that in every terminal session you see immediately which docker host is configured and where the local so that in every terminal session you see immediately which docker host is configured and where the local
docker commands are forwarded to. docker commands are forwarded to.
If the `DOCKER_HOST` variable is not set in the terminal session, it's showing a green `local` text what can b If the `DOCKER_HOST` variable is not set in the terminal session, it's showing a green `local` text what can b
interpreted as a personal local test environment. If a remote host is defined it will show the address in `red`. interpreted as a personal local test environment. If a remote host is defined it will show the address in `red`.
@ -1017,7 +1052,7 @@ Author: [@thornjad](https://github.com/thornjad)
* Working directory * Working directory
* Version control - branch, commit hash, dirty status, ahead/behind status * Version control - branch, commit hash, dirty status, ahead/behind status
* java, python, ruby. node versions * java, python, ruby. node versions
* Supports both mac and linux * Supports both mac and linux
* Asynchronously update prompt * Asynchronously update prompt
@ -1042,14 +1077,12 @@ See [repository](https://github.com/w33tmaricich/enlightenment) for source & doc
Author: [@w33tmaricich](http://w33tmaricich.com) Author: [@w33tmaricich](http://w33tmaricich.com)
#### iGeek
#### iGeek
![iGeek](https://camo.githubusercontent.com/db9d61987431bc10c3b410e6b3bcf103240fd866/687474703a2f2f692e696d6775722e636f6d2f614154384242432e706e67) ![iGeek](https://camo.githubusercontent.com/db9d61987431bc10c3b410e6b3bcf103240fd866/687474703a2f2f692e696d6775722e636f6d2f614154384242432e706e67)
See [repository](https://github.com/Saleh7/igeek-zsh-theme) for source. See [repository](https://github.com/Saleh7/igeek-zsh-theme) for source.
#### ASCIIGit #### ASCIIGit
ASCII-only ZSH prompt theme (using oh-my-zsh) for git users who are not fan of fancy glyphs. ASCII-only ZSH prompt theme (using oh-my-zsh) for git users who are not fan of fancy glyphs.
@ -1057,35 +1090,34 @@ ASCII-only ZSH prompt theme (using oh-my-zsh) for git users who are not fan of f
<img src="https://github.com/cemsbr/asciigit/blob/screenshot/screenshot.png?raw=true" width="606" height="468" alt="screenshot"> <img src="https://github.com/cemsbr/asciigit/blob/screenshot/screenshot.png?raw=true" width="606" height="468" alt="screenshot">
Features: Features:
- Works well in terminal or console. No need to change your font!
- Git info: * Works well in terminal or console. No need to change your font!
- Remote url, e.g. github.com/cemsbr/asciigit; * Git info:
- Relative path from git root dir; * Remote url, e.g. github.com/cemsbr/asciigit;
- Branch name; * Relative path from git root dir;
- Status (diverged, added, untracked, etc...). * Branch name;
- Colors known to work well with solarized light (probably with other schemes, too). * Status (diverged, added, untracked, etc...).
* Colors known to work well with solarized light (probably with other schemes, too).
See [repository](https://github.com/cemsbr/asciigit) for source and readme. See [repository](https://github.com/cemsbr/asciigit) for source and readme.
Author: [@cemsbr](https://github.com/cemsbr) Author: [@cemsbr](https://github.com/cemsbr)
#### dpoggi-newline-timestamp #### dpoggi-newline-timestamp
Timestamp and new line based on [dpoggi](https://github.com/ohmyzsh/ohmyzsh/wiki/Themes#dpoggi) theme. Timestamp and new line based on [dpoggi](https://github.com/ohmyzsh/ohmyzsh/wiki/Themes#dpoggi) theme.
<img width="651" alt="2017-09-08 18 03 32" src="https://user-images.githubusercontent.com/1831308/30204562-dd033128-94c0-11e7-944c-19d7b0c18196.png"> <img width="651" alt="2017-09-08 18 03 32" src="https://user-images.githubusercontent.com/1831308/30204562-dd033128-94c0-11e7-944c-19d7b0c18196.png">
Features: Features:
- Timestamp
- New line for command * Timestamp
* New line for command
See [repository](https://github.com/channprj/dotfiles-macOS) for [source](https://github.com/channprj/dotfiles-macOS/blob/master/sh/zsh/custom-zsh-theme/dpoggi-timestamp.zsh-theme). See [repository](https://github.com/channprj/dotfiles-macOS) for [source](https://github.com/channprj/dotfiles-macOS/blob/master/sh/zsh/custom-zsh-theme/dpoggi-timestamp.zsh-theme).
Author: [@channprj](https://github.com/channprj) Author: [@channprj](https://github.com/channprj)
#### nothing #### nothing
![nothing](https://raw.githubusercontent.com/eendroroy/nothing/master/nothing.png) ![nothing](https://raw.githubusercontent.com/eendroroy/nothing/master/nothing.png)
@ -1142,6 +1174,7 @@ Repo: [https://github.com/agkozak/agkozak-zsh-prompt](https://github.com/agkozak
Author: [@agkozak](https://github.com/agkozak) Author: [@agkozak](https://github.com/agkozak)
#### rainbow-theme #### rainbow-theme
![rainbow-theme](https://github.com/nivaca/rainbow-theme/blob/master/screenshot.png) ![rainbow-theme](https://github.com/nivaca/rainbow-theme/blob/master/screenshot.png)
Repo: [https://github.com/nivaca/rainbow-theme](https://github.com/nivaca/rainbow-theme) Repo: [https://github.com/nivaca/rainbow-theme](https://github.com/nivaca/rainbow-theme)
@ -1149,6 +1182,7 @@ Repo: [https://github.com/nivaca/rainbow-theme](https://github.com/nivaca/rainbo
Author: [@nivaca](https://github.com/nivaca) Author: [@nivaca](https://github.com/nivaca)
--- ---
#### Zeroastro Theme #### Zeroastro Theme
![Zeroastro ZSH Theme](https://github.com/zeroastro/zeroastro-zsh-theme/raw/master/zeroastro-zsh-theme.png) ![Zeroastro ZSH Theme](https://github.com/zeroastro/zeroastro-zsh-theme/raw/master/zeroastro-zsh-theme.png)
@ -1160,6 +1194,7 @@ Repo: [https://github.com/zeroastro/zeroastro-zsh-theme](https://github.com/zero
Author: [@zeroastro](https://github.com/zeroastro) Author: [@zeroastro](https://github.com/zeroastro)
--- ---
### Kayid Theme ### Kayid Theme
![Kayid Theme for ZSH](https://raw.githubusercontent.com/AmrMKayid/KayidmacOS/master/Kayid-Theme.png) ![Kayid Theme for ZSH](https://raw.githubusercontent.com/AmrMKayid/KayidmacOS/master/Kayid-Theme.png)
@ -1168,6 +1203,7 @@ See [repo](https://github.com/AmrMKayid/KayidmacOS/blob/master/kayid.zsh-theme)
Author: [@AmrMKayid](https://github.com/AmrMKayid) Author: [@AmrMKayid](https://github.com/AmrMKayid)
--- ---
### Shayan ZSH Theme ### Shayan ZSH Theme
![Shayan ZSH Theme](https://raw.githubusercontent.com/shayanh/shayan-zsh-theme/master/shayan-zsh-theme.png) ![Shayan ZSH Theme](https://raw.githubusercontent.com/shayanh/shayan-zsh-theme/master/shayan-zsh-theme.png)
@ -1179,17 +1215,19 @@ Repo: [https://github.com/shayanh/shayan-zsh-theme](https://github.com/shayanh/s
Author: [@shayanh](https://github.com/shayanh) Author: [@shayanh](https://github.com/shayanh)
--- ---
### FunkyBerlin Theme ### FunkyBerlin Theme
![FunkyBerlin](https://raw.githubusercontent.com/Ottootto2010/funkyberlin-zsh-theme/master/showcase.png) ![FunkyBerlin](https://raw.githubusercontent.com/Ottootto2010/funkyberlin-zsh-theme/master/showcase.png)
A colorfull two-line theme with support for GIT and SVN. A colorfull two-line theme with support for GIT and SVN.
Repo: [https://github.com/Ottootto2010/funkyberlin-zsh-theme](https://github.com/Ottootto2010/funkyberlin-zsh-theme) Repo: [https://github.com/Ottootto2010/funkyberlin-zsh-theme](https://github.com/Ottootto2010/funkyberlin-zsh-theme)
Author: [@Ottootto2010](https://github.com/Ottootto2010/funkyberlin-zsh-theme) Author: [@Ottootto2010](https://github.com/Ottootto2010/funkyberlin-zsh-theme)
--- ---
### RobbyRussell-WIP Theme ### RobbyRussell-WIP Theme
![img](https://raw.githubusercontent.com/ecbrodie/robbyrussell-WIP-theme/master/images/screenshot.png) ![img](https://raw.githubusercontent.com/ecbrodie/robbyrussell-WIP-theme/master/images/screenshot.png)
@ -1201,17 +1239,18 @@ Repo: https://github.com/ecbrodie/robbyrussell-WIP-theme
Author: [@ecbrodie](https://github.com/ecbrodie) Author: [@ecbrodie](https://github.com/ecbrodie)
--- ---
### McQuen Theme ### McQuen Theme
![McQuen](https://user-images.githubusercontent.com/772937/54210241-5d27ff00-449c-11e9-81b3-64efe0a13f6c.png) ![McQuen](https://user-images.githubusercontent.com/772937/54210241-5d27ff00-449c-11e9-81b3-64efe0a13f6c.png)
A minimalist two line theme with Git support and a Lambda (λ) shell. A minimalist two line theme with Git support and a Lambda (λ) shell.
Repo: [https://gist.github.com/ryanpcmcquen/150cf9a66bca2463e5660cafed3e1000](https://gist.github.com/ryanpcmcquen/150cf9a66bca2463e5660cafed3e1000) Repo: [https://gist.github.com/ryanpcmcquen/150cf9a66bca2463e5660cafed3e1000](https://gist.github.com/ryanpcmcquen/150cf9a66bca2463e5660cafed3e1000)
Author: [@ryanpcmcquen](https://github.com/ryanpcmcquen) Author: [@ryanpcmcquen](https://github.com/ryanpcmcquen)
---- ---
#### sm #### sm
@ -1223,13 +1262,13 @@ source: [Repo](https://github.com/blyndusk/sm-theme) for source.
author: [@blyndusk](https://github.com/blyndusk) author: [@blyndusk](https://github.com/blyndusk)
---- ---
#### minimal2 #### minimal2
![minimal2](https://github.com/girishrau/oh-my-zsh-customizations/blob/master/images/minimal2.jpg) ![minimal2](https://github.com/girishrau/oh-my-zsh-customizations/blob/master/images/minimal2.jpg)
A minimalist two line theme with Git support. A minimalist two line theme with Git support.
Repo: [https://github.com/girishrau/oh-my-zsh-customizations](https://github.com/girishrau/oh-my-zsh-customizations) Repo: [https://github.com/girishrau/oh-my-zsh-customizations](https://github.com/girishrau/oh-my-zsh-customizations)
@ -1329,7 +1368,6 @@ Author: [@sudo-HackerMan](https://github.com/sudo-HackerMan)
Original: [@RainyDayMedia](https://github.com/RainyDayMedia/oh-my-zsh-poncho) Original: [@RainyDayMedia](https://github.com/RainyDayMedia/oh-my-zsh-poncho)
#### None Theme #### None Theme
![none-theme](https://user-images.githubusercontent.com/43632885/83956911-a1c55600-a817-11ea-97d1-65c32238fb23.png) ![none-theme](https://user-images.githubusercontent.com/43632885/83956911-a1c55600-a817-11ea-97d1-65c32238fb23.png)
@ -1340,11 +1378,10 @@ Source: File `none.zsh-theme` containing only the line `PROMPT=""`.
Author: [@catleeball](https://github.com/catleeball) Author: [@catleeball](https://github.com/catleeball)
#### fishbone++ #### fishbone++
##### Features: ##### Features:
* emoji git status :) * emoji git status :)
* fault return indicator * fault return indicator
* various customization * various customization
@ -1356,11 +1393,14 @@ Author: [@catleeball](https://github.com/catleeball)
![fishbone++](https://github.com/EYH0602/Fishbonepp/blob/master/pics/defaultlook.png) ![fishbone++](https://github.com/EYH0602/Fishbonepp/blob/master/pics/defaultlook.png)
Source: [fishbone++](https://github.com/EYH0602/Fishbonepp) Source: [fishbone++](https://github.com/EYH0602/Fishbonepp)
Author: [@EYH0602](https://github.com/EYH0602) Author: [@EYH0602](https://github.com/EYH0602)
#### Ohio2's themes! #### Ohio2's themes!
##### Features: ##### Features:
* Simple * Simple
* One based on dallas * One based on dallas
* a whole collection. * a whole collection.
* Easy to customize * Easy to customize
* Time marker (ohio2, not ybl) * Time marker (ohio2, not ybl)
* Git marker. * Git marker.
@ -1368,7 +1408,7 @@ Author: [@EYH0602](https://github.com/EYH0602)
Themes:[Ohio2's themes repo](https://github.com/Ohio2/dotfiles-ohio2/tree/master/.oh-my-zsh/themes) Themes:[Ohio2's themes repo](https://github.com/Ohio2/dotfiles-ohio2/tree/master/.oh-my-zsh/themes)
![zsh-ohio2](https://i.imgur.com/tKc6B1P.png) ![zsh-ohio2](https://i.imgur.com/tKc6B1P.png)
*** ---
<br/> <br/>
<h3 align="center"><a href="https://github.com/ice-bear-forever/bubblegum-zsh">bubblegum</a></h3> <h3 align="center"><a href="https://github.com/ice-bear-forever/bubblegum-zsh">bubblegum</a></h3>
@ -1379,6 +1419,7 @@ Themes:[Ohio2's themes repo](https://github.com/Ohio2/dotfiles-ohio2/tree/master
</p></a> </p></a>
##### features: ##### features:
* a triangular glyph and your working directory, nothing more * a triangular glyph and your working directory, nothing more
* a [matching theme](https://github.com/ice-bear-forever/hyper-bubblegum) for [Hyper](http://hyper.is) terminal * a [matching theme](https://github.com/ice-bear-forever/hyper-bubblegum) for [Hyper](http://hyper.is) terminal
@ -1386,7 +1427,7 @@ repository: [bubblegum-zsh](https://github.com/ice-bear-forever/bubblegum-zsh/)
author: [@ice-bear-forever](https://github.com/ice-bear-forever/) author: [@ice-bear-forever](https://github.com/ice-bear-forever/)
*** ---
<br/> <br/>
<h3 align="center"><a href="https://github.com/tigerjz32/kube-zsh-theme">kube</a></h3> <h3 align="center"><a href="https://github.com/tigerjz32/kube-zsh-theme">kube</a></h3>
@ -1397,22 +1438,25 @@ author: [@ice-bear-forever](https://github.com/ice-bear-forever/)
</p></a> </p></a>
##### features: ##### features:
- shows the current time
- shows current kubectl context * shows the current time
- shows current dir
- shows current Git branch * shows current kubectl context
- shows an arrow to differentiate input vs prompt * shows current dir
- uses different colors for readability * shows current Git branch
* shows an arrow to differentiate input vs prompt
* uses different colors for readability
repository: [kube-zsh-theme](https://github.com/tigerjz32/kube-zsh-theme/) repository: [kube-zsh-theme](https://github.com/tigerjz32/kube-zsh-theme/)
author: [@tigerjz32](https://github.com/tigerjz32) author: [@tigerjz32](https://github.com/tigerjz32)
#### shini #### shini
![shini](https://raw.github.com/bashelled/shini/master/screenshot.png) ![shini](https://raw.github.com/bashelled/shini/master/screenshot.png)
A simple zsh theme. With your average time, exit status, user@host, directory and git branch, you can just install and relax. A simple zsh theme. With your average time, exit status, user@host, directory and git branch, you can just install and relax.
See [repository](https://github.com/bashelled/shini) for installation. See [repository](https://github.com/bashelled/shini) for installation.
Author: [@bashelled](https://github.com/bashelled) Author: [@bashelled](https://github.com/bashelled)

11
FAQ.md

@ -1,6 +1,6 @@
_If you don't find what you're looking for, and you think it should be covered by the FAQ, please [open a new issue](https://github.com/ohmyzsh/ohmyzsh/issues/new?title=FAQ:%20) with what you think should be here._ _If you don't find what you're looking for, and you think it should be covered by the FAQ, please [open a new issue](https://github.com/ohmyzsh/ohmyzsh/issues/new?title=FAQ:%20) with what you think should be here._
<!-- TOC depthFrom:2 --> <!-- TOC depthfrom:2 -->
- [Definitions](#definitions) - [Definitions](#definitions)
- [What is Oh My Zsh and what does it have to do with zsh?](#what-is-oh-my-zsh-and-what-does-it-have-to-do-with-zsh) - [What is Oh My Zsh and what does it have to do with zsh?](#what-is-oh-my-zsh-and-what-does-it-have-to-do-with-zsh)
@ -11,7 +11,7 @@ _If you don't find what you're looking for, and you think it should be covered b
- [What Zsh is not](#what-zsh-is-not) - [What Zsh is not](#what-zsh-is-not)
- [How do I...?](#how-do-i) - [How do I...?](#how-do-i)
- [How do I install Zsh?](#how-do-i-install-zsh) - [How do I install Zsh?](#how-do-i-install-zsh)
- [How do I install Zsh on Windows?](#how-do-i-install-zsh-on-windows) - [How do I install Zsh on Windows?](#how-do-i-install-zsh-on-windows)
- [How do I install Oh My Zsh?](#how-do-i-install-oh-my-zsh) - [How do I install Oh My Zsh?](#how-do-i-install-oh-my-zsh)
- [How do I uninstall Oh My Zsh?](#how-do-i-uninstall-oh-my-zsh) - [How do I uninstall Oh My Zsh?](#how-do-i-uninstall-oh-my-zsh)
- [How do I change my locale?](#how-do-i-change-my-locale) - [How do I change my locale?](#how-do-i-change-my-locale)
@ -27,7 +27,7 @@ _If you don't find what you're looking for, and you think it should be covered b
- [Zsh errors](#zsh-errors) - [Zsh errors](#zsh-errors)
- [zsh: no matches found](#zsh-no-matches-found) - [zsh: no matches found](#zsh-no-matches-found)
- [Other problems](#other-problems) - [Other problems](#other-problems)
- [`kill-word` or `backward-kill-word` do / don't delete a symbol (`WORDCHARS`)](#kill-word-or-backward-kill-word-do--dont-delete-a-symbol-wordchars) - [kill-word or backward-kill-word do / don't delete a symbol WORDCHARS](#kill-word-or-backward-kill-word-do--dont-delete-a-symbol-wordchars)
<!-- /TOC --> <!-- /TOC -->
@ -82,12 +82,11 @@ You can't install Zsh directly on Windows. As a reminder, Oh My Zsh needs Zsh in
To use Zsh on Windows, you need Windows 10 2004 or 11, and one of the following: To use Zsh on Windows, you need Windows 10 2004 or 11, and one of the following:
* [Cygwin](https://github.com/ohmyzsh/ohmyzsh/wiki/Installing-ZSH#cygwin) - [Cygwin](https://github.com/ohmyzsh/ohmyzsh/wiki/Installing-ZSH#cygwin)
* [WSL](https://github.com/ohmyzsh/ohmyzsh/wiki/Installing-ZSH#ubuntu-debian--derivatives-windows-10-wsl--native-linux-kernel-with-windows-10-build-1903) (note that this requires you to first [install WSL](https://docs.microsoft.com/en-us/windows/wsl/install)) - [WSL](https://github.com/ohmyzsh/ohmyzsh/wiki/Installing-ZSH#ubuntu-debian--derivatives-windows-10-wsl--native-linux-kernel-with-windows-10-build-1903) (note that this requires you to first [install WSL](https://docs.microsoft.com/en-us/windows/wsl/install))
If you're running earlier versions of Windows, you can't install it at all. You'll need a virtual machine, or a proper Linux install. If you're running earlier versions of Windows, you can't install it at all. You'll need a virtual machine, or a proper Linux install.
#### How do I install Oh My Zsh? #### How do I install Oh My Zsh?
Please follow the project's README instructions for a [basic installation](https://github.com/ohmyzsh/ohmyzsh#basic-installation), or the [advanced instructions](https://github.com/ohmyzsh/ohmyzsh#advanced-installation) if you need to automate the installation or change some of the settings of the installer. Please follow the project's README instructions for a [basic installation](https://github.com/ohmyzsh/ohmyzsh#basic-installation), or the [advanced instructions](https://github.com/ohmyzsh/ohmyzsh#advanced-installation) if you need to automate the installation or change some of the settings of the installer.

94
Installing-ZSH.md

@ -1,5 +1,6 @@
*** ***
## Zsh? ## Zsh?
Oh-My-Zsh is a framework for [Zsh](http://www.zsh.org), the Z shell. Oh-My-Zsh is a framework for [Zsh](http://www.zsh.org), the Z shell.
@ -15,16 +16,22 @@ Oh-My-Zsh is a framework for [Zsh](http://www.zsh.org), the Z shell.
If necessary, follow these steps to install Zsh: If necessary, follow these steps to install Zsh:
1. There are two main ways to install Zsh 1. There are two main ways to install Zsh:
- with the package manager of your choice, _e.g._ `sudo apt install zsh` (see [below for more examples](#how-to-install-zsh-on-many-platforms))
- from [source](http://zsh.sourceforge.net/Arc/source.html), following - With the package manager of your choice, _e.g._ `sudo apt install zsh` (see [below for more examples](#how-to-install-zsh-on-many-platforms))
[instructions from the Zsh FAQ](http://zsh.sourceforge.net/FAQ/zshfaq01.html#l7) - From [source](http://zsh.sourceforge.net/Arc/source.html), following [the instructions from the Zsh FAQ](http://zsh.sourceforge.net/FAQ/zshfaq01.html#l7).
2. Verify installation by running `zsh --version`. Expected result: `zsh 5.0.8` or more recent. 2. Verify installation by running `zsh --version`. Expected result: `zsh 5.0.8` or more recent.
3. Make it your default shell: `chsh -s $(which zsh)` 3. Make it your default shell: `chsh -s $(which zsh)`
- Note that this will not work if Zsh is not in your authorized shells list (`/etc/shells`)
- Note that this will not work if Zsh is not in your authorized shells list (`/etc/shells`)
or if you don't have permission to use `chsh`. If that's the case [you'll need to use a different procedure](https://www.google.com/search?q=zsh+default+without+chsh). or if you don't have permission to use `chsh`. If that's the case [you'll need to use a different procedure](https://www.google.com/search?q=zsh+default+without+chsh).
4. Log out and log back in again to use your new default shell. 4. Log out and log back in again to use your new default shell.
5. Test that it worked with `echo $SHELL`. Expected result: `/bin/zsh` or similar. 5. Test that it worked with `echo $SHELL`. Expected result: `/bin/zsh` or similar.
6. Test with `$SHELL --version`. Expected result: 'zsh 5.8' or similar 6. Test with `$SHELL --version`. Expected result: 'zsh 5.8' or similar
## How to install zsh on many platforms ## How to install zsh on many platforms
@ -36,16 +43,20 @@ If necessary, follow these steps to install Zsh:
```sh ```sh
brew install zsh brew install zsh
``` ```
To set zsh as your default shell, execute the following assuming a default install of Homebrew To set zsh as your default shell, execute the following assuming a default install of Homebrew
> Recent Mac OS versions: - Recent macOS versions:
```
chsh -s /usr/local/bin/zsh ```sh
``` chsh -s /usr/local/bin/zsh
> Mac OS **High Sierra** and before: ```
```
chsh -s /bin/zsh - macOS **High Sierra** and older:
```
```sh
chsh -s /bin/zsh
```
Assuming you have [Homebrew](http://brew.sh/) installed. If not, most versions of Assuming you have [Homebrew](http://brew.sh/) installed. If not, most versions of
**macOS** ship zsh by default, but it's normally an older version. Alternatively, you may **macOS** ship zsh by default, but it's normally an older version. Alternatively, you may
@ -62,10 +73,10 @@ apt install zsh
``` ```
If you don't have `apt`, the recommended package manager for end users If you don't have `apt`, the recommended package manager for end users
[ [1] ](http://askubuntu.com/a/446484) [[1]](http://askubuntu.com/a/446484)
[ [2] ](http://askubuntu.com/a/775264) [[2]](http://askubuntu.com/a/775264)
[ [3] ](https://help.ubuntu.com/lts/serverguide/apt.html) [[3]](https://help.ubuntu.com/lts/serverguide/apt.html)
[ [4] ](http://www.howtogeek.com/234583/simplify-command-line-package-management-with-apt-instead-of-apt-get/) [[4]](http://www.howtogeek.com/234583/simplify-command-line-package-management-with-apt-instead-of-apt-get/)
, you can try `apt-get` or `aptitude`. , you can try `apt-get` or `aptitude`.
[Other distributions that apply](https://en.wikipedia.org/wiki/List_of_Linux_distributions#Debian-based) include: [Other distributions that apply](https://en.wikipedia.org/wiki/List_of_Linux_distributions#Debian-based) include:
@ -94,32 +105,46 @@ xbps-install zsh
```sh ```sh
dnf install zsh dnf install zsh
``` ```
### OpenBSD ### OpenBSD
To install the package: To install the package:
```sh ```sh
pkg_add zsh pkg_add zsh
``` ```
### FreeBSD ### FreeBSD
To install the package: To install the package:
```sh ```sh
pkg install zsh pkg install zsh
``` ```
To install the port:
To install the port:
```sh ```sh
cd /usr/ports/shells/zsh/ && make install clean cd /usr/ports/shells/zsh/ && make install clean
``` ```
To reduce memory usage, optionally enable zsh-mem options with To reduce memory usage, optionally enable zsh-mem options with
![](https://i.imgur.com/l4id6Ek.png) ![installation screen to enable zsh-mem](https://i.imgur.com/l4id6Ek.png)
```sh ```sh
make config make config
``` ```
before running "make install". before running "make install".
### Centos/RHEL ### Centos/RHEL
```sh ```sh
sudo yum update && sudo yum -y install zsh sudo yum update && sudo yum -y install zsh
``` ```
### Cygwin ### Cygwin
Install the zsh package using the installer. Unfortunately Cygwin doesn't have a standard command line interface. You could, however, setup [apt-cyg](https://github.com/kou1okada/apt-cyg) and install zsh as follows: Install the zsh package using the installer. Unfortunately Cygwin doesn't have a standard command line interface. You could, however, setup [apt-cyg](https://github.com/kou1okada/apt-cyg) and install zsh as follows:
```sh ```sh
@ -129,16 +154,20 @@ apt-cyg install zsh
The easiest way to change the default shell is to set your SHELL user environment variable. Search for "Edit Environment variables for your account" to bring up the environment variables window, create a new variable named "SHELL" and give it the value "/usr/bin/zsh/". The easiest way to change the default shell is to set your SHELL user environment variable. Search for "Edit Environment variables for your account" to bring up the environment variables window, create a new variable named "SHELL" and give it the value "/usr/bin/zsh/".
*Alternatively:* *Alternatively:*
Open Cygwin (in BASH) then type: Open Cygwin (in BASH) then type:
```sh ```sh
sudo nano ~/.bashrc sudo nano ~/.bashrc
``` ```
Once the .bashrc file is open, add this line to the very top: Once the .bashrc file is open, add this line to the very top:
```sh ```sh
exec zsh exec zsh
``` ```
Close and save the file.
Close and reopen Cygwin. Close and save the file.
Close and reopen Cygwin.
It will execute the command every time you load the terminal and run your zsh shell. It will execute the command every time you load the terminal and run your zsh shell.
### Solus ### Solus
@ -148,44 +177,59 @@ eopkg it zsh
``` ```
### Funtoo/Gentoo ### Funtoo/Gentoo
```sh ```sh
emerge app-shells/zsh emerge app-shells/zsh
``` ```
### Alpine Linux ### Alpine Linux
```sh ```sh
apk add zsh apk add zsh
``` ```
### MSYS2 ### MSYS2
```sh ```sh
pacman -S zsh pacman -S zsh
``` ```
### Termux (Android) ### Termux (Android)
Termux is an terminal emulator for Android but has modern feature like Debian and Ubuntu (Termux has Bash shell and Busybox GNU-like programs). For the package manager, Termux using an Debian/Ubuntu package manager, APT.
To install the package, run this command: Termux is an terminal emulator for Android but has modern feature like Debian and Ubuntu (Termux has Bash shell and Busybox GNU-like programs). For the package manager, Termux using an Debian/Ubuntu package manager, APT.
To install the package, run this command:
```sh ```sh
pkg install zsh pkg install zsh
``` ```
The command looks like FreeBSD package manager (`pkg`). Or you can run this command: The command looks like FreeBSD package manager (`pkg`). Or you can run this command:
```sh ```sh
apt update && apt upgrade apt update && apt upgrade
apt install zsh apt install zsh
``` ```
To set zsh as your default shell, run this command: To set zsh as your default shell, run this command:
```sh ```sh
chsh -s /data/data/com.termux/files/usr/bin/zsh chsh -s /data/data/com.termux/files/usr/bin/zsh
``` ```
Or: Or:
```sh ```sh
chsh -s $(which zsh) chsh -s $(which zsh)
``` ```
### KISS Linux ### KISS Linux
To install zsh, you must add the [community](https://github.com/kiss-community/repo-community/) repo to your `$KISS_PATH`. To install zsh, you must add the [community](https://github.com/kiss-community/repo-community/) repo to your `$KISS_PATH`.
```sh ```sh
kiss b zsh && kiss i zsh kiss b zsh && kiss i zsh
``` ```
### Add yours ### Add yours
If you know a platform that is not covered, edit this page and add it! If you know a platform that is not covered, edit this page and add it!

2
Plugins-Overview.md

@ -27,7 +27,7 @@
| [encode64](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/encode64) | e64 & d64 aliases | | [encode64](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/encode64) | e64 & d64 aliases |
| [extract](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/extract) | 'x' alias - swiss knife for archive extracting | | [extract](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/extract) | 'x' alias - swiss knife for archive extracting |
| [fbterm](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/fbterm) | enhanced VESA terminal https://code.google.com/p/fbterm/ | | [fbterm](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/fbterm) | enhanced VESA terminal https://code.google.com/p/fbterm/ |
| [genpass](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/genpass) | Three distinct 128-bit password generators | | [genpass](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/genpass) | Three distinct 128-bit password generators |
| [gpg-agent](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/gpg-agent) | gpg-agent start/stop funcs | | [gpg-agent](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/gpg-agent) | gpg-agent start/stop funcs |
| [history](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/history) | aliases: h for history, hsi for grepping history | | [history](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/history) | aliases: h for history, hsi for grepping history |
| [history-substring-search\*\*](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/history-substring-search) | implementation of fish history substring search | | [history-substring-search\*\*](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/history-substring-search) | implementation of fish history substring search |

130
Testimonials.md

@ -1,45 +1,131 @@
Please share your thoughts on Oh My Zsh... they might help influence others to use and/or avoid it like the black plague. Please share your thoughts on Oh My Zsh... they might help influence others to use and/or avoid it like the black plague.
"oh-my-zsh is probably the only good thing I've ever done with my life." -- [[robbyrussell|https://github.com/robbyrussell]] > **oh-my-zsh is probably the only good thing I've ever done with my life.**
>
> -- **[@robbyrussell](https://github.com/robbyrussell)**
"oh-my-zsh is among the first things i install on any new machine I set up. It's as necessary as the shell itself." -- [[imeyer|https://github.com/imeyer]] ----
"oh-my-zsh can sometimes get a bit in the way, and it needs more polish, but generally it turns zsh from something which takes a lot of research and config fiddling into something that works pleasantly out of the box, and makes tweaking more straightforward" -- [[Dieterbe|https://github.com/dieterbe]] > oh-my-zsh is among the first things i install on any new machine I set up. It's as necessary as the shell itself.
>
> -- [@imeyer](https://github.com/imeyer)
"I honestly don't even like using zsh without oh-my-zsh" -- [[mrjones2014|https://github.com/mrjones2014]] ----
"This project is so much more than a sane set of defaults for zsh. It is a major hub of plugin development! The fact that everything is all nicely packaged as a project on github is very nice indeed. Zsh is an amazing shell, but it seems to suffer a lack of guides on how to use it. By checking out oh-my-zsh you get a really nice set of examples in which you can learn zsh" -- [[Ksira|https://github.com/ksira]] > oh-my-zsh can sometimes get a bit in the way, and it needs more polish, but generally it turns zsh from something which takes a lot of research and config fiddling into something that works pleasantly out of the box, and makes tweaking more straightforward
>
> -- [@Dieterbe](https://github.com/dieterbe)
"oh-my-zsh: your life in a shell" -- [[fox|https://github.com/volpino]] ----
"oh-my-zsh is probably one of the most fun open source projects to yell the name out loud." -- [[secondplanet|https://github.com/secondplanet]] > I honestly don't even like using zsh without oh-my-zsh
>
> -- [@mrjones2014](https://github.com/mrjones2014)
"oh-my-zsh makes me 300 milliseconds more efficient per command... I like it!" -- [[michielmulders|https://github.com/michielmulders]] ----
"oh-my-zsh is now mandatory on all my dev servers, it makes bash look boring!" -- [[digital006|https://github.com/digital006]] > This project is so much more than a sane set of defaults for zsh. It is a major hub of plugin development! The fact that everything is all nicely packaged as a project on github is very nice indeed. Zsh is an amazing shell, but it seems to suffer a lack of guides on how to use it. By checking out oh-my-zsh you get a really nice set of examples in which you can learn zsh
>
> -- [@Ksira](https://github.com/ksira)
"today i installed @ohmyzsh on my machine. after 10 minutes of use, i decided that there is no way back to bash =)" -- [[patbaumgartner|https://twitter.com/patbaumgartner/status/95954168531001344]] ----
"if a shell can make disruptive progress, zsh does." -- [[troyd|https://twitter.com/#!/troyd/status/96330785086373888]] > oh-my-zsh: your life in a shell
>
> -- [@fox](https://github.com/volpino)
"My terminal is the happiest terminal on the whole earth since I have installed Zsh and Oh My Zsh!" -- [[semahawk|https://github.com/semahawk]] ----
"ZSH, by default, is a pain to setup. Thanks oh-my-zsh for hand-holding noobs into this wonderful shell!" -- [[vikred|https://github.com/vikas-reddy]] > oh-my-zsh is probably one of the most fun open source projects to yell the name out loud.
>
> -- [@secondplanet](https://github.com/secondplanet)
"I've just started to use ZSH and with oh-my-zsh, my life just got better!" -- [[vinnx|https://github.com/vinhnx]] ----
"thanks to anyone who helped make the firework you call zsh!" --[[awesoham|http://sohamchowdhury.com/]] > oh-my-zsh makes me 300 milliseconds more efficient per command... I like it!
>
> -- [@michielmulders](https://github.com/michielmulders)
"Oh-my-zsh 很贴心，让 Zsh 配置变得更加简单，它让我享受到了比以往更加美丽的终端！" --[[tuhaihe|http://tuhaihe.com/]] ----
"I just can't imagine not using oh-my-zsh. I can believe I won't have to mess around with `.bashrc` again" --[[davblayn|https://github.com/davblayn]] > oh-my-zsh is now mandatory on all my dev servers, it makes bash look boring!
>
> -- [@digital006](https://github.com/digital006)
".i mi noi lojbo cu prami la'o gy oh-my-zsh gy i'esai" --[[DavidMikeSimon|https://github/DavidMikeSimon]] ----
"This is the one for me." --[[SysVoid|https://github.com/SysVoid]] > today i installed @ohmyzsh on my machine. after 10 minutes of use, i decided that there is no way back to bash =)
>
> -- [@patbaumgartner](https://twitter.com/patbaumgartner/status/95954168531001344)
"As a shell newbie, oh-my-zsh is my lighthouse. As I drown in the shell-sea at least I know where the mainland is!" --[[V-J-P|https://github.com/V-J-P]] ----
"My mouth dropped the first time I saw my new terminal with oh-my-zsh. I teach web development to students at a bootcamp. When students are struggling with the terminal, I tell them to install oh-my-zsh and struggling students start understanding it better. Its amazing themes can tell the students what directory they are in right way and what branch too" --[[besteman|https://github.com/besteman]] > if a shell can make disruptive progress, zsh does.
>
> -- [@troyd](https://twitter.com/#!/troyd/status/96330785086373888)
"J'utilise OMZ depuis que j'ai commence a developper en C et ca m'a sauve la vie bien des fois ! Il est pour moi impensable d'utilser un shell sans OMZ! --[[Seluj78|https://github.com/seluj78]] ----
> My terminal is the happiest terminal on the whole earth since I have installed Zsh and Oh My Zsh!
>
> -- [@semahawk](https://github.com/semahawk)
----
> ZSH, by default, is a pain to setup. Thanks oh-my-zsh for hand-holding noobs into this wonderful shell!
>
> -- [@vikred](https://github.com/vikas-reddy)
----
> I've just started to use ZSH and with oh-my-zsh, my life just got better!
>
> -- [@vinnx](https://github.com/vinhnx)
----
> thanks to anyone who helped make the firework you call zsh!
>
> -- [@awesoham](http://sohamchowdhury.com/)
----
> Oh-my-zsh 很贴心，让 Zsh 配置变得更加简单，它让我享受到了比以往更加美丽的终端！
>
> -- [@tuhaihe](http://tuhaihe.com/)
----
> I just can't imagine not using oh-my-zsh. I can believe I won't have to mess around with `.bashrc` again
>
> -- [@davblayn](https://github.com/davblayn)
----
> .i mi noi lojbo cu prami la'o gy oh-my-zsh gy i'esai
>
> -- [@DavidMikeSimon](https://github/DavidMikeSimon)
----
> This is the one for me.
>
> -- [@SysVoid](https://github.com/SysVoid)
----
> As a shell newbie, oh-my-zsh is my lighthouse. As I drown in the shell-sea at least I know where the mainland is!
>
> -- [@V-J-P](https://github.com/V-J-P)
----
> My mouth dropped the first time I saw my new terminal with oh-my-zsh. I teach web development to students at a bootcamp. When students are struggling with the terminal, I tell them to install oh-my-zsh and struggling students start understanding it better. Its amazing themes can tell the students what directory they are in right way and what branch too
>
> -- [@besteman](https://github.com/besteman)
----
> J'utilise OMZ depuis que j'ai commence a developper en C et ca m'a sauve la vie bien des fois ! Il est pour moi impensable d'utilser un shell sans OMZ!
>
> -- [@Seluj78](https://github.com/seluj78)

217
Themes.md

@ -7,22 +7,26 @@ If you do not want any theme enabled, just set `ZSH_THEME` to blank: `ZSH_THEME=
Here is a collection of screenshots and descriptions of themes that have been contributed to Oh My Zsh. There are some missing from this page. If you want to add or edit descriptions, see the [format description](#theme-description-format) at the bottom of this page. Here is a collection of screenshots and descriptions of themes that have been contributed to Oh My Zsh. There are some missing from this page. If you want to add or edit descriptions, see the [format description](#theme-description-format) at the bottom of this page.
## The Themes ## Themes
### robbyrussell ### robbyrussell
*the (default) that Robby uses*
*The default that Robby Russell uses.*
![robbyrussell](https://user-images.githubusercontent.com/49100982/108254738-764b8700-716c-11eb-9a59-4deb8c8c6193.jpg) ![robbyrussell](https://user-images.githubusercontent.com/49100982/108254738-764b8700-716c-11eb-9a59-4deb8c8c6193.jpg)
------------------------------------ ----
The rest of the themes, in alphabetical order: The rest of the themes, in alphabetical order:
## A ## A
### af-magic ### af-magic
![af-magic](https://user-images.githubusercontent.com/49100982/108254742-76e41d80-716c-11eb-89b0-09445ce76ff0.jpg) ![af-magic](https://user-images.githubusercontent.com/49100982/108254742-76e41d80-716c-11eb-89b0-09445ce76ff0.jpg)
### afowler ### afowler
![afowler](https://user-images.githubusercontent.com/49100982/108254744-777cb400-716c-11eb-9407-1463775bbc25.jpg) ![afowler](https://user-images.githubusercontent.com/49100982/108254744-777cb400-716c-11eb-9407-1463775bbc25.jpg)
### agnoster ### agnoster
@ -34,221 +38,284 @@ The rest of the themes, in alphabetical order:
Shown with [Solarized Dark colorscheme](http://ethanschoonover.com/solarized) and Powerline-patched Meslo 14pt in [iTerm 2](http://www.iterm2.com/). Shown with [Solarized Dark colorscheme](http://ethanschoonover.com/solarized) and Powerline-patched Meslo 14pt in [iTerm 2](http://www.iterm2.com/).
Additional setup: Additional setup:
- Install one of the [patched fonts from Vim-Powerline](https://github.com/powerline/fonts) or [patch your own](https://github.com/powerline/fontpatcher) for the special characters. - Install one of the [patched fonts from Vim-Powerline](https://github.com/powerline/fonts) or [patch your own](https://github.com/powerline/fontpatcher) for the special characters.
- *Optionally* set `DEFAULT_USER` to your regular username followed by prompt_context(){} in `~/.zshrc` to hide the “user@hostname” info when you’re logged in as yourself on your local machine. - *Optionally* set `DEFAULT_USER` to your regular username followed by prompt_context(){} in `~/.zshrc` to hide the “user@hostname” info when you’re logged in as yourself on your local machine.
### alanpeabody ### alanpeabody
![alanpeabody](https://user-images.githubusercontent.com/49100982/108254746-78154a80-716c-11eb-873a-6500b9d54219.jpg) ![alanpeabody](https://user-images.githubusercontent.com/49100982/108254746-78154a80-716c-11eb-873a-6500b9d54219.jpg)
### amuse ### amuse
![amuse](https://user-images.githubusercontent.com/49100982/108254748-78ade100-716c-11eb-8f61-0a2bec4f671c.jpg) ![amuse](https://user-images.githubusercontent.com/49100982/108254748-78ade100-716c-11eb-8f61-0a2bec4f671c.jpg)
Shown in the screenshot with tmux and the [powerline plugin](https://github.com/powerline/powerline) (you might need to install one of the [patched powerline fonts](https://github.com/powerline/fonts) for it to look the same). Shown in the screenshot with tmux and the [powerline plugin](https://github.com/powerline/powerline) (you might need to install one of the [patched powerline fonts](https://github.com/powerline/fonts) for it to look the same).
### apple ### apple
![apple](https://user-images.githubusercontent.com/49100982/108254750-78ade100-716c-11eb-8c3b-7d529b7b4e25.jpg) ![apple](https://user-images.githubusercontent.com/49100982/108254750-78ade100-716c-11eb-8c3b-7d529b7b4e25.jpg)
### arrow ### arrow
![arrow](https://user-images.githubusercontent.com/49100982/108254751-78ade100-716c-11eb-9135-39cbffcf406e.jpg) ![arrow](https://user-images.githubusercontent.com/49100982/108254751-78ade100-716c-11eb-9135-39cbffcf406e.jpg)
### aussiegeek ### aussiegeek
![aussiegeek](https://user-images.githubusercontent.com/49100982/108254752-79467780-716c-11eb-82d4-304d04bf35bf.jpg) ![aussiegeek](https://user-images.githubusercontent.com/49100982/108254752-79467780-716c-11eb-82d4-304d04bf35bf.jpg)
### avit ### avit
![avit](https://user-images.githubusercontent.com/49100982/108254755-79df0e00-716c-11eb-9069-da947bd4a3dc.jpg) ![avit](https://user-images.githubusercontent.com/49100982/108254755-79df0e00-716c-11eb-9069-da947bd4a3dc.jpg)
### awesomepanda ### awesomepanda
![awesomepanda](https://user-images.githubusercontent.com/49100982/108254758-79df0e00-716c-11eb-8990-62f456ddd785.jpg) ![awesomepanda](https://user-images.githubusercontent.com/49100982/108254758-79df0e00-716c-11eb-8990-62f456ddd785.jpg)
## B ## B
### bira ### bira
![bira](https://user-images.githubusercontent.com/49100982/108254762-7a77a480-716c-11eb-8665-b4f459fd8920.jpg) ![bira](https://user-images.githubusercontent.com/49100982/108254762-7a77a480-716c-11eb-8665-b4f459fd8920.jpg)
### blinks ### blinks
![blinks](https://user-images.githubusercontent.com/49100982/108254767-7b103b00-716c-11eb-9bdd-426643a53722.jpg) ![blinks](https://user-images.githubusercontent.com/49100982/108254767-7b103b00-716c-11eb-9bdd-426643a53722.jpg)
### bureau ### bureau
![bureau](https://user-images.githubusercontent.com/49100982/108254768-7b103b00-716c-11eb-92e1-ebd7486d6f13.jpg) ![bureau](https://user-images.githubusercontent.com/49100982/108254768-7b103b00-716c-11eb-92e1-ebd7486d6f13.jpg)
To use: In the right prompt you see git status and (if you use nvm) the Node.js version. To use: In the right prompt you see git status and (if you use nvm) the Node.js version.
## C ## C
### candy ### candy
![candy](https://user-images.githubusercontent.com/49100982/108254770-7ba8d180-716c-11eb-965f-63b9ce0efe15.jpg) ![candy](https://user-images.githubusercontent.com/49100982/108254770-7ba8d180-716c-11eb-965f-63b9ce0efe15.jpg)
### clean ### clean
![clean](https://user-images.githubusercontent.com/49100982/108254772-7ba8d180-716c-11eb-9d96-f54d13acde5b.jpg) ![clean](https://user-images.githubusercontent.com/49100982/108254772-7ba8d180-716c-11eb-9d96-f54d13acde5b.jpg)
### cloud ### cloud
![cloud](https://user-images.githubusercontent.com/49100982/108254774-7c416800-716c-11eb-9ea8-8f8cbac82922.jpg) ![cloud](https://user-images.githubusercontent.com/49100982/108254774-7c416800-716c-11eb-9ea8-8f8cbac82922.jpg)
### crcandy ### crcandy
![crcandy](https://user-images.githubusercontent.com/49100982/108254775-7c416800-716c-11eb-8e54-fa40ccb0d519.jpg) ![crcandy](https://user-images.githubusercontent.com/49100982/108254775-7c416800-716c-11eb-8e54-fa40ccb0d519.jpg)
### crunch ### crunch
![crunch](https://user-images.githubusercontent.com/49100982/108254776-7cd9fe80-716c-11eb-889a-84d7b26df847.jpg) ![crunch](https://user-images.githubusercontent.com/49100982/108254776-7cd9fe80-716c-11eb-889a-84d7b26df847.jpg)
### cypher ### cypher
![cypher](https://user-images.githubusercontent.com/49100982/108254777-7d729500-716c-11eb-9ab2-232ed00e30aa.jpg) ![cypher](https://user-images.githubusercontent.com/49100982/108254777-7d729500-716c-11eb-9ab2-232ed00e30aa.jpg)
## D ## D
### dallas ### dallas
![dallas](https://user-images.githubusercontent.com/49100982/108254779-7d729500-716c-11eb-98b9-ef343be7a8fe.jpg) ![dallas](https://user-images.githubusercontent.com/49100982/108254779-7d729500-716c-11eb-98b9-ef343be7a8fe.jpg)
### darkblood ### darkblood
![darkblood](https://user-images.githubusercontent.com/49100982/108254782-7e0b2b80-716c-11eb-95db-b149bc1c0032.jpg) ![darkblood](https://user-images.githubusercontent.com/49100982/108254782-7e0b2b80-716c-11eb-95db-b149bc1c0032.jpg)
### daveverwer ### daveverwer
![daveverwer](https://user-images.githubusercontent.com/1816101/62961143-7e4e9c00-bdfc-11e9-9777-ce1f230de9d7.jpg) ![daveverwer](https://user-images.githubusercontent.com/1816101/62961143-7e4e9c00-bdfc-11e9-9777-ce1f230de9d7.jpg)
### dieter ### dieter
![dieter](https://user-images.githubusercontent.com/49100982/108254786-7ea3c200-716c-11eb-9c33-d24d404d4e25.jpg) ![dieter](https://user-images.githubusercontent.com/49100982/108254786-7ea3c200-716c-11eb-9c33-d24d404d4e25.jpg)
### dogenpunk ### dogenpunk
![dogenpunk](https://user-images.githubusercontent.com/49100982/108254788-7f3c5880-716c-11eb-96e3-27cc0d6297d3.jpg) ![dogenpunk](https://user-images.githubusercontent.com/49100982/108254788-7f3c5880-716c-11eb-96e3-27cc0d6297d3.jpg)
### dpoggi ### dpoggi
![dpoggi](https://user-images.githubusercontent.com/49100982/108254790-7fd4ef00-716c-11eb-821e-d11fba0c4f10.jpg) ![dpoggi](https://user-images.githubusercontent.com/49100982/108254790-7fd4ef00-716c-11eb-821e-d11fba0c4f10.jpg)
### dst ### dst
![dst](https://user-images.githubusercontent.com/49100982/108254792-7fd4ef00-716c-11eb-8fa7-67d845b771be.jpg) ![dst](https://user-images.githubusercontent.com/49100982/108254792-7fd4ef00-716c-11eb-8fa7-67d845b771be.jpg)
### dstufft ### dstufft
![dstufft](https://user-images.githubusercontent.com/49100982/108254797-806d8580-716c-11eb-9ec5-ae1b23d0a7cd.jpg) ![dstufft](https://user-images.githubusercontent.com/49100982/108254797-806d8580-716c-11eb-9ec5-ae1b23d0a7cd.jpg)
### duellj ### duellj
![duellj](https://user-images.githubusercontent.com/49100982/108254799-806d8580-716c-11eb-9f1e-2634dc9309d3.jpg) ![duellj](https://user-images.githubusercontent.com/49100982/108254799-806d8580-716c-11eb-9f1e-2634dc9309d3.jpg)
## E ## E
### eastwood ### eastwood
![eastwood](https://user-images.githubusercontent.com/49100982/108254800-81061c00-716c-11eb-858e-aa17d4c5e07e.jpg) ![eastwood](https://user-images.githubusercontent.com/49100982/108254800-81061c00-716c-11eb-858e-aa17d4c5e07e.jpg)
### edvardm ### edvardm
![edvardm](https://user-images.githubusercontent.com/49100982/108254801-819eb280-716c-11eb-9279-01b8ef95c734.jpg) ![edvardm](https://user-images.githubusercontent.com/49100982/108254801-819eb280-716c-11eb-9279-01b8ef95c734.jpg)
### emotty ### emotty
![emotty](https://user-images.githubusercontent.com/49100982/108254802-819eb280-716c-11eb-9d66-d21bb1e7196c.jpg) ![emotty](https://user-images.githubusercontent.com/49100982/108254802-819eb280-716c-11eb-9d66-d21bb1e7196c.jpg)
### essembeh ### essembeh
![essembeh](https://user-images.githubusercontent.com/49100982/108254803-82374900-716c-11eb-9510-ef560d31e7e7.jpg) ![essembeh](https://user-images.githubusercontent.com/49100982/108254803-82374900-716c-11eb-9510-ef560d31e7e7.jpg)
### evan ### evan
![evan](https://user-images.githubusercontent.com/49100982/108254804-82374900-716c-11eb-9636-71abb16053df.jpg) ![evan](https://user-images.githubusercontent.com/49100982/108254804-82374900-716c-11eb-9636-71abb16053df.jpg)
## F ## F
### fino-time ### fino-time
![fino-time](https://user-images.githubusercontent.com/49100982/108254806-82cfdf80-716c-11eb-9bbc-2d9648109b31.jpg) ![fino-time](https://user-images.githubusercontent.com/49100982/108254806-82cfdf80-716c-11eb-9bbc-2d9648109b31.jpg)
### fino ### fino
![fino](https://user-images.githubusercontent.com/49100982/108254809-82cfdf80-716c-11eb-8d66-027fe4ecfd55.jpg) ![fino](https://user-images.githubusercontent.com/49100982/108254809-82cfdf80-716c-11eb-8d66-027fe4ecfd55.jpg)
### fishy ### fishy
![fishy](https://user-images.githubusercontent.com/49100982/108254811-83687600-716c-11eb-88df-2d1fb721a62b.jpg) ![fishy](https://user-images.githubusercontent.com/49100982/108254811-83687600-716c-11eb-88df-2d1fb721a62b.jpg)
The fish shell prompt with git support The fish shell prompt with git support
### flazz ### flazz
![flazz](https://user-images.githubusercontent.com/49100982/108254813-83687600-716c-11eb-98dc-083a14aae6e1.jpg) ![flazz](https://user-images.githubusercontent.com/49100982/108254813-83687600-716c-11eb-98dc-083a14aae6e1.jpg)
Has git and vi-command mode support (when enabled) Has git and vi-command mode support (when enabled)
### fletcherm ### fletcherm
![fletcherm](https://user-images.githubusercontent.com/49100982/108254817-84010c80-716c-11eb-8d56-81bc95a46ef5.jpg) ![fletcherm](https://user-images.githubusercontent.com/49100982/108254817-84010c80-716c-11eb-8d56-81bc95a46ef5.jpg)
### fox ### fox
![fox](https://user-images.githubusercontent.com/49100982/108254819-8499a300-716c-11eb-9c13-c6fd49d72a6c.jpg) ![fox](https://user-images.githubusercontent.com/49100982/108254819-8499a300-716c-11eb-9c13-c6fd49d72a6c.jpg)
### frisk ### frisk
![frisk](https://user-images.githubusercontent.com/49100982/108254820-8499a300-716c-11eb-922d-5cc6ffa08fc1.jpg) ![frisk](https://user-images.githubusercontent.com/49100982/108254820-8499a300-716c-11eb-922d-5cc6ffa08fc1.jpg)
### frontcube ### frontcube
![frontcube](https://user-images.githubusercontent.com/49100982/108254821-85323980-716c-11eb-90b9-fc0b4b014f36.jpg) ![frontcube](https://user-images.githubusercontent.com/49100982/108254821-85323980-716c-11eb-90b9-fc0b4b014f36.jpg)
### funky ### funky
![funky](https://user-images.githubusercontent.com/49100982/108254822-85323980-716c-11eb-8422-69480dce0f62.jpg) ![funky](https://user-images.githubusercontent.com/49100982/108254822-85323980-716c-11eb-8422-69480dce0f62.jpg)
It’s funky… It’s funky…
### fwalch ### fwalch
![fwalch](https://user-images.githubusercontent.com/49100982/108254824-85cad000-716c-11eb-9b7a-fe9e24131df7.jpg) ![fwalch](https://user-images.githubusercontent.com/49100982/108254824-85cad000-716c-11eb-9b7a-fe9e24131df7.jpg)
# G # G
### gallifrey ### gallifrey
![gallifrey](https://user-images.githubusercontent.com/49100982/108254827-86636680-716c-11eb-94e2-64318cb21f3b.jpg) ![gallifrey](https://user-images.githubusercontent.com/49100982/108254827-86636680-716c-11eb-94e2-64318cb21f3b.jpg)
### gallois ### gallois
![gallois](https://user-images.githubusercontent.com/49100982/108254828-86636680-716c-11eb-8d3a-146431df149f.jpg) ![gallois](https://user-images.githubusercontent.com/49100982/108254828-86636680-716c-11eb-8d3a-146431df149f.jpg)
### garyblessington ### garyblessington
![garyblessington](https://user-images.githubusercontent.com/49100982/108254830-86fbfd00-716c-11eb-8e9e-57cb190cd35b.jpg) ![garyblessington](https://user-images.githubusercontent.com/49100982/108254830-86fbfd00-716c-11eb-8e9e-57cb190cd35b.jpg)
### gentoo ### gentoo
![gentoo](https://user-images.githubusercontent.com/49100982/108254832-86fbfd00-716c-11eb-8bbf-7840e84b4c44.jpg) ![gentoo](https://user-images.githubusercontent.com/49100982/108254832-86fbfd00-716c-11eb-8bbf-7840e84b4c44.jpg)
### geoffgarside ### geoffgarside
![geoffgarside](https://user-images.githubusercontent.com/49100982/108254834-87949380-716c-11eb-8ff7-9a494c650852.jpg) ![geoffgarside](https://user-images.githubusercontent.com/49100982/108254834-87949380-716c-11eb-8ff7-9a494c650852.jpg)
### gianu ### gianu
![gianu](https://user-images.githubusercontent.com/49100982/108254836-87949380-716c-11eb-8d5b-a4b24ea53f67.jpg) ![gianu](https://user-images.githubusercontent.com/49100982/108254836-87949380-716c-11eb-8d5b-a4b24ea53f67.jpg)
### gnzh ### gnzh
![gnzh](https://user-images.githubusercontent.com/49100982/108254837-882d2a00-716c-11eb-9f49-3b5e6e62eb52.jpg) ![gnzh](https://user-images.githubusercontent.com/49100982/108254837-882d2a00-716c-11eb-9f49-3b5e6e62eb52.jpg)
### gozilla ### gozilla
![gozilla](https://user-images.githubusercontent.com/49100982/108254838-88c5c080-716c-11eb-9bd9-4d88b870f04f.jpg) ![gozilla](https://user-images.githubusercontent.com/49100982/108254838-88c5c080-716c-11eb-9bd9-4d88b870f04f.jpg)
## H ## H
### half-life ### half-life
![half-life](https://user-images.githubusercontent.com/49100982/108254840-88c5c080-716c-11eb-9971-f2cfbf54f91a.jpg) ![half-life](https://user-images.githubusercontent.com/49100982/108254840-88c5c080-716c-11eb-9971-f2cfbf54f91a.jpg)
### humza ### humza
![humza](https://user-images.githubusercontent.com/49100982/108254841-895e5700-716c-11eb-9984-ab8ec70ad92e.jpg) ![humza](https://user-images.githubusercontent.com/49100982/108254841-895e5700-716c-11eb-9984-ab8ec70ad92e.jpg)
# I # I
### imajes ### imajes
![imajes](https://user-images.githubusercontent.com/49100982/108254845-895e5700-716c-11eb-807f-0ecb0aa4db00.jpg) ![imajes](https://user-images.githubusercontent.com/49100982/108254845-895e5700-716c-11eb-807f-0ecb0aa4db00.jpg)
### intheloop ### intheloop
![intheloop](https://user-images.githubusercontent.com/49100982/108254849-89f6ed80-716c-11eb-8e92-dcf5e576df64.jpg) ![intheloop](https://user-images.githubusercontent.com/49100982/108254849-89f6ed80-716c-11eb-8e92-dcf5e576df64.jpg)
### itchy ### itchy
![itchy](https://user-images.githubusercontent.com/49100982/108254851-89f6ed80-716c-11eb-9922-185b952b24db.jpg) ![itchy](https://user-images.githubusercontent.com/49100982/108254851-89f6ed80-716c-11eb-9922-185b952b24db.jpg)
# J # J
### jaischeema ### jaischeema
![jaischeema](https://user-images.githubusercontent.com/49100982/108254853-8a8f8400-716c-11eb-9775-780e00c3f680.jpg) ![jaischeema](https://user-images.githubusercontent.com/49100982/108254853-8a8f8400-716c-11eb-9775-780e00c3f680.jpg)
### jbergantine ### jbergantine
![jbergantine](https://user-images.githubusercontent.com/49100982/108254855-8b281a80-716c-11eb-960d-2f2cf8e5153f.jpg) ![jbergantine](https://user-images.githubusercontent.com/49100982/108254855-8b281a80-716c-11eb-960d-2f2cf8e5153f.jpg)
### jispwoso ### jispwoso
![jispwoso](https://user-images.githubusercontent.com/49100982/108254857-8bc0b100-716c-11eb-808f-d0b6f1a16774.jpg) ![jispwoso](https://user-images.githubusercontent.com/49100982/108254857-8bc0b100-716c-11eb-808f-d0b6f1a16774.jpg)
### jnrowe ### jnrowe
![jnrowe](https://user-images.githubusercontent.com/49100982/108254859-8bc0b100-716c-11eb-998b-4ee8bb6c1f3f.jpg) ![jnrowe](https://user-images.githubusercontent.com/49100982/108254859-8bc0b100-716c-11eb-998b-4ee8bb6c1f3f.jpg)
### jonathan ### jonathan
![jonathan](https://user-images.githubusercontent.com/49100982/108254860-8c594780-716c-11eb-8f8b-be04d4943216.jpg) ![jonathan](https://user-images.githubusercontent.com/49100982/108254860-8c594780-716c-11eb-8f8b-be04d4943216.jpg)
### josh ### josh
![josh](https://user-images.githubusercontent.com/49100982/108254862-8cf1de00-716c-11eb-8bfe-f2e46376a10f.jpg) ![josh](https://user-images.githubusercontent.com/49100982/108254862-8cf1de00-716c-11eb-8bfe-f2e46376a10f.jpg)
### jreese ### jreese
![jreese](https://user-images.githubusercontent.com/49100982/108254863-8cf1de00-716c-11eb-935f-87cc85ef6ed7.jpg) ![jreese](https://user-images.githubusercontent.com/49100982/108254863-8cf1de00-716c-11eb-935f-87cc85ef6ed7.jpg)
### jtriley ### jtriley
![jtriley](https://user-images.githubusercontent.com/49100982/108254869-8d8a7480-716c-11eb-8857-ee82b1fe4023.jpg) ![jtriley](https://user-images.githubusercontent.com/49100982/108254869-8d8a7480-716c-11eb-8857-ee82b1fe4023.jpg)
### juanghurtado ### juanghurtado
![juanghurtado](https://user-images.githubusercontent.com/49100982/108254872-8d8a7480-716c-11eb-9782-4a37a851ce1f.jpg) ![juanghurtado](https://user-images.githubusercontent.com/49100982/108254872-8d8a7480-716c-11eb-9782-4a37a851ce1f.jpg)
### junkfood ### junkfood
@ -259,237 +326,300 @@ It’s funky…
[More Info](http://www.tylercipriani.com/2012/12/18/zsh-prompt-customization.html) [More Info](http://www.tylercipriani.com/2012/12/18/zsh-prompt-customization.html)
## K ## K
### kafeitu ### kafeitu
![kafeitu](https://user-images.githubusercontent.com/49100982/108254876-8e230b00-716c-11eb-9adb-50d695796563.jpg) ![kafeitu](https://user-images.githubusercontent.com/49100982/108254876-8e230b00-716c-11eb-9adb-50d695796563.jpg)
### kardan ### kardan
![kardan](https://user-images.githubusercontent.com/49100982/108254877-8ebba180-716c-11eb-9fb5-9b0437433305.jpg) ![kardan](https://user-images.githubusercontent.com/49100982/108254877-8ebba180-716c-11eb-9fb5-9b0437433305.jpg)
### kennethreitz ### kennethreitz
![kennethreitz](https://user-images.githubusercontent.com/49100982/108254878-8f543800-716c-11eb-9373-a3e4e19b58ae.jpg) ![kennethreitz](https://user-images.githubusercontent.com/49100982/108254878-8f543800-716c-11eb-9373-a3e4e19b58ae.jpg)
### kolo ### kolo
![kolo](https://user-images.githubusercontent.com/49100982/108254881-8f543800-716c-11eb-8115-2232727264d6.jpg) ![kolo](https://user-images.githubusercontent.com/49100982/108254881-8f543800-716c-11eb-8115-2232727264d6.jpg)
### kphoen ### kphoen
![kphoen](https://user-images.githubusercontent.com/49100982/108254883-8fecce80-716c-11eb-9a4d-ad5c465af835.jpg) ![kphoen](https://user-images.githubusercontent.com/49100982/108254883-8fecce80-716c-11eb-9a4d-ad5c465af835.jpg)
# L # L
### lambda ### lambda
![lambda](https://user-images.githubusercontent.com/49100982/108254885-8fecce80-716c-11eb-8012-aabac630c475.jpg) ![lambda](https://user-images.githubusercontent.com/49100982/108254885-8fecce80-716c-11eb-8012-aabac630c475.jpg)
### linuxonly ### linuxonly
![linuxonly](https://user-images.githubusercontent.com/49100982/108254886-90856500-716c-11eb-81e8-8ba2b7ea922f.jpg) ![linuxonly](https://user-images.githubusercontent.com/49100982/108254886-90856500-716c-11eb-81e8-8ba2b7ea922f.jpg)
(As the name states, this only works on Linux) (As the name states, this only works on Linux)
### lukerandall ### lukerandall
![lukerandall](https://user-images.githubusercontent.com/49100982/108254887-911dfb80-716c-11eb-99a0-275b35afd9ce.jpg) ![lukerandall](https://user-images.githubusercontent.com/49100982/108254887-911dfb80-716c-11eb-99a0-275b35afd9ce.jpg)
## M ## M
### macovsky ### macovsky
![macovsky](https://user-images.githubusercontent.com/49100982/108254888-911dfb80-716c-11eb-9595-b08415fb1c17.jpg) ![macovsky](https://user-images.githubusercontent.com/49100982/108254888-911dfb80-716c-11eb-9595-b08415fb1c17.jpg)
### maran ### maran
![maran](https://user-images.githubusercontent.com/49100982/108254890-91b69200-716c-11eb-8fa3-108c8692087c.jpg) ![maran](https://user-images.githubusercontent.com/49100982/108254890-91b69200-716c-11eb-8fa3-108c8692087c.jpg)
### mgutz ### mgutz
![mgutz](https://user-images.githubusercontent.com/49100982/108254893-91b69200-716c-11eb-9f6c-221967f1adc6.jpg) ![mgutz](https://user-images.githubusercontent.com/49100982/108254893-91b69200-716c-11eb-9f6c-221967f1adc6.jpg)
### mh ### mh
![mh](https://user-images.githubusercontent.com/49100982/108254896-924f2880-716c-11eb-83fe-be8f732f46da.jpg) ![mh](https://user-images.githubusercontent.com/49100982/108254896-924f2880-716c-11eb-83fe-be8f732f46da.jpg)
### michelebologna ### michelebologna
![michelebologna](https://user-images.githubusercontent.com/49100982/108254897-92e7bf00-716c-11eb-86b8-bf00a43d6a43.jpg) ![michelebologna](https://user-images.githubusercontent.com/49100982/108254897-92e7bf00-716c-11eb-86b8-bf00a43d6a43.jpg)
### mikeh ### mikeh
![mikeh](https://user-images.githubusercontent.com/49100982/108254900-93805580-716c-11eb-9e39-5e8dda6c2308.jpg) ![mikeh](https://user-images.githubusercontent.com/49100982/108254900-93805580-716c-11eb-9e39-5e8dda6c2308.jpg)
### miloshadzic ### miloshadzic
![miloshadzic](https://user-images.githubusercontent.com/49100982/108254899-93805580-716c-11eb-84d6-822e33ad5ffb.jpg) ![miloshadzic](https://user-images.githubusercontent.com/49100982/108254899-93805580-716c-11eb-84d6-822e33ad5ffb.jpg)
### minimal ### minimal
![minimal](https://user-images.githubusercontent.com/49100982/108254900-93805580-716c-11eb-9e39-5e8dda6c2308.jpg) ![minimal](https://user-images.githubusercontent.com/49100982/108254900-93805580-716c-11eb-9e39-5e8dda6c2308.jpg)
### mortalscumbag ### mortalscumbag
![mortalscumbag](https://user-images.githubusercontent.com/49100982/108254901-9418ec00-716c-11eb-9439-6dd4621e6784.jpg) ![mortalscumbag](https://user-images.githubusercontent.com/49100982/108254901-9418ec00-716c-11eb-9439-6dd4621e6784.jpg)
Also tells you when logged in over ssh Also tells you when logged in over ssh
### mrtazz ### mrtazz
![mrtazz](https://user-images.githubusercontent.com/49100982/108254902-9418ec00-716c-11eb-9001-6a5abecf0aa1.jpg) ![mrtazz](https://user-images.githubusercontent.com/49100982/108254902-9418ec00-716c-11eb-9001-6a5abecf0aa1.jpg)
### murilasso ### murilasso
![murilasso](https://user-images.githubusercontent.com/1816101/62966002-6419bb80-be06-11e9-90f0-7ef55042e6e9.jpg) ![murilasso](https://user-images.githubusercontent.com/1816101/62966002-6419bb80-be06-11e9-90f0-7ef55042e6e9.jpg)
### muse ### muse
![muse](https://user-images.githubusercontent.com/49100982/108254905-954a1900-716c-11eb-820c-15814dd13a7d.jpg) ![muse](https://user-images.githubusercontent.com/49100982/108254905-954a1900-716c-11eb-820c-15814dd13a7d.jpg)
## N ## N
### nanotech ### nanotech
![nanotech](https://user-images.githubusercontent.com/49100982/108254907-954a1900-716c-11eb-8be4-d8accb5a2a44.jpg) ![nanotech](https://user-images.githubusercontent.com/49100982/108254907-954a1900-716c-11eb-8be4-d8accb5a2a44.jpg)
### nebirhos ### nebirhos
![nebirhos](https://user-images.githubusercontent.com/49100982/108254909-95e2af80-716c-11eb-8d16-d78875d9263a.jpg) ![nebirhos](https://user-images.githubusercontent.com/49100982/108254909-95e2af80-716c-11eb-8d16-d78875d9263a.jpg)
### nicoulaj ### nicoulaj
![nicoulaj](https://user-images.githubusercontent.com/49100982/108254911-95e2af80-716c-11eb-811d-e8ea16f6ee0c.jpg) ![nicoulaj](https://user-images.githubusercontent.com/49100982/108254911-95e2af80-716c-11eb-811d-e8ea16f6ee0c.jpg)
### norm ### norm
![norm](https://user-images.githubusercontent.com/49100982/108254912-967b4600-716c-11eb-8e3e-eb5487570074.jpg) ![norm](https://user-images.githubusercontent.com/49100982/108254912-967b4600-716c-11eb-8e3e-eb5487570074.jpg)
## O ## O
### obraun ### obraun
![obraun](https://user-images.githubusercontent.com/49100982/108254914-967b4600-716c-11eb-8c11-830bc97f274e.jpg) ![obraun](https://user-images.githubusercontent.com/49100982/108254914-967b4600-716c-11eb-8c11-830bc97f274e.jpg)
## P ## P
### peepcode ### peepcode
![peepcode](https://user-images.githubusercontent.com/49100982/108254917-9713dc80-716c-11eb-8f73-69c67ced32a7.jpg) ![peepcode](https://user-images.githubusercontent.com/49100982/108254917-9713dc80-716c-11eb-8f73-69c67ced32a7.jpg)
### philips ### philips
![philips](https://user-images.githubusercontent.com/49100982/108254919-97ac7300-716c-11eb-9338-cb7009d3a5ea.jpg) ![philips](https://user-images.githubusercontent.com/49100982/108254919-97ac7300-716c-11eb-9338-cb7009d3a5ea.jpg)
### pmcgee ### pmcgee
![pmcgee](https://user-images.githubusercontent.com/49100982/108254920-97ac7300-716c-11eb-80d5-301ba10cf969.jpg) ![pmcgee](https://user-images.githubusercontent.com/49100982/108254920-97ac7300-716c-11eb-80d5-301ba10cf969.jpg)
### pygmalion ### pygmalion
![pygmalion](https://user-images.githubusercontent.com/49100982/108254921-98450980-716c-11eb-9d27-18562610887f.jpg) ![pygmalion](https://user-images.githubusercontent.com/49100982/108254921-98450980-716c-11eb-9d27-18562610887f.jpg)
## R ## R
### re5et ### re5et
![re5et](https://user-images.githubusercontent.com/49100982/108254922-98450980-716c-11eb-88af-2e1c1ba5c5fe.jpg) ![re5et](https://user-images.githubusercontent.com/49100982/108254922-98450980-716c-11eb-88af-2e1c1ba5c5fe.jpg)
### refined ### refined
![refined](https://user-images.githubusercontent.com/49100982/108255729-b2cbb280-716d-11eb-8869-d612e2344ef5.jpg) ![refined](https://user-images.githubusercontent.com/49100982/108255729-b2cbb280-716d-11eb-8869-d612e2344ef5.jpg)
### rgm ### rgm
![rgm](https://user-images.githubusercontent.com/49100982/108255732-b2cbb280-716d-11eb-8587-f8b412c48907.jpg) ![rgm](https://user-images.githubusercontent.com/49100982/108255732-b2cbb280-716d-11eb-8587-f8b412c48907.jpg)
### risto ### risto
![risto](https://user-images.githubusercontent.com/49100982/108255733-b3644900-716d-11eb-8fea-4ce136198782.jpg) ![risto](https://user-images.githubusercontent.com/49100982/108255733-b3644900-716d-11eb-8fea-4ce136198782.jpg)
### rixius ### rixius
![rixius](https://user-images.githubusercontent.com/49100982/108255734-b3fcdf80-716d-11eb-8e9b-b8c7c7546e75.jpg) ![rixius](https://user-images.githubusercontent.com/49100982/108255734-b3fcdf80-716d-11eb-8e9b-b8c7c7546e75.jpg)
### rkj-repos ### rkj-repos
![rkj](https://user-images.githubusercontent.com/49100982/108255735-b3fcdf80-716d-11eb-92ee-678fd1bff92f.jpg) ![rkj](https://user-images.githubusercontent.com/49100982/108255735-b3fcdf80-716d-11eb-92ee-678fd1bff92f.jpg)
## S ## S
### sammy ### sammy
![sammy](https://user-images.githubusercontent.com/49100982/108255736-b4957600-716d-11eb-848a-f4b9a83a58c7.jpg) ![sammy](https://user-images.githubusercontent.com/49100982/108255736-b4957600-716d-11eb-848a-f4b9a83a58c7.jpg)
### simonoff ### simonoff
![simonoff](https://user-images.githubusercontent.com/49100982/108255738-b4957600-716d-11eb-8dea-87c1764d7e35.jpg) ![simonoff](https://user-images.githubusercontent.com/49100982/108255738-b4957600-716d-11eb-8dea-87c1764d7e35.jpg)
### simple ### simple
![simple](https://user-images.githubusercontent.com/49100982/108255740-b52e0c80-716d-11eb-8645-d1ed285204f9.jpg) ![simple](https://user-images.githubusercontent.com/49100982/108255740-b52e0c80-716d-11eb-8645-d1ed285204f9.jpg)
### skaro ### skaro
![skaro](https://user-images.githubusercontent.com/49100982/108255742-b52e0c80-716d-11eb-8ea1-8a6aa361fe96.jpg) ![skaro](https://user-images.githubusercontent.com/49100982/108255742-b52e0c80-716d-11eb-8ea1-8a6aa361fe96.jpg)
### smt ### smt
![smt](https://user-images.githubusercontent.com/49100982/108255743-b5c6a300-716d-11eb-9f64-185f288c1364.jpg) ![smt](https://user-images.githubusercontent.com/49100982/108255743-b5c6a300-716d-11eb-9f64-185f288c1364.jpg)
### Soliah ### Soliah
![Soliah](https://user-images.githubusercontent.com/49100982/108255747-b65f3980-716d-11eb-8e12-1ce6cf4d009f.jpg) ![Soliah](https://user-images.githubusercontent.com/49100982/108255747-b65f3980-716d-11eb-8e12-1ce6cf4d009f.jpg)
### sonicradish ### sonicradish
![sonicradish](https://user-images.githubusercontent.com/49100982/108255750-b65f3980-716d-11eb-9dfc-620748a03844.jpg) ![sonicradish](https://user-images.githubusercontent.com/49100982/108255750-b65f3980-716d-11eb-9dfc-620748a03844.jpg)
### sorin ### sorin
![sorin](https://user-images.githubusercontent.com/49100982/108255752-b6f7d000-716d-11eb-8415-3d5d18839646.jpg) ![sorin](https://user-images.githubusercontent.com/49100982/108255752-b6f7d000-716d-11eb-8415-3d5d18839646.jpg)
### sporty_256 ### sporty_256
![sporty_256](https://user-images.githubusercontent.com/49100982/108255753-b6f7d000-716d-11eb-96b7-7448b890a583.jpg) ![sporty_256](https://user-images.githubusercontent.com/49100982/108255753-b6f7d000-716d-11eb-96b7-7448b890a583.jpg)
### steeef ### steeef
![steeef](https://user-images.githubusercontent.com/49100982/108255754-b7906680-716d-11eb-9e70-4d79fdd62a2a.jpg) ![steeef](https://user-images.githubusercontent.com/49100982/108255754-b7906680-716d-11eb-9e70-4d79fdd62a2a.jpg)
### strug ### strug
![strug](https://user-images.githubusercontent.com/49100982/108255755-b828fd00-716d-11eb-8dee-2d981777a2b3.jpg) ![strug](https://user-images.githubusercontent.com/49100982/108255755-b828fd00-716d-11eb-8dee-2d981777a2b3.jpg)
### sunaku ### sunaku
![sunaku](https://user-images.githubusercontent.com/49100982/108255759-b828fd00-716d-11eb-8951-0af2c0ac1297.jpg) ![sunaku](https://user-images.githubusercontent.com/49100982/108255759-b828fd00-716d-11eb-8951-0af2c0ac1297.jpg)
Exit status if nonzero, status & branch if git, `pwd` always. Exit status if nonzero, status & branch if git, `pwd` always.
### sunrise ### sunrise
![sunrise](https://user-images.githubusercontent.com/49100982/108255761-b8c19380-716d-11eb-8c73-02da22b53021.jpg) ![sunrise](https://user-images.githubusercontent.com/49100982/108255761-b8c19380-716d-11eb-8c73-02da22b53021.jpg)
Lightweight prompt with exit status and `git status` consistent mode line. Lightweight prompt with exit status and `git status` consistent mode line.
### superjarin ### superjarin
![superjarin](https://user-images.githubusercontent.com/49100982/108255762-b8c19380-716d-11eb-8ab2-de382c6dd78e.jpg) ![superjarin](https://user-images.githubusercontent.com/49100982/108255762-b8c19380-716d-11eb-8ab2-de382c6dd78e.jpg)
Git status, git branch, and ruby, all in a no muss, no fuss prompt! Works with RVM, chruby, and rbenv (just activate the corresponding plugin). Git status, git branch, and ruby, all in a no muss, no fuss prompt! Works with RVM, chruby, and rbenv (just activate the corresponding plugin).
### suvash ### suvash
![suvash](https://user-images.githubusercontent.com/49100982/108255766-b95a2a00-716d-11eb-905e-bad027eacc41.jpg) ![suvash](https://user-images.githubusercontent.com/49100982/108255766-b95a2a00-716d-11eb-905e-bad027eacc41.jpg)
Username, host, directory, git branch and rvm gemset Username, host, directory, git branch and rvm gemset
## T ## T
### takashiyoshida ### takashiyoshida
![takashiyoshida](https://user-images.githubusercontent.com/49100982/108255767-b95a2a00-716d-11eb-9750-41c3b6036529.jpg) ![takashiyoshida](https://user-images.githubusercontent.com/49100982/108255767-b95a2a00-716d-11eb-9750-41c3b6036529.jpg)
### terminalparty ### terminalparty
![terminalparty](https://user-images.githubusercontent.com/49100982/108255770-b9f2c080-716d-11eb-8e79-068a5ed7ee7a.jpg) ![terminalparty](https://user-images.githubusercontent.com/49100982/108255770-b9f2c080-716d-11eb-8e79-068a5ed7ee7a.jpg)
There is a party every day. There is a party every day.
### theunraveler ### theunraveler
![theunraveler](https://user-images.githubusercontent.com/49100982/108255772-ba8b5700-716d-11eb-99cc-53d05b5bf20c.jpg) ![theunraveler](https://user-images.githubusercontent.com/49100982/108255772-ba8b5700-716d-11eb-99cc-53d05b5bf20c.jpg)
Minimal, informative when it needs to be. Minimal, informative when it needs to be.
### tjkirch ### tjkirch
![tjkirch](https://user-images.githubusercontent.com/49100982/108255774-ba8b5700-716d-11eb-80f2-213a9932fb0a.jpg) ![tjkirch](https://user-images.githubusercontent.com/49100982/108255774-ba8b5700-716d-11eb-80f2-213a9932fb0a.jpg)
Based on dst, plus a lightning bolt and return codes. Based on dst, plus a lightning bolt and return codes.
### tonotdo ### tonotdo
![tonotdo](https://user-images.githubusercontent.com/49100982/108255775-bb23ed80-716d-11eb-9ec4-ea00690300bb.jpg) ![tonotdo](https://user-images.githubusercontent.com/49100982/108255775-bb23ed80-716d-11eb-9ec4-ea00690300bb.jpg)
### trapd00r ### trapd00r
![trapd00r](https://user-images.githubusercontent.com/49100982/108255776-bb23ed80-716d-11eb-9ada-24b61a3d4afe.jpg) ![trapd00r](https://user-images.githubusercontent.com/49100982/108255776-bb23ed80-716d-11eb-9ada-24b61a3d4afe.jpg)
## W ## W
### wedisagree ### wedisagree
![wedisagree](https://user-images.githubusercontent.com/49100982/108255779-bbbc8400-716d-11eb-98e9-3d0993efe2c3.jpg) ![wedisagree](https://user-images.githubusercontent.com/49100982/108255779-bbbc8400-716d-11eb-98e9-3d0993efe2c3.jpg)
Instructions to further customize the theme are available as comments in the theme file. Instructions to further customize the theme are available as comments in the theme file.
### wezm ### wezm
![wezm](https://user-images.githubusercontent.com/49100982/108255780-bbbc8400-716d-11eb-83b2-b9a4ba63bdbf.jpg) ![wezm](https://user-images.githubusercontent.com/49100982/108255780-bbbc8400-716d-11eb-83b2-b9a4ba63bdbf.jpg)
### wezm+ ### wezm+
![wezm+](https://user-images.githubusercontent.com/49100982/108255782-bc551a80-716d-11eb-9347-c841028b8c1a.jpg) ![wezm+](https://user-images.githubusercontent.com/49100982/108255782-bc551a80-716d-11eb-9347-c841028b8c1a.jpg)
### wuffers ### wuffers
![wuffers](https://user-images.githubusercontent.com/49100982/108255783-bcedb100-716d-11eb-9330-e1d16aeaf994.jpg) ![wuffers](https://user-images.githubusercontent.com/49100982/108255783-bcedb100-716d-11eb-9330-e1d16aeaf994.jpg)
## X ## X
### xiong-chiamiov ### xiong-chiamiov
![xiong-chiamiov-plus](https://user-images.githubusercontent.com/49100982/108255788-bd864780-716d-11eb-87b1-01cab8ee3f93.jpg) ![xiong-chiamiov-plus](https://user-images.githubusercontent.com/49100982/108255788-bd864780-716d-11eb-87b1-01cab8ee3f93.jpg)
### xiong-chiamiov-plus ### xiong-chiamiov-plus
![xiong-chiamiov](https://user-images.githubusercontent.com/49100982/108255786-bcedb100-716d-11eb-9f4d-540b75cc62c2.jpg) ![xiong-chiamiov](https://user-images.githubusercontent.com/49100982/108255786-bcedb100-716d-11eb-9f4d-540b75cc62c2.jpg)
## Y ## Y
### ys ### ys
![ys](https://user-images.githubusercontent.com/49100982/108255792-be1ede00-716d-11eb-8c26-f7ad7ab3c4f2.jpg) ![ys](https://user-images.githubusercontent.com/49100982/108255792-be1ede00-716d-11eb-8c26-f7ad7ab3c4f2.jpg)
Clean, simple, compatible and meaningful.Tested on Linux, Unix and Windows under ANSI colors. Clean, simple, compatible and meaningful.Tested on Linux, Unix and Windows under ANSI colors.
@ -497,40 +627,38 @@ It is recommended to use with a dark background.
[More info](http://blog.ysmood.org/my-ys-terminal-theme/) [More info](http://blog.ysmood.org/my-ys-terminal-theme/)
## Z ## Z
### zhann ### zhann
![zhann](https://user-images.githubusercontent.com/49100982/108255796-be1ede00-716d-11eb-8b61-9a419ebe7a4a.jpg) ![zhann](https://user-images.githubusercontent.com/49100982/108255796-be1ede00-716d-11eb-8b61-9a419ebe7a4a.jpg)
----
---
## More themes ## More themes
You can find more themes [here](https://github.com/robbyrussell/oh-my-zsh/wiki/External-themes). You can find more themes [here](https://github.com/robbyrussell/oh-my-zsh/wiki/External-themes).
## (Don’t) Send us your theme! (for now)
## (Don’t) Send us your theme! (for now)
We have enough themes for the time being. Please fork the project and add on in there, you can let people know how to grab it from there. We have enough themes for the time being. Please fork the project and add on in there, you can let people know how to grab it from there.
Or put into a Gist and add it to the [External Themes list](https://github.com/robbyrussell/oh-my-zsh/wiki/External-themes). Or put into a Gist and add it to the [External Themes list](https://github.com/robbyrussell/oh-my-zsh/wiki/External-themes).
## Theme Description Format ## Theme Description Format
The theme descriptions in this page should contain: The theme descriptions in this page should contain:
* The name of the theme
* A screenshot - The name of the theme
* (Preferably in PNG format, and hosted on a GitHub issue) - A screenshot
* Instructions for any configuration besides setting `ZSH_THEME` in `~/.zshrc` - (Preferably in PNG format, and hosted on a GitHub issue)
* For example, font installation, terminal color scheme configuration, or optional environment variables that affect the theme - Instructions for any configuration besides setting `ZSH_THEME` in `~/.zshrc`
* Any dependencies outside Oh My Zsh - For example, font installation, terminal color scheme configuration, or optional environment variables that affect the theme
- Any dependencies outside Oh My Zsh
We use manually-constructed screenshots because some of the themes require additional terminal configuration to look their best, and so the code in example shell sessions can showcase the theme's features. There is also a separate collection of automatically-generated screenshots linked [at the bottom of this page](#screenshots-of-each-theme). We use manually-constructed screenshots because some of the themes require additional terminal configuration to look their best, and so the code in example shell sessions can showcase the theme's features. There is also a separate collection of automatically-generated screenshots linked [at the bottom of this page](#screenshots-of-each-theme).
### Uploading screenshots to GitHub
### Uploading screenshots to GitHub
We host all the screenshot images on GitHub itself, to avoid external dependencies on other hosting services or URLs that might break.Please, compress images before. We use issue attachments which will get them in to githubusercontent.com. (It's also possible to store image files in a GitHub wiki itself, but this requires you to have Contributor permissions for the repo whose Wiki you're editing. The issue-attachment method can be done by anybody.) We host all the screenshot images on GitHub itself, to avoid external dependencies on other hosting services or URLs that might break.Please, compress images before. We use issue attachments which will get them in to githubusercontent.com. (It's also possible to store image files in a GitHub wiki itself, but this requires you to have Contributor permissions for the repo whose Wiki you're editing. The issue-attachment method can be done by anybody.)
@ -538,16 +666,17 @@ To upload an image to GitHub, just drag and drop it into the text area on an iss
For example: For example:
``` ```md
[![wezm](https://cloud.githubusercontent.com/assets/1441704/6315419/915f6ca6-ba01-11e4-95b3-2c98114b5e5c.png)](https://cloud.githubusercontent.com/assets/1441704/6315419/915f6ca6-ba01-11e4-95b3-2c98114b5e5c.png) [![wezm](https://cloud.githubusercontent.com/assets/1441704/6315419/915f6ca6-ba01-11e4-95b3-2c98114b5e5c.png)](https://cloud.githubusercontent.com/assets/1441704/6315419/915f6ca6-ba01-11e4-95b3-2c98114b5e5c.png)
``` ```
If you have several uploaded screenshot links you need to convert to that self-linked syntax, you can use this `sed` command on the markdown file to programmatically convert them. If you have several uploaded screenshot links you need to convert to that self-linked syntax, you can use this `sed` command on the markdown file to programmatically convert them.
sed 's/^!\[[a-zA-Z0-9 -]*\](\([^)]*\)) *$/[&](\1)/' ```sh
sed 's/^!\[[a-zA-Z0-9 -]*\](\([^)]*\)) *$/[&](\1)/'
```
## Screenshots of each Theme
## Screenshots of each Theme
### Version 2019-08 ### Version 2019-08

13
Troubleshooting.md

@ -2,8 +2,9 @@ This page is meant to describe the most common problems with oh-my-zsh and what
### Keyboard shortcut problems ### Keyboard shortcut problems
Example: Example:
```shell
```sh
bindkey '^L' clear-screen bindkey '^L' clear-screen
``` ```
@ -45,13 +46,15 @@ Many completion problems, including the infamous `command not found: compdef`, c
### Other problems ### Other problems
As a last resort, if you're getting weird behavior and can't find the culprit, run the following command to enable debug mode: As a last resort, if you're getting weird behavior and can't find the culprit, run the following command to enable debug mode:
```shell
```sh
zsh -xv &> >(tee ~/omz-debug.log 2>/dev/null) zsh -xv &> >(tee ~/omz-debug.log 2>/dev/null)
``` ```
Afterwards, reproduce the behavior (_i.e._ if it's a particular command, run it), and when you're done, run `exit` to stop the debugging session. This will create a `omz-debug.log` file on your home directory, which you can upload to [gist.github.com](https://gist.github.com/) and link to it on the issue you'll open next. Afterwards, reproduce the behavior (_i.e._ if it's a particular command, run it), and when you're done, run `exit` to stop the debugging session. This will create a `omz-debug.log` file on your home directory, which you can upload to [gist.github.com](https://gist.github.com/) and link to it on the issue you'll open next.
If you only need to debug the session initialization, you can do so with the command: If you only need to debug the session initialization, you can do so with the command:
```shell
```sh
zsh -xvic exit &> ~/omz-debug.log zsh -xvic exit &> ~/omz-debug.log
``` ```

4
Volunteers.md

@ -1,6 +1,6 @@
We're having a discussion on the need to have [a few moderators](https://github.com/ohmyzsh/ohmyzsh/issues/2771) as well as having some [general guidelines](https://github.com/ohmyzsh/ohmyzsh/issues/3770) and [help](https://github.com/ohmyzsh/ohmyzsh/wiki/Contribution-Technical-Practices) for new collaborators in the project, whether they want to submit a patch, report a bug or just ask a question. Feel free to write your opinion! We're having a discussion on the need to have [a few moderators](https://github.com/ohmyzsh/ohmyzsh/issues/2771) as well as having some [general guidelines](https://github.com/ohmyzsh/ohmyzsh/issues/3770) and [help](https://github.com/ohmyzsh/ohmyzsh/wiki/Contribution-Technical-Practices) for new collaborators in the project, whether they want to submit a patch, report a bug or just ask a question. Feel free to write your opinion!
Please read our [Code of Conduct](https://github.com/ohmyzsh/ohmyzsh/blob/master/CODE_OF_CONDUCT.md), too. 🙃 Please read our [Code of Conduct](https://github.com/ohmyzsh/ohmyzsh/blob/master/CODE_OF_CONDUCT.md), too. 🙃
*** ***
@ -24,4 +24,4 @@ Get in touch with [@robbyrussell](https://github.com/robbyrussell) and [@mcornel
* Many [plugins](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins) are still missing a proper * Many [plugins](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins) are still missing a proper
ReadMe file ReadMe file
* Some wiki pages ([[Plugins]], [[Plugins Overview]], _etc_) need updating * Some wiki pages ([[Plugins]], [[Plugins Overview]], _etc_) need updating

9
Wiki-Style-Guide.md

@ -18,15 +18,19 @@ Following these guidelines while making the readme for your plugin/theme would b
Below is an example of how to use each header (and will be the only use of ##/h2 in abnormal circumstances). Below is an example of how to use each header (and will be the only use of ##/h2 in abnormal circumstances).
___ ---
## This is a main subject (h2) ## This is a main subject (h2)
### This subject has several important sub-subjects (h3) ### This subject has several important sub-subjects (h3)
#### Some sub-subjects are so vast, they require their own sub-subjects (h4) #### Some sub-subjects are so vast, they require their own sub-subjects (h4)
##### _Example:_ (h5) ##### _Example:_ (h5)
###### _Quick explanation of example:_ (h6) ###### _Quick explanation of example:_ (h6)
___ ---
## Tables ## Tables
@ -57,6 +61,7 @@ Use hyphens `-` for defining unnumbered lists and sublists, as opposed to asteri
Use Markdown formatting for images, **not HTML**. Use Markdown formatting for images, **not HTML**.
###### _Example:_ ###### _Example:_
```markdown ```markdown
![image description](url to image) ![image description](url to image)
``` ```

2
_Footer.md

@ -2,4 +2,4 @@
— [Website](https://ohmyz.sh) — [Website](https://ohmyz.sh)
— [Twitter](https://twitter.com/ohmyzsh) — [Twitter](https://twitter.com/ohmyzsh)
— [Merchandise](https://shop.planetargon.com/collections/oh-my-zsh?utm_source=github) — [Merchandise](https://shop.planetargon.com/collections/oh-my-zsh?utm_source=github)
— [Discord](https://discord.gg/ohmyzsh) — [Discord](https://discord.gg/ohmyzsh)

32
_Sidebar.md

@ -2,24 +2,24 @@
* **[[FAQ]]** * **[[FAQ]]**
* **[[Plugins Overview]]** * **[[Plugins Overview]]**
* **Documentation** * **Documentation**
+ [[Installing ZSH]] * [[Installing ZSH]]
+ [[Settings]] * [[Settings]]
+ [[Plugins]] * [[Plugins]]
+ [[Themes]] * [[Themes]]
+ [[Cheatsheet]] * [[Cheatsheet]]
+ [[Customization]] * [[Customization]]
+ [[Troubleshooting]] * [[Troubleshooting]]
* **Community** * **Community**
+ [[Articles]] * [[Articles]]
+ [[External plugins]] * [[External plugins]]
+ [[External themes]] * [[External themes]]
+ [[Testimonials]] * [[Testimonials]]
* **Contributing** * **Contributing**
+ [[Volunteers]] * [[Volunteers]]
+ [[Design]] * [[Design]]
+ [[Code Style Guide]] * [[Code Style Guide]]
+ [[Wiki Style Guide]] * [[Wiki Style Guide]]
+ [[Contribution Technical Practices]] * [[Contribution Technical Practices]]
------------------ ------------------