mirror of https://github.com/bitwarden/android.git synced 2026-05-21 11:56:35 -05:00

Files

Andre Rosado 79c15ea9d5 [BWA-99] feat: Add Preview Next TOTP Code setting

Adds a user-controlled "Show next code" toggle in authenticator
settings. When enabled, the upcoming TOTP code is rendered below the
current code for each TOTP item in the list, letting users see incoming
codes without waiting for the rollover. HOTP items are excluded since
next-code generation requires advancing the counter.

2026-04-27 12:20:25 +01:00

schemas/com.bitwarden.authenticator.data.authenticator.datasource.disk.database.AuthenticatorDatabase

Rename app package to authenticator (#305 )

2025-02-12 22:13:07 +00:00

src

[BWA-99] feat: Add Preview Next TOTP Code setting

2026-04-27 12:20:25 +01:00

.gitignore

Rename app package to authenticator (#305 )

2025-02-12 22:13:07 +00:00

build.gradle.kts

PM-31922: Remove deprecated Android block where possible (#6512 )

2026-02-11 15:55:33 +00:00

proguard-rules.pro

Rename app package to authenticator (#305 )

2025-02-12 22:13:07 +00:00

README.md

Remove Gitter chat badge from README (#6612 )

2026-03-04 17:54:54 +00:00

README.md

Bitwarden Authenticator Android App

Bitwarden Authenticator allows you easily store and generate two-factor authentication codes on your device. The Bitwarden Authenticator Android application is written in Kotlin.

Compatibility

Minimum SDK: 28 (Android 9)
Target SDK: 36 (Android 16)
Device Types Supported: Phone and Tablet
Orientations Supported: Portrait and Landscape

Setup

Clone the repository:

$ git clone https://github.com/bitwarden/authenticator-android

Create a user.properties file in the root directory of the project and add the following properties:
- gitHubToken: A "classic" Github Personal Access Token (PAT) with the read:packages scope (ex: gitHubToken=gph_xx...xx). These can be generated by going to the Github tokens page. See the Github Packages user documentation concerning authentication for more details.
Setup the code style formatter:

All code must follow the guidelines described in the Code Style Guidelines document. To aid in adhering to these rules, all contributors should apply docs/bitwarden-style.xml as their code style scheme. In IntelliJ / Android Studio:
- Navigate to Preferences > Editor > Code Style.
- Hit the Manage button next to Scheme.
- Select Import.
- Find the bitwarden-style.xml file in the project's docs/ directory.
- Import "from" BitwardenStyle "to" BitwardenStyle.
- Hit Apply and OK to save the changes and exit Preferences.
Note that in some cases you may need to restart Android Studio for the changes to take effect.

All code should be formatted before submitting a pull request. This can be done manually but it can also be helpful to create a macro with a custom keyboard binding to auto-format when saving. In Android Studio on OS X:
- Select Edit > Macros > Start Macro Recording
- Select Code > Optimize Imports
- Select Code > Reformat Code
- Select File > Save All
- Select Edit > Macros > Stop Macro Recording
This can then be mapped to a set of keys by navigating to Android Studio > Preferences and editing the macro under Keymap (ex : shift + command + s).

Please avoid mixing formatting and logical changes in the same commit/PR. When possible, fix any large formatting issues in a separate PR before opening one to make logical changes to the same code. This helps others focus on the meaningful code changes when reviewing the code.

Contribute

Code contributions are welcome! Please commit any pull requests against the main branch. Learn more about how to contribute by reading the Contributing Guidelines. Check out the Contributing Documentation for how to get started with your first contribution.

Security audits and feedback are welcome. Please open an issue or email us privately if the report is sensitive in nature. You can read our security policy in the SECURITY.md file.