New app: Ramblr

Required

  • The app complies with the inclusion criteria
  • The original app author has been notified (and does not oppose the inclusion)
  • All related fdroiddata and RFP issues have been referenced in this merge request
  • There is an issue tracker and contact info of the author so that we can report bugs and contact the author.
  • The upstream app source code repo contains the app metadata (summary/description/images/changelog/etc) in a Fastlane or Triple-T folder structure
  • Releases are tagged and auto update is enabled

Suggested

  • External repos are added as git submodules instead of srclibs
  • Enable Reproducible Builds
  • Multiple apks for native code

About Ramblr

Ramblr is a floating-overlay dictation app: tap to record, tap to stop, and cleaned-up transcribed text is inserted into the currently focused field via Android's Accessibility Service. On-device transcription (sherpa-onnx) and on-device cleanup (llama.cpp GGUF) work fully offline. Cloud transcription/ cleanup via user-supplied API keys (OpenAI, Anthropic, Gemini, or a self-hosted OpenAI-compatible endpoint) is optional and off by default. GPL-3.0-only, source at https://github.com/trevornk/ramblr.

Original F-Droid blocker and how it was resolved

The app originally fetched a prebuilt sherpa-onnx AAR from GitHub Releases at build time, which F-Droid's no-network build sandbox does not allow. This was replaced with a full source build: sherpa-onnx is a pinned git submodule built via CMake, libonnxruntime.so comes from the com.microsoft.onnxruntime:onnxruntime-android Maven Central dependency (covered by Gradle dependency verification), and all 7 of sherpa-onnx's FetchContent-declared native source dependencies are vendored as pinned git submodules with FETCHCONTENT_SOURCE_DIR_* CMake overrides, so zero network access is needed at CMake configure time. Two of the 7 (kissfft, kaldifst) were transitive deps discovered only via a real local network-isolation build test (GitHub hosts blocked at /etc/hosts, restored and diffed afterward), not assumed from reading the CMake files.

Verified twice locally: once against the working tree, and once against a fresh clone of the pinned 7dc443d commit with --recurse-submodules. Both produced a successful assembleDebug, and the resulting APK was inspected to confirm it contains both lib/arm64-v8a/libonnxruntime.so and lib/arm64-v8a/libsherpa-onnx-jni.so.

Update from initial review

Addressed reviewer (@linsui) feedback in 23267c6:

  • Added an inline comment in the YAML explaining the NonFreeNet AntiFeature (optional cloud providers, user-supplied API key, off by default; on-device path is fully offline).
  • Removed the output: line — it matched F-Droid's own default gradle build output path and didn't need to be declared explicitly.

Reproducible-build fix (v1.0.13 -> v1.0.16)

Getting from "builds successfully" to "byte-identical to the developer's published APK" took three rounds of real root-causing against actual build-host artifacts (not guesswork):

  1. libggml-base.so embedded a build-host-dependent git commit hash (ggml's own CMake independently runs git rev-parse). Pinned to a host-independent fallback (v1.0.13, commit 1547d38).
  2. All 7 native libs' ELF .comment section differed -- each build host's linker pulls a different prebuilt NDK crt/libunwind object, appending a different linker-ident string. Fixed via a real post-link llvm-strip --strip-all pass hooked into the Gradle build (not a linker flag, which doesn't touch already-merged sections) (v1.0.16, building on v1.0.14/v1.0.15's iterations).
  3. libggml-base.so alone still differed even after (2): ggml's own find_program(GIT_EXE) re-discovers a real git binary on any host that has one on PATH, re-embedding the true submodule commit hash regardless of an earlier GIT_EXE-NOTFOUND cache pin (which only blocks hosts with no git at all). Fixed by overriding the GGML_COMMIT compile definition directly on the ggml-base target after add_subdirectory(), since a repeated -D for the same macro wins on both clang and gcc regardless of what ggml's own git lookup found (v1.0.16, commit 696c3dc).

Verified end to end: this MR's own pipeline (fdroid build job) now reports all native libraries byte-identical to the GitHub Releases reference APK and the signature-copy check succeeds.

Edited by Trevor Nash-Keller

Merge request reports

Loading
Loading