feat: Trafero v0.2.0 - Tdarr v2 native Android client with slow-connection resilience

Full client for the Tdarr /api/v2 JSON API (jobs, library, nodes, stats, logs, settings, flows, multi-server switcher) plus v0.2.0 resilience: per-server timeout + slow-connection mode, retry-with-backoff on read polls, last-good-data + reconnecting chip, 60s poll backoff after repeated failures, and keep-alive eviction on app resume.

Includes GPL-3.0 licensing (LICENSE/NOTICE), README, CONTRIBUTING, PREVIOUS_HISTORY, issue/PR templates, CI release-notes script, keystore docs and the vendored OpenAPI 2.0 spec.
This commit is contained in:
nick committed 2026-09-21 17:46:29 +12:00
commit 312858e8f6
50 files changed
+4446

No files matched your search

+76
View File
@@ -0,0 +1,76 @@
name: Bug Report
description: Report something that isn't working as expected.
labels:
- kind/bug
body:
- type: input
id: summary
attributes:
label: Summary
description: One-line description of the bug.
placeholder: e.g. "Tapping the FAB doesn't open the editor"
validations:
required: true
- type: textarea
id: steps
attributes:
label: Steps to reproduce
description: What did you do, and what happened?
placeholder: |
1. Open the app
2. Tap ...
3. See error ...
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behaviour
description: What did you expect to happen?
validations:
required: true
- type: dropdown
id: severity
attributes:
label: Severity
description: How broken is it?
options:
- Low (cosmetic / minor inconvenience)
- Medium (feature broken but app still usable)
- High (core functionality broken)
- Critical (app crashes, data loss)
validations:
required: true
- type: input
id: app_version
attributes:
label: App version
description: Found in Settings → Apps → Trafero → App info, or via `adb shell dumpsys package com.trafero.app | grep versionName`.
placeholder: 0.2.0
validations:
required: true
- type: input
id: device
attributes:
label: Device & Android version
description: e.g. Pixel 7, Android 15; or `adb shell getprop ro.product.model` / `ro.build.version.release`.
placeholder: Pixel 7, Android 15
validations:
required: true
- type: textarea
id: logs
attributes:
label: Logs (optional)
description: |
If you can, attach a `logcat` snippet from the moment the bug occurred.
`adb logcat -d -v time | grep -i trafero` after reproducing the bug.
render: shell
validations:
required: false
- type: textarea
id: screenshots
attributes:
label: Screenshots / recordings
description: Drag-and-drop or paste links.
validations:
required: false
+61
View File
@@ -0,0 +1,61 @@
name: Feature Request
description: Suggest a new feature for Trafero.
labels:
- kind/feature
body:
- type: input
id: summary
attributes:
label: Summary
description: One-line description of the feature.
placeholder: e.g. "Add a push alert when the error stack grows"
validations:
required: true
- type: textarea
id: problem
attributes:
label: Problem / motivation
description: What problem does this solve? What can the user do today that they can't, or what do they do today that's harder than it should be?
validations:
required: true
- type: textarea
id: proposal
attributes:
label: Proposed solution
description: Describe how you imagine the feature working. Screenshots, mockups, or links welcome.
validations:
required: true
- type: textarea
id: alternatives
attributes:
label: Alternatives considered
description: What other approaches did you consider, and why is your proposal better?
validations:
required: false
- type: textarea
id: roadmap
attributes:
label: Roadmap relevance
description: |
Has someone asked for this before - link or mention any related issues.
If not, do you think it should be added there before implementing?
validations:
required: false
- type: dropdown
id: privacy
attributes:
label: Privacy impact
description: Does this feature touch anything that leaves the device, scans user data, or requires a new permission?
options:
- None — fully on-device
- Adds new on-device processing only
- Requires a new optional permission
- Requires network access (almost certainly out of scope for now)
validations:
required: true
- type: textarea
id: extra
attributes:
label: Anything else?
validations:
required: false
+58
View File
@@ -0,0 +1,58 @@
<!--
Thanks for the PR! Please keep this template filled in so reviewers can
move quickly. Delete any section that doesn't apply.
-->
## Summary
<!-- One or two sentences describing what this PR changes. -->
## Linked issues
<!-- "Fixes #123" / "Closes #456" / "Refs #789". Use "Fixes" only if this fully closes the issue. -->
## Type of change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that changes existing behaviour)
- [ ] Documentation / repo-meta (README, CONTRIBUTING, CI, templates — no app code change)
- [ ] Refactor (no functional change)
## How tested
<!-- Be specific. "Tested on my phone" is not enough. -->
- [ ] `./gradlew assembleDebug` is green locally
- [ ] Manual smoke test on a real device (Android 8.0+, ideally 12+ for dynamic colour)
- [ ] Unit tests added / updated (encouraged for `data/` parsing and repo logic)
- [ ] Gitea Actions build on this PR is green
If you added new UI, attach a screenshot or short screen recording.
## Privacy / permissions checklist
- [ ] No new Android permissions requested (Trafero needs INTERNET; nothing else should be needed)
- [ ] No analytics, telemetry, or third-party trackers introduced
- [ ] No analytics, telemetry, or crash-reporting SDK introduced; Trafero talks only to the user-configured Tdarr server
- [ ] If a new permission is genuinely required, the PR description explains why
## Documentation
- [ ] `README.md` updated (Features section + any new build steps)
- [ ] `PREVIOUS_HISTORY.md` has a `## v<VERSION>` section for the upcoming release (if user-visible)
- [ ] `CONTRIBUTING.md` still accurate (branch naming, commit format, etc.)
## Checklist
- [ ] I've read the [Contributing guide](./CONTRIBUTING.md)
- [ ] My commit messages follow Conventional Commits
- [ ] My changes don't add new dependencies that aren't justified
- [ ] I've tested on at least one real Android device
<!--
Maintainer notes — delete before merging:
- Confirm the Gitea Actions build is green before merging
- Confirm the PREVIOUS_HISTORY.md section for this version exists
- If user-visible, ensure the README's Features section is updated
-->