Mobile app for Ente Photos

Source code for our flagship mobile app. For us, this is our most important client app. This is where Ente started. This is what had the first commit.

commit a8cdc811fd20ca4289d8e779c97f08ef5d276e37
Author: Vishnu Mohandas <v****@****.***>
Date:   Wed Mar 25 01:29:36 2020 +0530

    Hello world

To know more about Ente, see our main README or visit ente.io.

To use Ente Photos on the web, see ../../../web. To use Ente Photos on the desktop, see ../../../desktop. There is a also a CLI tool for easy / automated exports.

If you're looking for Ente Auth instead, see ../auth.

📲 Installation

Android

The GitHub releases contain APKs, built straight from source. The latest build is available at ente.io/apk. These builds keep themselves updated, without relying on third party stores.

You can alternatively install the build from PlayStore or F-Droid.

iOS

🧑‍💻 Building from source

1. Install Flutter v3.32.8 and Rust.

2. Pull in all submodules with git submodule update --init --recursive

3. Enable repo git hooks git config core.hooksPath hooks

4. Install dependencies using one of these methods:

   • Using Melos (recommended): Install Melos with dart pub global activate melos, then from any folder inside mobile/, run melos run codegen:rust. This will install dependencies and generate Rust bindings.
   • Using Flutter directly: Run flutter pub get, then install Flutter Rust Bridge with cargo install flutter_rust_bridge_codegen and run flutter_rust_bridge_codegen generate in both this folder and in mobile/packages/rust.

5. On Android:

   • For development, run flutter run -t lib/main.dart --flavor independent

   • For building APK, setup your keystore and run flutter build apk --release --flavor independent

6. For iOS, run flutter build ios

Some common issues and troubleshooting tips are in docs/dev.

VSCode users might find it useful to copy docs/vscode into a top level .vscode.

📝 Localization

This project uses Flutter's built-in localization system configured via l10n.yaml.

• Localization files are auto-generated when you run flutter pub get
• The base localization file is lib/l10n/intl_en.arb
• Generated code appears in lib/generated/intl/
• To manually regenerate: flutter gen-l10n

See docs/translations.md for contributing translations.

🏙️ Attributions

City coordinates from Simple Maps

🌍 Translate

If you're interested in helping out with translation, please visit our Crowdin project to get started. Thank you for your support.

If your language is not listed for translation, please create a GitHub issue to have it added.

Certificate Fingerprints

• SHA1: E1:60:10:18:B6:B0:2E:A3:74:6F:90:67:50:30:29:75:0E:EF:6D:39
• SHA256: 35:ED:56:81:B7:0B:B3:BD:35:D9:0D:85:6A:F5:69:4C:50:4D:EF:46:AA:D8:3F:77:7B:1C:67:5C:F4:51:35:0B

To verify these fingerprints, use the following command:

apksigner verify --print-certs <path_to_apk>

💚 Contribute

For more ways to contribute, see ../../../CONTRIBUTING.md.