Skip to content

Latest commit

 

History

History
83 lines (59 loc) · 3.69 KB

Home.md

File metadata and controls

83 lines (59 loc) · 3.69 KB

This wiki is automatically published from ohmyzsh/wiki. To edit this page, go to ohmyzsh/wiki, make your changes and submit a Pull Request.

Oh My Zsh

Welcome to Oh My Zsh!

Oh My Zsh is an open source, community-driven framework for managing your zsh configuration.

  • You'll need zsh to install Oh My Zsh. Run zsh --version to check if you have it:

    $ zsh --version
    zsh 5.8 (x86_64-ubuntu-linux-gnu)
  • If you see command not found you don't have zsh installed. See [[Installing Zsh]] for instructions.

  • 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)"

    NOTE: the installer will rename an existing .zshrc file to .zshrc.pre-oh-my-zsh.

  • Alternatively, the installer is also mirrored outside GitHub. Using this URL may be required if you're in a country like India or China, that blocks raw.githubusercontent.com:

    Method Command
    curl sh -c "$(curl -fsSL https://install.ohmyz.sh)"
    wget sh -c "$(wget -O- https://install.ohmyz.sh)"
    fetch sh -c "$(fetch -o - https://install.ohmyz.sh)"

Getting started

Once Oh My Zsh is installed:

  • Take a look at the most common questions and gotchas in the [[FAQ]].
  • Get a quick summary of the built-in plugins: [[Plugins Overview]].
  • Take a look at our [[Themes]] and [[Plugins]] (read the READMEs first!).
  • If you need more, you can look at [[External themes]] and [[External plugins]]. Take caution, we do not review these.
  • Have a look at the [[Cheatsheet]] for other Oh My Zsh tricks.

Advanced topics

  • Having problems? Check out the [[FAQ]] for common problems, or the [[Troubleshooting]] page for instructions on how to diagnose the issue.
  • Want to change stuff about Oh My Zsh? Learn about [[Customization]].
  • If you want to learn more, check out the [[Resources]] page for more information.

Community

Discord Twitter
  • Read our user [[Testimonials]].
  • [[Articles]] Have you written a blog post/article that mentions Oh My Zsh?
  • And don't forget to follow us on twitter!

Help out!

Want to contribute?

We are looking for [[Volunteers]] of all skill levels.

Check out our [[Code Style Guide]] and [[Design]] guidelines and start hacking away!