Felice
======

A custom build of [Fennec F-Droid](https://f-droid.org/packages/org.mozilla.fennec_fdroid/).

Changes from Fennec F-Droid
----------------------------

- **Extension signing disabled**: Mozilla's mandatory addon signature verification is removed at both compile time (`MOZ_REQUIRE_SIGNING`) and runtime (`xpinstall.signatures.required = false`). You can install any `.xpi` extension without Mozilla's approval.
- **Default homepage**: Opens to `https://smesh.lol` instead of the Firefox default.
- **Distinct app ID**: Installs as `lol.smesh.felice` — coexists with Fennec F-Droid on the same device.
- **Branded as "Felice"** in the launcher and throughout the UI.

Everything else is identical to Fennec F-Droid: proprietary Google components removed, microG substituted, telemetry/crash reporting disabled, additional privacy-respecting search engines included, UnifiedPush support.

Download
--------

[felice.apk](felice.apk) — arm64 build for modern Android phones and tablets.

Build
-----

Requires: Debian/Arch Linux, Android SDK (build-tools 36.1, platforms android-36.1, NDK 29), Rust 1.93, Gradle, CMake, Clang, LLD, NASM, terser, cbindgen 0.29.2, JDK 17.

1. Clone source libraries into `../srclib/` at the versions specified in the [F-Droid metadata](https://gitlab.com/fdroid/fdroiddata/-/blob/master/metadata/org.mozilla.fennec_fdroid.yml).

2. Run prebuild and build:
```sh
./prebuild.sh 149.0.2 1490220
./build.sh
```

3. Sign the output APK:
```sh
apksigner sign --ks felice.keystore --out felice.apk \
  ../srclib/MozFennec/obj/gradle/build/mobile/android/fenix/app/outputs/apk/release/app-*-release-unsigned.apk
```

Licenses
--------

Scripts: GNU Affero General Public License v3+.
Patch changes: Apache 2.0 or MPL 2.0 per original file headers.
Artwork: MPL 2.0.