Yi is a text editor written in Haskell and extensible in Haskell. The goal of Yi is to provide a flexible, powerful and correct editor core scriptable in Haskell.
Its features include
- a purely functional editor core;
- keybindings written as parsers of the input;
- Emacs, Vim and Cua (subset) emulations provided by default;
- Vty (terminal), Gtk-based Pango and Vte, UIs, as well as a Cocoa frontend in development.
The long term goal of the project is to make Yi the editor of choice for the haskell hacker. The main short term goal is to maximize Yi's Fun Factor. This means that we want to
- improve hackability (and therefore architecture) and
- add cool features.
We also want to simplify the core Yi package to make it more accessible, splitting some parts into several packages.
Other information (much of it old) is available on the Haskell wiki.
Yi requires the Haskell Platform 2011.2.0.0 at minimum (for GHC 7, alex, and cabal-install, among other things).
With the Haskell Platform installed, yi should be installed with cabal-install:
$ cabal update $ cabal install yi
On Linux systems, you'll probably need ncurses development headers for the Vty frontend. On Ubuntu, you'll need to install the
You can specify frontends to compile, also:
$ cabal install yi -fvty -fpango
-fcocoa. Some are likely broken.
You can also install the
yi-contrib package, which contains some extra contributed things (like user configs):
$ cabal install yi-contrib
If you're in the source repository, you can install yi from source:
$ cabal update # Still update to get updated dependencies $ (cd yi && cabal install)
And the contrib package:
$ (cd yi-contrib && cabal install)
To get the git version,
$ git clone git://github.com/yi-editor/yi.git
(There may be more repositories in the future, as yi is split more.)
Due to a cabal bug, documentation won't be generated when running 'cabal install yi'. Use the following workaround:
$ cabal install -fdochack yi
This command will install the yi library with documentation, but not the yi executable. To install the executable, simply run
$ cabal install yi
after the documentation has been generated.
Our mailing list is yi-devel, hosted at Google Groups. Please ask us questions on this list! All development discussion occurs on this list.
Yi uses the Dyre package to have dynamic reconfiguration. You can configure Yi by creating
~/.yi/yi.hs, and then Yi is reconfigured whenever you update this file. Example configuration files are in
yi/examples/ (copy any of these into
yi.hs and restart Yi).
You can also use the sample user configs in the
yi-contrib package (see the list of user configs in the source repository on GitHub). To use one of these configurations, install the package and then create a configuration file
~/.yi/yi.hs like this:
import Yi import Yi.Config.Users.Anders main = yi config
It's possible to customize even these user configs in the same way as the example configurations.
| Vty Pango Cocoa --------+---------------------- Linux | X X OSX | X X X Windows | X
Windows support for Vty may eventually come; patches on the vty package would certainly be appreciated.
The plan is to move the UI frontends into separate packages, but this has not yet happened.
You can run Yi without installing by running from the
dist directory. There's a
-fhacking flag in the Yi package to compile without dynamic reconfiguration. When used, it'll statically compile a
yi binary using the file
HackerMain.hs in the source repository (so you'll need to put a configuration file there before trying to compile with
$ cp ~/.yi/yi.hs HackerMain.hs $ cabal configure -fhacking $ cabal build $ ./dist/build/yi/yi
There's also a Makefile build script to do the same thing:
$ cp ~/.yi/yi.hs HackerMain.hs $ make run-inplace
If you're interested in optimizing Yi, the Makefile contains two example rules for profiling called
prof-config, depending on whether you want to use
make prof-config-hacking make run-inplace
make prof-config make install
Of course, feel free to adjust those rules to your needs. If you go for the prof-config variant, here's an example of how you then can run yi to get profiling output:
yi --force-recompile --ghc-options="-prof -auto-all" +RTS -p -hc