What?

This is an unofficial nightly build and mirror for Librechair. GitHub Actions sync and build apks at UTC 00:00. Please download them from here.

Why?

The CI/CD on gitlab is broken and new binaries are only available on Telegram which need tel number to access.

Librechair

Downloads

You can download directly from CI / CD or join the Telegram releases channel

Librechair-changed

The original project Lawnchair can be found here^Warning: ^LibreJS ^Incompatible. This project is a fork of Lawnchair that aims to remove non-free (proprietary) blobs from Lawnchair, and make it completely free (libre) software. Apart from features that require non-free blobs (Sesame) and features that require interfacing with non-free software (Google Feed), Librechair aims to track upstream Lawnchair. What this means is that new Lawnchair features will eventually show up in Librechair, sans those that require non-free blobs.

Librechair is not yet complete

Obviously, Librechair is not yet complete. The project still contains a single (though free) blob that needs to be inlined, and also requires several free blobs for compilation. The project will also aim to compile those inline or require installation as external tools.

Here's the complete roadmap:

[x] Remove Sesame
[x] Remove Feed
[x] Remove all search providers that require non-free software
    [-] Add replacement search providers using purely free software (ongoing work)
        [x] Just Search from F-Droid
        [ ] Searx (ongoing work)
        [*] KISS Launcher from F-Droid
        [*] Chromium
             [*] Bromite
[x] Remove all weather providers that require non-free software
[x] Remove all calendar providers that require non-free software
    [x] Add replacement calendar providers using purely free software
[x] Inline the SystemUI shared library
[ ] Remove all remanants of Google (ongoing work)
[ ] Inline the private platform API jar
[ ] Inline or eliminate build-tools blobs
[ ] De-smalify all Google smali blobs
[*] Find a smart way to de-smalify all AOSP smali blobs (completed upstream and merged; credits @paphonb)

Lawnchair -

Lawnchair is the customizable Pixel Launcher alternative. This Repository contains our full rewrite from scratch (simply known as V2), if you were looking for our older V1 sources you can find the archive here.

How to Contribute?

If you know Java/Android and have some Kotlin knowledge you should quickly be able to start contributing to Lawnchair. Make sure to generally add any new classes/resources to the lawnchair/ subdirectory and try to make as little changes as necessary directly inside Launcher3 code. Kotlin is preferred but we'll accept great contributions in Java as well. We'll happily accept all bug fixes and will most likely also accept your well thought out feature.

Adding a search provider

A great entry point to start to understand how we work is trying to add your own search provider. You can find existing providers to reference in the ch.deletescape.lawnchair.globalsearch.providers package. It is pretty self explanatory, all you really need to do is find an Intent to directly start the search in the app of your liking, and then add that to a new provider. After registering it in ch.deletescape.lawnchair.globalsearch.SearchProviderController your new provider should appear in the app and be ready for testing.

Building

Alright, I admit it, our build variants are a bit of a mess right now. Make sure to choose one of the variants prefixed quickstepLawnchairDev* from the "Build Variants" menu in Android Studio / IntelliJ. Our team is usually always on the latest stable version of Android Studio.

If you're redistributing Lawnchair, please avoid using the package name ch.deletescape.lawnchair.plah and ch.deletescape.lawnchair.ci as that will prevents users from updating to the official builds.

Translations

Wanna help us by translating Lawnchair to your own language? Just take a look at our Crowdin page.

Source releases

(this does not apply to Librechair, but only upstream Lawnchair. Librechair releases source per commit)

To make our problems with rip-offs a bit easier we will work in private development cycles but release our newest sources with every production release (beta, stable). This also means that any contributions will be cherry-picked to our tree internally, we'll notify you whenever we do this. We're going to keep releasing public alpha builds in-between cycles in the future.

Licensing

All of Lawnchairs additions to Launcher3 are licensed under GPLv3 and anyone wanting to use it (even in parts) has to adhere to this license, make sure to inform yourself before creating your own project based on Lawnchair. Here some guidelines to how we actually handle licensing in the case of Lawnchair (I am not a Lawyer, don't take this as legally binding advice):

• We will ALWAYS use all our legal options if you simply rename our app, strip it of all credit and upload it anywhere as your own, be this with or without monetization.
• Librechair does enforce the GPL clause which would force you to release the source of your entire project
• You are required to give us full credits for any work you may be using from us.
• If you're simply using Lawnchair as a reference for minor implementation details or utility functions (not entire features of our app) you can treat that as if it were licensed under Apache2 and properly credit us.
• We kindly ask you to use common sense and don't profit entirely off the work of others.
• If you have any questions regarding licensing or derivative works feel free to contact licensing@deletescape.ch

Graphics

The official Lawnchair graphics were designed by Josh Baldassarre & Lumiq Creative. Thanks a lot to those awesome designers!

Useful links

Website - Twitter - Telegram - XDA Thread - APK Mirror

Librechair-changed-contact-me

You can reach me at Po Lu < Luangruo (arse) Yahoo (dog) com >
You'd better fill in the E-Mail address.

I'm @oldosfan on Freenode. I might or might not be online.