An open API service indexing awesome lists of open source software.

https://github.com/traewelldroid/traewelldroid

Android app for @Traewelling public transport check-in service
https://github.com/traewelldroid/traewelldroid

android bahn deutsche-bahn public-transport traewelling transit transport

Last synced: 4 months ago
JSON representation

Android app for @Traewelling public transport check-in service

Awesome Lists containing this project

README

          

# Träwelldroid

This is a community app for the open source project
[Träwelling](https://github.com/Traewelling/traewelling).

[![Übersetzungsstatus](https://translate.codeberg.org/widgets/traewelldroid/-/svg-badge.svg)](https://translate.codeberg.org/engage/traewelldroid/)
[![Gitmoji](https://img.shields.io/badge/gitmoji-%20😜%20😍-FFDD67.svg)](https://gitmoji.dev)

## Find us on

- [traewelldroid.de](https://traewelldroid.de)
- Mastodon

## Download the app

[Download on Google Play](https://play.google.com/store/apps/details?id=de.hbch.traewelling)
[Download on F-Droid](https://f-droid.org/packages/de.hbch.traewelling)

## How it is developed

The app is using the official Jetpack Compose framework by Google. Crashes of the app are detected
and transmitted by ACRA. For the production version of the app deployed to
Google Play, a self-hosted Acrarium instance is used. Feature Flags are possible and implemented via
a self-hosted Unleash instance.

## Setup

Personalised properties can be configured in the app-level `build.gradle` file.

| Property name | Usage | Mandatory |
|----------------------|--------------------------------------------------------------------------------------------------------------------------------------|------------|
| `OAUTH_CLIENT_ID` | The OAuth client id used for authentication with Träwelling. | Yes |
| `OAUTH_REDIRECT_URL` | The OAuth redirect URL | Yes |
| `REPO_URL` | The URL to the repository | No |
| `PRIVACY_URL` | URL to the privacy statement and imprint. | Yes |
| `UNLEASH_URL` | API URL to reach the Unleash API | No |
| `UNLEASH_KEY` | API Key for Unleash API | No |
| `WEBHOOK_URL` | URL for accepting Träwelling webhooks | No |
| `ENABLE_ACRA` | Enable ACRA reporting. | Yes |
| `ACRA_REPORT_MAIL` | Mail to which ACRA reports are sent in FOSS. | Yes (foss) |
| `ACRA_ENDPOINT` | Endpoint for ACRA compatible server | Yes (play) |
| `ACRA_USERNAME` | Username for ACRA compatible server | Yes (play) |
| `ACRA_PASSWORD` | Password for ACRA compatible server | Yes (play) |

## Contributions

I'm always happy for contributions in any way! Is there something that could be improved on
Träwelldroid? Just [create an issue](https://github.com/Traewelldroid/traewelldroid/issues/new/choose)
and tell us about your concerns or ideas!

Of course you're also free to contribute code by yourself! Just fork the repo, do your changes and
simply submit a PR. Thank you! 😊