Lantern allows you to give or get access to the internet through other users around the world connected by a peer-to-peer network.
Lantern is written in Java and runs on modern Mac, Windows, and Ubuntu Linux desktop systems.
Setting up a development environment
Ensure you have the requirements installed:
Clone the repository:
$ git clone git://github.com/getlantern/lantern.git
Change to the lantern directory:
$ cd lantern
Run the build-and-run script:
That script will fetch the required Java libraries, build, and
run Lantern. There's also a
quickRun.bash script that will run Lantern
when already built.
Lantern binds its HTTP API to a random port for security. You can pass
--api-port=xyz to override this. This is helpful for pointing external
browsers at Lantern for development.
If you want to run Lantern in headless mode, pass
is useful for running Lantern on a server without an X environment.
If you're running Linux, note that Lantern's UI currently targets the Ubuntu 12.04 desktop environment (i.e. Unity). Other environments may work as well but are currently untested and unmaintained.
If you want to load the Lantern source code in Eclipse, you can do the following:
Build the Eclipse project and classpath files:
$ mvn eclipse:eclipse
Load them into Eclipse using File->Import->General->Existing Projects into Workspace
Select the directory where you ran mvn eclipse:eclipse, and you should see the "lantern" project loaded into Eclipse.
You can also access JavaDocs and automatically generated reports on the Lantern codebase at the following: