Project for 3rd-party Linux app-installations, using modularized runtimes and PyPI-like software distribution
Clone or download

README.md

Limba

Limba provides developers with a way to easily create software bundles for their applications which run on multiple Linux distributions. It provides atomic upgrades of software, simultaneous installation of multiple software versions and a simple way to obtain and upgrade software.

It is based on ideas of Glick2 and Listaller, and uses modern Linux kernel features to allow applications to share libraries and other components, reducing the amount of duplicate software components running on a Linux system while still getting all the advantages obtained by bundling software components.

Limba logo

Releases

You can find official, signed release tarballs here: people.freedesktop.org/~mak/limba/releases

If you want to test the latest changes, you should consider cloning the Git repository instead.

Getting started with Limba

Running Limba applications

In order to build & run Limba applications, you will need a Linux kernel supporting OverlayFS1 and multiple OverlayFS layers. This is at least Linux 4.0.

Applications installed with Limba will nicely integrate with your desktop-environment, and should not look different from native applications.

Building Limba packages

We have brief instructions on how to create new Limba packages in the documentation.

Examples

There are some examples on Limba bundle creation available. They are intended to show how bundling works, and are usually not complete. A complex example showing how to automatically create Limba packages is Limba-Neverball.

Documentation & other resources

You can find documentation about Limba here. The documentation is a work in progress, please send pull-requests or bug reports in case you encounter missing bits or errors. Limba is used by a repository service called LimbaHub, which is able to manage large Limba repositories (unlike the minimal repository manager included in limba-build). You might want to check out it's source code and help developing the repository service.

Developing Limba

Dependencies

  • glib2 (>= 2.46)
  • GObject-Introspection
  • AppStream 2
  • PolicyKit
  • libarchive 3
  • GPGMe 4
  • libuuid
  • libcurl
  • systemd (optional)

Build instructions

Build Status

Ensure all build dependencies are installed. Then run the following commands to compile (and install) Limba:

mkdir build && cd build
cmake ..
make
sudo make install

Testing Limba

Run make test first, This will produce two packages (file extension .ipk) in the tests/data directory. You can install these packages using

sudo limba install-local file.ipk

One package depends on the other (so runtime generation and dependencies can be tested in the testsuite), this means you will have to install the library first. You can list all installed software using the limba list command. The FooBar demo application can be run by executing

runapp foobar/1.0:/bin/foo

or simply by using the link which should have been installed into the GUI application menu of your desktop environment. If you want to remove the software again, just use the limba remove command.

A more complex example can be found at the Limba-Neverball repository. It shows how to build a Limba package, and how to distribute it via a software source. Just take a look at the instructions there.

Contributing

Translations

You can help localizing Limba! Take a look at the Transifex Project. New languages will be approved as soon as possible.

Code, Bugs, Documentation, etc.

Just create a pull request or submit a patch via the issue tracker or email. The software is subjected to the LGPLv2+ and GPLv2+ licenses.