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.
Strongly Recommended
- 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
NonFreeNetAntiFeature (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):
- 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). - All 7 native libs' ELF
.commentsection 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-linkllvm-strip --strip-allpass 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). - libggml-base.so alone still differed even after (2): ggml's own
find_program(GIT_EXE)re-discovers a realgitbinary on any host that has one on PATH, re-embedding the true submodule commit hash regardless of an earlierGIT_EXE-NOTFOUNDcache pin (which only blocks hosts with no git at all). Fixed by overriding theGGML_COMMITcompile definition directly on theggml-basetarget afteradd_subdirectory(), since a repeated-Dfor 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.