thunderbird-android/README.md
2024-01-15 15:33:06 +01:00

83 lines
3.8 KiB
Markdown

# K-9 Mail
[![Latest release](https://img.shields.io/github/release/thunderbird/thunderbird-android.svg?style=flat-square)](https://github.com/thunderbird/thunderbird-android/releases/latest)
[![Latest beta release](https://img.shields.io/github/v/release/thunderbird/thunderbird-android.svg?include_prereleases&style=flat-square)](https://github.com/thunderbird/thunderbird-android/releases)
K-9 Mail is an open-source email client for Android.
## Download
K-9 Mail can be downloaded from a couple of sources:
- [Google Play](https://play.google.com/store/apps/details?id=com.fsck.k9)
- [F-Droid](https://f-droid.org/repository/browse/?fdid=com.fsck.k9)
- [Github Releases](https://github.com/thunderbird/thunderbird-android/releases)
You might also be interested in becoming a [tester](https://forum.k9mail.app/t/how-do-i-become-a-beta-tester/68) to get an early look at new versions.
## Release Notes
Check out the [Release Notes](https://github.com/thunderbird/thunderbird-android/wiki/ReleaseNotes) to find out what changed
in each version of K-9 Mail.
## Need Help?
If the app is not behaving like it should, you might find these resources helpful:
- [User Manual](https://docs.k9mail.app/)
- [Frequently Asked Questions](https://forum.k9mail.app/c/faq)
- [Support Forum](https://forum.k9mail.app/)
## Translations
Interested in helping to translate K-9 Mail? Contribute here:
- [K-9 Mail localization](https://hosted.weblate.org/projects/tb-android/)
## Contributing
Thank you for contributing! If you're unfamiliar with the code, start by reading the [developer documentation](docs/DESIGN.md)
Please fork this repository and contribute back using [pull requests](https://github.com/thunderbird/thunderbird-android/pulls).
Any contributions, large or small, major features, bug fixes, unit/integration tests are welcomed and appreciated
but will be thoroughly reviewed and discussed.
Please make sure you read the [Code Style Guidelines](https://github.com/thunderbird/thunderbird-android/wiki/CodeStyle).
### Architecture Decision Records (ADR)
We use [Architecture Decision Records](https://adr.github.io/) to document the architectural decisions made in the
development of K-9 Mail. You can find them in the [`docs/architecture/adr`](docs/architecture/adr) directory.
For more information about our ADRs, please see the [ADRs README](docs/architecture/adr/README.md).
We encourage team members and contributors to read through our ADRs to understand the architectural decisions that
have shaped this project so far. Feel free to propose new ADRs or suggest modifications to existing ones as needed.
## Communication
Aside from discussing changes in [pull requests](https://github.com/thunderbird/thunderbird-android/pulls) and
[issues](https://github.com/thunderbird/thunderbird-android/issues) we use the following communication services:
- Matrix: [#tb-android:mozilla.org](https://matrix.to/#/#tb-android:mozilla.org)
## Security
The code in this repository was undergoing an extensive security audit in collaboration with the Open Source Technology
Improvement Fund ([OSTIF](https://ostif.org/)) and [7ASecurity](https://7asecurity.com/) in the first half of 2023. For
more details, see
our [blog post](https://blog.thunderbird.net/2023/07/k-9-mail-collaborates-with-ostif-and-7asecurity-security-audit/).
## License
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.