0
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-09-19 04:01:21 +02:00

Add new Themes section with uniform screenshots

Marc Cornellà 2020-09-16 13:35:17 +02:00
parent 631a1e08b7
commit ef5fabb034

559
Themes.md Normal file

@ -0,0 +1,559 @@
All the current themes can be found in the `themes/` directory in the oh-my-zsh distribution. [See list here.](http://github.com/robbyrussell/oh-my-zsh/tree/master/themes/)
In order to enable a theme, set `ZSH_THEME` to the name of the theme in your `~/.zshrc`, before sourcing Oh My Zsh; for example: `ZSH_THEME=robbyrussell`
If you do not want any theme enabled, just set `ZSH_THEME` to blank: `ZSH_THEME=""`
Here is a collection of screenshots and descriptions of themes that have been contributed to Oh My Zsh. There are some missing from this page. If you want to add or edit descriptions, see the [format description](#theme-description-format) at the bottom of this page.
## The Themes
### robbyrussell
*the (default) that Robby uses*
![robbyrussell](https://user-images.githubusercontent.com/1816101/62960429-ebf9c880-bdfa-11e9-9d26-193d50ea34de.jpg)
------------------------------------
The rest of the themes, in alphabetical order:
## A
### af-magic
![af-magic](https://user-images.githubusercontent.com/1816101/62960494-09c72d80-bdfb-11e9-8f5c-1c0149ef453b.jpg)
### afowler
![afowler](https://user-images.githubusercontent.com/1816101/62960517-177cb300-bdfb-11e9-942f-e6f6e9383246.jpg)
### agnoster
![agnoster](https://user-images.githubusercontent.com/1816101/62960553-295e5600-bdfb-11e9-86f3-8cdfe5bbe947.jpg)
[Official repository](https://github.com/agnoster/agnoster-zsh-theme)
Shown with [Solarized Dark colorscheme](http://ethanschoonover.com/solarized) and Powerline-patched Meslo 14pt in [iTerm 2](http://www.iterm2.com/).
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 followed by prompt_context(){} in `~/.zshrc` to hide the “user@hostname” info when youre logged in as yourself on your local machine.
### alanpeabody
![alanpeabody](https://user-images.githubusercontent.com/1816101/62960555-29f6ec80-bdfb-11e9-9011-29fe69bc058a.jpg)
### amuse
![amuse](https://user-images.githubusercontent.com/1816101/62960556-29f6ec80-bdfb-11e9-9ad7-63cd1181fc53.jpg)
Shown in the screenshot with tmux and the [powerline plugin](https://github.com/powerline/powerline) (you might need to install one of the [patched powerline fonts](https://github.com/powerline/fonts) for it to look the same).
### apple
![apple](https://user-images.githubusercontent.com/1816101/62960559-29f6ec80-bdfb-11e9-8661-3a50d911d494.jpg)
### arrow
![arrow](https://user-images.githubusercontent.com/1816101/62960560-2a8f8300-bdfb-11e9-8367-44c397bb7a9e.jpg)
### aussiegeek
![aussiegeek](https://user-images.githubusercontent.com/1816101/62960561-2a8f8300-bdfb-11e9-82ba-0bf2dfa95671.jpg)
### avit
![avit](https://user-images.githubusercontent.com/1816101/62960742-9ffb5380-bdfb-11e9-81d2-da12212829b0.jpg)
### awesomepanda
![awesomepanda](https://user-images.githubusercontent.com/1816101/62960743-9ffb5380-bdfb-11e9-91bc-866a9bda2106.jpg)
## B
### bira
![bira](https://user-images.githubusercontent.com/1816101/62960744-9ffb5380-bdfb-11e9-8167-1dc4dbf1b835.jpg)
### blinks
![blinks](https://user-images.githubusercontent.com/1816101/62960747-9ffb5380-bdfb-11e9-848c-26372f7b690d.jpg)
### bureau
![bureau](https://user-images.githubusercontent.com/1816101/62960748-a093ea00-bdfb-11e9-93e0-9d945d0cbe13.jpg)
To use: In the right prompt you see git status and (if you use nvm) the Node.js version.
## C
### candy
![candy](https://user-images.githubusercontent.com/1816101/62960749-a093ea00-bdfb-11e9-9bbf-04ce2a6fd6a0.jpg)
### clean
![clean](https://user-images.githubusercontent.com/1816101/62960752-a093ea00-bdfb-11e9-89d4-0d6ae616db94.jpg)
### cloud
![cloud](https://user-images.githubusercontent.com/1816101/62960753-a093ea00-bdfb-11e9-9922-a72495b2b06a.jpg)
### crcandy
![crcandy](https://user-images.githubusercontent.com/1816101/62961066-56f7cf00-bdfc-11e9-9c5b-10044d622f61.jpg)
### crunch
![crunch](https://user-images.githubusercontent.com/1816101/62961067-56f7cf00-bdfc-11e9-911b-0316a41b7779.jpg)
### cypher
![cypher](https://user-images.githubusercontent.com/1816101/62961068-56f7cf00-bdfc-11e9-951e-a2e06d21ae3c.jpg)
## D
### dallas
![dallas](https://user-images.githubusercontent.com/1816101/62961138-7e4e9c00-bdfc-11e9-8530-5e0d386ada0c.jpg)
### darkblood
![darkblood](https://user-images.githubusercontent.com/1816101/62961141-7e4e9c00-bdfc-11e9-9a9f-d8b858ad6f8d.jpg)
### daveverwer
![daveverwer](https://user-images.githubusercontent.com/1816101/62961143-7e4e9c00-bdfc-11e9-9777-ce1f230de9d7.jpg)
### dieter
![dieter](https://user-images.githubusercontent.com/1816101/62961144-7e4e9c00-bdfc-11e9-9693-4270c50e2031.jpg)
### dogenpunk
![dogenpunk](https://user-images.githubusercontent.com/1816101/62961146-7e4e9c00-bdfc-11e9-9e29-aae8d5f74b8f.jpg)
### dpoggi
![dpoggi](https://user-images.githubusercontent.com/1816101/62961147-7e4e9c00-bdfc-11e9-8ac3-ef4d49178357.jpg)
### dst
![dst](https://user-images.githubusercontent.com/1816101/62961148-7ee73280-bdfc-11e9-9b12-0719b80046fb.jpg)
### dstufft
![dstufft](https://user-images.githubusercontent.com/1816101/62961149-7ee73280-bdfc-11e9-89c5-8bcd02d0097a.jpg)
### duellj
![duellj](https://user-images.githubusercontent.com/1816101/62961151-7ee73280-bdfc-11e9-860d-dab928179199.jpg)
## E
### eastwood
![eastwood](https://user-images.githubusercontent.com/1816101/62961289-ca99dc00-bdfc-11e9-9965-27d49bf087c7.jpg)
### edvardm
![edvardm](https://user-images.githubusercontent.com/1816101/62961290-ca99dc00-bdfc-11e9-8016-93e12a40d42e.jpg)
### emotty
![emotty](https://user-images.githubusercontent.com/1816101/62961291-ca99dc00-bdfc-11e9-8998-6f50cc06c200.jpg)
### essembeh
![essembeh](https://user-images.githubusercontent.com/1816101/62961292-ca99dc00-bdfc-11e9-8c5e-a1f356ceef07.jpg)
### evan
![evan](https://user-images.githubusercontent.com/1816101/62961293-ca99dc00-bdfc-11e9-91f1-de80272be791.jpg)
## F
### fino-time
![fino-time](https://user-images.githubusercontent.com/1816101/62961370-eb623180-bdfc-11e9-87c7-cd557f08cbe3.jpg)
### fino
![fino](https://user-images.githubusercontent.com/1816101/62961371-ebfac800-bdfc-11e9-9c37-64aa5117259c.jpg)
### fishy
![fishy](https://user-images.githubusercontent.com/1816101/62961373-ebfac800-bdfc-11e9-93fd-77b12b608953.jpg)
The fish shell prompt with git support
### flazz
![flazz](https://user-images.githubusercontent.com/1816101/62961375-ebfac800-bdfc-11e9-81ab-9c87c1c629ad.jpg)
Has git and vi-command mode support (when enabled)
### fletcherm
![fletcherm](https://user-images.githubusercontent.com/1816101/62961376-ebfac800-bdfc-11e9-8629-801812f3cef3.jpg)
### fox
![fox](https://user-images.githubusercontent.com/1816101/62961377-ebfac800-bdfc-11e9-9e6e-ddf4fa38699f.jpg)
### frisk
![frisk](https://user-images.githubusercontent.com/1816101/62961379-ec935e80-bdfc-11e9-9a8c-c605ccf0f281.jpg)
### frontcube
![frontcube](https://user-images.githubusercontent.com/1816101/62961380-ec935e80-bdfc-11e9-8f80-d77e8adc42d6.jpg)
### funky
![funky](https://user-images.githubusercontent.com/1816101/62961381-ec935e80-bdfc-11e9-92fb-b8bb9e6078b8.jpg)
Its funky…
### fwalch
![fwalch](https://user-images.githubusercontent.com/1816101/62961382-ec935e80-bdfc-11e9-84e4-0785ea308284.jpg)
# G
### gallifrey
![gallifrey](https://user-images.githubusercontent.com/1816101/62961508-2f553680-bdfd-11e9-98f9-898b8d418ea2.jpg)
### gallois
![gallois](https://user-images.githubusercontent.com/1816101/62961509-2f553680-bdfd-11e9-8abc-9faaefebe0f7.jpg)
### garyblessington
![garyblessington](https://user-images.githubusercontent.com/1816101/62961510-2f553680-bdfd-11e9-961c-e126714e2bed.jpg)
### gentoo
![gentoo](https://user-images.githubusercontent.com/1816101/62961511-2f553680-bdfd-11e9-944f-18b9a65d8c28.jpg)
### geoffgarside
![geoffgarside](https://user-images.githubusercontent.com/1816101/62961512-2fedcd00-bdfd-11e9-8e44-f4ad6be47ce2.jpg)
### gianu
![gianu](https://user-images.githubusercontent.com/1816101/62961514-2fedcd00-bdfd-11e9-8433-9d0fb5eaa5e8.jpg)
### gnzh
![gnzh](https://user-images.githubusercontent.com/1816101/62961515-2fedcd00-bdfd-11e9-995b-59b42041c8f0.jpg)
### gozilla
![gozilla](https://user-images.githubusercontent.com/1816101/62961517-2fedcd00-bdfd-11e9-8ba6-1d508c8460c8.jpg)
## H
### half-life
![half-life](https://user-images.githubusercontent.com/1816101/62961593-5a3f8a80-bdfd-11e9-912f-ca3e2a4aa9e5.jpg)
### humza
![humza](https://user-images.githubusercontent.com/1816101/62961595-5a3f8a80-bdfd-11e9-9526-20eeccc3b3f2.jpg)
# I
### imajes
![imajes](https://user-images.githubusercontent.com/1816101/62961597-5ad82100-bdfd-11e9-8459-ca1fd31dd43c.jpg)
### intheloop
![intheloop](https://user-images.githubusercontent.com/1816101/62961599-5ad82100-bdfd-11e9-810a-2349233ca712.jpg)
### itchy
![itchy](https://user-images.githubusercontent.com/1816101/62961600-5ad82100-bdfd-11e9-969a-43e034065c1c.jpg)
# J
### jaischeema
![jaischeema](https://user-images.githubusercontent.com/1816101/62961660-79d6b300-bdfd-11e9-8d69-2ea44ed22bac.jpg)
### jbergantine
![jbergantine](https://user-images.githubusercontent.com/1816101/62961661-79d6b300-bdfd-11e9-872e-b51a40bb3c7d.jpg)
### jispwoso
![jispwoso](https://user-images.githubusercontent.com/1816101/62961663-79d6b300-bdfd-11e9-96ad-76bf2c061ab2.jpg)
### jnrowe
![jnrowe](https://user-images.githubusercontent.com/1816101/62961664-7a6f4980-bdfd-11e9-8933-7d3e3d2a5ded.jpg)
### jonathan
![jonathan](https://user-images.githubusercontent.com/1816101/62961665-7a6f4980-bdfd-11e9-8b93-b9c41b11cd8e.jpg)
### josh
![josh](https://user-images.githubusercontent.com/1816101/62961666-7a6f4980-bdfd-11e9-8fa5-394d4319ad2f.jpg)
### jreese
![jreese](https://user-images.githubusercontent.com/1816101/62961667-7a6f4980-bdfd-11e9-9866-7094a8988f72.jpg)
### jtriley
![jtriley](https://user-images.githubusercontent.com/1816101/62961668-7a6f4980-bdfd-11e9-8da6-644379f1c18a.jpg)
### juanghurtado
![juanghurtado](https://user-images.githubusercontent.com/1816101/62961669-7a6f4980-bdfd-11e9-99fe-09f2559f153a.jpg)
### junkfood
![junkfood](https://user-images.githubusercontent.com/1816101/62961670-7b07e000-bdfd-11e9-9aef-87128aa769c3.jpg)
> Totally ripped off Dallas theme
[More Info](http://www.tylercipriani.com/2012/12/18/zsh-prompt-customization.html)
## K
### kafeitu
![kafeitu](https://user-images.githubusercontent.com/1816101/62965888-36cd0d80-be06-11e9-83c6-836228a04a48.jpg)
### kardan
![kardan](https://user-images.githubusercontent.com/1816101/62965889-36cd0d80-be06-11e9-8ab1-a9d56aae78a7.jpg)
### kennethreitz
![kennethreitz](https://user-images.githubusercontent.com/1816101/62965891-36cd0d80-be06-11e9-9ad2-ed2e9fb3f345.jpg)
### kolo
![kolo](https://user-images.githubusercontent.com/1816101/62965893-36cd0d80-be06-11e9-8c24-e5d21a03b9a7.jpg)
### kphoen
![kphoen](https://user-images.githubusercontent.com/1816101/62965895-3765a400-be06-11e9-9f8f-53cd2ee8224b.jpg)
# L
### lambda
![lambda](https://user-images.githubusercontent.com/1816101/62965896-3765a400-be06-11e9-9eb8-e5e04f772ae7.jpg)
### linuxonly
![linuxonly](https://user-images.githubusercontent.com/1816101/62965897-3765a400-be06-11e9-94a8-e8ee994b72e7.jpg)
(As the name states, this only works on Linux)
### lukerandall
![lukerandall](https://user-images.githubusercontent.com/1816101/62965898-37fe3a80-be06-11e9-8872-a5dc726d3693.jpg)
## M
### macovsky
![macovsky](https://user-images.githubusercontent.com/1816101/62965990-62e88e80-be06-11e9-8fb7-d219b0042f0f.jpg)
### maran
![maran](https://user-images.githubusercontent.com/1816101/62965991-62e88e80-be06-11e9-989c-3c8fdc2f0b3f.jpg)
### mgutz
![mgutz](https://user-images.githubusercontent.com/1816101/62965992-62e88e80-be06-11e9-8c0c-7654e97f6b37.jpg)
### mh
![mh](https://user-images.githubusercontent.com/1816101/62965993-63812500-be06-11e9-99f3-c5b44934fab0.jpg)
### michelebologna
![michelebologna](https://user-images.githubusercontent.com/1816101/62965994-63812500-be06-11e9-9f6f-3d36e3cc4fa3.jpg)
### mikeh
![mikeh](https://user-images.githubusercontent.com/1816101/62965995-63812500-be06-11e9-9739-5877d641a269.jpg)
### miloshadzic
![miloshadzic](https://user-images.githubusercontent.com/1816101/62965997-63812500-be06-11e9-904d-352b78cd4408.jpg)
### minimal
![minimal](https://user-images.githubusercontent.com/1816101/62965998-63812500-be06-11e9-97a0-34cac4e5b0df.jpg)
### mortalscumbag
![mortalscumbag](https://user-images.githubusercontent.com/1816101/62966000-63812500-be06-11e9-8ba7-0d8f7fbea464.jpg)
Also tells you when logged in over ssh
### mrtazz
![mrtazz](https://user-images.githubusercontent.com/1816101/62966001-6419bb80-be06-11e9-9d41-b2632295e445.jpg)
### murilasso
![murilasso](https://user-images.githubusercontent.com/1816101/62966002-6419bb80-be06-11e9-90f0-7ef55042e6e9.jpg)
### muse
![muse](https://user-images.githubusercontent.com/1816101/62966003-6419bb80-be06-11e9-9d0a-db4f1eb096e8.jpg)
## N
### nanotech
![nanotech](https://user-images.githubusercontent.com/1816101/62966128-b22ebf00-be06-11e9-928b-0c0e86142eef.jpg)
### nebirhos
![nebirhos](https://user-images.githubusercontent.com/1816101/62966129-b22ebf00-be06-11e9-8b42-fd00e20e12a8.jpg)
### nicoulaj
![nicoulaj](https://user-images.githubusercontent.com/1816101/62966130-b22ebf00-be06-11e9-94f2-9f692d31aedf.jpg)
### norm
![norm](https://user-images.githubusercontent.com/1816101/62966131-b2c75580-be06-11e9-9b0c-de2100cdd437.jpg)
## O
### obraun
![obraun](https://user-images.githubusercontent.com/1816101/62966132-b2c75580-be06-11e9-9d58-70e9f15876a7.jpg)
## P
### peepcode
![peepcode](https://user-images.githubusercontent.com/1816101/62966133-b2c75580-be06-11e9-890e-e2cd14c79e52.jpg)
### philips
![philips](https://user-images.githubusercontent.com/1816101/62966134-b2c75580-be06-11e9-9ee2-c56eb03f0220.jpg)
### pmcgee
![pmcgee](https://user-images.githubusercontent.com/1816101/62966135-b35fec00-be06-11e9-8318-9ae8fdb6ca4c.jpg)
### pygmalion
![pygmalion](https://user-images.githubusercontent.com/1816101/62966137-b35fec00-be06-11e9-85a8-2d90d395c304.jpg)
## R
### re5et
![re5et](https://user-images.githubusercontent.com/1816101/62966419-4a2ca880-be07-11e9-8b32-2266fc1c09da.jpg)
### refined
![refined](https://user-images.githubusercontent.com/1816101/62966420-4ac53f00-be07-11e9-9b62-7816a65871bb.jpg)
### rgm
![rgm](https://user-images.githubusercontent.com/1816101/62966421-4ac53f00-be07-11e9-87de-99ea008be104.jpg)
### risto
![risto](https://user-images.githubusercontent.com/1816101/62966422-4ac53f00-be07-11e9-88cf-740f1ad2edde.jpg)
### rixius
![rixius](https://user-images.githubusercontent.com/1816101/62966423-4ac53f00-be07-11e9-9f02-32b02c25d4a9.jpg)
### rkj-repos
![rkj](https://user-images.githubusercontent.com/1816101/62966424-4ac53f00-be07-11e9-8b4a-3de59e7bb806.jpg)
## S
### sammy
![sammy](https://user-images.githubusercontent.com/1816101/62966495-76e0c000-be07-11e9-9f16-f381afe686f5.jpg)
### simonoff
![simonoff](https://user-images.githubusercontent.com/1816101/62966496-77795680-be07-11e9-9985-4d813573fdd6.jpg)
### simple
![simple](https://user-images.githubusercontent.com/1816101/62966497-77795680-be07-11e9-9ffe-73b34b4b14a2.jpg)
### skaro
![skaro](https://user-images.githubusercontent.com/1816101/62966498-77795680-be07-11e9-8a25-e728a89e7981.jpg)
### smt
![smt](https://user-images.githubusercontent.com/1816101/62966499-77795680-be07-11e9-98b0-e3e9ab9cdff9.jpg)
### Soliah
![Soliah](https://user-images.githubusercontent.com/1816101/62966500-77795680-be07-11e9-89af-905723509f87.jpg)
### sonicradish
![sonicradish](https://user-images.githubusercontent.com/1816101/62966501-7811ed00-be07-11e9-9a0a-37cc64cf7e54.jpg)
### sorin
![sorin](https://user-images.githubusercontent.com/1816101/62966502-7811ed00-be07-11e9-8348-5de10312557b.jpg)
### sporty_256
![sporty_256](https://user-images.githubusercontent.com/1816101/62966503-7811ed00-be07-11e9-9d86-2f26d90155ab.jpg)
### steeef
![steeef](https://user-images.githubusercontent.com/1816101/62966504-7811ed00-be07-11e9-81a2-2df843640210.jpg)
### strug
![strug](https://user-images.githubusercontent.com/1816101/62966505-7811ed00-be07-11e9-965b-6cef987101d0.jpg)
### sunaku
![sunaku](https://user-images.githubusercontent.com/1816101/62966506-78aa8380-be07-11e9-80e2-67931ebe397a.jpg)
Exit status if nonzero, status & branch if git, `pwd` always.
### sunrise
![sunrise](https://user-images.githubusercontent.com/1816101/62966507-78aa8380-be07-11e9-91f5-a9ebae6bd88e.jpg)
Lightweight prompt with exit status and `git status` consistent mode line.
### superjarin
![superjarin](https://user-images.githubusercontent.com/1816101/62966509-78aa8380-be07-11e9-903f-5bd3cd836d21.jpg)
Git status, git branch, and ruby, all in a no muss, no fuss prompt! Works with RVM, chruby, and rbenv (just activate the corresponding plugin).
### suvash
![suvash](https://user-images.githubusercontent.com/1816101/62966510-78aa8380-be07-11e9-9e27-f77fcde6bae2.jpg)
Username, host, directory, git branch and rvm gemset
## T
### takashiyoshida
![takashiyoshida](https://user-images.githubusercontent.com/1816101/62967268-ec995b80-be08-11e9-9b86-bf3d728dd9fa.jpg)
### terminalparty
![terminalparty](https://user-images.githubusercontent.com/1816101/62967270-ec995b80-be08-11e9-87df-9096ba428583.jpg)
There is a party every day.
### theunraveler
![theunraveler](https://user-images.githubusercontent.com/1816101/62967271-ec995b80-be08-11e9-9d49-efe6d6a677a8.jpg)
Minimal, informative when it needs to be.
### tjkirch
![tjkirch](https://user-images.githubusercontent.com/1816101/62967272-ec995b80-be08-11e9-9ac5-8fd135a74248.jpg)
Based on dst, plus a lightning bolt and return codes.
### tonotdo
![tonotdo](https://user-images.githubusercontent.com/1816101/62967273-ec995b80-be08-11e9-9349-8d910a629227.jpg)
### trapd00r
![trapd00r](https://user-images.githubusercontent.com/1816101/62967441-3eda7c80-be09-11e9-9c4d-1cae5871e000.jpg)
## W
### wedisagree
![wedisagree](https://user-images.githubusercontent.com/1816101/62967478-54e83d00-be09-11e9-849c-ed463ac9b0dd.jpg)
Instructions to further customize the theme are available as comments in the theme file.
### wezm
![wezm](https://user-images.githubusercontent.com/1816101/62967479-54e83d00-be09-11e9-8905-95a366fe7081.jpg)
### wezm+
![wezm+](https://user-images.githubusercontent.com/1816101/62967480-54e83d00-be09-11e9-8968-e71024c3d03e.jpg)
### wuffers
![wuffers](https://user-images.githubusercontent.com/1816101/62967481-54e83d00-be09-11e9-94e0-f47139d586a7.jpg)
## X
### xiong-chiamiov
![xiong-chiamiov](https://user-images.githubusercontent.com/1816101/62967485-54e83d00-be09-11e9-8646-fd420eba3647.jpg)
### xiong-chiamiov-plus
![xiong-chiamiov-plus](https://user-images.githubusercontent.com/1816101/62967483-54e83d00-be09-11e9-8ccd-b5f376d65b75.jpg)
## Y
### ys
![ys](https://user-images.githubusercontent.com/1816101/62967487-5580d380-be09-11e9-8589-f2e245f4a22e.jpg)
Clean, simple, compatible and meaningful.Tested on Linux, Unix and Windows under ANSI colors.
It is recommended to use with a dark background.
[More info](http://blog.ysmood.org/my-ys-terminal-theme/)
## Z
### zhann
![zhann](https://user-images.githubusercontent.com/1816101/62967488-5580d380-be09-11e9-9d71-ab15c0742b3e.jpg)
---
## More themes
You can find more themes [here](https://github.com/robbyrussell/oh-my-zsh/wiki/External-themes).
## (Dont) 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.
Or put into a Gist and add it to the [External Themes list](https://github.com/robbyrussell/oh-my-zsh/wiki/External-themes).
## Theme Description Format
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
We use manually-constructed screenshots because some of the themes require additional terminal configuration to look their best, and so the code in example shell sessions can showcase the theme's features. There is also a separate collection of automatically-generated screenshots linked [at the bottom of this page](#screenshots-of-each-theme).
### Uploading screenshots to GitHub
We host all the screenshot images on GitHub itself, to avoid external dependencies on other hosting services or URLs that might break. We use issue attachments which will get them in to githubusercontent.com. (It's also possible to store image files in a GitHub wiki itself, but this requires you to have Contributor permissions for the repo whose Wiki you're editing. The issue-attachment method can be done by anybody.)
To upload an image to GitHub, just drag and drop it into the text area on an issue you're editing. You can use issue #3619 for this to avoid spamming people with notifications about new issues. The uploaded image will turn in to an image in Markdown format. Edit that to use the special `[![name](image-url)](image-url)` syntax to make the image link to itself, so people can open the image in a new tab to view it full size. (Images inside a wiki page may be displayed scaled down.)
For example:
```
[![wezm](https://cloud.githubusercontent.com/assets/1441704/6315419/915f6ca6-ba01-11e4-95b3-2c98114b5e5c.png)](https://cloud.githubusercontent.com/assets/1441704/6315419/915f6ca6-ba01-11e4-95b3-2c98114b5e5c.png)
```
If you have several uploaded screenshot links you need to convert to that self-linked syntax, you can use this `sed` command on the markdown file to programmatically convert them.
sed 's/^!\[[a-zA-Z0-9 -]*\](\([^)]*\)) *$/[&](\1)/'
## Screenshots of each Theme
### Version 2019-08
The current set of theme screenshots was generated on macOS Mojave (10.14.5) with the macOS Terminal app. The used theme is `Basic` with the default settings and colors. The font was switched to `Fira Code` at 13 pt to enable some special characters in certain themes. All terminal windows have a size of 100x31.
Run commands in a prepared folder with a pseudo project structure with Git enabled:
```bash
ls -lah
git status
```
### Version 2013-04
[Screenshot collection](https://www.dropbox.com/sh/u532agyv1hyash1/LS9yNESRlQ?lst) (as of 2013-04-10), in OS X Terminal.app using Consolas 13pt and Pro color scheme, inside a folder containing both a git and a mercurial repo. Each screenshot displays the output of the `pwd` command. It has shortcomings (plugins for some themes might be missing), but it offers a convenient and uniform overview of each theme. Plugins used were battery, rvm, hg prompt, among others.