Building

Platform specific instructions

• Arch Linux
• Debian (Sid)
• Mac OS X (10.9 / Mavericks)
• Ubuntu (14.04)
• Ubuntu (13.10)
• Vagrant
• Windows
• Fedora 21

Install required components

• Python 3.4
• Oniguruma
• Git
• Mercurial
• Go 1.4 installed and some familiarity with writing code in Go.

Download the needed repositories

go get github.com/limetext/lime/frontend/... 

If you have various other go code on your machine, it's possible that your local code of those libraries are stale and need to be updated. In that instance you can run the following command that will update all dependencies:

go get -u github.com/limetext/lime/frontend/...

We also need to init and update all submodules which isn't done automatically by go get.

cd $GOPATH/src/github.com/limetext/lime
git submodule update --init

Make sure it works as expected

go test github.com/limetext/lime/backend/... github.com/limetext/lime/frontend/...

Common build errors and solutions

/xxx/github.com/limetext/text/settings.go:69: method s.onChange is not an expression, must be called

You are building using Go 1.0, please update to the newest Go release.

clang: error: argument unused during compilation: '-fno-eliminate-unused-debug-types'

You are using a version of Go < 1.2. Please update to the newest Go release. If you have a proper gcc installed (not just an alias for clang), you can also try setting the environment variable CC to gcc.

Package oniguruma was not found in the pkg-config search path.

On Ubuntu Saucy, add the oniguruma.pc file to your /usr/lib/pkgconfig directory. Or alternatively, export PKG_CONFIG_PATH before running go get:

export PKG_CONFIG_PATH=$GOPATH/src/github.com/limetext/rubex

Package python3.4 was not found in the pkg-config search path.

On Ubuntu:

sudo add-apt-repository ppa:fkrull/deadsnakes
sudo apt-get update
sudo apt-get install python3.4 python3.4-dev

inconsistent definitions for C.PyLong_AsLong or similar

Try updating to Go 1.3.3

To use termbox frontend

cd $GOPATH/src/github.com/limetext/lime/frontend/termbox
go build
./termbox main.go

Press Ctrl+Q to exit.

To use qml frontend

Presuming qml is already installed:

On Ubuntu Saucy, you have to download QT 5.2, and export LIBRARY_PATH=/your/installation/location.

cd $GOPATH/src/github.com/limetext/lime/frontend/qml
go build
./qml

To use HTML frontend

cd $GOPATH/src/github.com/limetext/lime/frontend/html
go run main.go

If you run into cannot find package "code.google.com/p/go.net/websocket" in any of:, you are missing the websocket module and have to install it.

go get code.google.com/p/go.net/websocket