109 lines
3.5 KiB
Markdown
109 lines
3.5 KiB
Markdown
# Ente Auth
|
|
|
|
Ente's 2FA app. An end-to-end encrypted, cross platform and free app for
|
|
storing your 2FA codes with cloud backups. Works offline. You can even use it
|
|
without signing up for an account if you don't want the cloud backups or
|
|
multi-device sync.
|
|
|
|
|
|
|
|
## 📲 Download
|
|
|
|
### Android
|
|
|
|
This repository's [GitHub
|
|
releases](https://github.com/ente-io/ente/releases?q=tag%3Aauth-v2)
|
|
contains APKs, built straight from source. These builds keep themselves updated,
|
|
without relying on third party stores.
|
|
|
|
You can alternatively install the build from PlayStore or F-Droid.
|
|
|
|
<a href="https://play.google.com/store/apps/details?id=io.ente.auth">
|
|
<img height="59" src="../.github/assets/play-store-badge.png">
|
|
</a>
|
|
<a href="https://f-droid.org/packages/io.ente.auth/">
|
|
<img height="59" src="../.github/assets/f-droid-badge.png">
|
|
</a>
|
|
|
|
### iOS / Apple Silicon macOS
|
|
|
|
<a href="https://apps.apple.com/us/app/ente-authenticator/id6444121398">
|
|
<img height="59" src="../.github/assets/app-store-badge.svg">
|
|
</a>
|
|
|
|
### Desktop
|
|
|
|
You can [**download**](https://github.com/ente-io/ente/releases?q=tag%3Aauth-v2)
|
|
a native desktop app from this repository's GitHub releases. The desktop app
|
|
works on Windows, Linux and macOS.
|
|
|
|
### Web
|
|
|
|
You can view your 2FA codes at [auth.ente.io](https://auth.ente.io). For adding
|
|
or managing your secrets, please use our mobile or desktop app.
|
|
|
|
## 🧑💻 Build from source
|
|
|
|
1. [Install Flutter](https://flutter.dev/docs/get-started/install)
|
|
|
|
2. Pull in all submodules with `git submodule update --init --recursive`
|
|
|
|
3. For Android, [setup your
|
|
keystore](https://docs.flutter.dev/deployment/android#create-an-upload-keystore)
|
|
and run `flutter build apk --release --flavor independent`
|
|
|
|
4. For iOS, run `flutter build ios`
|
|
|
|
## ⚙️ Develop
|
|
|
|
For Android, use
|
|
|
|
```sh
|
|
flutter run -t lib/main.dart --flavor independent
|
|
```
|
|
|
|
For iOS, use `flutter run`
|
|
|
|
VSCode users might find it useful to copy [docs/vscode](docs/vscode) into a top
|
|
level `.vscode`.
|
|
|
|
If the code you're working needs to modify user facing strings, see
|
|
[docs/localization](docs/localization.md).
|
|
|
|
## 🔩 Architecture
|
|
|
|
The architecture that powers end-to-end encrypted storage and sync of your
|
|
tokens has been documented [here](../architecture/README.md).
|
|
|
|
## 🌍 Translate
|
|
|
|
[](https://crowdin.com/project/ente-authenticator-app)
|
|
|
|
If you're interested in helping out with translation, please visit our [Crowdin
|
|
project](https://crowdin.com/project/ente-photos-app) to get started. Thank you
|
|
for your support.
|
|
|
|
If your language is not listed for translation, please [create a GitHub
|
|
issue](https://github.com/ente-io/ente/issues/new?title=Request+for+New+Language+Translation&body=Language+name%3A)
|
|
to have it added.
|
|
|
|
## 🧑🎨 Icons
|
|
|
|
Ente Auth supports the icon pack provided by
|
|
[simple-icons](https://github.com/simple-icons/simple-icons). If you wish to add
|
|
more, see [docs/adding-icons](docs/adding-icons.md).
|
|
|
|
## 💚 Contribute
|
|
|
|
For more ways to contribute, see [../CONTRIBUTING.md](../CONTRIBUTING.md).
|
|
|
|
You can also support us by giving this project a ⭐ star on GitHub or by leaving
|
|
a review on
|
|
[PlayStore](https://play.google.com/store/apps/details?id=io.ente.auth),
|
|
[AppStore](https://apps.apple.com/us/app/ente-authenticator/id6444121398) or
|
|
[AlternativeTo](https://alternativeto.net/software/ente-authenticator/).
|
|
|
|
## ⭐️ About
|
|
|
|
To know more about Ente and the ways to get in touch or seek help, see [our main
|
|
README](../README.md) or visit [ente.io](https://ente.io).
|