Skip to content
thyponPublic

About

eLauncher - minimal eInk launcher (BDD + coverage gated)

Topics

Resources

Stars

69 stars

Watchers

1 watching

Forks

Repository files navigation

eLauncher

eLauncher logo

eLauncher is an extremely lightweight and minimal launcher for Android, based on NoLauncher and inspired by OLauncher Light, and OLauncher in general. It is even more barebones than OLauncher Light, and aims to provide only the most basic features.

eLauncher favours easy readibility on eInk/ePaper devices, such as the Onyx Boox Note series, and the Bigme HiBreak.

Features

  • Extremely lightweight: only 1010KB

  • eInk friendly: uses a light theme by default, fix text size and weight

  • Fuzzy Search: search for apps by typing their name

  • Bottom search bar in app drawer

  • Homescreen and app drawer: swipe up on homescreen to enter the app drawer

  • Long press an app field on the homescreen to assign an app, app can be renamed

  • Type to search in app drawer, if only one result is left, it is automatically launched (like OLauncher)

  • Gestures: swipe down for notification center, left/right swipe to launch any app (configurable in Settings), double tap to open the original launcher

  • Customizable swipe gestures: pick any app — or the built-in eBoard dashboard — for the left and right swipe via Settings

  • eBoard: a macOS-Snow-Leopard-style dashboard of persistent widgets, opened by the default left swipe (internal to the launcher: it has no launcher entry of its own and is not listed in the app drawer or search). The widget board is a single-column stack ported from Olauncher: per-widget tap modes (on / double tap / off), long-press editing with drag-to-reorder and vertical resize; hold on empty space for the widget adder

  • Hold on empty space to change the number of apps on homescreen

apk size differences with OLauncher Light

This might have been done on purpose, but OLauncher Light uses long deprecated APIs, like ListView to achieve its impressive 23 KB apk size. eLauncher uses RecyclerView, which is much better for performance and memory usage, and also uses many other newer APIs. Thus, the APK size is much larger than with OLauncher Light, but still really small — ~1 MB.

Download

You can download the apk file directly from the releases tab and install it manually.

You can also add the repository to the F-Droid client to receive the current build of master as an automatic update. In the client, go to Settings → Repositories → + and add:

https://thypon.github.io/eLauncher/fdroid/repo?fingerprint=2d19154ca98ad6d062cf0bfccdb2721536451b1d9a11b3f3690cbd9cf07f6555

Or scan the QR code from your phone (e.g. in the F-Droid client's repository screen):

QR code for the F-Droid repository URL

The SHA-256 fingerprint of the repository signing key is 2d19154ca98ad6d062cf0bfccdb2721536451b1d9a11b3f3690cbd9cf07f6555 (also printed in the summary of every run of the F-Droid repo workflow). Versions are built automatically on every push to master; the 30 newest builds are kept in the repository.

Contributing

Feel free to contribute if you found a bug or have a way to make the code more efficient or minimal, but please don't add massive new features. If you feel like adding a lot of customization options, widgets, etc. please start your own fork, as the scope of this project is to be as (reasonably) barebones of a launcher as possible.

Testing (Cucumber BDD + coverage gate)

Behavior specs live in Gherkin features (app/src/test/resources/features/) and run on the JVM via Robolectric — no emulator needed:

./gradlew check                      # runs the BDD suite, unit tests, and the coverage gate
./gradlew jacocoUnitTestReport       # HTML/XML coverage report
  • Feature files describe every launcher behavior (drawer, fuzzy search, homescreen slots, gestures, settings, first-launch onboarding, dark mode, last-used-app, vendor shims, eBoard dashboard).
  • Step definitions are in app/src/test/java/me/pompel/elauncher/bdd/steps/.
  • check fails the build when line coverage of the app source drops below 80% (jacocoTestCoverageVerification).
  • CI (.github/workflows/ci.yml) enforces the gate on every push and pull request.

Attribution

The eBoard widget system (the single-column stack, the per-widget tap modes, the touch dispatcher and the resize frame) is ported from Olauncher (GPL-3.0, © tanujnotes and Olauncher contributors), adapted for eInk: no crossfade animation and vertical-only resizing.

About

eLauncher - minimal eInk launcher (BDD + coverage gated)

Topics

Resources

Stars

69 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages