zimfw/README.md

70 lines
2.0 KiB
Markdown
Raw Normal View History

2015-12-15 00:12:17 -05:00
ZIM - Zsh IMproved
==================
2015-12-17 07:44:19 -05:00
<div align="center">
<a href="http://github.com/Eriner/zim">
2015-12-17 11:04:01 -05:00
<img width=650px src="https://i.eriner.me/zim_banner.png">
2015-12-17 07:44:19 -05:00
</a>
</div>
2015-12-15 00:12:17 -05:00
What is Zim?
------------
2015-12-18 07:40:11 -05:00
Zim is a Zsh configuration framework with blazing speed and modular extensions.
2015-12-17 08:06:26 -05:00
2015-12-18 07:40:11 -05:00
Zim is very easy to customize, and comes with a rich set of modules and features without compromising on speed or functionality!
2015-12-15 00:12:17 -05:00
What does Zim offer?
-----------------
2015-12-16 18:00:14 -05:00
If you're here, it means you want to see the cool shit Zim can do. Check out the [available modules](https://github.com/Eriner/zim/wiki/Modules)!
Below is a brief showcase of Zim's features.
2015-12-15 00:12:17 -05:00
#### Themes
2015-12-18 11:44:57 -05:00
2015-12-18 12:03:43 -05:00
##### Minimal
2015-12-18 11:44:57 -05:00
![Minimal Theme][theme_minimal]
2015-12-18 12:03:43 -05:00
To see more themes, check the [wiki page](https://github.com/Eriner/zim/wiki/Themes).
2015-12-18 11:44:57 -05:00
2015-12-15 00:12:17 -05:00
#### Fish-shell History Navigation
2015-12-15 00:43:33 -05:00
![history-substring-search][fish_shell]
2015-12-15 00:12:17 -05:00
#### Syntax Highlighting
2015-12-15 00:43:33 -05:00
![syntax-highlighting][syntax_highlighting]
2015-12-15 00:12:17 -05:00
#### Speed
2015-12-18 07:40:11 -05:00
For a speed comparison between zim and other frameworks, see [this gist][zim_vs_others].
2015-12-15 00:12:17 -05:00
#### And much more!
Zim has many modules! Enable as many or as few as you'd like.
Installation
------------
Installing Zim is easy. If you have a different shell framework installed (like oh-my-zsh or prezto),
uninstall those first to prevent conflicts.
1. In Zsh, clone the repository:
```
git clone --recursive https://github.com/Eriner/zim.git ${ZDOTDIR:-$HOME}/.zim
```
2. Copy the template configuration files (or append to existing configs):
```
setopt EXTENDED_GLOB
for template_file ( ${ZDOTDIR:-$HOME}/.zim/templates/* ); do
cat ${template_file} | tee -a ${ZDOTDIR:-$HOME}/.$(basename ${template_file}) > /dev/null
done
```
3. Set Zsh as the default shell:
```
chsh -s $(which zsh)
```
4. Open a new terminal and admire your work!
2015-12-15 00:43:33 -05:00
2015-12-18 11:44:57 -05:00
[theme_minimal]: http://i.eriner.me/zim_prompt_minimal.png
2015-12-17 11:04:01 -05:00
[fish_shell]: https://i.eriner.me/zim_history-substring-search.gif
[syntax_highlighting]: https://i.eriner.me/zim_syntax-highlighting.gif
2015-12-18 07:40:11 -05:00
[zim_vs_others]: https://gist.github.com/Eriner/3aa88b161615c2913930