From e925ca02cb4ec43d29f352ff3c9526ffad3d4533 Mon Sep 17 00:00:00 2001 From: Carlo Sala Date: Sun, 22 Dec 2024 16:29:21 +0100 Subject: [PATCH] chore: run prettier --- Articles.md | 2 + Cheatsheet.md | 58 +-- Code-Style-Guide.md | 8 +- Contribution-Technical-Practices.md | 2 + Customization.md | 6 +- Design.md | 24 +- External-plugins.md | 5 +- External-themes.md | 546 ++++++++++++++-------------- FAQ.md | 54 +-- Home.md | 4 +- Installing-ZSH.md | 18 +- Plugin:git.md | 2 + Plugin:svn.md | 2 + Plugins-Overview.md | 2 + Plugins.md | 4 +- Resources.md | 4 +- Settings.md | 14 +- Testimonials.md | 44 +-- Themes-(legacy).md | 118 +++++- Themes.md | 12 +- Troubleshooting.md | 10 +- Volunteers.md | 87 ++--- Wiki-Style-Guide.md | 14 +- _Sidebar.md | 48 +-- 24 files changed, 615 insertions(+), 473 deletions(-) diff --git a/Articles.md b/Articles.md index b2f7b63..0357b11 100644 --- a/Articles.md +++ b/Articles.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + Here are a collection of blog posts and articles that mention Oh My Zsh. diff --git a/Cheatsheet.md b/Cheatsheet.md index 06e7d7a..de72ffb 100644 --- a/Cheatsheet.md +++ b/Cheatsheet.md @@ -1,8 +1,10 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ > **If you're coming from the Internet, this section has been edited to only show main** > **Oh My Zsh tricks. Documentation for each plugin can be found in each [[Plugins]] README.** + Quick reference: @@ -14,34 +16,34 @@ Quick reference: ## Commands -| Command | Description | -| :-------------- | :----------------------------------------------------------------------------------------- | -| `alias` | List all aliases | -| `mkcd` | Create a new directory and change to it, will create intermediate directories as required. | -| `take` | Like `mkcd`, but also knows how to handle remote URLs. When given an argument that looks like a URL (something that ends in `.git` or `.tar.(gz\|bz2\|xz)`), download the remote resource and extract it (if necessary) into the current directory. Then change to the newly extracted/downloaded/cloned directory. | -| `zsh_stats` | Get a list of the top 20 commands and how many times they have been run. | +| Command | Description | +| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `alias` | List all aliases | +| `mkcd` | Create a new directory and change to it, will create intermediate directories as required. | +| `take` | Like `mkcd`, but also knows how to handle remote URLs. When given an argument that looks like a URL (something that ends in `.git` or `.tar.(gz\|bz2\|xz)`), download the remote resource and extract it (if necessary) into the current directory. Then change to the newly extracted/downloaded/cloned directory. | +| `zsh_stats` | Get a list of the top 20 commands and how many times they have been run. | ## Directory -| Alias | Command | -| :--------- | :----------------------------------------- | -| `md` | `mkdir -p` | -| `rd` | `rmdir` | -| `~` | `cd` (change to home directory) | -| `..` | `cd ..` | -| `...` | `cd ../..` | -| `....` | `cd ../../..` | -| `.....` | `cd ../../../..` | -| `/` | `cd /` | -| `d` | `dirs -v` (lists last visited directories) | -| `cd +n` | Switch to directory number `n` | -| `-` | `cd` to last visited directory | -| `1` | `cd -1` | -| `2` | `cd -2` | -| `3` | `cd -3` | -| `4` | `cd -4` | -| `5` | `cd -5` | -| `6` | `cd -6` | -| `7` | `cd -7` | -| `8` | `cd -8` | -| `9` | `cd -9` | +| Alias | Command | +| :------ | :----------------------------------------- | +| `md` | `mkdir -p` | +| `rd` | `rmdir` | +| `~` | `cd` (change to home directory) | +| `..` | `cd ..` | +| `...` | `cd ../..` | +| `....` | `cd ../../..` | +| `.....` | `cd ../../../..` | +| `/` | `cd /` | +| `d` | `dirs -v` (lists last visited directories) | +| `cd +n` | Switch to directory number `n` | +| `-` | `cd` to last visited directory | +| `1` | `cd -1` | +| `2` | `cd -2` | +| `3` | `cd -3` | +| `4` | `cd -4` | +| `5` | `cd -5` | +| `6` | `cd -6` | +| `7` | `cd -7` | +| `8` | `cd -8` | +| `9` | `cd -9` | diff --git a/Code-Style-Guide.md b/Code-Style-Guide.md index 727ae3c..0cc6bea 100644 --- a/Code-Style-Guide.md +++ b/Code-Style-Guide.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + ## General Code Style @@ -27,7 +29,7 @@ long_string_1="I am an exceptionalllllllllllly loooooooooooooooooooooooooooooooo ```shell cat < > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + Oh My Zsh is a community-driven project and contributions are welcome, but it all works best with a proper setup. Here follow the best practices for setting up a fork and getting started for contributing. diff --git a/Customization.md b/Customization.md index 15f1840..e1f0259 100644 --- a/Customization.md +++ b/Customization.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + Oh My Zsh is fully configurable to your needs with the help of the `$ZSH_CUSTOM` variable, whether you want to change its internals, plugins or the rich theme set – and all that **without forking**! @@ -30,11 +32,11 @@ $ZSH_CUSTOM 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//`. 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. ### Partially overriding an existing plugin -To partially customize a plugin by redefining individual functions or variables from it, use a "patch" plugin. Create a custom "patch" plugin with a different name that has definitions for just the items you wish to override, and load that after the base plugin by putting your patch plugin in `$plugins` *after* the base plugin it customizes. (This is necessary because user custom files are loaded before any plugins are loaded.) Make sure it doesn't have the same name as any other base plugin, either. +To partially customize a plugin by redefining individual functions or variables from it, use a "patch" plugin. Create a custom "patch" plugin with a different name that has definitions for just the items you wish to override, and load that after the base plugin by putting your patch plugin in `$plugins` _after_ the base plugin it customizes. (This is necessary because user custom files are loaded before any plugins are loaded.) Make sure it doesn't have the same name as any other base plugin, either. This may or may not work, depending on how the plugin is written: your redefinitions only take effect after the plugin has been loaded by `source`-ing its definition file. If any of the things you redefine are called or referenced during the plugin's initialization, they will not see your redefinitions. diff --git a/Design.md b/Design.md index b99ccb5..853150c 100644 --- a/Design.md +++ b/Design.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + This page is a description of the current architecture and design of Oh My Zsh. @@ -25,7 +27,7 @@ It seems that plugins can get arbitrarily powerful and do whatever they want, so ## Variables -These are variables that base OMZ (excluding any plugins) uses. I've read through .oh-my-zsh so far, but not the lib/*.zsh files. More may be on the way. +These are variables that base OMZ (excluding any plugins) uses. I've read through .oh-my-zsh so far, but not the lib/\*.zsh files. More may be on the way. ### Variables OMZ reads @@ -39,8 +41,8 @@ In oh-my-zsh.sh: - `ZSH_THEME` – theme to load at startup - `CASE_SENSITIVE` – controls zsh completion matching - `COMPLETION_WAITING_DOTS` -- `DISABLE_AUTO_UPDATE` – ("true"/*) -- `DISABLE_AUTO_PROMPT` – ("true"/*) +- `DISABLE_AUTO_UPDATE` – ("true"/\*) +- `DISABLE_AUTO_PROMPT` – ("true"/\*) - `DISABLE_LS_COLORS` – in lib/theme-and-appearance - `ENABLE_CORRECTION` - `ZSH_CACHE_DIR` @@ -67,13 +69,13 @@ At init: - `POST_1_7_2_GIT` - `PAGER` - `LESS` -- `FX` – special terminal control "effects" (reset/bold/no-bold/etc) +- `FX` – special terminal control "effects" (reset/bold/no-bold/etc) - `FG` - `BG` 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_COMPDUMP` - `ZSH_SPECTRUM_TEXT` @@ -117,7 +119,7 @@ The initialization steps in detail: - Discovers and sources all lib files, in alphabetical order, respecting custom overrides - Load custom user code - 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` - Initialize Completion support - Set `$ZSH_COMPDUMP` @@ -130,16 +132,16 @@ The initialization steps in detail: In Oh My Zsh terms, _customization_ means adding or overriding zsh code, including its internals and implementation. It's not just a term for user-specified configuration. -Overriding internals can be done by adding `*.zsh` files to the `$ZSH_CUSTOM` root directory. All `*.zsh` files there will be sourced after OMZ loads and sources its own lib/* files. This allows you to redefine functions after the fact. (This will take place after any setup has called OMZ functions.) These are referred to as "config files" in oh-my-zsh.sh. +Overriding internals can be done by adding `*.zsh` files to the `$ZSH_CUSTOM` root directory. All `*.zsh` files there will be sourced after OMZ loads and sources its own lib/\* files. This allows you to redefine functions after the fact. (This will take place after any setup has called OMZ functions.) These are referred to as "config files" in oh-my-zsh.sh. 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: -- 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 - Override plugins and themes on a per-plugin/theme basis (loaded instead of base) -- Override parts of plugins by defining an additional "patch" plugin and including it in `$plugins` *after* the base plugin +- Override parts of plugins by defining an additional "patch" plugin and including it in `$plugins` _after_ the base plugin `$ZSH_CUSTOM` controls where the custom override files are found; defaults to `$ZSH/custom` (under the main OMZ installation). @@ -169,7 +171,7 @@ Themes control the appearance of the `zsh` prompt, the appearance of certain oth OMZ turns on the `prompt_subst` shell option, and OMZ themes assume it is enabled. -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: @@ -183,7 +185,7 @@ These variables are set by themes to control the prompt's appearance and other c - `PROMPT` - `DEFAULT_USER` -- `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(): diff --git a/External-plugins.md b/External-plugins.md index ab9fcf9..d250035 100644 --- a/External-plugins.md +++ b/External-plugins.md @@ -1,4 +1,7 @@ -> _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page, go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + +> _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ +> _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + ## Non-Bundled Plugins diff --git a/External-themes.md b/External-themes.md index 68c7c32..b60fd38 100644 --- a/External-themes.md +++ b/External-themes.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + Due to the massive amount of themes bundled with OMZ, [new themes are not accepted](https://github.com/ohmyzsh/ohmyzsh/#do-not-send-us-themes). This is a list of other themes that are compatible with Oh My Zsh that live in their own separate repositories. More themes are listed in the [awesome-zsh-plugins](https://github.com/unixorn/awesome-zsh-plugins) list. @@ -11,11 +13,12 @@ You can also use Github's search to find `*.zsh-theme` files: Check out the instructions [here](https://github.com/ohmyzsh/ohmyzsh/wiki/Customization#overriding-and-adding-themes). --- +
### Simplerich Theme -#### *Informative Git Status, Anaconda Environment Info and Command Execution Time.* +#### _Informative Git Status, Anaconda Environment Info and Command Execution Time._ ![Simplerich](https://github.com/philip82148/simplerich-zsh-theme/blob/main/readme/demo.png) @@ -37,27 +40,33 @@ After command execution, you can see also: - Success/Error Hint #### Install: [Install](https://github.com/philip82148/simplerich-zsh-theme#install) + #### Source: [simplerich-zsh-theme](https://github.com/philip82148/simplerich-zsh-theme) + #### Author: [@philip82148](https://github.com/philip82148) --- +
### Neo Theme #### *Simple, intuitive, and nonclustered.* ![neo](https://github.com/migoa/wiki/assets/111497717/9c641982-3d6f-4548-9e5d-92a50308bea7) +
**Repo: [Gitlab ](https://gitlab.com/migoa/neo) or [Hub](https://github.com/migoa/neo)
Author: [Migo](https://gitlab.com/migoa)** + --- + ### Heapbytes Terminal theme ![heapbytes-theme](https://github.com/ohmyzsh/wiki/assets/56447720/39c2e4e0-3315-4e06-8b46-8e83514ccaca) -#### Features +#### Features - Fork/update/inspiration of rkj theme. - Prints the tun0 IP if connected to a VPN @@ -107,10 +116,10 @@ Author: [@win0err](https://github.com/win0err) ##### Feature -* real time prompt. -* command running time cost prompt. -* command running error hint. -* git status prompt; +- real time prompt. +- command running time cost prompt. +- command running error hint. +- git status prompt; ##### Install: [Install](https://github.com/ChesterYue/ohmyzsh-theme-passion#install) @@ -121,7 +130,8 @@ Author: [@win0err](https://github.com/win0err) ---

- typewritten +typewritten +

typewritten

A minimal zsh prompt

@@ -163,16 +173,16 @@ npm install -g typewritten **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) Documentation: [typewritten.dev](https://typewritten.dev) -Author: [@reobin](https://github.com/reobin) +Author: [@reobin](https://github.com/reobin) --- @@ -185,10 +195,10 @@ Author: [@reobin](https://github.com/reobin) **Features** -* Color matched separator line -* Dynamic information line -* Git status info (including commits ahead/behind) -* Customizable colors, styles, and symbols +- Color matched separator line +- Dynamic information line +- Git status info (including commits ahead/behind) +- Customizable colors, styles, and symbols Author: [@Moarram](https://github.com/moarram) @@ -205,14 +215,14 @@ Author: [@sebastianpulido](https://github.com/sebastianpulido) #### ubunly -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. -* Install: [how to install](https://github.com/alejandromume/ubunly-zsh-theme#install) +- Install: [how to install](https://github.com/alejandromume/ubunly-zsh-theme#install) -* Source: [here](https://github.com/alejandromume/ubunly-zsh-theme) -* Author [@alejandromume](https://github.com/alejandromume) +- Source: [here](https://github.com/alejandromume/ubunly-zsh-theme) +- Author [@alejandromume](https://github.com/alejandromume) --- @@ -230,28 +240,28 @@ Author: [@Tesohh](https://github.com/Tesohh) #### ✏️✅ 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. ![Alt text](https://raw.githubusercontent.com/masaakifuruki/emoji.zsh-theme/main/emoji_theme_ohmyzsh.png "emoji oh my zsh theme preview") ##### Installation -Copy emoji.zsh-theme into your ```~/.oh-my-zsh/themes/``` directory +Copy emoji.zsh-theme into your `~/.oh-my-zsh/themes/` directory -Then change current theme to emoji ```ZSH_THEME=emoji``` in your ```~/.zshrc```. +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 -* ```➜ current_dir (git_branch) ``` +- `➜ current_dir (git_branch) ` -* ✏️ Git prompt is dirty (uncommitted files) -* ✅ Git prompt is clean (committed) +- ✏️ Git prompt is dirty (uncommitted files) +- ✅ Git prompt is clean (committed) ##### 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) @@ -259,13 +269,12 @@ author: [@masaakifuruki](https://github.com/masaakifuruki) --- - #### guezwhoz ![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 -* Interactive `Tab` completer +- Single git status marker for Visual Studio Code and Git cli +- Interactive `Tab` completer source: [repo](https://github.com/guesswhozzz/guezwhoz-zshell) @@ -290,7 +299,7 @@ author: [@guesswhozzz](https://github.com/guesswhozzz) The minimal MacOS terminal brought to ZSH -* Tested OS's: `Ubuntu 20.04` and `Windows 10 WSL` +- Tested OS's: `Ubuntu 20.04` and `Windows 10 WSL` @@ -300,18 +309,18 @@ The minimal MacOS terminal brought to ZSH **Features** -* Git Branch at right -* Last Login message -* Same format as MacOS +- Git Branch at right +- Last Login message +- Same format as MacOS **Code** -* [Installation](https://github.com/alejandromume/macos-zsh-theme/#installation) -* [Source Code](https://github.com/alejandromume/macos-zsh-theme) +- [Installation](https://github.com/alejandromume/macos-zsh-theme/#installation) +- [Source Code](https://github.com/alejandromume/macos-zsh-theme) **Credits** -* Author: [@alejandromume](https://github.com/alejandromume) +- Author: [@alejandromume](https://github.com/alejandromume) --- @@ -324,10 +333,10 @@ It does away with the long path after the username, and retains only the basenam Features: -* Colored input to shell to easily differentiate it from the output of commands. -* No annoying long prompts. -* Option to keep/hide the virtual environment name. -* Prominent alert on command exiting with non-zero code. +- Colored input to shell to easily differentiate it from the output of commands. +- No annoying long prompts. +- Option to keep/hide the virtual environment name. +- Prominent alert on command exiting with non-zero code. Source: [Repository](https://github.com/nikhilkmr300/omz-themes) (also contains other themes you might be interested in) @@ -341,11 +350,11 @@ Author: [@nikhilkmr300](https://github.com/nikhilkmr300) Features: -* 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. -* Option to keep/hide the virtual environment name. -* Prominent alert on command exiting with non-zero code. -* Dashed line separating successive prompts. +- 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. +- Option to keep/hide the virtual environment name. +- Prominent alert on command exiting with non-zero code. +- Dashed line separating successive prompts. Source: [Repository](https://github.com/nikhilkmr300/omz-themes) (also contains other themes you might be interested in) @@ -359,11 +368,11 @@ Author: [@nikhilkmr300](https://github.com/nikhilkmr300) Features: -* 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. -* Option to keep/hide the virtual environment name. -* Prominent alert on command exiting with non-zero code. -* Dashed line separating successive prompts. +- 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. +- Option to keep/hide the virtual environment name. +- Prominent alert on command exiting with non-zero code. +- Dashed line separating successive prompts. Source: [Repository](https://github.com/nikhilkmr300/omz-themes) (also contains other themes you might be interested in) @@ -389,7 +398,7 @@ Chill zsh-theme, personal take on smt Source: [daivasmara.zsh-theme](https://github.com/Daivasmara/daivasmara.zsh-theme) -Author: [@Daivasmara](https://github.com/Daivasmara) +Author: [@Daivasmara](https://github.com/Daivasmara) --- @@ -397,14 +406,14 @@ Author: [@Daivasmara](https://github.com/Daivasmara) ![Ducula Theme](https://raw.githubusercontent.com/janjoswig/Ducula/master/ducula_showcase.png) - * 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) - * 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} - * Current path: Displays the full current working directory - * Return status: Shows the error return code (:bat:/:duck:) - * Git messages: Uses `git_super_status` from the git-prompt plugin - * Prompt time: Timestamp (hh:mm) +- 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) +- 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} +- Current path: Displays the full current working directory +- Return status: Shows the error return code (:bat:/:duck:) +- Git messages: Uses `git_super_status` from the git-prompt plugin +- Prompt time: Timestamp (hh:mm) See [repository](https://github.com/janjoswig/Ducula) for source. Author: [@janjoswig](https://github.com/janjoswig/) @@ -520,8 +529,8 @@ author: [@sobolevn](https://github.com/sobolevn) ![xxf](https://i.ibb.co/rtGyPRs/Wechat-IMG230.png) -* Show Current commit shorten hash and message -See [Gist](https://gist.github.com/xfanwu/18fd7c24360c68bab884) for source. +- Show Current commit shorten hash and message + See [Gist](https://gist.github.com/xfanwu/18fd7c24360c68bab884) for source. author: [@xfanwu](https://github.com/xfanwu) @@ -562,14 +571,14 @@ Bullet Train is a Oh My Zsh shell theme based on the Powerline Vim plugin. It ai It currently shows: -* Current Python virtualenv -* Current Ruby version and gemset, through RVM -* Current Node.js version, through NVM -* Git status -* Timestamp -* Current directory -* Background jobs -* Exit code of last command +- Current Python virtualenv +- Current Ruby version and gemset, through RVM +- Current Node.js version, through NVM +- Git status +- Timestamp +- Current directory +- Background jobs +- Exit code of last command See [Repo](https://github.com/caiogondim/bullet-train-oh-my-zsh-theme) for source @@ -583,7 +592,7 @@ See [repository](https://github.com/stevelacy/cordial-zsh-theme) for source. 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 @@ -633,13 +642,13 @@ Author: [@fjpalacios](https://github.com/fjpalacios) It currently shows: -* Git status -* 🕕 Time -* `~/Desktop` Working directory -* > where you type your cmds -* `✹git:master` **color : Red** unstaged commit -* `git:master` **color: White** committed files -* `○` shows if current directory is a git folder || git branch +- Git status +- 🕕 Time +- `~/Desktop` Working directory +- > where you type your cmds +- `✹git:master` **color : Red** unstaged commit +- `git:master` **color: White** committed files +- `○` shows if current directory is a git folder || git branch See [repository](https://github.com/akinjide/chi) for source. @@ -649,9 +658,9 @@ Author: [@akinjide](https://github.com/akinjide) ![haribotheme](https://fooo.biz/images/haribo_omz_theme.png) -* Works with most console fonts -* simple git status -* timestamp +- Works with most console fonts +- simple git status +- timestamp See [Repo](https://github.com/haribo/omz-haribo-theme) for source @@ -669,11 +678,11 @@ author: [Schminitz](https://github.com/schminitz)/[@Schminitz](https://twitter.c ![odin](https://github.com/tylerreckart/odin/raw/master/images/preview.gif) -* Git focused development. -* A clean and distraction free programming environment. -* 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. +- Git focused development. +- A clean and distraction free programming environment. +- 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. author: [@tylerreckart](https://github.com/tylerreckart) @@ -681,11 +690,11 @@ author: [@tylerreckart](https://github.com/tylerreckart) ![hyperzsh](https://raw.githubusercontent.com/tylerreckart/hyperzsh/master/screenshots/demo.gif) -* Git status -* Timestamp -* Current directory -* Background jobs -* Exit code of last command +- Git status +- Timestamp +- Current directory +- Background jobs +- Exit code of last command See [hyperzsh](https://github.com/tylerreckart/hyperzsh) for source. @@ -695,7 +704,7 @@ author: [@tylerreckart](https://github.com/tylerreckart) ![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) author: [@willmendesneto](https://github.com/willmendesneto) @@ -704,8 +713,8 @@ author: [@willmendesneto](https://github.com/willmendesneto) ![Screenshot](https://raw.githubusercontent.com/halfo/lambda-mod-zsh-theme/master/screenshot.png) -* A simple yet elegant theme with git focused development. -See [lambda-mod](https://github.com/halfo/lambda-mod-zsh-theme/) for source. +- A simple yet elegant theme with git focused development. + See [lambda-mod](https://github.com/halfo/lambda-mod-zsh-theme/) for source. author: [@halfo](https://github.com/halfo) @@ -713,7 +722,7 @@ author: [@halfo](https://github.com/halfo) ![hedgehog](https://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) author: [@hedgehog1029](https://github.com/hedgehog1029) @@ -729,7 +738,7 @@ author: [@skuridin](https://github.com/skuridin) ![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) author: [@yarisgutierrez](https://github.com/yarisgutierrez) @@ -742,52 +751,52 @@ Spaceship is a minimalistic, powerful and extremely customizable Zsh prompt. It Currently it shows: -* Clever hostname and username displaying. -* Prompt character turns red if the last command exits with non-zero code. -* Current Git branch and rich repo status: - * `?` — untracked changes; - * `+` — uncommitted changes in the index; - * `!` — unstaged changes; - * `»` — renamed files; - * `✘` — deleted files; - * `$` — stashed changes; - * `=` — unmerged changes; - * `⇡` — ahead of remote branch; - * `⇣` — behind of remote branch; - * `⇕` — diverged chages. -* Current Mercurial branch and rich repo status: - * `?` — untracked changes; - * `+` — uncommitted changes in the index; - * `!` — unstaged changes; - * `✘` — deleted files; -* Indicator for jobs in the background (`✦`). -* Current Node.js version, through nvm/nodenv/n (`⬢`). -* Current Ruby version, through rvm/rbenv/chruby (`💎`). -* Current Elixir version, through kiex/exenv/elixir (`💧`). -* Current Swift version, through swiftenv (`🐦`). -* Current Xcode version, through xenv (`🛠`). -* Current Go version (`🐹`). -* Current PHP version (`🐘`). -* Current Rust version (`𝗥`). -* Current version of Haskell Tool Stack (`λ`). -* Current Julia version (`ஃ`). -* Current Docker version and connected machine (`🐳`). -* Current Amazon Web Services (AWS) profile (`☁️`) ([Using named profiles](https://docs.aws.amazon.com/cli/latest/userguide/cli-multiple-profiles.html)). -* Current Python virtualenv. -* Current Conda virtualenv (`🅒`). -* Current Python pyenv (`🐍`). -* Current .NET SDK version, through dotnet-cli (`.NET`). -* Current Ember.js version, through ember-cli (`🐹`). -* Current Kubectl context (`☸️`). -* Package version, if there's is a package in the current directory (`📦`). -* Current battery level and status: - * `⇡` - charging; - * `⇣` - discharging; - * `•` - fully charged. -* Current Vi-mode mode (with handy aliases for temporarily enabling). -* Optional exit-code of the last command. -* Optional time stamps 12/24hr in format. -* Execution time of the last command if it exceeds the set threshold. +- Clever hostname and username displaying. +- Prompt character turns red if the last command exits with non-zero code. +- Current Git branch and rich repo status: + - `?` — untracked changes; + - `+` — uncommitted changes in the index; + - `!` — unstaged changes; + - `»` — renamed files; + - `✘` — deleted files; + - `$` — stashed changes; + - `=` — unmerged changes; + - `⇡` — ahead of remote branch; + - `⇣` — behind of remote branch; + - `⇕` — diverged chages. +- Current Mercurial branch and rich repo status: + - `?` — untracked changes; + - `+` — uncommitted changes in the index; + - `!` — unstaged changes; + - `✘` — deleted files; +- Indicator for jobs in the background (`✦`). +- Current Node.js version, through nvm/nodenv/n (`⬢`). +- Current Ruby version, through rvm/rbenv/chruby (`💎`). +- Current Elixir version, through kiex/exenv/elixir (`💧`). +- Current Swift version, through swiftenv (`🐦`). +- Current Xcode version, through xenv (`🛠`). +- Current Go version (`🐹`). +- Current PHP version (`🐘`). +- Current Rust version (`𝗥`). +- Current version of Haskell Tool Stack (`λ`). +- Current Julia version (`ஃ`). +- Current Docker version and connected machine (`🐳`). +- Current Amazon Web Services (AWS) profile (`☁️`) ([Using named profiles](https://docs.aws.amazon.com/cli/latest/userguide/cli-multiple-profiles.html)). +- Current Python virtualenv. +- Current Conda virtualenv (`🅒`). +- Current Python pyenv (`🐍`). +- Current .NET SDK version, through dotnet-cli (`.NET`). +- Current Ember.js version, through ember-cli (`🐹`). +- Current Kubectl context (`☸️`). +- Package version, if there's is a package in the current directory (`📦`). +- Current battery level and status: + - `⇡` - charging; + - `⇣` - discharging; + - `•` - fully charged. +- Current Vi-mode mode (with handy aliases for temporarily enabling). +- Optional exit-code of the last command. +- Optional time stamps 12/24hr in format. +- Execution time of the last command if it exceeds the set threshold. source: [spaceship-prompt/spaceship-prompt](https://github.com/spaceship-prompt/spaceship-prompt) docs: [spaceship-prompt.sh](https://spaceship-prompt.sh) @@ -799,20 +808,20 @@ author: [@denysdovhan](https://twitter.com/denysdovhan) Currently it shows: -* User name -* Machine name -* Current working directory -* Git branch -* Git status - * `✔` —— Clean branch - * `✘` —— Dirty branch - * `+` —— Added files - * `-` —— Deleted files - * `*` —— Modified files - * `>` —— Renamed files - * `=` —— Unmerged changes - * `?` —— Untracked changes -* Prompt indicator turns red if the last run fails +- User name +- Machine name +- Current working directory +- Git branch +- Git status + - `✔` —— Clean branch + - `✘` —— Dirty branch + - `+` —— Added files + - `-` —— Deleted files + - `*` —— Modified files + - `>` —— Renamed files + - `=` —— Unmerged changes + - `?` —— Untracked changes +- Prompt indicator turns red if the last run fails source: [here](https://github.com/skylerlee/zeta-zsh-theme) @@ -826,11 +835,11 @@ AgnosterZak is a Oh My Zsh shell theme based on the Powerline Vim plugin & Agnos It currently shows: -* Battery Life (in case of the laptop is not charging) -* Current Date & Time -* Current directory -* Git status -* User & Host status +- Battery Life (in case of the laptop is not charging) +- Current Date & Time +- Current directory +- Git status +- User & Host status See [Repo](https://github.com/zakaziko99/agnosterzak-ohmyzsh-theme) for source @@ -862,10 +871,10 @@ author: [@Ciacho](https://github.com/Ciacho/) ##### What it shows -* The current folder -* A customizable delimiter -* The current branch -* The current branch state (shows `*` if has uncommited changes) +- The current folder +- A customizable delimiter +- The current branch +- The current branch state (shows `*` if has uncommited changes) See [Repo](https://github.com/igor9silva/zsh-theme) for source. @@ -879,11 +888,11 @@ A clean, distraction free and git focused development theme. ##### It currently shows: -* Show the location from git's root folder (when in a git repo) or show from home `~` -* Show current sha() -* Show current branch name -* Show current branch state (dirty, add, remove, delete...) -* Show time from last commit +- Show the location from git's root folder (when in a git repo) or show from home `~` +- Show current sha() +- Show current branch name +- Show current branch state (dirty, add, remove, delete...) +- Show time from last commit See [Repo](https://github.com/lenguyenthanh/nt9-oh-my-zsh-theme) for source. @@ -897,13 +906,13 @@ pretty face, feel more jovial with this theme. It currently shows: -* Show Host and User -* Show current path -* Show development environment segment -* Show git branch, git actions -* Show python venv -* Show time at the line end -* Show exit code at the previous line end +- Show Host and User +- Show current path +- Show development environment segment +- Show git branch, git actions +- Show python venv +- Show time at the line end +- Show exit code at the previous line end See [Repo](https://github.com/zthxxx/jovial) for source. @@ -917,19 +926,19 @@ geometry is a minimalistic, fully customizable zsh prompt theme. ##### What it does: -* work asynchronously to speed up the prompt -* display current git branch -* 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 -* display the number of conflicting files and total number of conflicts -* display the running time of long running commands -* optionally display random colors based on your hostname -* give you a custom, colorizable prompt symbol -* change the prompt symbol color depending on the last command exit status -* show virtualenv and docker machine data -* set the terminal title to current command and directory -* fully customizable, allowing you to change anything through environment variables -* make you the coolest hacker in the whole Starbucks +- work asynchronously to speed up the prompt +- display current git branch +- 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 +- display the number of conflicting files and total number of conflicts +- display the running time of long running commands +- optionally display random colors based on your hostname +- give you a custom, colorizable prompt symbol +- change the prompt symbol color depending on the last command exit status +- show virtualenv and docker machine data +- set the terminal title to current command and directory +- fully customizable, allowing you to change anything through environment variables +- make you the coolest hacker in the whole Starbucks See [repo](https://github.com/frmendes/geometry) for source. We welcome any contributions! @@ -973,10 +982,10 @@ A simple, informative prompt built with Solarized colours in mind. ##### Features -* Customisable colours & output -* Git branch & status display -* Username turns red when root -* Prompt turns red if the last command finishes with non-zero exit code +- Customisable colours & output +- Git branch & status display +- Username turns red when root +- Prompt turns red if the last command finishes with non-zero exit code See [repo](https://github.com/dannynimmo/punctual-zsh-theme) for installation. @@ -1043,7 +1052,7 @@ author: [@marszall87](https://github.com/marszall87) ![imperator theme](https://raw.githubusercontent.com/LinuxGogley/Linux-Mods/master/Shell-Themes/Screenshot_2016-11-28_17-48-18.png) -An adaptation of the mortalscumbag theme. Its modification no longer has the hostname next to the username on the prompt and has a better differentiation of colors by highlighting the user, working directory, and shell sign. The theme also keeps the error number within brackets, as well as a running header stating whether the user is under an ssh connection. +An adaptation of the mortalscumbag theme. Its modification no longer has the hostname next to the username on the prompt and has a better differentiation of colors by highlighting the user, working directory, and shell sign. The theme also keeps the error number within brackets, as well as a running header stating whether the user is under an ssh connection. source: [Repo](https://github.com/LinuxGogley/Linux-Mods/tree/master/Shell-Themes) for source @@ -1071,13 +1080,13 @@ Themes: ##### Features -* Time -* Battery percentage (with charging direction, - discharging, + charging, ● full-charge) -* Username -* Working directory -* Version control - branch, commit hash, dirty status, ahead/behind status -* Supports both mac and linux -* Asynchronously update prompt +- Time +- Battery percentage (with charging direction, - discharging, + charging, ● full-charge) +- Username +- Working directory +- Version control - branch, commit hash, dirty status, ahead/behind status +- Supports both mac and linux +- Asynchronously update prompt See [Repo](https://github.com/eendroroy/alien) for source & documentation. @@ -1089,13 +1098,13 @@ author: [@eendroroy](https://github.com/eendroroy) ##### Features -* Working directory -* Previous command exit status -* Version control - branch, commit hash, dirty status, ahead/behind status -* Supports both mac and linux -* Asynchronously update prompt -* Lots of configuration options -* **AND MANY MORE** +- Working directory +- Previous command exit status +- Version control - branch, commit hash, dirty status, ahead/behind status +- Supports both mac and linux +- Asynchronously update prompt +- Lots of configuration options +- **AND MANY MORE** See [Repo](https://github.com/eendroroy/alien-minimal) for source & documentation. @@ -1139,11 +1148,11 @@ Author: [@dpdornseifer](https://github.com/dpdornseifer) A theme designed for simplicity, neatness and availability of information. Vero offers: -* Timestamp -* Current Node.js version -* Current Git branch and status -* SSH indicator -* A fancy lambda symbol +- Timestamp +- Current Node.js version +- Current Git branch and status +- SSH indicator +- A fancy lambda symbol ![Screenshot of Vero](https://gitlab.com/thornjad/vero/-/raw/main/img/preview.png) @@ -1157,11 +1166,11 @@ Author: [@thornjad](https://github.com/thornjad) ##### Features -* Working directory -* Version control - branch, commit hash, dirty status, ahead/behind status -* java, python, ruby. node versions -* Supports both mac and linux -* Asynchronously update prompt +- Working directory +- Version control - branch, commit hash, dirty status, ahead/behind status +- java, python, ruby. node versions +- Supports both mac and linux +- Asynchronously update prompt See [Repo](https://github.com/eendroroy/theta) for source & documentation. @@ -1173,12 +1182,12 @@ author: [@eendroroy](https://github.com/eendroroy) ##### Features -* Current working directory. -* Clojure, python, and node version numbers, only when you need them. -* Number of seconds the previous command took to run. -* Git branch, dirty & clean. -* Color visuals for vi-mode. -* Clojure, python, and node version numbers, only when you need them. +- Current working directory. +- Clojure, python, and node version numbers, only when you need them. +- Number of seconds the previous command took to run. +- Git branch, dirty & clean. +- Color visuals for vi-mode. +- Clojure, python, and node version numbers, only when you need them. See [repository](https://github.com/w33tmaricich/enlightenment) for source & documentation. @@ -1198,13 +1207,13 @@ ASCII-only ZSH prompt theme (using Oh My Zsh) for git users who are not fan of f Features: -* Works well in terminal or console. No need to change your font! -* Git info: - * Remote url, e.g. github.com/cemsbr/asciigit; - * Relative path from git root dir; - * Branch name; - * Status (diverged, added, untracked, etc...). -* Colors known to work well with solarized light (probably with other schemes, too). +- Works well in terminal or console. No need to change your font! +- Git info: + - Remote url, e.g. github.com/cemsbr/asciigit; + - Relative path from git root dir; + - Branch name; + - 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. @@ -1218,8 +1227,8 @@ Timestamp and new line based on [dpoggi](https://github.com/ohmyzsh/ohmyzsh/wiki 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). @@ -1231,8 +1240,8 @@ Author: [@channprj](https://github.com/channprj) ##### Features -* Current sessions history count -* Exit code in right prompt on error +- Current sessions history count +- Exit code in right prompt on error See [Repo](https://github.com/eendroroy/nothing) for source & documentation. @@ -1242,9 +1251,9 @@ author: [@eendroroy](https://github.com/eendroroy) A theme based on [fishy](https://github.com/ohmyzsh/ohmyzsh/wiki/Themes#fishy) with two differences: -* The full path is shown instead of abbreviated directory names. -* ```$USER@$HOST``` is not shown for the local machine, only for SSH sessions and - inside docker containers (in that case it is ```$USER@docker```) +- The full path is shown instead of abbreviated directory names. +- `$USER@$HOST` is not shown for the local machine, only for SSH sessions and + inside docker containers (in that case it is `$USER@docker`) ![Screenshot of kinda fishy](https://raw.githubusercontent.com/folixg/kinda-fishy-theme/master/screenshot.png) @@ -1415,7 +1424,7 @@ Simple prompt with system clock, current working directory, git prompt info and Source: [halil.zsh-theme](https://github.com/5m0k3r/zsh-themes) -Author: [@5m0k3r](https://github.com/5m0k3r) +Author: [@5m0k3r](https://github.com/5m0k3r) --- @@ -1439,7 +1448,7 @@ Simple is better Source: [maza.zsh-theme](https://github.com/eamazaj/maza-theme) -Author: [@eamazaj](https://github.com/eamazaj) +Author: [@eamazaj](https://github.com/eamazaj) #### Chill @@ -1449,7 +1458,7 @@ Clean and simple look with return status, git status and full path. Source: [chill.zsh-theme](https://github.com/PsychoPatate/chill.zsh-theme) -Author: [@PsychoPatate](https://github.com/PsychoPatate) +Author: [@PsychoPatate](https://github.com/PsychoPatate) #### Solus @@ -1459,7 +1468,7 @@ Simple theme was based on Bira, and influenced by the default Bash PS1 from Solu Source: [solus.zsh-theme](https://gist.github.com/cloudnull/4cc7890acaae6cb809e811e09e9eaade#file-solus-zsh-theme) -Author: [@cloudnull](https://github.com/cloudnull) +Author: [@cloudnull](https://github.com/cloudnull) #### gitstatus @@ -1475,7 +1484,7 @@ Multiline Oh My Zsh theme with git info, virtualenv, vi-mode indicator, current Source: [antsy.zsh-theme](https://github.com/jeffmhubbard/antsy-zsh-theme) -Author: [@jeffmhubbard](https://github.com/jeffmhubbard) +Author: [@jeffmhubbard](https://github.com/jeffmhubbard) #### thm @@ -1503,13 +1512,13 @@ Author: [@catleeball](https://github.com/catleeball) ##### Features: -* emoji git status :) -* fault return indicator -* various customization - * prompt layout - * prompt symbol - * time - * new line after every command +- emoji git status :) +- fault return indicator +- various customization + - prompt layout + - prompt symbol + - time + - new line after every command ![fishbone++](https://github.com/EYH0602/Fishbonepp/blob/master/pics/defaultlook.png) Source: [fishbone++](https://github.com/EYH0602/Fishbonepp) @@ -1519,12 +1528,12 @@ Author: [@EYH0602](https://github.com/EYH0602) ##### Features: -* Simple -* One based on dallas -* a whole collection. -* Easy to customize -* Time marker (ohio2, not ybl) -* Git marker. +- Simple +- One based on dallas +- a whole collection. +- Easy to customize +- Time marker (ohio2, not ybl) +- Git marker. 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) @@ -1541,8 +1550,8 @@ Themes:[Ohio2's themes repo](https://github.com/Ohio2/dotfiles-ohio2/tree/master ##### features: -* a triangular glyph and your working directory, nothing more -* a [matching theme](https://github.com/ice-bear-forever/hyper-bubblegum) for [Hyper](https://hyper.is) terminal +- a triangular glyph and your working directory, nothing more +- a [matching theme](https://github.com/ice-bear-forever/hyper-bubblegum) for [Hyper](https://hyper.is) terminal repository: [bubblegum-zsh](https://github.com/ice-bear-forever/bubblegum-zsh/) @@ -1560,13 +1569,13 @@ author: [@ice-bear-forever](https://github.com/ice-bear-forever/) ##### features: -* shows the current time +- shows the current time -* shows current kubectl context -* shows current dir -* shows current Git branch -* shows an arrow to differentiate input vs prompt -* uses different colors for readability +- shows current kubectl context +- shows current dir +- 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/) @@ -1611,12 +1620,13 @@ A highly customizable zsh theme for your terminal, which is stupidly easy to con - Extensive fool-proof customization by just setting variables - Configurable symbols, prompt segment orders - Can set each and every color manually -- Detects multiple batteries in linux +- Detects multiple batteries in linux ##### Installation + - Install any powerline or nerdfonts. - If you have oh-my-zsh installed, just run install.sh ( with zsh not bash ) -- If you do not have oh-my-zsh, some symbols may not work but most features work, just source the theme file using the `source /path/to/comfyline.zsh-theme` command, and add it to your zshrc +- If you do not have oh-my-zsh, some symbols may not work but most features work, just source the theme file using the `source /path/to/comfyline.zsh-theme` command, and add it to your zshrc [Source Code](https://gitlab.com/imnotpua/comfyline_prompt) is my gitlab Author: [imnotpua](https://gitlab.com/notpua) diff --git a/FAQ.md b/FAQ.md index 261fe8a..5e3c181 100644 --- a/FAQ.md +++ b/FAQ.md @@ -1,28 +1,30 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + _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._ - [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 a zsh plugin?](#what-is-a-zsh-plugin) - - [What is a zsh theme?](#what-is-a-zsh-theme) - - [What is the .zshrc file?](#what-is-the-zshrc-file) - - [What Oh My Zsh is not](#what-oh-my-zsh-is-not) - - [What Zsh is not](#what-zsh-is-not) + - [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 a zsh plugin?](#what-is-a-zsh-plugin) + - [What is a zsh theme?](#what-is-a-zsh-theme) + - [What is the .zshrc file?](#what-is-the-zshrc-file) + - [What Oh My Zsh is not](#what-oh-my-zsh-is-not) + - [What Zsh is not](#what-zsh-is-not) - [How do I...?](#how-do-i) - - [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 Oh My Zsh?](#how-do-i-install-oh-my-zsh) - - [How do I install Oh My Zsh globally?](#how-do-i-install-oh-my-zsh-globally) - - [How do I update Oh My Zsh?](#how-do-i-update-oh-my-zsh) - - [How do I manually update Oh My Zsh from a script?](#how-do-i-manually-update-oh-my-zsh-from-a-script) - - [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 reload the zshrc file?](#how-do-i-reload-the-zshrc-file) - - [How do I reset the completion cache?](#how-do-i-reset-the-completion-cache) + - [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 Oh My Zsh?](#how-do-i-install-oh-my-zsh) + - [How do I install Oh My Zsh globally?](#how-do-i-install-oh-my-zsh-globally) + - [How do I update Oh My Zsh?](#how-do-i-update-oh-my-zsh) + - [How do I manually update Oh My Zsh from a script?](#how-do-i-manually-update-oh-my-zsh-from-a-script) + - [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 reload the zshrc file?](#how-do-i-reload-the-zshrc-file) + - [How do I reset the completion cache?](#how-do-i-reset-the-completion-cache) - [Common problems](#common-problems) - [Installation](#installation) - [I can't access the installer / connection timed out](#i-cant-access-the-installer--connection-timed-out) @@ -38,7 +40,7 @@ _If you don't find what you're looking for, and you think it should be covered b - [zsh: no matches found](#zsh-no-matches-found) - [Some commands no longer work after installing Oh My Zsh](#some-commands-no-longer-work-after-installing-oh-my-zsh) - [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) - [Why is `PUSHD_IGNORE_DUPS` set by default?](#why-is-pushd_ignore_dups-set-by-default) - [Why shouldn't I install Oh My Zsh as root?](#why-shouldnt-i-install-oh-my-zsh-as-root) @@ -48,7 +50,7 @@ _If you don't find what you're looking for, and you think it should be covered b #### What is Oh My Zsh and what does it have to do with zsh? -Zsh is a [shell](https://en.wikipedia.org/wiki/Shell_(computing)), just like [bash](https://www.gnu.org/software/bash/) or [fish](https://fishshell.com/), which interprets commands and runs them. Oh My Zsh is a framework built on top of zsh that is structured to allow it to have plugins and themes, as well as providing what we think are the best settings from the start. You can use zsh without Oh My Zsh, but you can't use Oh My Zsh if you don't have zsh. +Zsh is a [shell](), just like [bash](https://www.gnu.org/software/bash/) or [fish](https://fishshell.com/), which interprets commands and runs them. Oh My Zsh is a framework built on top of zsh that is structured to allow it to have plugins and themes, as well as providing what we think are the best settings from the start. You can use zsh without Oh My Zsh, but you can't use Oh My Zsh if you don't have zsh. #### What is a zsh plugin? @@ -110,12 +112,13 @@ If you'd like to install Oh My Zsh for all the users in a system, you can read t Requirements for a global install: -1. The root of the folder needs to be installed somewhere globally accessible, like `/usr/share/ohmyzsh` or `/opt/ohmyzsh`, with root ownership without global write permissions. +1. The root of the folder needs to be installed somewhere globally accessible, like `/usr/share/ohmyzsh` or `/opt/ohmyzsh`, with root ownership without global write permissions. 2. Every user's `.zshrc` file needs to reference the global `$ZSH` installation, and add the settings there, see more below. 3. Automatic updates are already skipped if there's no write access to the global directory or it's not a git repository, so it is not needed to turn it off manually in every `.zshrc` file. Remember that the global installation will not be updated automatically. **If you have installed it as a git repository**, you can trigger a manual update by running the command below as the root user: + ```sh zsh /usr/share/ohmyzsh/tools/upgrade.sh # or wherever you installed Oh My Zsh ``` @@ -286,7 +289,6 @@ Similar issues: [#11818](https://github.com/ohmyzsh/ohmyzsh/issues/11818) [#11908](https://github.com/ohmyzsh/ohmyzsh/discussions/11908) - #### My .zshrc file was deleted on install The installer script is designed to back up your existing `.zshrc` file, and any previous backups are also preserved. @@ -298,9 +300,9 @@ a. If a `.zshrc` file is not found, write and modify the template zshrc file to b. If otherwise the `.zshrc` exists, start the back up process: - 1. If `~/.zshrc.pre-oh-my-zsh` exists, back it up to `~/.zshrc.pre-oh-my-zsh-`, where `` is in the format `YYYY-mm-dd_HH-MM-SS`. **If this destination file exists, the installer is aborted**. - 2. After `~/.zshrc.pre-oh-my-zsh` is backed up, back up the existing `.zshrc` file to `~/.zshrc.pre-oh-my-zsh`. - 3. **Only then write the template zshrc file to `~/.zshrc`.** +1. If `~/.zshrc.pre-oh-my-zsh` exists, back it up to `~/.zshrc.pre-oh-my-zsh-`, where `` is in the format `YYYY-mm-dd_HH-MM-SS`. **If this destination file exists, the installer is aborted**. +2. After `~/.zshrc.pre-oh-my-zsh` is backed up, back up the existing `.zshrc` file to `~/.zshrc.pre-oh-my-zsh`. +3. **Only then write the template zshrc file to `~/.zshrc`.** As you can see, the installer is designed to never delete any existing files, even if the installer is ran multiple times. If you find that your `.zshrc` file was deleted, you can search for the backup file with the command below: @@ -449,11 +451,11 @@ This might result in errors such as this: zsh: command not found: npm ``` -This applies even if you were using zsh, and not some other shell, prior to installing Oh My Zsh, as your original zshrc is not modified; it's replaced, but backed up before it's installed. If you used zsh prior to installing Oh My Zsh, you can retrieve your old zshrc from `~/.zshrc.pre-oh-my-zsh`, and copy the changes you made from there. +This applies even if you were using zsh, and not some other shell, prior to installing Oh My Zsh, as your original zshrc is not modified; it's replaced, but backed up before it's installed. If you used zsh prior to installing Oh My Zsh, you can retrieve your old zshrc from `~/.zshrc.pre-oh-my-zsh`, and copy the changes you made from there. -If you weren't using zsh before, you need to copy over any changes to the PATH from the config file for your previous shell. Note that certain programs, such as Anaconda, may have initialisation functions that are shell-dependent, and that cannot be copied directly. For these, it's recommended you try to re-initialise the config using the software's own installation/initialisation system. For example, for Anaconda, you can use `conda init zsh` to regenerate the initialisation block correctly. See the documentation for the specific software you're using for more details about your alternatives when changing shells. +If you weren't using zsh before, you need to copy over any changes to the PATH from the config file for your previous shell. Note that certain programs, such as Anaconda, may have initialisation functions that are shell-dependent, and that cannot be copied directly. For these, it's recommended you try to re-initialise the config using the software's own installation/initialisation system. For example, for Anaconda, you can use `conda init zsh` to regenerate the initialisation block correctly. See the documentation for the specific software you're using for more details about your alternatives when changing shells. -However, in most cases, it's enough to look at your old config files, find any and all `export PATH="some string here"` (where "some string here" is a placeholder for actual PATH changes), and copy those back into your current `.zshrc`. +However, in most cases, it's enough to look at your old config files, find any and all `export PATH="some string here"` (where "some string here" is a placeholder for actual PATH changes), and copy those back into your current `.zshrc`. ## Other problems diff --git a/Home.md b/Home.md index 3ff1ad0..9216b9b 100644 --- a/Home.md +++ b/Home.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ +

Oh My Zsh

@@ -18,7 +20,7 @@ Oh My Zsh is an open source, community-driven framework for managing your [zsh]( - Once you have zsh, you can install Oh My Zsh by simply running one of these commands: | Method | Command | - |:----------|:--------------------------------------------------------------------------------------------------| + | :-------- | :------------------------------------------------------------------------------------------------ | | **curl** | `sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"` | | **wget** | `sh -c "$(wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"` | | **fetch** | `sh -c "$(fetch -o - https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"` | diff --git a/Installing-ZSH.md b/Installing-ZSH.md index f443a2f..00f095f 100644 --- a/Installing-ZSH.md +++ b/Installing-ZSH.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + ## Zsh? @@ -27,14 +29,14 @@ If necessary, follow these steps to install Zsh: If you are on Fedora, use `sudo chsh $USER` for recent versions or `sudo lchsh $USER` for older versions. - 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). - If you run just `chsh` you need to type `/bin/zsh` to make it your default shell. -5. 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. -6. 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. -7. 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 @@ -55,7 +57,7 @@ To set zsh as your default shell, execute the following assuming a default insta ```sh chsh -s $(which zsh) ``` - + For intel macs: ```sh @@ -68,14 +70,14 @@ To set zsh as your default shell, execute the following assuming a default insta chsh -s /bin/zsh ``` -If you get an error for non-stadard shell you can try running first +If you get an error for non-stadard shell you can try running first ```sh sudo sh -c "echo $(which zsh) >> /etc/shells" ``` Assuming you have [Homebrew](https://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 also use [MacPorts](https://www.macports.org/) ```sh @@ -169,7 +171,7 @@ 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/". -*Alternatively:* +_Alternatively:_ Open Cygwin (in BASH) then type: ```sh diff --git a/Plugin:git.md b/Plugin:git.md index d4fff1d..08f38a1 100644 --- a/Plugin:git.md +++ b/Plugin:git.md @@ -1,4 +1,6 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + [See git plugin README](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git/) diff --git a/Plugin:svn.md b/Plugin:svn.md index 8d67312..97f97f8 100644 --- a/Plugin:svn.md +++ b/Plugin:svn.md @@ -1,4 +1,6 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + [See svn plugin README](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/svn/) diff --git a/Plugins-Overview.md b/Plugins-Overview.md index c7b5110..7f5a58b 100644 --- a/Plugins-Overview.md +++ b/Plugins-Overview.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + - [Productivity](#productivity) - [Password Managers](#password-managers) diff --git a/Plugins.md b/Plugins.md index 9ec6277..4492638 100644 --- a/Plugins.md +++ b/Plugins.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + Oh My Zsh comes bundled with plugins, which allow you to take advantage of functionality of many sorts to your shell just by enabling them. They are each documented in the README file in their respective `plugins/` folder. @@ -347,7 +349,7 @@ plugins=(rails git ruby) - [vundle](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/vundle): this plugin adds functions to control [vundle](https://github.com/VundleVim/Vundle.vim) plug-in manager for vim. - [wakeonlan](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/wakeonlan): this plugin provides a wrapper around the "wakeonlan" tool available from most distributions' package repositories, or from [the following website](https://github.com/jpoliv/wakeonlan). - [watson](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/watson): this plugin provides completion for [Watson](https://tailordev.github.io/Watson/). -- [wd](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/wd): `wd` (*warp directory*) lets you jump to custom directories in zsh, without using `cd`. Why? Because `cd` seems inefficient when the folder is frequently visited or has a long path. +- [wd](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/wd): `wd` (_warp directory_) lets you jump to custom directories in zsh, without using `cd`. Why? Because `cd` seems inefficient when the folder is frequently visited or has a long path. - [web-search](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/web-search): this plugin adds aliases for searching with Google, Wiki, Bing, YouTube and other popular services. - [wp-cli](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/wp-cli): the [WordPress CLI](https://wp-cli.org/) is a command-line tool for managing WordPress installations. You can update plugins, set up multisite installs and much more, without using a web browser. - [xcode](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/xcode): this plugin provides a few utilities that can help you on your daily use of Xcode and iOS development. diff --git a/Resources.md b/Resources.md index ee90623..6a58098 100644 --- a/Resources.md +++ b/Resources.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + ### These are a few resources for Oh My Zsh @@ -31,7 +33,7 @@ **The `zsh-users` list is for asking questions as a user; the `zsh-workers` list is for asking questions as a developer of Zsh code**. - + I recommend joining the `zsh-workers` list and periodically reading the emails to push your knowledge further, even if sometimes you don't understand what you're reading. You can also use it to search if your question has already been answered by adding `site:https://zsh.org/mla` to your Google search. diff --git a/Settings.md b/Settings.md index faa0dfe..8dcb868 100644 --- a/Settings.md +++ b/Settings.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + # Settings @@ -167,7 +169,7 @@ Migrate to the `zstyle` settings while you still can. - `DISABLE_AUTO_UPDATE=true`: if set, it has the same effect as setting -[**`disabled` mode** in the new zstyle format](#omzupdate-mode). Instead, use: + [**`disabled` mode** in the new zstyle format](#omzupdate-mode). Instead, use: ```zsh zstyle ':omz:update' mode disabled @@ -176,7 +178,7 @@ Migrate to the `zstyle` settings while you still can. - `DISABLE_UPDATE_PROMPT=true`: if set, it has the same effect as setting -[**`auto` mode** in the new zstyle format](#omzupdate-mode). Instead, use: + [**`auto` mode** in the new zstyle format](#omzupdate-mode). Instead, use: ```zsh zstyle ':omz:update' mode auto @@ -185,11 +187,11 @@ Migrate to the `zstyle` settings while you still can. - `UPDATE_ZSH_DAYS=`: if set, it has the same effect as setting -[**`frequency `** in the new zstyle format](#omzupdate-frequency). Instead, use: + [**`frequency `** in the new zstyle format](#omzupdate-frequency). Instead, use: - ```zsh - zstyle ':omz:update' frequency - ``` + ```zsh + zstyle ':omz:update' frequency + ``` ## Completion settings diff --git a/Testimonials.md b/Testimonials.md index 7a80d8b..91d4f0f 100644 --- a/Testimonials.md +++ b/Testimonials.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + Please share your thoughts on Oh My Zsh... they might help influence others to use and/or avoid it like the black plague. @@ -7,127 +9,127 @@ Please share your thoughts on Oh My Zsh... they might help influence others to u > > -- **[@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) ----- +--- > 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: 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) ----- +--- > 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) ----- +--- > 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) ----- +--- > 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](https://sohamchowdhury.com/) ----- +--- > Oh My Zsh 很贴心，让 Zsh 配置变得更加简单，它让我享受到了比以往更加美丽的终端！ > > -- [@tuhaihe](https://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! > diff --git a/Themes-(legacy).md b/Themes-(legacy).md index 30ce49a..f7c9004 100644 --- a/Themes-(legacy).md +++ b/Themes-(legacy).md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + All the current themes can be found in the `themes/` directory in the Oh My Zsh distribution. [See list here.](https://github.com/ohmyzsh/ohmyzsh/tree/master/themes/) @@ -11,18 +13,21 @@ Here is a collection of screenshots and descriptions of themes that have been co ## The Themes ### robbyrussell -*the (default) that Robby uses* + +_the (default) that Robby uses_ [![robbyrussell](https://cloud.githubusercontent.com/assets/2618447/6316876/710cbb8c-ba03-11e4-90b3-0315d72f270c.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316876/710cbb8c-ba03-11e4-90b3-0315d72f270c.jpg) ------------------------------------- +--- The rest of the themes, in alphabetical order: ### af-magic + [![af-magic](https://user-images.githubusercontent.com/145113/73003386-8f500000-3dd3-11ea-8710-657fac00d4ad.png)](https://user-images.githubusercontent.com/145113/73003386-8f500000-3dd3-11ea-8710-657fac00d4ad.png) ### afowler + [![afowler](https://cloud.githubusercontent.com/assets/2618447/6316859/70f1cb06-ba03-11e4-865f-209473ddd5c8.png)](https://cloud.githubusercontent.com/assets/2618447/6316859/70f1cb06-ba03-11e4-865f-209473ddd5c8.png) ### agnoster @@ -36,137 +41,173 @@ Shown with [Solarized Dark colorscheme](https://ethanschoonover.com/solarized) a 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. -- *Optionally* to hide the “user@hostname” info when you’re logged in as yourself on your local machine, add `prompt_context(){}` at the bottom of your `~/.zshrc`. See [here](https://github.com/agnoster/agnoster-zsh-theme/issues/39#issuecomment-307338817) to learn how to only show your username instead. +- _Optionally_ to hide the “user@hostname” info when you’re logged in as yourself on your local machine, add `prompt_context(){}` at the bottom of your `~/.zshrc`. See [here](https://github.com/agnoster/agnoster-zsh-theme/issues/39#issuecomment-307338817) to learn how to only show your username instead. ### alanpeabody -[![alanpeabody](https://cloud.githubusercontent.com/assets/2618447/6316714/5190b8ba-ba00-11e4-8fa9-9f22160be9e4.png)](https://cloud.githubusercontent.com/assets/2618447/6316714/5190b8ba-ba00-11e4-8fa9-9f22160be9e4.png) +[![alanpeabody](https://cloud.githubusercontent.com/assets/2618447/6316714/5190b8ba-ba00-11e4-8fa9-9f22160be9e4.png)](https://cloud.githubusercontent.com/assets/2618447/6316714/5190b8ba-ba00-11e4-8fa9-9f22160be9e4.png) ### amuse + [![amuse](https://cloud.githubusercontent.com/assets/2618447/6316861/70f3c4ce-ba03-11e4-88a5-0b423dd5a2ce.png)](https://cloud.githubusercontent.com/assets/2618447/6316861/70f3c4ce-ba03-11e4-88a5-0b423dd5a2ce.png) 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). ### arrow + [![arrow](https://cloud.githubusercontent.com/assets/2618447/6316717/51a09e7e-ba00-11e4-8120-45ca128b9bf6.png)](https://cloud.githubusercontent.com/assets/2618447/6316717/51a09e7e-ba00-11e4-8120-45ca128b9bf6.png) ### aussiegeek + [![aussiegeek](https://cloud.githubusercontent.com/assets/2618447/6316719/51a34962-ba00-11e4-9577-882124c30b4e.png)](https://cloud.githubusercontent.com/assets/2618447/6316719/51a34962-ba00-11e4-9577-882124c30b4e.png) ### avit + [![avit](https://cloud.githubusercontent.com/assets/2618447/6316718/51a2fd9a-ba00-11e4-845a-24bed6ae9210.png)](https://cloud.githubusercontent.com/assets/2618447/6316718/51a2fd9a-ba00-11e4-845a-24bed6ae9210.png) ### awesomepanda -[![awesomepanda](https://cloud.githubusercontent.com/assets/760855/18191406/2cb2e21e-70f4-11e6-83f0-42096ff33cfd.png)](https://cloud.githubusercontent.com/assets/760855/18191406/2cb2e21e-70f4-11e6-83f0-42096ff33cfd.png) +[![awesomepanda](https://cloud.githubusercontent.com/assets/760855/18191406/2cb2e21e-70f4-11e6-83f0-42096ff33cfd.png)](https://cloud.githubusercontent.com/assets/760855/18191406/2cb2e21e-70f4-11e6-83f0-42096ff33cfd.png) ### bira + [![bira](https://cloud.githubusercontent.com/assets/2618447/6316716/51a0708e-ba00-11e4-8664-11a804f2fe3f.png)](https://cloud.githubusercontent.com/assets/2618447/6316716/51a0708e-ba00-11e4-8664-11a804f2fe3f.png) ### blinks + [![blinks](https://cloud.githubusercontent.com/assets/2618447/6316715/519c8e56-ba00-11e4-9792-a4b3d1d3775a.png)](https://cloud.githubusercontent.com/assets/2618447/6316715/519c8e56-ba00-11e4-9792-a4b3d1d3775a.png) Additional setup: Set up [Solarized](https://ethanschoonover.com/solarized). ### bureau + [![bureau](https://cloud.githubusercontent.com/assets/2618447/6316720/51a54ba4-ba00-11e4-82d2-f2af8cc18869.png)](https://cloud.githubusercontent.com/assets/2618447/6316720/51a54ba4-ba00-11e4-82d2-f2af8cc18869.png) To use: In the right prompt you see git status and (if you use nvm) the Node.js version. (I’m using the [Solarized](https://ethanschoonover.com/solarized) color scheme in this screenshot.) ### candy + [![candy](https://cloud.githubusercontent.com/assets/2618447/6316863/70f5b87e-ba03-11e4-8ee5-65345537e0bf.png)](https://cloud.githubusercontent.com/assets/2618447/6316863/70f5b87e-ba03-11e4-8ee5-65345537e0bf.png) ### clean + [![clean](https://cloud.githubusercontent.com/assets/2618447/6316721/51af13a0-ba00-11e4-87ea-cf83f32010f0.png)](https://cloud.githubusercontent.com/assets/2618447/6316721/51af13a0-ba00-11e4-87ea-cf83f32010f0.png) ### cloud + [![cloud](https://cloud.githubusercontent.com/assets/2618447/6316723/51b24944-ba00-11e4-8dcb-cb09a198523e.png)](https://cloud.githubusercontent.com/assets/2618447/6316723/51b24944-ba00-11e4-8dcb-cb09a198523e.png) ### crunch + [![crunch](https://cloud.githubusercontent.com/assets/2618447/6316722/51b1f4b2-ba00-11e4-9ebf-1359aa272fbd.png)](https://cloud.githubusercontent.com/assets/2618447/6316722/51b1f4b2-ba00-11e4-9ebf-1359aa272fbd.png) ### cypher + [![cypher](https://cloud.githubusercontent.com/assets/2618447/6316864/70f5c09e-ba03-11e4-90c3-c539e09c6cc9.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316864/70f5c09e-ba03-11e4-90c3-c539e09c6cc9.jpg) ### dallas + [![dallas](https://cloud.githubusercontent.com/assets/2618447/6316725/51b39b28-ba00-11e4-942e-600c704a8180.png)](https://cloud.githubusercontent.com/assets/2618447/6316725/51b39b28-ba00-11e4-942e-600c704a8180.png) ### darkblood + [![darkblood](https://cloud.githubusercontent.com/assets/2618447/6316865/70fa9006-ba03-11e4-81c4-593d9ae34a9c.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316865/70fa9006-ba03-11e4-81c4-593d9ae34a9c.jpg) ### daveverwer + [![daveverwer](https://cloud.githubusercontent.com/assets/2618447/6317506/faa0ca2a-ba24-11e4-9c34-ffa83f0cca23.png)](https://cloud.githubusercontent.com/assets/2618447/6317506/faa0ca2a-ba24-11e4-9c34-ffa83f0cca23.png) ### dieter + [![dieter](https://cloud.githubusercontent.com/assets/2618447/6316724/51b2886e-ba00-11e4-805f-c622567608e3.png)](https://cloud.githubusercontent.com/assets/2618447/6316724/51b2886e-ba00-11e4-805f-c622567608e3.png) Additional setup: Get this small [[fix|https://github.com/Dieterbe/oh-my-zsh/commit/7ca0afd6861fe0c9e6903a08f0e469746df627e0]] if you don’t have it yet. (Fix was [[pulled|https://github.com/ohmyzsh/ohmyzsh/commit/8294cf44d1d348fd1590ee28b5be8483fb012153]] into ohmyzsh/ohmyzsh on 2011-01-08.) ### dogenpunk + [![dogenpunk](https://cloud.githubusercontent.com/assets/2618447/6316727/51b8067c-ba00-11e4-8e59-722a79ec60c2.png)](https://cloud.githubusercontent.com/assets/2618447/6316727/51b8067c-ba00-11e4-8e59-722a79ec60c2.png) ### dpoggi + [![dpoggi](https://cloud.githubusercontent.com/assets/2618447/6316730/51bca236-ba00-11e4-810d-ab3e9365c56b.png)](https://cloud.githubusercontent.com/assets/2618447/6316730/51bca236-ba00-11e4-810d-ab3e9365c56b.png) ### eastwood + [![eastwood](https://cloud.githubusercontent.com/assets/2618447/6316728/51ba0026-ba00-11e4-9d83-435c3c4513cf.png)](https://cloud.githubusercontent.com/assets/2618447/6316728/51ba0026-ba00-11e4-9d83-435c3c4513cf.png) ### evan -*a minimal prompt* + +_a minimal prompt_ [![evan](https://cloud.githubusercontent.com/assets/2618447/6316867/70fc6e44-ba03-11e4-8537-9a77378e6c48.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316867/70fc6e44-ba03-11e4-8537-9a77378e6c48.jpg) ### fishy + The fish shell prompt with git support [![fishy](https://cloud.githubusercontent.com/assets/1441704/6315377/3ee891ce-ba00-11e4-92cc-885bc3c96c6e.png)](https://cloud.githubusercontent.com/assets/1441704/6315377/3ee891ce-ba00-11e4-92cc-885bc3c96c6e.png) ### flazz + Has git and vi-command mode support (when enabled) [![flazz](https://cloud.githubusercontent.com/assets/2618447/6316729/51bc9fac-ba00-11e4-9e4b-cb0612d5f440.png)](https://cloud.githubusercontent.com/assets/2618447/6316729/51bc9fac-ba00-11e4-9e4b-cb0612d5f440.png) ### frisk + [![frisk](https://cloud.githubusercontent.com/assets/2618447/6316732/51bdd21e-ba00-11e4-97ac-0fdda49fe3c2.png)](https://cloud.githubusercontent.com/assets/2618447/6316732/51bdd21e-ba00-11e4-97ac-0fdda49fe3c2.png) ### funky + it’s funky… [![funky](https://cloud.githubusercontent.com/assets/1441704/6315381/55ccfdb2-ba00-11e4-9fd1-86623b5bba17.png)](https://cloud.githubusercontent.com/assets/1441704/6315381/55ccfdb2-ba00-11e4-9fd1-86623b5bba17.png) ### gallifrey + [![gallifrey](https://cloud.githubusercontent.com/assets/2618447/6316866/70fc3f8c-ba03-11e4-888a-baef9f609c56.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316866/70fc3f8c-ba03-11e4-888a-baef9f609c56.jpg) ### gallois + [![gallois](https://cloud.githubusercontent.com/assets/2618447/6316731/51bd3b88-ba00-11e4-9c58-e09a3965e0f0.png)](https://cloud.githubusercontent.com/assets/2618447/6316731/51bd3b88-ba00-11e4-9c58-e09a3965e0f0.png) ### garyblessington + [![garyblessington](https://cloud.githubusercontent.com/assets/2618447/6316868/7100520c-ba03-11e4-9357-07472942ad5e.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316868/7100520c-ba03-11e4-9357-07472942ad5e.jpg) ### gentoo + [![gentoo](https://cloud.githubusercontent.com/assets/2618447/6316733/51c0f390-ba00-11e4-876d-70a95b5d629b.png)](https://cloud.githubusercontent.com/assets/2618447/6316733/51c0f390-ba00-11e4-876d-70a95b5d629b.png) ### geoffgarside + [![geoffgarside](https://cloud.githubusercontent.com/assets/1441704/6315385/701d32e0-ba00-11e4-8c31-ab30a0fd6324.png)](https://cloud.githubusercontent.com/assets/1441704/6315385/701d32e0-ba00-11e4-8c31-ab30a0fd6324.png) ### gianu + [![gianu](https://cloud.githubusercontent.com/assets/2618447/6316736/51c6a6c8-ba00-11e4-8b5f-b45795d98907.png)](https://cloud.githubusercontent.com/assets/2618447/6316736/51c6a6c8-ba00-11e4-8b5f-b45795d98907.png) ### gnzh + [![gnzh](https://cloud.githubusercontent.com/assets/2618447/6316735/51c62b1c-ba00-11e4-8107-fb532db89c7d.png)](https://cloud.githubusercontent.com/assets/2618447/6316735/51c62b1c-ba00-11e4-8107-fb532db89c7d.png) ### imajes + [![imajes](https://cloud.githubusercontent.com/assets/2618447/6316870/710289f0-ba03-11e4-9482-25742645379d.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316870/710289f0-ba03-11e4-9482-25742645379d.jpg) ### jnrowe + [![jnrowe](https://cloud.githubusercontent.com/assets/2618447/6316737/51c7104a-ba00-11e4-9875-ca6652e45fb5.png)](https://cloud.githubusercontent.com/assets/2618447/6316737/51c7104a-ba00-11e4-9875-ca6652e45fb5.png) ### jreese + [![jreese](https://cloud.githubusercontent.com/assets/2618447/6316734/51c54d82-ba00-11e4-882e-695dd5570528.png)](https://cloud.githubusercontent.com/assets/2618447/6316734/51c54d82-ba00-11e4-882e-695dd5570528.png) ### jtriley + [![jtriley](https://cloud.githubusercontent.com/assets/2618447/6316738/51c836c8-ba00-11e4-87a9-667ccbcbbd30.png)](https://cloud.githubusercontent.com/assets/2618447/6316738/51c836c8-ba00-11e4-87a9-667ccbcbbd30.png) ### juanghurtado + [![juanghurtado](https://cloud.githubusercontent.com/assets/2618447/6316739/51cc2814-ba00-11e4-9d4a-1dca9961d906.png)](https://cloud.githubusercontent.com/assets/2618447/6316739/51cc2814-ba00-11e4-9d4a-1dca9961d906.png) ### junkfood @@ -178,166 +219,213 @@ it’s funky… [+info](https://tylercipriani.com/2012/12/18/zsh-prompt-customization.html) ### kafeitu + [![kafeitu](https://cloud.githubusercontent.com/assets/2618447/6316741/51cec254-ba00-11e4-8433-a3c2524086c1.png)](https://cloud.githubusercontent.com/assets/2618447/6316741/51cec254-ba00-11e4-8433-a3c2524086c1.png) ### kardan + [![kardan](https://cloud.githubusercontent.com/assets/2618447/6316740/51ce9356-ba00-11e4-80c1-79e0b489cd32.png)](https://cloud.githubusercontent.com/assets/2618447/6316740/51ce9356-ba00-11e4-80c1-79e0b489cd32.png) ### kennethreitz + [![kennethreitz](https://cloud.githubusercontent.com/assets/2618447/6316742/51cfb3e4-ba00-11e4-8e8e-720bab641edd.png)](https://cloud.githubusercontent.com/assets/2618447/6316742/51cfb3e4-ba00-11e4-8e8e-720bab641edd.png) ### kolo + [![kolo](https://cloud.githubusercontent.com/assets/2618447/6316743/51d066ea-ba00-11e4-850c-6527b01d8ef5.png)](https://cloud.githubusercontent.com/assets/2618447/6316743/51d066ea-ba00-11e4-850c-6527b01d8ef5.png) ### kphoen + [![kphoen](https://cloud.githubusercontent.com/assets/2618447/6316871/7103ea8e-ba03-11e4-977d-255b34aabe53.png)](https://cloud.githubusercontent.com/assets/2618447/6316871/7103ea8e-ba03-11e4-977d-255b34aabe53.png) ### lambda + [![lambda](https://cloud.githubusercontent.com/assets/2618447/6316744/51d09ba6-ba00-11e4-9e41-e942ee626bae.png)](https://cloud.githubusercontent.com/assets/2618447/6316744/51d09ba6-ba00-11e4-9e41-e942ee626bae.png) ### linuxonly + [![linuxonly](https://cloud.githubusercontent.com/assets/2618447/6316745/51dab9ba-ba00-11e4-853b-7ea8ab5ced35.png)](https://cloud.githubusercontent.com/assets/2618447/6316745/51dab9ba-ba00-11e4-853b-7ea8ab5ced35.png) (As the name states, this only works on linux.) ### lukerandall + [![lukerandall](https://cloud.githubusercontent.com/assets/2618447/6316747/51db7bca-ba00-11e4-8018-6838f2bec7da.png)](https://cloud.githubusercontent.com/assets/2618447/6316747/51db7bca-ba00-11e4-8018-6838f2bec7da.png) ### macovsky + [![macovsky](https://cloud.githubusercontent.com/assets/2618447/6316872/71047346-ba03-11e4-8a49-2d83c4437b81.png)](https://cloud.githubusercontent.com/assets/2618447/6316872/71047346-ba03-11e4-8a49-2d83c4437b81.png) ### maran + [![maran](https://cloud.githubusercontent.com/assets/1441704/6315389/7df9c496-ba00-11e4-8386-027d324255c4.png)](https://cloud.githubusercontent.com/assets/1441704/6315389/7df9c496-ba00-11e4-8386-027d324255c4.png) ### mh + [![mh](https://cloud.githubusercontent.com/assets/2618447/6316746/51db6d92-ba00-11e4-988c-6c89eb581c8c.png)](https://cloud.githubusercontent.com/assets/2618447/6316746/51db6d92-ba00-11e4-988c-6c89eb581c8c.png) ### michelebologna + [![michelebologna](https://cloud.githubusercontent.com/assets/530992/7785021/34c45cea-017d-11e5-964f-10f99d4a5d37.png)](https://cloud.githubusercontent.com/assets/530992/7785021/34c45cea-017d-11e5-964f-10f99d4a5d37.png) ### miloshadzic + [![miloshadzic](https://cloud.githubusercontent.com/assets/2618447/6316748/51dc1eae-ba00-11e4-843d-379183044762.png)](https://cloud.githubusercontent.com/assets/2618447/6316748/51dc1eae-ba00-11e4-843d-379183044762.png) ### minimal + [![minimal](https://cloud.githubusercontent.com/assets/2618447/6316749/51de4ad0-ba00-11e4-8b4e-42e7000bad53.png)](https://cloud.githubusercontent.com/assets/2618447/6316749/51de4ad0-ba00-11e4-8b4e-42e7000bad53.png) ### mortalscumbag + also tells you when logged in over ssh [![mortalscumbag](https://cloud.githubusercontent.com/assets/2618447/6316750/51dee102-ba00-11e4-8ede-27627cd495f9.png)](https://cloud.githubusercontent.com/assets/2618447/6316750/51dee102-ba00-11e4-8ede-27627cd495f9.png) ### mrtazz + [![mrtazz](https://cloud.githubusercontent.com/assets/2618447/6316873/71057cc8-ba03-11e4-911a-53d085b1894e.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316873/71057cc8-ba03-11e4-911a-53d085b1894e.jpg) ### muse + [![muse](https://cloud.githubusercontent.com/assets/2618447/6316752/51e211a6-ba00-11e4-8f57-e82fcc4a453f.png)](https://cloud.githubusercontent.com/assets/2618447/6316752/51e211a6-ba00-11e4-8f57-e82fcc4a453f.png) ### nanotech + [![nanotech](https://cloud.githubusercontent.com/assets/2618447/6316751/51e187c2-ba00-11e4-8a7e-1a45e4df00bf.png)](https://cloud.githubusercontent.com/assets/2618447/6316751/51e187c2-ba00-11e4-8a7e-1a45e4df00bf.png) ### nebirhos + [![nebirhos](https://cloud.githubusercontent.com/assets/2618447/6316754/51e4a182-ba00-11e4-8cf1-65ff1511da34.png)](https://cloud.githubusercontent.com/assets/2618447/6316754/51e4a182-ba00-11e4-8cf1-65ff1511da34.png) ### nicoulaj + [![nicoulaj](https://cloud.githubusercontent.com/assets/2618447/6316755/51e4b0c8-ba00-11e4-85ef-3e7faeeb0e0b.png)](https://cloud.githubusercontent.com/assets/2618447/6316755/51e4b0c8-ba00-11e4-85ef-3e7faeeb0e0b.png) ### norm + [![norm](https://cloud.githubusercontent.com/assets/1441704/11986491/65c9c702-a9d0-11e5-8393-ce262988ab09.png)](https://cloud.githubusercontent.com/assets/1441704/11986491/65c9c702-a9d0-11e5-8393-ce262988ab09.png) ### philips + [![philips](https://cloud.githubusercontent.com/assets/2618447/6316874/710a1e22-ba03-11e4-91c4-30f195e3fa2f.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316874/710a1e22-ba03-11e4-91c4-30f195e3fa2f.jpg) ### pygmalion + [![pygmalion](https://cloud.githubusercontent.com/assets/2618447/6316756/51e859ee-ba00-11e4-8b58-2f086c491926.png)](https://cloud.githubusercontent.com/assets/2618447/6316756/51e859ee-ba00-11e4-8b58-2f086c491926.png) (Shown with [Solarized Dark colorscheme](https://ethanschoonover.com/solarized).) ### risto + [![risto](https://cloud.githubusercontent.com/assets/1441704/6315405/18aa274c-ba01-11e4-8bb7-0ba9ca166974.png)](https://cloud.githubusercontent.com/assets/1441704/6315405/18aa274c-ba01-11e4-8bb7-0ba9ca166974.png) ### rixius + [![rixius](https://cloud.githubusercontent.com/assets/2618447/6316760/51efdeb2-ba00-11e4-8da6-a839f192a207.png)](https://cloud.githubusercontent.com/assets/2618447/6316760/51efdeb2-ba00-11e4-8da6-a839f192a207.png) ### rkj-repos + [![rkj-repos](https://cloud.githubusercontent.com/assets/2618447/6316757/51ee9e12-ba00-11e4-86d4-1d59a182f688.png)](https://cloud.githubusercontent.com/assets/2618447/6316757/51ee9e12-ba00-11e4-86d4-1d59a182f688.png) [![rkj-repos-2](https://cloud.githubusercontent.com/assets/2618447/6316875/710b063e-ba03-11e4-9e22-ecb86da25f46.png)](https://cloud.githubusercontent.com/assets/2618447/6316875/710b063e-ba03-11e4-9e22-ecb86da25f46.png) ### sammy + [![sammy](https://cloud.githubusercontent.com/assets/2618447/6316759/51ef7a44-ba00-11e4-9c76-e9bb6e75f5ce.png)](https://cloud.githubusercontent.com/assets/2618447/6316759/51ef7a44-ba00-11e4-9c76-e9bb6e75f5ce.png) ### simple + [![simple](https://cloud.githubusercontent.com/assets/2618447/6316758/51ef3480-ba00-11e4-840c-a9ebec42f4b6.png)](https://cloud.githubusercontent.com/assets/2618447/6316758/51ef3480-ba00-11e4-840c-a9ebec42f4b6.png) ### smt + [![smt](https://cloud.githubusercontent.com/assets/2618447/6316761/51f0052c-ba00-11e4-990f-cdf7fc5610e6.png)](https://cloud.githubusercontent.com/assets/2618447/6316761/51f0052c-ba00-11e4-990f-cdf7fc5610e6.png) ### sorin + [![sorin](https://cloud.githubusercontent.com/assets/2618447/6316762/51f34624-ba00-11e4-948a-6ac65a49f8c5.png)](https://cloud.githubusercontent.com/assets/2618447/6316762/51f34624-ba00-11e4-948a-6ac65a49f8c5.png) ### sporty_256 + ![sporty_256](https://cloud.githubusercontent.com/assets/2618447/6316763/51f8f2e0-ba00-11e4-82fe-40c9a5a81569.png) ### steeef + [![steeef](https://cloud.githubusercontent.com/assets/2618447/6316764/51f98994-ba00-11e4-9083-ecec290a8dcb.png)](https://cloud.githubusercontent.com/assets/2618447/6316764/51f98994-ba00-11e4-9083-ecec290a8dcb.png) ### sunaku + exit status if nonzero, status & branch if git, `pwd` always [![sunaku](https://cloud.githubusercontent.com/assets/1441704/6315408/4599c546-ba01-11e4-8ba0-591dc9433f7f.png)](https://cloud.githubusercontent.com/assets/1441704/6315408/4599c546-ba01-11e4-8ba0-591dc9433f7f.png) ### sunrise + Lightweight prompt with exit status and `git status` consistent mode line [![sunrise](https://cloud.githubusercontent.com/assets/2618447/6316766/51fbf062-ba00-11e4-9b66-2b0da5a0dbbc.png)](https://cloud.githubusercontent.com/assets/2618447/6316766/51fbf062-ba00-11e4-9b66-2b0da5a0dbbc.png) ### superjarin + 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). [![superjarin](https://cloud.githubusercontent.com/assets/2618447/6316765/51fac93a-ba00-11e4-95bc-e2eea4e98c8b.png)](https://cloud.githubusercontent.com/assets/2618447/6316765/51fac93a-ba00-11e4-95bc-e2eea4e98c8b.png) ### suvash + username, host, directory, git branch and rvm gemset [![suvash](https://cloud.githubusercontent.com/assets/2618447/6316877/710d06be-ba03-11e4-8942-d6d28c54ff74.png)](https://cloud.githubusercontent.com/assets/2618447/6316877/710d06be-ba03-11e4-8942-d6d28c54ff74.png) ### terminalparty + There is a party every day. [![terminalparty](https://cloud.githubusercontent.com/assets/2618447/6316767/51fc28fc-ba00-11e4-9129-953048acce0a.png)](https://cloud.githubusercontent.com/assets/2618447/6316767/51fc28fc-ba00-11e4-9129-953048acce0a.png) ### theunraveler + Minimal, informative when it needs to be. [![theunraveler](https://cloud.githubusercontent.com/assets/1441704/6315413/6d28ed9e-ba01-11e4-98ad-7ae9a713e95c.png)](https://cloud.githubusercontent.com/assets/1441704/6315413/6d28ed9e-ba01-11e4-98ad-7ae9a713e95c.png) ### tjkirch + Based on dst, plus a lightning bolt and return codes. [![tjkirch](https://cloud.githubusercontent.com/assets/2618447/6316768/520565e8-ba00-11e4-98ad-4665f72882ac.png)](https://cloud.githubusercontent.com/assets/2618447/6316768/520565e8-ba00-11e4-98ad-4665f72882ac.png) ### tonotdo + [![tonotdo](https://cloud.githubusercontent.com/assets/2618447/6316878/710deab6-ba03-11e4-8897-52154d993ad8.jpg)](https://cloud.githubusercontent.com/assets/2618447/6316878/710deab6-ba03-11e4-8897-52154d993ad8.jpg) ### trapd00r + [![trapd00r](https://cloud.githubusercontent.com/assets/2618447/6316879/710ec8dc-ba03-11e4-923a-580d6682a3bf.png)](https://cloud.githubusercontent.com/assets/2618447/6316879/710ec8dc-ba03-11e4-923a-580d6682a3bf.png) ### wedisagree + [![wedisagree](https://cloud.githubusercontent.com/assets/2618447/6316769/5205cc54-ba00-11e4-9d2b-e7b632f74997.png)](https://cloud.githubusercontent.com/assets/2618447/6316769/5205cc54-ba00-11e4-9d2b-e7b632f74997.png) Instructions to further customize the theme are available as comments in the theme file. ### wezm + [![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) ### wuffers + [![wuffers](https://cloud.githubusercontent.com/assets/2618447/6316770/52071794-ba00-11e4-9122-c7194f5188f4.png)](https://cloud.githubusercontent.com/assets/2618447/6316770/52071794-ba00-11e4-9122-c7194f5188f4.png) ### xiong-chiamiov + [![xiong-chiamiov](https://cloud.githubusercontent.com/assets/1441704/6315428/ded1e6ee-ba01-11e4-8b9d-a67485476e9f.png)](https://cloud.githubusercontent.com/assets/1441704/6315428/ded1e6ee-ba01-11e4-8b9d-a67485476e9f.png) ### xiong-chiamiov-plus + [![xiong-chiamiov-plus](https://cloud.githubusercontent.com/assets/1441704/6315427/d02464d2-ba01-11e4-8546-9c8dc984be79.png)](https://cloud.githubusercontent.com/assets/1441704/6315427/d02464d2-ba01-11e4-8546-9c8dc984be79.png) ### ys + Clean, simple, compatible and meaningful. Tested on Linux, Unix and Windows under ANSI colors. It is recommended to use with a dark background. @@ -345,14 +433,15 @@ It is recommended to use with a dark background. ![ys-zsh-theme](https://cloud.githubusercontent.com/assets/1415488/13198621/f2c1320c-d848-11e5-8f22-7fac1baeec2f.jpg) - ### zhann + [![zhann](https://cloud.githubusercontent.com/assets/2618447/6316771/520a5170-ba00-11e4-9561-78f0c76e996c.png)](https://cloud.githubusercontent.com/assets/2618447/6316771/520a5170-ba00-11e4-9561-78f0c76e996c.png) ## More themes + You can find more themes [here](https://github.com/ohmyzsh/ohmyzsh/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. @@ -361,12 +450,13 @@ Or put it gist and list it in https://github.com/ohmyzsh/ohmyzsh/wiki/External-t ## Theme Description Format The theme descriptions in this page should contain: -* The name of the theme -* A screenshot - * (Preferably in PNG format, and hosted on a GitHub issue) -* Instructions for any configuration besides setting `ZSH_THEME` in `~/.zshrc` - * For example, font installation, terminal color scheme configuration, or optional environment variables that affect the theme -* Any dependencies outside Oh My Zsh + +- The name of the theme +- A screenshot + - (Preferably in PNG format, and hosted on a GitHub issue) +- Instructions for any configuration besides setting `ZSH_THEME` in `~/.zshrc` + - 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). diff --git a/Themes.md b/Themes.md index 4f4efed..b01cf1f 100644 --- a/Themes.md +++ b/Themes.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + _This section uses new, uniform screenshots. To see the previous section, go to [[Themes (legacy)]]._ @@ -12,7 +14,7 @@ Here is a collection of screenshots and descriptions of themes that have been co > [!NOTE] > You will many times see screenshots for a zsh theme, and try it out, and find that it doesn't look the same for you. -> +> > This is because many themes require installing a [Powerline Font](https://github.com/powerline/fonts) or a [Nerd Font](https://github.com/ryanoasis/nerd-fonts) in order to render properly. > Without them, these themes will render weird prompt symbols. Check out [the FAQ](https://github.com/ohmyzsh/ohmyzsh/wiki/FAQ#i-have-a-weird-character-in-my-prompt) for more information. > @@ -24,11 +26,11 @@ Here is a collection of screenshots and descriptions of themes that have been co ### robbyrussell -*The default that Robby Russell uses.* +_The default that Robby Russell uses._ ![robbyrussell](https://user-images.githubusercontent.com/49100982/108254738-764b8700-716c-11eb-9a59-4deb8c8c6193.jpg) ----- +--- The rest of the themes, in alphabetical order: @@ -51,7 +53,7 @@ The rest of the themes, in alphabetical order: 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. -- *Optionally* set `DEFAULT_USER` to your regular username to hide the “user@hostname” info when you’re logged in as yourself on your local machine. Or add `prompt_context(){}` to `~/.zshrc` to always hide the “user@hostname” info. +- _Optionally_ set `DEFAULT_USER` to your regular username to hide the “user@hostname” info when you’re logged in as yourself on your local machine. Or add `prompt_context(){}` to `~/.zshrc` to always hide the “user@hostname” info. ### alanpeabody @@ -644,7 +646,7 @@ It is recommended to use with a dark background. ![zhann](https://user-images.githubusercontent.com/49100982/108255796-be1ede00-716d-11eb-8b61-9a419ebe7a4a.jpg) ----- +--- ## More themes diff --git a/Troubleshooting.md b/Troubleshooting.md index 7d0f31e..64d302f 100644 --- a/Troubleshooting.md +++ b/Troubleshooting.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + This page is meant to describe the most common problems with Oh My Zsh and what you can do to diagnose them: @@ -13,19 +15,19 @@ bindkey '^L' clear-screen Two main things could go wrong: -1. The key sequence (`^L` in the example) does not match the key sequence being sent to the terminal: +1. The key sequence (`^L` in the example) does not match the key sequence being sent to the terminal: You can see the exact sequence a keyboard shortcut sends by pressing `CTRL`+`V` and then the keyboard shortcut. For example: `CTRL`+`V`, `CTRL`+`L` will output `^L` (`^` represents the Control key). 2. The command executed (`clear-screen` in the example) has an error. In that case, post both the key binding and - the definition of the command (if exists) like so: + the definition of the command (if exists) like so: - **key binding:** `bindkey '^[[1;6D'` will print `"^[[1;6D" insert-cycledleft` - **command definition:** `which insert-cycledleft` will print `insert-cycledleft () { ... }` - + Notice that sometimes the command is a builtin [zle widget](https://zsh.sourceforge.net/Doc/Release/Zsh-Line-Editor.html) and so the `which` command won't work. If that's the case, just post the key binding and we'll figure it out. ### Completion problems @@ -35,7 +37,7 @@ Many completion problems, including the infamous `command not found: compdef`, c 1. First, try to remove your completion cache with `rm ~/.zcompdump*`, close and reopen your shells. 2. If you still have problems, try fully resetting the completion system, as explained by - [**@dragon788**](https://github.com/ohmyzsh/ohmyzsh/issues/630#issuecomment-70291622): + [**@dragon788**](https://github.com/ohmyzsh/ohmyzsh/issues/630#issuecomment-70291622): ```zsh compaudit | xargs chmod g-w,o-w diff --git a/Volunteers.md b/Volunteers.md index 6f74d2a..adfc59f 100644 --- a/Volunteers.md +++ b/Volunteers.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + Oh My Zsh has had contributions from 2,000+ developers across the planet, which is truly amazing and something we're proud of. Yet, there has only been a small handful of developers who have played a big role in organizing, prioritizing, triaging, promoting, and maintaining all these contributions. @@ -19,12 +21,12 @@ We are establishing a series of levels so that there is a way for everyone to ge As a Level 1 volunteer, you can help us by: -* Joining [our Discord server](https://discord.com/invite/ohmyzsh) and participating in the community conversations that take place. -* Answering questions on [StackOverflow relate to Oh My Zsh](https://stackoverflow.com/questions/tagged/oh-my-zsh) (and ⬆️ up-voting answers that help you resolve a problem). -* Asking and/or responding in [our Github Discussions](https://github.com/ohmyzsh/ohmyzsh/discussions). -* Follow us on [twitter/@ohmyzsh](https://twitter.com/ohmyzsh) and share useful links to blog articles, tutorials, and/or discussions. -* Help us continue to bring the joy of Oh My Zsh to more people by introducing it to peers! -* ...and be sure to thank the person who introduced you! +- Joining [our Discord server](https://discord.com/invite/ohmyzsh) and participating in the community conversations that take place. +- Answering questions on [StackOverflow relate to Oh My Zsh](https://stackoverflow.com/questions/tagged/oh-my-zsh) (and ⬆️ up-voting answers that help you resolve a problem). +- Asking and/or responding in [our Github Discussions](https://github.com/ohmyzsh/ohmyzsh/discussions). +- Follow us on [twitter/@ohmyzsh](https://twitter.com/ohmyzsh) and share useful links to blog articles, tutorials, and/or discussions. +- Help us continue to bring the joy of Oh My Zsh to more people by introducing it to peers! +- ...and be sure to thank the person who introduced you! Skill(s) needed: You know how to be a delightful human being! @@ -32,67 +34,66 @@ Skill(s) needed: You know how to be a delightful human being! As a Level 2 volunteer, you can help us by: -* Opening an issue when you encounter inaccurate documentation. -* Improving the readability of our documentation and wiki content. -* Creating a new plugin (can be a custom one you share and/or one to pitch for inclusion). -* Opening an issue when you encounter a weird bug. -* Fixing a weird bug you encountered. -* Helping improve an existing plugin. -* Testing pull-requests that other people have submitted (we usually have a lot to review!). -* Writing a blog post about how to use a favorite plugin of yours and post about it online. -* Recording a screencast and uploading it to places like YouTube. +- Opening an issue when you encounter inaccurate documentation. +- Improving the readability of our documentation and wiki content. +- Creating a new plugin (can be a custom one you share and/or one to pitch for inclusion). +- Opening an issue when you encounter a weird bug. +- Fixing a weird bug you encountered. +- Helping improve an existing plugin. +- Testing pull-requests that other people have submitted (we usually have a lot to review!). +- Writing a blog post about how to use a favorite plugin of yours and post about it online. +- Recording a screencast and uploading it to places like YouTube. Skills needed: -* You should be comfortable switching across git branches -* You should be able to test a pull-request out in your local environment -* You should be able to run our linters +- You should be comfortable switching across git branches +- You should be able to test a pull-request out in your local environment +- You should be able to run our linters ### Level 3: Triage / Moderator As a Level 3 volunteer, you can help us by: -* Help us moderate channels in our Discord server. -* Participating in our planning meetings (a few of us meet every other month or so). -* Testing pull-requests from other contributors. -* Providing feedback and/or change requests to people who submit pull-requests. -* Let pull-request submitters know if their proposed plugin, theme, and/or changes might not qualify for inclusion. (TODO: this process requires documentation) -* Suggest pull-requests to Maintainer(s) that you believe are good for us to consider merging. - +- Help us moderate channels in our Discord server. +- Participating in our planning meetings (a few of us meet every other month or so). +- Testing pull-requests from other contributors. +- Providing feedback and/or change requests to people who submit pull-requests. +- Let pull-request submitters know if their proposed plugin, theme, and/or changes might not qualify for inclusion. (TODO: this process requires documentation) +- Suggest pull-requests to Maintainer(s) that you believe are good for us to consider merging. Skills needed: -* You should be comfortable navigating git merge conflicts -* You should be able to test various plugins across different operating systems, programming languages, frameworks, and CLI tools. +- You should be comfortable navigating git merge conflicts +- You should be able to test various plugins across different operating systems, programming languages, frameworks, and CLI tools. ### Level 4 / Maintainer -* Keeping an eye out for the long-term maintainability of Oh My Zsh. -* Participating in our planning meetings (a few of us meet every other month or so). -* Prioritizing [the backlog of issues and pull-requests](https://github.com/orgs/ohmyzsh/projects/1/views/29) for the upcoming cycle(s) using input from Triage volunteers. -* Merging and/or Closing Pull-Requests and Issues in Github. -* Addressing high-priority security incidents and/or bug fixes. -* Helping coordinate communication through our various user channels. +- Keeping an eye out for the long-term maintainability of Oh My Zsh. +- Participating in our planning meetings (a few of us meet every other month or so). +- Prioritizing [the backlog of issues and pull-requests](https://github.com/orgs/ohmyzsh/projects/1/views/29) for the upcoming cycle(s) using input from Triage volunteers. +- Merging and/or Closing Pull-Requests and Issues in Github. +- Addressing high-priority security incidents and/or bug fixes. +- Helping coordinate communication through our various user channels. Skills needed: -* You should be able to help us in a project manager capacity. -* You should feel comfortable merging (and/or reverting) big changes to the project. -* ... +- You should be able to help us in a project manager capacity. +- You should feel comfortable merging (and/or reverting) big changes to the project. +- ... + ### Level 5 / Maintainer with Admin access As a Level 5 volunteer, you might be: -* Doing a little bit of everything -* Recruiting new volunteers -* Steering the toward a bright future -* Managing our Github accounts, settings, projects, and permissions. +- Doing a little bit of everything +- Recruiting new volunteers +- Steering the toward a bright future +- Managing our Github accounts, settings, projects, and permissions. This is currently handled by: -* [@mcornella](https://github.com/mcornella) (official maintainer of Oh My Zsh) -* [@robbyrussell](https://github.com/robbyrussell) (creator of Oh My Zsh) - +- [@mcornella](https://github.com/mcornella) (official maintainer of Oh My Zsh) +- [@robbyrussell](https://github.com/robbyrussell) (creator of Oh My Zsh) ## In Summary diff --git a/Wiki-Style-Guide.md b/Wiki-Style-Guide.md index 5ac1f64..00dba86 100644 --- a/Wiki-Style-Guide.md +++ b/Wiki-Style-Guide.md @@ -1,5 +1,7 @@ + > _This wiki is automatically published from [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki). To edit this page,_ > _go to [ohmyzsh/wiki](https://github.com/ohmyzsh/wiki), make your changes and submit a Pull Request._ + ## General Wiki Code Style @@ -11,13 +13,13 @@ Following these guidelines while making the readme for your plugin/theme would b ## Headers -| GFM Element | HTML Header Tag Equivalent | Use | -| ----------- | -------------------------- | ------------------------------------------------------------------------------ | -| # | `

` | This will not be used, as Github wiki pages uses the filename as h1 | +| GFM Element | HTML Header Tag Equivalent | Use | +| ----------- | -------------------------- | -------------------------------------------------------------------------------- | +| # | `

` | This will not be used, as Github wiki pages uses the filename as h1 | | ## | `

` | Main section divider (as in this page _Headers_, _Syntax Highlighting_, etc are) | -| ### - #### | `

` - `

` | For use in subsections | -| ##### | `

` | Please try to use this just for labeling _Example_ in fenced code blocks | -| ###### | `
` | For descriptors in example fenced code blocks | +| ### - #### | `

` - `

` | For use in subsections | +| ##### | `

` | Please try to use this just for labeling _Example_ in fenced code blocks | +| ###### | `
` | For descriptors in example fenced code blocks | Below is an example of how to use each header (and will be the only use of ##/h2 in abnormal circumstances). diff --git a/_Sidebar.md b/_Sidebar.md index 1d156be..b74704d 100644 --- a/_Sidebar.md +++ b/_Sidebar.md @@ -1,28 +1,28 @@ -* **[[Home]]** -* **[[FAQ]]** -* **[[Plugins Overview]]** -* **Documentation** - * [[Installing ZSH]] - * [[Settings]] - * [[Plugins]] - * [[Themes]] - * [[Cheatsheet]] - * [[Customization]] - * [[Resources]] - * [[Troubleshooting]] -* **Community** - * [[Articles]] - * [[External plugins]] - * [[External themes]] - * [[Testimonials]] -* **Contributing** - * [[Volunteers]] - * [[Design]] - * [[Code Style Guide]] - * [[Wiki Style Guide]] - * [[Contribution Technical Practices]] +- **[[Home]]** +- **[[FAQ]]** +- **[[Plugins Overview]]** +- **Documentation** + - [[Installing ZSH]] + - [[Settings]] + - [[Plugins]] + - [[Themes]] + - [[Cheatsheet]] + - [[Customization]] + - [[Resources]] + - [[Troubleshooting]] +- **Community** + - [[Articles]] + - [[External plugins]] + - [[External themes]] + - [[Testimonials]] +- **Contributing** + - [[Volunteers]] + - [[Design]] + - [[Code Style Guide]] + - [[Wiki Style Guide]] + - [[Contribution Technical Practices]] ------------------- +---

Get a t-shirt!