From 312858e8f64032c09cd22b40d3c5b788029ebe9c Mon Sep 17 00:00:00 2001 From: nick Date: Mon, 21 Sep 2026 17:46:29 +1200 Subject: [PATCH] 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. --- .gitea/ISSUE_TEMPLATE/bug_report.yml | 76 +++ .gitea/ISSUE_TEMPLATE/feature_request.yml | 61 ++ .gitea/PULL_REQUEST_TEMPLATE.md | 58 ++ .gitignore | 38 ++ CONTRIBUTING.md | 136 ++++ LICENSE | 634 ++++++++++++++++++ NOTICE | 38 ++ PREVIOUS_HISTORY.md | 27 + README.md | 57 ++ app/build.gradle.kts | 97 +++ app/proguard-rules.pro | 1 + app/src/main/AndroidManifest.xml | 26 + app/src/main/assets/api-docs-v2.json | 1 + .../com/trafero/app/data/api/TdarrClient.kt | 179 +++++ .../java/com/trafero/app/data/model/Models.kt | 123 ++++ .../com/trafero/app/data/repo/TraferoRepo.kt | 356 ++++++++++ .../com/trafero/app/data/store/ServerStore.kt | 62 ++ .../java/com/trafero/app/di/AppContainer.kt | 16 + .../main/java/com/trafero/app/ui/AppRoot.kt | 175 +++++ .../java/com/trafero/app/ui/MainActivity.kt | 26 + .../com/trafero/app/ui/common/Components.kt | 198 ++++++ .../java/com/trafero/app/ui/common/Format.kt | 38 ++ .../java/com/trafero/app/ui/common/Polling.kt | 91 +++ .../app/ui/screens/flows/FlowsScreen.kt | 75 +++ .../trafero/app/ui/screens/jobs/JobsScreen.kt | 318 +++++++++ .../app/ui/screens/library/LibraryScreen.kt | 245 +++++++ .../trafero/app/ui/screens/logs/LogsScreen.kt | 86 +++ .../trafero/app/ui/screens/more/MoreScreen.kt | 26 + .../app/ui/screens/nodes/NodesScreen.kt | 146 ++++ .../app/ui/screens/onboarding/Onboarding.kt | 42 ++ .../app/ui/screens/settings/ServerEditor.kt | 212 ++++++ .../app/ui/screens/settings/SettingsScreen.kt | 192 ++++++ .../app/ui/screens/stats/StatsScreen.kt | 104 +++ .../java/com/trafero/app/ui/theme/Theme.kt | 29 + .../java/com/trafero/app/util/JsonUtil.kt | 34 + .../main/java/com/trafero/app/util/UrlUtil.kt | 25 + .../res/drawable/ic_launcher_background.xml | 6 + .../res/drawable/ic_launcher_foreground.xml | 11 + .../res/mipmap-anydpi-v26/ic_launcher.xml | 6 + .../mipmap-anydpi-v26/ic_launcher_round.xml | 6 + app/src/main/res/values/strings.xml | 4 + build.gradle.kts | 6 + gradle.properties | 7 + gradle/libs.versions.toml | 39 ++ gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 43583 bytes gradle/wrapper/gradle-wrapper.properties | 7 + gradlew | 160 +++++ keystore/README.md | 42 ++ scripts/ci/release-notes.py | 88 +++ settings.gradle.kts | 16 + 50 files changed, 4446 insertions(+) create mode 100644 .gitea/ISSUE_TEMPLATE/bug_report.yml create mode 100644 .gitea/ISSUE_TEMPLATE/feature_request.yml create mode 100644 .gitea/PULL_REQUEST_TEMPLATE.md create mode 100644 .gitignore create mode 100644 CONTRIBUTING.md create mode 100644 LICENSE create mode 100644 NOTICE create mode 100644 PREVIOUS_HISTORY.md create mode 100644 README.md create mode 100644 app/build.gradle.kts create mode 100644 app/proguard-rules.pro create mode 100644 app/src/main/AndroidManifest.xml create mode 100644 app/src/main/assets/api-docs-v2.json create mode 100644 app/src/main/java/com/trafero/app/data/api/TdarrClient.kt create mode 100644 app/src/main/java/com/trafero/app/data/model/Models.kt create mode 100644 app/src/main/java/com/trafero/app/data/repo/TraferoRepo.kt create mode 100644 app/src/main/java/com/trafero/app/data/store/ServerStore.kt create mode 100644 app/src/main/java/com/trafero/app/di/AppContainer.kt create mode 100644 app/src/main/java/com/trafero/app/ui/AppRoot.kt create mode 100644 app/src/main/java/com/trafero/app/ui/MainActivity.kt create mode 100644 app/src/main/java/com/trafero/app/ui/common/Components.kt create mode 100644 app/src/main/java/com/trafero/app/ui/common/Format.kt create mode 100644 app/src/main/java/com/trafero/app/ui/common/Polling.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/flows/FlowsScreen.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/jobs/JobsScreen.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/library/LibraryScreen.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/logs/LogsScreen.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/more/MoreScreen.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/nodes/NodesScreen.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/onboarding/Onboarding.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/settings/ServerEditor.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/settings/SettingsScreen.kt create mode 100644 app/src/main/java/com/trafero/app/ui/screens/stats/StatsScreen.kt create mode 100644 app/src/main/java/com/trafero/app/ui/theme/Theme.kt create mode 100644 app/src/main/java/com/trafero/app/util/JsonUtil.kt create mode 100644 app/src/main/java/com/trafero/app/util/UrlUtil.kt create mode 100644 app/src/main/res/drawable/ic_launcher_background.xml create mode 100644 app/src/main/res/drawable/ic_launcher_foreground.xml create mode 100644 app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml create mode 100644 app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml create mode 100644 app/src/main/res/values/strings.xml create mode 100644 build.gradle.kts create mode 100644 gradle.properties create mode 100644 gradle/libs.versions.toml create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 keystore/README.md create mode 100755 scripts/ci/release-notes.py create mode 100644 settings.gradle.kts diff --git a/.gitea/ISSUE_TEMPLATE/bug_report.yml b/.gitea/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..9b47e9f --- /dev/null +++ b/.gitea/ISSUE_TEMPLATE/bug_report.yml @@ -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 diff --git a/.gitea/ISSUE_TEMPLATE/feature_request.yml b/.gitea/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..9ea2bcc --- /dev/null +++ b/.gitea/ISSUE_TEMPLATE/feature_request.yml @@ -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 diff --git a/.gitea/PULL_REQUEST_TEMPLATE.md b/.gitea/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..b872737 --- /dev/null +++ b/.gitea/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,58 @@ + + +## Summary + + + +## Linked issues + + + +## 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 + + + +- [ ] `./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` 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 + + diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..65c4479 --- /dev/null +++ b/.gitignore @@ -0,0 +1,38 @@ +# Gradle +.gradle/ +build/ +!**/src/**/build/ +!**/test/**/build/ + +# Release keystore — generated locally, never committed. +# See keystore/README.md for instructions for regenerating the dev key. +keystore/*.jks +keystore/*.keystore +keystore/*.p12 +!keystore/README.md + +# Android Studio / IntelliJ +.idea/ +*.iml +*.iws +*.ipr +local.properties +captures/ +.externalNativeBuild/ +.cxx/ + +# Kotlin +.kotlin/ + +# VS Code +.vscode/ + +# OS +.DS_Store +Thumbs.db + +# Built APKs at the repo root (stamped with version — release CI builds live +# under build/outputs and are attached to Gitea Releases, never committed). +Trafero-*.apk +*.apk +trafero_next_plan.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..d6c5cec --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,136 @@ +# Contributing to Trafero + +First off, thank you for taking the time to contribute! 🎉 Trafero is a +small, self-hosted-community project and every contribution — bug +reports, documentation fixes, code — makes a real difference. + +## How can I contribute? + +There are several ways you can help: + +### 🐛 Reporting bugs +Open a [bug report](.gitea/ISSUE_TEMPLATE/bug_report.yml) on the issue +tracker. Include: +- Device model and Android version +- App version (`Settings → Apps → Trafero → App info` or `adb shell dumpsys package com.trafero.app`) +- Your Tdarr server version and how the phone reaches it (LAN / VPN / Wi-Fi repeater) — connection issues depend heavily on this +- Steps to reproduce, expected vs actual behaviour +- Screenshots or screen recordings if relevant + +### 💡 Suggesting features +Open a [feature request](.gitea/ISSUE_TEMPLATE/feature_request.yml). +Before you do, check the existing issues — the feature you want may +already be on the roadmap. Note that flow editing, node/server restart, +the updater and disk-delete actions are **deliberately out of scope** +(agreed safety scope — Trafero should never destroy media). + +### 🔧 Submitting code changes +Open a pull request. See the workflow below. + +--- + +## Development workflow + +### 1. Pick something to work on +- Check existing issues for `good first issue` or `help wanted` labels. + +### 2. Branch +- Branch off `main`. +- Use a descriptive name: + - `feat/node-queue-charts` + - `fix/log-follow-scroll` + - `refactor/json-helpers` + +### 3. Make your changes +- Follow the existing code style (Kotlin official style; Compose + conventions as already used in the codebase). +- Single `:app` module: API plumbing in `data/api` + `data/repo`, + screens under `ui/screens/*`, shared bits in `ui/common`. +- **Never add calls that mutate the server** (start/stop/edit/delete) + unless the issue explicitly asks for them and the safety of the call + is discussed first. +- Update `PREVIOUS_HISTORY.md` if your change is user-visible. + +### 4. Verify locally +```bash +./gradlew assembleDebug +adb install -r app/build/outputs/apk/debug/app-debug.apk +``` +…then run through the affected screens against a real Tdarr server. +Release builds additionally need the dev keystore — see +[`keystore/README.md`](./keystore/README.md). + +### 5. Commit +We use [Conventional Commits](https://www.conventionalcommits.org/). +Per-version user-facing notes live in `PREVIOUS_HISTORY.md` — the +release CI attaches the matching section to each Gitea release +automatically. Write each note (paragraph or bullet) as **one complete +line — do not hard-wrap it**: the CI copies the section verbatim, so +manual line breaks ship as premature returns, and the release UI +reflows the text for you. + +Commit types: + +| Type | Use for | +|------|---------| +| `feat:` | new user-visible feature | +| `fix:` | bug fix | +| `chore:` | maintenance (deps, tooling, no user impact) | +| `docs:` | documentation only | +| `refactor:` | code change that neither fixes a bug nor adds a feature | +| `test:` | adding or fixing tests | + +### 6. Open a Pull Request +- Push your branch and open a PR against `main`. +- Fill out the [PR template](./.gitea/PULL_REQUEST_TEMPLATE.md). +- A Gitea Actions build will run automatically — make sure it passes. +- A maintainer will review; expect 1–2 rounds of feedback on your first PR. + +--- + +## GPL-3.0 contribution terms + +Trafero is licensed under the **GNU General Public License v3.0**. +By submitting a contribution, you affirm: + +1. The contribution is your own original work, **or** you have the right + to submit it under the GPL-3.0. +2. You agree your contribution is licensed under GPL-3.0 (or a + compatible licence) and that the project may redistribute it under + those terms. + +If you're contributing on behalf of an employer or as part of +work-for-hire, please confirm you have authority to license the work +under GPL-3.0 before opening the PR. + +--- + +## Code style + +- **Kotlin:** [Kotlin coding conventions](https://kotlinlang.org/docs/coding-conventions.html). +- **Compose:** Prefer stateless composables, hoist state, use + `Modifier` parameter ordering `Modifier.size().background().clickable()`. +- **Imports:** Wildcard imports are discouraged. Group: Android → + Compose → third-party → internal. +- **Naming:** `PascalCase` for types, `camelCase` for functions/properties, + `UPPER_SNAKE_CASE` for constants. +- **Strings:** Hard-coded UI strings in the UI layer are fine for now; + once translation infrastructure lands, user-visible strings must move + to `strings.xml`. + +--- + +## Release process (for maintainers) + +> **Version scheme:** plain semver `MAJOR.MINOR.PATCH` — e.g. `0.2.0`. +> `versionCode` is a monotonic int and always +1 per release. + +1. Bump `versionCode` (+1) and `versionName` in `app/build.gradle.kts`. +2. Add the `## v — ` section to `PREVIOUS_HISTORY.md`. +3. Tag the commit: `git tag -a vX.Y.Z -m "vX.Y.Z — short summary"`. +4. `./gradlew assembleDebug assembleRelease` — confirm both green. +5. Push the tag: `git push origin vX.Y.Z` — the release workflow builds, + publishes the Gitea release with notes, and attaches both APKs plus + `Trafero--changes.md`. + +Thanks again for contributing! 🙏 diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..1039f5e --- /dev/null +++ b/LICENSE @@ -0,0 +1,634 @@ + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies of this + license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. + + Installation information for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to +a network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise is void, and will +automatically terminate your rights under this License (including any +patent licenses granted under the third paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, and import the work that is licensed +in this License, for the term of that patent. This patent license +grants permission to the licensee's customers and partners to use the +program in conjunction with the licensor's contribution, in the +absence of any patent license granted to the recipient, and the +patent license is not transferable to recipients who receive copies +of the program from the licensee. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits, or conditions its exercise on +exercise of rights under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + If you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU General Public License v3. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the work with which it is combined will remain governed by version +3 of the GNU General Public License. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised or new versions of +the GNU General Public License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in +detail to address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain version of the GNU General Public +License "or any later version" applies to it, you may choose to follow +either the GNU General Public License version 3 or any later version +published by the Free Software Foundation. If the Program does not +specify a version number of the GNU General Public License, you may +choose any version ever published by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING +ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF +THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO +LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU +OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. For more information on this, and how to apply and follow the +GNU GPL, see . + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/NOTICE b/NOTICE new file mode 100644 index 0000000..6732293 --- /dev/null +++ b/NOTICE @@ -0,0 +1,38 @@ +Trafero +Copyright (C) 2026 The Trafero contributors + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . + +================================================================================ + +Third-Party Components + +This project includes or depends on the following third-party libraries. +Each is used in accordance with its own license terms; full license +texts are available in the respective upstream repositories. + +- Kotlin (Apache License 2.0) — Copyright JetBrains s.r.o. and respective contributors +- Jetpack Compose & Material 3 (Apache License 2.0) — Copyright The Android Open Source Project +- AndroidX libraries incl. Lifecycle, Navigation, DataStore (Apache License 2.0) — Copyright The Android Open Source Project +- kotlinx.coroutines (Apache License 2.0) — Copyright JetBrains s.r.o. +- kotlinx.serialization (Apache License 2.0) — Copyright JetBrains s.r.o. +- OkHttp (Apache License 2.0) — Copyright Square, Inc. and OkHttp contributors +- Gradle (Apache License 2.0) — Copyright Gradle Inc. + +A full machine-readable bill of materials will be added in a future +release. + +Trafero is an independent client for the Tdarr media transcode server. +It is not affiliated with, endorsed by, or sponsored by the Tdarr +project. "Tdarr" is a trademark of its respective owner. diff --git a/PREVIOUS_HISTORY.md b/PREVIOUS_HISTORY.md new file mode 100644 index 0000000..c799d7a --- /dev/null +++ b/PREVIOUS_HISTORY.md @@ -0,0 +1,27 @@ +# Trafero — Previous Release History + +Reference archive of Trafero's user-facing release history. + +Current downloads ship **with their own notes**: every release on the [Releases page](https://git.trevena.info/nick/Trafero/releases) carries its version's changelog — rendered in the release description and also attached beside the APKs as `Trafero--changes.md`. The CI generates both from the matching section below via `scripts/ci/release-notes.py` at tag-build time. + +**Adding a release:** append a `## v — ` section at the top of this file. Newest first; never delete or reorder older sections — the CI must find a section for whatever tag it builds. If a tag has no section, the release falls back to a plain "Release " description. + +--- + +## v0.2.0 — 2026-09-21 + +> **⚠️ Reinstall required for phone installs of the debug build.** This is the first Trafero release built and signed by CI. Release APKs are signed with the persistent CI keystore, which is a **different signing key** from locally-built debug APKs (such as the v0.1.1 debug install most testers have). Android refuses to install over a different signature — uninstall the old app first, then install either APK from this release. From v0.2.0 onwards, debug↔release stay separate apps but release→release upgrades are normal in-place updates. + +- **Slow-connection resilience.** Tdarr servers reached over VPN, Wi-Fi repeaters or powerline adapters often stall mid-request; Trafero now rides those out instead of showing a dead-end "Connection timed out" banner. +- **Per-server timeout settings.** The server editor now exposes a connect-timeout field (default 20 s; read timeout scales ×4.5 to 90 s) plus a **"Slow connection"** switch that doubles every timeout for high-latency links. Timeouts are saved per server profile. +- **Automatic retry for read-style calls.** Polling and screen-load requests retry up to two times with 2 s / 5 s backoff on network failures only. Actions you trigger yourself (cancel job, pause node, approve transcode, scans) are never silently repeated. +- **"reconnecting…" chip instead of error walls.** When a poll fails transiently while the screen already shows data, the last good data stays on screen with a slim reconnecting indicator; the full error banner now only appears when nothing has loaded, or when the problem is authentication or a server error (these are now clearly distinguished). +- **Nerfed failure storms.** After three consecutive poll failures a screen backs off to one retry per minute until the server answers again; returning to the foreground (or switching tabs) retries immediately and evicts stale keep-alive sockets so the next request opens a fresh connection. + +## v0.1.1 — 2026-09-21 + +- **First public build.** Native Kotlin / Jetpack Compose (Material 3) client for the Tdarr v2.2x+ `/api/v2` JSON API: connection wizard with multi-server switcher (no-auth / API key / login, self-signed TLS support), running workers with progress/fps/ETA and cancel, staged queue approve/reject, job history and error stacks, library search with per-library filter, sort and file detail sheets (ffprobe streams, plugin output, re-check), node pause/resume with worker limits and kill, server stats with transcode/health donuts and codec mix, live server log, global settings, library scans and a read-only flow-plugin catalog. +- **Fixed:** first (onboarding/server) screen rendered on the light platform window background — now dark and readable everywhere; cold-start white flash gone (DayNight window theme + Compose Surface base layer). +- **Fixed:** "Connection timed out" after the app was backgrounded — polling is now lifecycle-aware (pauses in background, refetches instantly on resume) and OkHttp keep-alive is 30 s so stale LAN sockets are evicted. +- **Fixed:** Stats donut rendered oversized and crushed its legend. +- Library cards no longer show a literal "none" plugin line. diff --git a/README.md b/README.md new file mode 100644 index 0000000..5f1dc71 --- /dev/null +++ b/README.md @@ -0,0 +1,57 @@ +# Trafero + +Native Android (Kotlin / Jetpack Compose / Material 3) client for the Tdarr server v2.2x+ /api/v2 JSON API. + +**Current release:** v0.2.0 — full release notes ship on its entry on the +[Releases page](https://git.trevena.info/nick/Trafero/releases). + +> **Installing a release APK over a debug build?** They are signed with +> different keys, so uninstall the debug app first — Android will refuse +> an in-place update across signatures. Release → release updates are +> normal in-place upgrades. + +## Build + ./gradlew assembleDebug + # app/build/outputs/apk/debug/app-debug.apk +Toolchain: JDK 17, Android SDK platform 35 + build-tools 35, Gradle 8.10.2 wrapper, AGP 8.7.2, Kotlin 2.0.21. + +Release builds need the local dev keystore — see [`keystore/README.md`](keystore/README.md). + +## Install & test + adb install -r app/build/outputs/apk/debug/app-debug.apk + +## Features (v0.2.0) +- Connection wizard: custom URL (scheme/port normalization, default :8265), auth mode None / API key (x-api-key) / username+password (bearer token), self-signed TLS toggle, live test probe, multi-server switcher. +- Jobs: running workers (progress/fps/ETA, cancel), staged queue (approve/reject), history (file filter), error stacks (table1/2/3). +- Library: search + per-library filter + sort, paged file cards, detail bottom sheet (streams from ffprobe, plugin output, re-check). +- Nodes: pause/resume, worker limit +/-, kill worker, queue depths. +- Stats: server info, CPU/mem, totals, space saved, transcode/health donuts, codec mix. +- Logs: server log with filter + follow. +- Settings: pause-all-nodes & ignore-schedules, libraries (watch toggle, scan new / full scan), server CRUD. +- Flows: read-only flow-plugin catalog (inputs/filters/actions/variables/outputs). +- Polling interval picker (Off/5s/15s/30s/1m/5m) in app bar; Material You dynamic color, dark & light. + +## v0.2.0 changes (slow-connection resilience) +- Per-server **timeout** field and **"Slow connection"** mode (doubles all timeouts) in the server editor; defaults 20 s connect / 90 s read. +- Read-style/polling calls auto-retry twice (2 s / 5 s backoff) on network failures only — user-triggered mutations are never repeated. +- Screens keep their last good data on transient failures and show a slim **"reconnecting…"** chip; full error banners are reserved for no-data, auth, or server errors. After 3 consecutive poll failures a screen backs off to a 60 s cadence. +- OkHttp keep-alive pool is evicted on app resume so stale NAT/LAN sockets can't cause phantom timeouts. + +## Earlier changes +Full history lives in [`PREVIOUS_HISTORY.md`](PREVIOUS_HISTORY.md); each release on the Releases page carries its own notes plus a `Trafero--changes.md` asset. + +## Known caveats +- Staged verdict strings ('approve'/'reject') match web-client wording but were not exercised against a live server (read-only testing constraint). +- Flow editing, node/server restart, updater and disk-delete actions intentionally not exposed (agreed scope / safety). + +## Architecture +Single :app module. data/api/TdarrClient (OkHttp, {data:{...}} envelope, TraferoApiException kinds: AUTH/NETWORK/SERVER/LEGACY), data/repo/TraferoRepo (typed parsing), DataStore server profiles, manual DI (AppContainer), Compose screens under ui/screens/*, pollLoop() helper for per-screen refresh. + +## Reference +OpenAPI 2.0 spec of the target API vendored at app/src/main/assets/api-docs-v2.json (served live by any Tdarr server at /api/v2/public/api-docs/json). + +## Contributing +See [CONTRIBUTING.md](CONTRIBUTING.md) — bug reports, feature requests and pull requests are all welcome. Keep server-mutating calls out of the codebase unless explicitly discussed. + +## License +Trafero is licensed under the **GNU General Public License v3.0** — see [LICENSE](LICENSE) and [NOTICE](NOTICE). Trafero is an independent client for Tdarr and is not affiliated with or endorsed by the Tdarr project. diff --git a/app/build.gradle.kts b/app/build.gradle.kts new file mode 100644 index 0000000..6298e8d --- /dev/null +++ b/app/build.gradle.kts @@ -0,0 +1,97 @@ +plugins { + alias(libs.plugins.androidApplication) + alias(libs.plugins.kotlinAndroid) + alias(libs.plugins.kotlinCompose) + alias(libs.plugins.kotlinSerialization) +} + +android { + namespace = "com.trafero.app" + compileSdk = 35 + + defaultConfig { + applicationId = "com.trafero.app" + minSdk = 26 + targetSdk = 35 + versionCode = 3 + versionName = "0.2.0" + } + + signingConfigs { + create("release") { + storeFile = rootProject.file("keystore/release.jks") + storePassword = "trafero_dev_keystore" + keyAlias = "trafero" + keyPassword = "trafero_dev_keystore" + } + } + + buildTypes { + debug { + isMinifyEnabled = false + } + release { + isMinifyEnabled = false + signingConfig = signingConfigs.getByName("release") + } + } + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 + } + kotlinOptions { + jvmTarget = "17" + } + buildFeatures { + compose = true + } + packaging { + resources.excludes += "META-INF/DEPENDENCIES" + } +} + +// Fail fast with an actionable message only when assembleRelease actually +// runs and the keystore is missing - not during project configuration. +tasks.register("validateReleaseKeystore") { + group = "build" + description = "Validates that keystore/release.jks exists before assembleRelease runs" + doFirst { + val f = rootProject.file("keystore/release.jks") + if (!f.exists()) { + throw GradleException( + "Missing ${f.absolutePath}.\n" + + "Generate the dev keystore documented in keystore/README.md:\n" + + " keytool -genkey -noprompt -v \\\n" + + " -keystore keystore/release.jks \\\n" + + " -keyalg RSA -keysize 2048 -validity 10000 \\\n" + + " -alias trafero \\\n" + + " -storepass trafero_dev_keystore \\\n" + + " -keypass trafero_dev_keystore \\\n" + + " -dname \"CN=Trafero, OU=Local, O=Trafero, L=Local, ST=Local, C=NZ\"" + ) + } + } +} + +tasks.matching { it.name == "validateReleaseSigningConfig" || it.name.startsWith("assembleRelease") || it.name.startsWith("bundleRelease") } + .configureEach { dependsOn("validateReleaseKeystore") } + +dependencies { + implementation(libs.androidx.core.ktx) + implementation(libs.androidx.activity.compose) + implementation(libs.androidx.lifecycle.runtime.compose) + implementation(libs.androidx.lifecycle.runtime.ktx) + implementation(libs.androidx.lifecycle.viewmodel.compose) + implementation(libs.androidx.navigation.compose) + implementation(libs.androidx.datastore.preferences) + implementation(platform(libs.composeBom)) + implementation(libs.compose.ui) + implementation(libs.compose.material3) + implementation(libs.compose.material.icons.extended) + implementation(libs.compose.ui.tooling.preview) + debugImplementation(libs.compose.ui.tooling) + implementation(libs.kotlinx.serialization.json) + implementation(libs.kotlinx.coroutines.android) + implementation(libs.okhttp) +} diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro new file mode 100644 index 0000000..f216da5 --- /dev/null +++ b/app/proguard-rules.pro @@ -0,0 +1 @@ +# keep defaults for debug; release unused diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml new file mode 100644 index 0000000..48f77b7 --- /dev/null +++ b/app/src/main/AndroidManifest.xml @@ -0,0 +1,26 @@ + + + + + + + + + + + + + + diff --git a/app/src/main/assets/api-docs-v2.json b/app/src/main/assets/api-docs-v2.json new file mode 100644 index 0000000..2bf6d8b --- /dev/null +++ b/app/src/main/assets/api-docs-v2.json @@ -0,0 +1 @@ +{"swagger":"2.0","info":{"title":"Tdarr API","description":"Tdarr API Docs","version":"2"},"definitions":{},"paths":{"/api/v2/add-audio-codec-exclude":{"post":{"description":"For adding an audio codec to be excluded/included in basic audio transcoding settings","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"}},"required":["dbID","ele"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/add-plugin-include":{"post":{"description":"For adding a plugin to a classic plugin stack","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"},"source":{"type":"string"},"index":{"type":"integer"}},"required":["dbID","ele","source","index"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/add-video-codec-exclude":{"post":{"description":"For adding an video codec to be excluded/included in basic video transcoding settings","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"}},"required":["dbID","ele"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/admin/register":{"post":{"description":"For admin registering a new user","tags":["users"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"username":{"type":"string"},"roles":{"type":"array","items":{"type":"string"}}},"required":["username","roles"]}}],"responses":{"201":{"description":"Default Response","schema":{"type":"object","properties":{"temporaryPassword":{"type":"string"}}}},"400":{"description":"Default Response","schema":{"type":"string"}},"403":{"description":"Default Response","schema":{"type":"string"}},"500":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/admin/reset-password":{"post":{"description":"For admin resetting a user password","tags":["users"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"username":{"type":"string"}},"required":["username"]}}],"responses":{"201":{"description":"Default Response","schema":{"type":"object","properties":{"temporaryPassword":{"type":"string"}}}},"400":{"description":"Default Response","schema":{"type":"string"}},"403":{"description":"Default Response","schema":{"type":"string"}},"500":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/alter-worker-limit":{"post":{"description":"For changing the number of running workers of a specific type on a specific node","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"nodeID":{"type":["string"]},"process":{"type":"string","enum":["increase","decrease"]},"workerType":{"type":"string","enum":["healthcheckcpu","healthcheckgpu","transcodecpu","transcodegpu"]}},"required":["nodeID","process","workerType"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/auth/logout":{"post":{"description":"For logging out a user","tags":["users"],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/auth/reset-password":{"post":{"description":"For resetting a user password","tags":["users"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"oldPassword":{"type":"string"},"password":{"type":"string"}},"required":["oldPassword","password"]}}],"responses":{"201":{"description":"Default Response","schema":{"type":"object","properties":{"token":{"type":"string"}}}},"400":{"description":"Default Response","schema":{"type":"string"}},"401":{"description":"Default Response","schema":{"type":"string"}},"500":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/auth/verify-token":{"get":{"description":"For verifying a user token","tags":["users"],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"roles":{"type":"array","items":{"type":"string"}},"localAuth":{"type":"boolean"}}}}}}},"/api/v2/auth-status":{"post":{"description":"For checking Tdarr Pro status","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"saU":{"type":"boolean"}},"required":["saU"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"boolean"}}}}},"/api/v2/run-automation":{"post":{"description":"Manually trigger an automation","tags":["automations"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["configId"],"properties":{"configId":{"type":"string"},"payload":{"type":"object","additionalProperties":true},"libraryIds":{"type":"array","items":{"type":"string"}},"targetNodeNames":{"type":"array","items":{"type":"string"}},"targetNodeIds":{"type":"array","items":{"type":"string"}},"executeImmediately":{"type":"boolean"},"bypassWorkerLimits":{"type":"boolean"},"bypassStagedFileLimit":{"type":"boolean"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"success":{"type":"boolean"}}}},"403":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"}}}},"404":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}},"/api/v2/bulk-delete-files":{"post":{"description":"For bulk deleting selected files from disk and removing them from the database","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"fileIds":{"type":"array","items":{"type":"string"}}},"required":["fileIds"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/bulk-update-files":{"post":{"description":"For bulk updating specific files by their IDs","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"fileIds":{"type":"array","items":{"type":"string"}},"updatedObj":{"type":"object"}},"required":["fileIds","updatedObj"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/cancel-worker-item":{"post":{"description":"For cancelling a running worker item on a specific node","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"nodeID":{"type":"string"},"workerID":{"type":"string"},"cause":{"type":"string"}},"required":["nodeID","workerID","cause"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/client/{clientType}":{"post":{"description":"For loading and updating data in various tables found around the Tdarr UI","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"start":{"type":"number"},"pageSize":{"type":"number"},"filters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string"}},"required":["id","value"]}},"sorts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"desc":{"type":"boolean"}},"required":["id","desc"]}},"opts":{"type":"object","properties":{"table":{"type":"string"},"property":{"type":"string"},"fileMedium":{"type":"string"},"detail":{"type":"string"},"dbID":{"type":"string"},"setAll":{"type":"boolean"},"updatedObj":{"type":"object"},"csv":{"type":"boolean"},"applyToAllStaged":{"type":"boolean"},"verdict":{"type":"string"}}}},"required":["start","pageSize","filters","sorts","opts"]}},"required":["data"]}},{"type":"string","required":true,"in":"path","name":"clientType"}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":true,"properties":{}}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/copy-community-to-local":{"post":{"description":"For copying a community plugin to local plugins","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pluginID":{"type":"string"},"forceOverwrite":{"type":"boolean"}},"required":["pluginID","forceOverwrite"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"boolean"}]}}}}}},"/api/v2/create-backup":{"post":{"description":"For creating a backup of the Tdarr database","tags":["backups"],"responses":{"200":{"description":"Default Response","schema":{"type":"boolean"}}}}},"/api/v2/create-plugin":{"post":{"description":"For creating a basic classic plugin using the classic plugin creator","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"details":{"type":"object","properties":{"Name":{"type":"string"},"Type":{"type":"string"},"Operation":{"type":"string"},"Description":{"type":"string"}},"required":["Name","Type","Operation","Description"]},"conditionalsString":{"type":"string"},"conditionalNotes":{"type":"string"},"action":{"type":"object","properties":{"preset":{"type":"string"},"container":{"type":"string"},"handbrakeMode":{"type":"boolean"},"ffmpegMode":{"type":"boolean"},"processFile":{"type":["boolean","string"]},"infoLog":{"type":"string"}},"required":["preset","container","handbrakeMode","ffmpegMode","processFile","infoLog"]}},"required":["details","conditionalsString","conditionalNotes","action"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"boolean"}}}}},"/api/v2/create-sample":{"post":{"description":"For creating a 30 second sample of a file","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"filePath":{"type":"string"}},"required":["filePath"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"output":{"type":"string"}}}},"400":{"description":"Default Response","schema":{"type":"object","properties":{"output":{"type":"string"}}}}}}},"/api/v2/cruddb":{"post":{"description":"\nFor interacting with the database\n\ninsert: requires collection, docID, obj (with keys/values to insert)\ngetById: requires collection, docID\ngetByIndex:requires collection, docID\ngetAll: requires collection\nupdate: requires collection, docID, obj (with keys/values to update)\nremoveOne: requires collection, docID\nremoveAll: requires collection, optional filters (with filter conditions)\n ","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["collection","mode"],"properties":{"collection":{"type":"string","enum":["SettingsGlobalJSONDB","LibrarySettingsJSONDB","NodeJSONDB","StatisticsJSONDB","VariablesJSONDB","UsersJSONDB","ApiKeysJSONDB","FlowsJSONDB","StagedJSONDB","FileJSONDB","F2FOutputJSONDB","WorkerVerdictHistoryJSONDB","JobsJSONDB","AutomationsJSONDB"]},"mode":{"type":"string","enum":["getById","getByIndex","getAll","insert","update","incdec","removeOne","removeByDB","removeAll"]},"docID":{"type":"string","examples":["C:/mediaFile.mkv"]},"obj":{"type":"object","examples":[{"createdAt":1644381503446}]},"filters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string"}},"required":["id","value"]}}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"oneOf":[{"type":"object","additionalProperties":true},{"type":"array","items":{"type":"object","additionalProperties":true}}]}},"403":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/debug-vars/{type}":{"get":{"description":"For getting various debug info","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":true,"properties":{}}}}}},"/api/v2/debug":{"get":{"description":"For getting a page with various debug info","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/delete-backup":{"post":{"description":"For deleting a backup of the Tdarr database","tags":["backups"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":["string","boolean"]}}}}},"/api/v2/delete-cache-file":{"post":{"description":"For deleting a cache file","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"file":{"type":"string"}},"required":["file"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/delete-file":{"post":{"description":"For deleting a file on disk of a file in Tdarr DB","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"file":{"type":"object","properties":{"_id":{"type":"string"}},"required":["_id"]}},"required":["file"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}},"/api/v2/delete-job-report":{"post":{"description":"Delete a single job report from both database and disk","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["jobId"],"properties":{"jobId":{"type":"string","description":"The ID of the job report to delete"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}}}},"400":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}},"/api/v2/delete-job-reports":{"post":{"description":"Delete multiple job reports from both database and disk (with optional filters)","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"filters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{"type":"string"}},"required":["id","value"]},"description":"Optional filters to apply when selecting job reports to delete"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"count":{"type":"number"}}}},"400":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}},"/api/v2/delete-plugin":{"post":{"description":"For deleting a plugin","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pluginSource":{"type":"string"},"pluginID":{"type":"string"}},"required":["pluginSource","pluginID"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"boolean"}]}}}}}},"/api/v2/delete-unhealthy-files":{"post":{"description":"For deleting files which have failed to transcode (table3) or unhealthy files (table6)","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"table":{"type":"string"}},"required":["table"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/disconnect-node":{"post":{"description":"For forcefully disconnecting a node","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["nodeID"],"properties":{"nodeID":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/download-plugins":{"get":{"description":"For nodes to download the latest plugins zip","tags":["nodes","plugins"],"produces":["application/zip"],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/file/download":{"post":{"description":"For downloading a file","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"filePath":{"type":"string"}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object"}},"400":{"description":"Default Response","schema":{"type":"string"}},"501":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/file/upload":{"post":{"description":"For uploading a file","tags":["nodes"],"consumes":["multipart/form-data"],"responses":{"200":{"description":"Default Response","schema":{"type":"object"}},"400":{"description":"Default Response","schema":{"type":"string"}},"500":{"description":"Default Response","schema":{"type":"string"}},"501":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/find-duplicates":{"post":{"description":"For starting the find duplicates process","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"threshold":{"type":"number","minimum":0},"count":{"type":"number","minimum":1},"detectionMethod":{"type":"string","enum":["metadata","sha256"]},"sha256HashAmount":{"type":"string","enum":["10MB","100MB","1GB","10GB","10%","50%","100%"]}},"required":["threshold","count"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}},"403":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/get-backup-status":{"post":{"description":"For getting the status of a Tdarr backup in progress","tags":["backups"],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"status":{"type":"string"}}}}}}}},"/api/v2/get-backups":{"post":{"description":"For getting a list of backups of the Tdarr database","tags":["backups"],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"size":{"type":"string"},"statSync":{"type":"object","additionalProperties":true},"date":{"type":"number"}}}}}}}},"/api/v2/get-db-statuses":{"post":{"description":"For getting the statuses of the Tdarr database","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":true,"properties":{}}}}}},"/api/v2/get-filescanner-status":{"post":{"description":"For getting the status of a file scanner in progress","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"}},"required":["dbID"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/get-new-task":{"post":{"description":"For a node to request a new task","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["nodeID","workerID","workerType"],"properties":{"nodeID":{"type":"string"},"workerID":{"type":"string"},"workerType":{"type":"string"},"automation":{"type":"object","properties":{"priorityFileId":{"type":"string"}}}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]}}}}}},"/api/v2/get-node-log":{"post":{"description":"For getting the log of a node","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["nodeID"],"properties":{"nodeID":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/get-nodes":{"get":{"description":"For getting connected nodes information","tags":["nodes"],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":true,"properties":{}}}}}},"/api/v2/get-process-info":{"post":{"description":"For getting process information from server and nodes with child process relationships","tags":["processes"],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":{"type":"object","properties":{"nodeName":{"type":"string","description":"Name of the node or server"},"processes":{"type":"object","additionalProperties":{"type":"object","properties":{"ppid":{"type":"number","description":"Parent process ID"},"pid":{"type":"number","description":"Process ID"},"execPath":{"type":"string","description":"Executable path"},"filename":{"type":"string","description":"Script filename being executed"},"lastUpdateTime":{"type":"number","description":"Last update timestamp"},"memory":{"type":"object","properties":{"rss":{"type":"number","description":"Resident Set Size - total memory allocated"},"heapTotal":{"type":"number","description":"Total heap size"},"heapUsed":{"type":"number","description":"Used heap size"},"external":{"type":"number","description":"External memory usage"},"arrayBuffers":{"type":"number","description":"Array buffer memory usage"}},"required":["rss","heapTotal","heapUsed","external","arrayBuffers"]},"children":{"type":"array","description":"Child processes with the same structure","items":{"type":"object","additionalProperties":true}}},"required":["ppid","pid","execPath","filename","lastUpdateTime","memory","children"]}}},"required":["nodeName","processes"]}}},"500":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}},"required":["error"]}}}}},"/api/v2/get-res-stats":{"post":{"description":"For getting server resource information","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"process":{"type":"object","properties":{"uptime":{"type":"integer"},"heapUsedMB":{"type":"string"},"heapTotalMB":{"type":"string"}},"required":["uptime","heapUsedMB","heapTotalMB"]},"os":{"type":"object","properties":{"cpuPerc":{"type":"string"},"memUsedGB":{"type":"string"},"memTotalGB":{"type":"string"}},"required":["cpuPerc","memUsedGB","memTotalGB"]}}}}}}},"/api/v2/get-server-log":{"get":{"description":"For getting the server log","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/get-subdirectories":{"post":{"description":"For getting subdirectories of a folder","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"folderPath":{"type":"string"}},"required":["folderPath"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"valid":{"type":"boolean"},"folders":{"type":"array","items":{"type":"object","properties":{"fullPath":{"type":"string"},"folder":{"type":"string"}}}},"warning":{"type":"string"}}}}}}},"/api/v2/get-time-now":{"post":{"description":"For getting the current time on the server","tags":[],"responses":{"200":{"description":"Time now","schema":{"type":"integer","description":"Time now"}}}}},"/api/v2/is-server-alive":{"post":{"description":"Old endpoint for checking if the server is alive (user 'status' instead)","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"isAlive":{"type":"boolean"}}}}}}},"/api/v2/item-proc-end":{"post":{"description":"For when a node completes processing an item","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["nodeID","obj"],"properties":{"nodeID":{"type":"string"},"obj":{"type":"object"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/job-reports/{jobId}/download":{"get":{"description":"Download a job report by job ID as a text file","tags":["reports"],"parameters":[{"type":"string","required":true,"in":"path","name":"jobId"}],"responses":{"200":{"description":"Raw job report text","schema":{"type":"string","description":"Raw job report text"}},"404":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"},"jobId":{"type":"string"},"isJobRunning":{"type":"boolean"},"jobReportExists":{"type":"boolean"}}}},"500":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"},"jobId":{"type":"string"},"isJobRunning":{"type":"boolean"},"jobReportExists":{"type":"boolean"}}}}}}},"/api/v2/job-reports/{jobId}":{"get":{"description":"Get job report content and metadata by job ID as JSON","tags":["reports"],"parameters":[{"type":"string","required":true,"in":"path","name":"jobId"}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"jobId":{"type":"string"},"filename":{"type":"string"},"downloadPath":{"type":"string"},"text":{"type":"string"},"isJobRunning":{"type":"boolean"},"jobReportExists":{"type":"boolean"},"sizeBytes":{"type":"number"},"job":{"type":"object","additionalProperties":true},"jobRecord":{"type":"object","additionalProperties":true}}}},"404":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"},"jobId":{"type":"string"},"isJobRunning":{"type":"boolean"},"jobReportExists":{"type":"boolean"},"job":{"type":"object","additionalProperties":true},"jobRecord":{"type":"object","additionalProperties":true}}}},"500":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string"},"jobId":{"type":"string"},"isJobRunning":{"type":"boolean"},"jobReportExists":{"type":"boolean"}}}}}}},"/api/v2/kill-file-scanner":{"post":{"description":"For killing a file scanner in progress","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"}},"required":["dbID"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/kill-worker":{"post":{"description":"For killing a worker on a node","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"nodeID":{"type":"string","description":"The ID of the node where the worker is running."},"workerID":{"type":"string","description":"The ID of the worker to kill."}},"required":["nodeID","workerID"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/list-footprintId-reports":{"post":{"description":"For listing all job reports for a specific footprintId","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["footprintId"],"properties":{"footprintId":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"type":"string"}}}}}},"/api/v2/log-job-report":{"post":{"description":"For updating a job report","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["date","job","text"],"properties":{"date":{"type":"number"},"job":{"type":"object"},"text":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/nodes/ready":{"get":{"description":"Returns ready=true when server + N connected nodes have finished initial plugin setup","tags":[],"parameters":[{"type":"string","default":"0","required":false,"in":"query","name":"numberOfNodes"}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"ready":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}}}}}}}},"/api/v2/nodes/version-check":{"post":{"description":"For nodes to verify the server version before establishing a full connection","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"nodeID":{"type":"string"},"nodeName":{"type":"string"},"nodeVersion":{"type":"string"},"nodeEngine":{"type":"string"},"protocolVersion":{"type":"string"},"nodeType":{"type":"string"},"inDocker":{"type":"boolean"},"processPid":{"type":"integer"}},"required":["nodeVersion"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"status":{"type":"string"},"isProduction":{"type":"boolean"},"os":{"type":"string"},"version":{"type":"string"},"buildDate":{"type":"string"},"uptime":{"type":"integer"},"autoUpdateNodes":{"type":"boolean"},"requiredVersion":{"type":"string"},"serverEngine":{"type":"string"},"protocolVersion":{"type":"string"},"message":{"type":"string"}}}},"409":{"description":"Default Response","schema":{"type":"object","properties":{"status":{"type":"string"},"isProduction":{"type":"boolean"},"os":{"type":"string"},"version":{"type":"string"},"buildDate":{"type":"string"},"uptime":{"type":"integer"},"autoUpdateNodes":{"type":"boolean"},"requiredVersion":{"type":"string"},"serverEngine":{"type":"string"},"protocolVersion":{"type":"string"},"message":{"type":"string"}}}}}}},"/api/v2/performance-stats":{"post":{"description":"For various performance stat info","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"performanceStats":{"type":"object","additionalProperties":true}}}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/plugin-repo-versions":{"post":{"description":"List recent commits on the plugin repo (SHA + date + message + author)","tags":["plugins"],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":true}},"400":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}},"required":["error"]}},"500":{"description":"Default Response","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}},"required":["error"]}}}}},"/api/v2/poll-worker-limits":{"post":{"description":"For a node to get its worker limits and check if there's anything in the queue","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["nodeID"],"properties":{"nodeID":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"workerLimits":{"type":"object","properties":{"healthcheckcpu":{"type":"number"},"healthcheckgpu":{"type":"number"},"transcodecpu":{"type":"number"},"transcodegpu":{"type":"number"}}},"queueLengths":{"type":"object","properties":{"healthcheckcpu":{"type":"number"},"healthcheckgpu":{"type":"number"},"transcodecpu":{"type":"number"},"transcodegpu":{"type":"number"}}},"processPriority":{"type":"string"}}}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/public/auth/login":{"post":{"description":"For logging in a user","tags":["users"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"username":{"type":"string"},"password":{"type":"string"}},"required":["username","password"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"token":{"type":"string"}}}},"401":{"description":"Default Response","schema":{"type":"string"}},"500":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/public/auth/register":{"post":{"description":"For registering a new user","tags":["users"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"username":{"type":"string"},"password":{"type":"string"}},"required":["username","password"]}}],"responses":{"201":{"description":"Default Response","schema":{"type":"object","properties":{"token":{"type":"string"}}}},"400":{"description":"Default Response","schema":{"type":"string"}},"403":{"description":"Default Response","schema":{"type":"string"}},"500":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/read-job-file":{"post":{"description":"For reading a job report","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["footprintId","jobId","jobFileId"],"properties":{"footprintId":{"type":"string"},"jobId":{"type":"string"},"jobFileId":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"text":{"type":"string"},"isJobRunning":{"type":"boolean","example":true},"jobReportExists":{"type":"boolean","example":true}}}},"400":{"description":"Default Response","schema":{"type":"object","properties":{"text":{"type":"string"},"isJobRunning":{"type":"boolean","example":false},"jobReportExists":{"type":"boolean","example":false}}}},"500":{"description":"Default Response","schema":{"type":"object","properties":{"text":{"type":"string"},"isJobRunning":{"type":"boolean"},"jobReportExists":{"type":"boolean"}}}}}}},"/api/v2/read-plugin-text":{"post":{"description":"For the classic plugin editor to read a plugin file","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pluginSource":{"type":"string"},"pluginID":{"type":"string"}},"required":["pluginSource","pluginID"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"boolean"}]}}}}}},"/api/v2/read-plugin":{"post":{"description":"For a node to read a plugin","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["plugin"],"properties":{"plugin":{"type":"object","required":["source","id"],"properties":{"source":{"type":"string"},"id":{"type":"string"}}}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"pluginRaw":{"type":"string"}}}}}}},"/api/v2/remove-audio-codec-exclude":{"post":{"description":"For removing an audio codec to be excluded/included in basic audio transcoding settings","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"}},"required":["dbID","ele"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/remove-library-files":{"post":{"description":"For removing all files from a Tdarr library DB, files on disk aren't removed","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"DB":{"type":"string","description":"The ID of the library to remove files from."}},"required":["DB"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/remove-plugin-include":{"post":{"description":"For removing a plugin from a classic plugin stack","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"}},"required":["dbID","ele"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/remove-video-codec-exclude":{"post":{"description":"For removing an video codec to be excluded/included in basic video transcoding settings","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"}},"required":["dbID","ele"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/rescan-file":{"post":{"description":"For rescanning a file","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"_id":{"type":"string"},"DB":{"type":"string"}},"required":["_id","DB"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/reset-backup-status":{"post":{"description":"For resetting the backup status","tags":["backups"],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/restart-node":{"post":{"description":"For restarting a specific node","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"nodeID":{"type":"string","description":"The ID of the node to restart."}},"required":["nodeID"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/restart-server":{"post":{"description":"For restarting Tdarr Server","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/restart-ui":{"get":{"description":"For restarting the UI","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/run-help-command":{"post":{"description":"For running an ffmpeg or handbrake help command on the Help tab","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"mode":{"type":"string"},"text":{"type":"string"}},"required":["mode","text"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/save-plugin-text":{"post":{"description":"For the classic plugin editor to save plugin text","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pluginSource":{"type":"string"},"pluginID":{"type":"string"},"text":{"type":"string"}},"required":["pluginSource","pluginID","text"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"boolean"}]}}}}}},"/api/v2/scan-files":{"post":{"description":"\n For running a scanFresh, scanFindNew or scanFolderWatcher on a library\n scanFresh & scanFindNew require a single string directory path\n scanFolderWatcher requires an array of file paths to scanned\n ","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"scanConfig":{"type":"object","properties":{"dbID":{"type":"string"},"mode":{"type":"string","enum":["scanFresh","scanFindNew","scanFolderWatcher"]},"arrayOrPath":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},"required":["dbID","mode","arrayOrPath"]}},"required":["scanConfig"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/scan-individual-file":{"post":{"description":"For scanning an individual file with various tools","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"scanTypes":{"type":"object","properties":{"exifToolScan":{"type":"boolean"},"mediaInfoScan":{"type":"boolean"},"closedCaptionScan":{"type":"boolean"}},"required":["exifToolScan","mediaInfoScan","closedCaptionScan"]},"file":{"type":"object","properties":{"file":{"type":"string"}},"required":["file"]}},"required":["scanTypes","file"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":true,"properties":{"_id":{"type":"string"},"file":{"type":"string"},"DB":{"type":"string"},"footprintId":{"type":"string"},"container":{"type":"string"},"scannerReads":{"type":"object","properties":{"ffProbeRead":{"type":"string"},"exiftoolRead":{"type":"string"},"mediaInfoRead":{"type":"string"},"closedCaptionRead":{"type":"string"}}},"ffProbeData":{"type":"object","additionalProperties":true},"meta":{"type":"object","additionalProperties":true},"mediaInfo":{"type":"object","additionalProperties":true}}}}}}},"/api/v2/search-db":{"post":{"description":"Old endpoint for searching the file database (use 'client' endpoint instead)","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"string":{"type":"string"},"greaterThanGB":{"type":"number"},"lessThanGB":{"type":"number"}},"required":["string","greaterThanGB","lessThanGB"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{}}}}}}},"/api/v2/search-flow-plugins":{"post":{"description":"For searching flow plugins","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"string":{"type":"string"},"pluginType":{"type":"string"}},"required":["string","pluginType"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{}}},{"type":"string"}]}}}}}},"/api/v2/search-flow-templates":{"post":{"description":"For searching flow templates","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"string":{"type":"string"},"pluginType":{"type":"string"}},"required":["string","pluginType"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{}}},{"type":"string"}]}}}}}},"/api/v2/search-job-reports":{"post":{"description":"For searching job reports","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["searchTerms"],"properties":{"searchTerms":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"jobReports":{"type":"array","items":{"type":"object","properties":{"filename":{"type":"string"},"lastModifiedMs":{"type":"number"}}}}}}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/search-plugins":{"post":{"description":"For searching classic plugins","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"string":{"type":"string"},"pluginType":{"type":"string"}},"required":["string","pluginType"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"array","items":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"Name":{"type":"string"},"Type":{"type":"string"},"Operation":{"type":"string"},"Description":{"type":"string"},"Version":{"type":"string"},"Link":{"type":"string"},"source":{"type":"string"}}}},{"type":"string"}]}}}}}},"/api/v2/set-all-status":{"post":{"description":"For requeueing files for transcode or health check for a specific library","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"mode":{"type":"string"},"table":{"type":"string"},"processStatus":{"type":"string"}},"required":["dbID","mode","table","processStatus"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/stats/get-pies":{"post":{"description":"For getting all or library pie stats","tags":["stats"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"libraryId":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"pieStats":{"type":"object","additionalProperties":true}}}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/stats/get-res-hist":{"post":{"description":"For getting server resource history","tags":["stats"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"timeframe":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"c":{"type":"number"},"hU":{"type":"number"},"hT":{"type":"number"},"cP":{"type":"number"},"mU":{"type":"number"}}}}}}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/stats/get-running-worker-hist":{"post":{"description":"For getting running worker history","tags":["stats"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"timeframe":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"number"},"c":{"type":"number"},"tcpu":{"type":"number"},"tgpu":{"type":"number"},"hcpu":{"type":"number"},"hgpu":{"type":"number"}}}}}}},"400":{"description":"Default Response","schema":{"type":"string"}},"403":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/stats/get-space-saved":{"post":{"description":"For getting space saved history","tags":["stats"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"libraryId":{"type":"string"},"timeframe":{"type":"string"},"nodeId":{"type":"string"},"workerType":{"type":"string"},"pluginId":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"buckets":{"type":"array","items":{"type":"object","properties":{"space_saved":{"type":"number"},"bucket":{"type":"string"}}}}}}},"400":{"description":"Default Response","schema":{"type":"string"}},"403":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/stats/get-streams":{"post":{"description":"For getting stream stats info","tags":["stats"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"libraryId":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"streamInfo":{"type":"object","additionalProperties":true}}}},"400":{"description":"Default Response","schema":{"type":"string"}},"403":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/stats/get-worker-verdict-hist":{"post":{"description":"For getting worker verdict history","tags":["stats"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"timeframe":{"type":"string"},"libraryId":{"type":"string"},"nodeId":{"type":"string"},"workerType":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"buckets":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"tSuc":{"type":"number"},"tErr":{"type":"number"},"tNq":{"type":"number"},"hSuc":{"type":"number"},"hErr":{"type":"number"}}}}}}},"400":{"description":"Default Response","schema":{"type":"string"}},"403":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/stats/space-saved-add":{"post":{"description":"For adding space saved record","tags":["stats"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"libraryId":{"type":"string"},"spaceSaved":{"type":"number"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/status":{"get":{"description":"For checking server status","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"status":{"type":"string"},"isProduction":{"type":"boolean"},"os":{"type":"string"},"version":{"type":"string"},"buildDate":{"type":"string"},"uptime":{"type":"integer"},"serverEngine":{"type":"string"}}}}}}},"/api/v2/stop-dedupe":{"get":{"description":"For stopping the dedupe process","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/sync-plugins":{"post":{"description":"For syncing plugins from server to all nodes","tags":["nodes","plugins"],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/toggle-folder-watch":{"post":{"description":"For enabling/disabling folder watching on a library","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"auto":{"type":"boolean","description":"Whether request has been triggered automatically (true) or by user (false)."},"folder":{"type":"string","description":"The path to the folder to watch."},"dbID":{"type":"string","description":"The library ID."},"status":{"type":"boolean","description":"If the folder watcher should be enabled or disabled."}},"required":["auto","folder","dbID","status"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/toggle-schedule":{"post":{"description":"For updating the schedule of a library","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"start":{"type":"integer"},"end":{"type":"integer"},"type":{"type":"string"}},"required":["dbID","start","end","type"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/transcode-user-verdict":{"post":{"description":"For taking action on a staged item","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["obj","verdict"],"properties":{"obj":{"type":"object"},"verdict":{"type":"string"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/update-audio-codec-exclude":{"post":{"description":"For updating an audio codec to be excluded/included in basic audio transcoding settings","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"},"status":{"type":"boolean"}},"required":["dbID","ele","status"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/update-node-relay":{"post":{"description":"For nodes to update the server with their status","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["nodeID","resStats","workers"],"properties":{"nodeID":{"type":"string"},"resStats":{"type":"object"},"workers":{"type":"object"}}}}}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}},"500":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/update-node":{"post":{"description":"For the UI to update a connected node","tags":["nodes"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"nodeID":{"type":"string","description":"The ID of the node to update."},"nodeUpdates":{"type":"object","description":"The updates to apply to the node."}},"required":["nodeID","nodeUpdates"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/update-plugin-include":{"post":{"description":"For enabling/disabling a plugin in a classic plugin stack","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"},"status":{"type":"boolean"}},"required":["dbID","ele","status"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/update-plugins":{"post":{"description":"For requesting the server to update community plugins","tags":["plugins"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"force":{"type":"boolean"}},"required":["force"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/update-schedule-block":{"post":{"description":"For updating a block in a library schedule","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"},"status":{"type":"boolean"}},"required":["dbID","ele","status"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/update-video-codec-exclude":{"post":{"description":"For updating an video codec to be excluded/included in basic video transcoding settings","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"dbID":{"type":"string"},"ele":{"type":"string"},"status":{"type":"boolean"}},"required":["dbID","ele","status"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/updater/check":{"post":{"description":"For checking if an update is available","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"resetUpdater":{"type":"boolean"},"downloadUpdate":{"type":"boolean"},"applyUpdate":{"type":"boolean"}},"required":["downloadUpdate","applyUpdate","resetUpdater"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","properties":{"newVersionAvailable":{"type":"boolean"},"currentVersion":{"type":"string"},"requiredVersion":{"type":"string"},"message":{"type":"string"}}}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/updater/package-index":{"post":{"description":"For getting the package index","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":true,"properties":{}}}}}},"/api/v2/updater/relaunch":{"post":{"description":"For relaunching Tdarr Server when an update is ready","tags":[],"responses":{"200":{"description":"Default Response","schema":{"type":"string"}},"400":{"description":"Default Response","schema":{"type":"string"}}}}},"/api/v2/use-token":{"post":{"description":"For using a token","tags":[],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"token":{"type":"string"},"redirect":{"type":"string"}},"required":["token","redirect"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"object","additionalProperties":true,"properties":{}}}}}},"/api/v2/verify-folder-exists":{"post":{"description":"For verifying if a folder exists","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"folderPath":{"type":"string"}},"required":["folderPath"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"boolean"}}}}},"/api/v2/verify-plugin":{"post":{"description":"For verifying if a classic plugin exists","tags":["libraries"],"parameters":[{"name":"body","in":"body","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pluginID":{"type":"string"},"community":{"type":"boolean"}},"required":["pluginID","community"]}},"required":["data"]}}],"responses":{"200":{"description":"Default Response","schema":{"type":"boolean"}}}}}},"tags":[{"name":"libraries"},{"name":"plugins"},{"name":"nodes"},{"name":"backups"},{"name":"stats"},{"name":"reports"},{"name":"users"}],"externalDocs":{}} \ No newline at end of file diff --git a/app/src/main/java/com/trafero/app/data/api/TdarrClient.kt b/app/src/main/java/com/trafero/app/data/api/TdarrClient.kt new file mode 100644 index 0000000..73ab1f1 --- /dev/null +++ b/app/src/main/java/com/trafero/app/data/api/TdarrClient.kt @@ -0,0 +1,179 @@ +package com.trafero.app.data.api + +import com.trafero.app.data.model.AuthMode +import com.trafero.app.data.model.ServerProfile +import java.io.IOException +import java.net.ConnectException +import java.net.SocketTimeoutException +import java.net.UnknownHostException +import java.security.SecureRandom +import java.security.cert.X509Certificate +import java.util.concurrent.TimeUnit +import javax.net.ssl.HostnameVerifier +import javax.net.ssl.SSLContext +import javax.net.ssl.SSLException +import javax.net.ssl.TrustManager +import javax.net.ssl.X509TrustManager +import kotlin.coroutines.resume +import kotlin.coroutines.resumeWithException +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.suspendCancellableCoroutine +import kotlinx.coroutines.withContext +import kotlinx.serialization.json.JsonElement +import kotlinx.serialization.json.buildJsonObject +import okhttp3.Call +import okhttp3.Callback +import okhttp3.HttpUrl.Companion.toHttpUrlOrNull +import okhttp3.MediaType.Companion.toMediaType +import okhttp3.ConnectionPool +import okhttp3.OkHttpClient +import okhttp3.Request +import okhttp3.RequestBody.Companion.toRequestBody +import okhttp3.Response +import com.trafero.app.util.TraferoJson +import com.trafero.app.util.UrlUtil + +class TraferoApiException(val kind: Kind, message: String) : Exception(message) { + enum class Kind { AUTH, NETWORK, SERVER, LEGACY } +} + +/** + * Thin OkHttp client for the Tdarr /api/v2 JSON API. + * Auth modes: NONE, API_KEY (x-api-key header), USER_PASS (bearer token from login). + */ +class TdarrClient(val profile: ServerProfile) { + + private val jsonType = "application/json; charset=utf-8".toMediaType() + + val apiBase: String = + (UrlUtil.normalizeBase(profile.baseUrl) ?: "http://127.0.0.1:8265").trimEnd('/') + "/api/v2/" + + private val clientLazy = lazy { buildClient() } + private val client: OkHttpClient get() = clientLazy.value + + /** Effective connect timeout in seconds; doubled for slow-connection profiles. */ + private val connectSec: Long + get() = profile.timeoutSeconds.coerceIn(5, 120).toLong() * + (if (profile.slowConnection) 2L else 1L) + + private fun buildClient(): OkHttpClient { + val connect = connectSec + val read = (connectSec * 4.5).toLong() // default profile: 20 s connect / 90 s read + val builder = OkHttpClient.Builder() + .connectTimeout(connect, TimeUnit.SECONDS) + .readTimeout(read, TimeUnit.SECONDS) + .writeTimeout(connect, TimeUnit.SECONDS) + .callTimeout(connect + read, TimeUnit.SECONDS) + .retryOnConnectionFailure(true) + .connectionPool(ConnectionPool(5, 30, TimeUnit.SECONDS)) + .addInterceptor { chain -> + val rb = chain.request().newBuilder().header("Accept", "application/json") + when (profile.authMode) { + AuthMode.API_KEY -> rb.header("x-api-key", profile.apiKey) + AuthMode.USER_PASS -> if (profile.token.isNotBlank()) + rb.header("Authorization", "Bearer " + profile.token) + AuthMode.NONE -> Unit + } + chain.proceed(rb.build()) + } + if (profile.allowInsecureTls) { + val trustAll = object : X509TrustManager { + override fun checkClientTrusted(chain: Array?, authType: String?) {} + override fun checkServerTrusted(chain: Array?, authType: String?) {} + override fun getAcceptedIssuers(): Array = arrayOf() + } + runCatching { + val ctx = SSLContext.getInstance("TLS") + ctx.init(null, arrayOf(trustAll), SecureRandom()) + builder.sslSocketFactory(ctx.socketFactory, trustAll) + builder.hostnameVerifier(HostnameVerifier { _, _ -> true }) + } + } + return builder.build() + } + + private suspend fun raw( + method: String, + path: String, + query: Map = emptyMap(), + bodyJson: String? = null + ): Pair = withContext(Dispatchers.IO) { + val parsed = (apiBase + path).toHttpUrlOrNull() + ?: throw TraferoApiException(TraferoApiException.Kind.SERVER, "Invalid URL: " + apiBase + path) + val url = parsed.newBuilder() + query.forEach { (k, v) -> url.addQueryParameter(k, v) } + val request = Request.Builder() + .url(url.build()) + .method(method, bodyJson?.toRequestBody(jsonType)) + .build() + suspendCancellableCoroutine { cont -> + val call: Call = client.newCall(request) + cont.invokeOnCancellation { call.cancel() } + call.enqueue(object : Callback { + override fun onFailure(call: Call, e: IOException) { + if (cont.isActive) cont.resumeWithException( + TraferoApiException(TraferoApiException.Kind.NETWORK, describeIo(e)) + ) + } + + override fun onResponse(call: Call, response: Response) { + val text = runCatching { response.body?.string() ?: "" }.getOrDefault("") + if (cont.isActive) cont.resume(response.code to text) + } + }) + } + } + + private fun describeIo(e: Exception): String = when (e) { + is SocketTimeoutException -> "Connection timed out" + is ConnectException -> "Connection refused" + is UnknownHostException -> "Hostname not found" + is SSLException -> "TLS handshake failed (try allowing self-signed certificates)" + else -> e.message ?: "Network error" + } + + private fun unwrap(code: Int, body: String): String { + if (code == 401 || code == 403) + throw TraferoApiException(TraferoApiException.Kind.AUTH, "Authentication required or rejected") + if (code == 404 && body.contains("not found", true)) + throw TraferoApiException( + TraferoApiException.Kind.LEGACY, + "Endpoint missing - server may not support the /api/v2 API (needs Tdarr 2.2x+)" + ) + if (code !in 200..299) { + throw TraferoApiException(TraferoApiException.Kind.SERVER, "HTTP " + code + ": " + body.take(240)) + } + return body + } + + suspend fun getJson(path: String, query: Map = emptyMap()): JsonElement { + val (code, body) = raw("GET", path, query) + return TraferoJson.parseToJsonElement(unwrap(code, body)) + } + + suspend fun post(path: String, payload: JsonElement = buildJsonObject { }): JsonElement { + val json = TraferoJson.encodeToString(JsonElement.serializer(), payload) + val (code, body) = raw("POST", path, bodyJson = json) + return TraferoJson.parseToJsonElement(unwrap(code, body)) + } + + suspend fun getText(path: String, query: Map = emptyMap()): String { + val (code, body) = raw("GET", path, query) + return unwrap(code, body) + } + + /** + * Drops idle keep-alive sockets so the next poll reconnects instead of + * writing into a stale NAT/LAN socket. No-op when no client exists yet. + * Called on app resume - slow links often kill idle connections silently. + */ + fun evictConnections() { + if (clientLazy.isInitialized()) runCatching { client.connectionPool.evictAll() } + } + + fun close() { + if (!clientLazy.isInitialized()) return + runCatching { client.dispatcher.executorService.shutdown() } + runCatching { client.connectionPool.evictAll() } + } +} diff --git a/app/src/main/java/com/trafero/app/data/model/Models.kt b/app/src/main/java/com/trafero/app/data/model/Models.kt new file mode 100644 index 0000000..a6bb6df --- /dev/null +++ b/app/src/main/java/com/trafero/app/data/model/Models.kt @@ -0,0 +1,123 @@ +package com.trafero.app.data.model + +import kotlinx.serialization.Serializable + +@Serializable +enum class AuthMode { NONE, API_KEY, USER_PASS } + +@Serializable +data class ServerProfile( + val id: String, + val label: String, + val baseUrl: String, + val authMode: AuthMode = AuthMode.NONE, + val apiKey: String = "", + val username: String = "", + val password: String = "", + val token: String = "", + val allowInsecureTls: Boolean = false, + val timeoutSeconds: Int = 20, + /** Doubles all HTTP timeouts for VPN / Wi-Fi-repeater links. */ + val slowConnection: Boolean = false +) + +data class ServerStatus( + val version: String, + val buildDate: String, + val os: String, + val serverEngine: String, + val uptimeSeconds: Long +) + +data class WorkerInfo( + val id: String, + val workerType: String, + val idle: Boolean, + val status: String, + val file: String, + val fps: String, + val eta: String, + val percentage: Int, + val startTime: Long, + val lastPluginDetails: String, + val jobId: String +) + +data class NodeInfo( + val id: String, + val name: String, + val remoteAddress: String, + val isPaused: Boolean, + val workerLimits: Map, + val queueLengths: Map, + val workers: List +) + +data class LibInfo( + val id: String, + val name: String, + val folder: String, + val container: String, + val folderWatching: Boolean, + val flowId: String, + val processLibrary: Boolean, + val sizeDiff: Double, + val totalTranscodeCount: Int, + val totalHealthCheckCount: Int +) + +data class GlobalSettings( + val pauseAllNodes: Boolean, + val ignoreSchedules: Boolean, + val autoAcceptTranscodes: Boolean, + val prioritiseHealthChecks: Boolean +) + +data class JobRow( + val id: String, + val file: String, + val type: String, + val nodeNames: String, + val workerGenus: String, + val startMs: Long, + val endMs: Long, + val status: String, + val fileSizeStartGB: Double, + val fileSizeEndGB: Double +) + +data class StagedRow( + val id: String, + val file: String, + val workerType: String, + val startMs: Long, + val jobId: String, + val status: String +) + +data class PieStatBucket(val name: String, val value: Int) + +data class PieStats( + val totalFiles: Int, + val totalTranscodeCount: Int, + val totalHealthCheckCount: Int, + val sizeDiffGB: Double, + val transcodeStatus: List, + val healthCheckStatus: List, + val videoCodecs: List +) + +data class ResStats( + val cpuPerc: Double, + val memUsedGB: Double, + val memTotalGB: Double, + val heapUsedMB: Double +) + +data class FlowPluginInfo( + val id: String, + val name: String, + val description: String, + val inputMedia: String, + val isOutputPlugin: Boolean +) diff --git a/app/src/main/java/com/trafero/app/data/repo/TraferoRepo.kt b/app/src/main/java/com/trafero/app/data/repo/TraferoRepo.kt new file mode 100644 index 0000000..d93769c --- /dev/null +++ b/app/src/main/java/com/trafero/app/data/repo/TraferoRepo.kt @@ -0,0 +1,356 @@ +package com.trafero.app.data.repo + +import com.trafero.app.data.api.TdarrClient +import com.trafero.app.data.api.TraferoApiException +import com.trafero.app.data.model.FlowPluginInfo +import com.trafero.app.data.model.GlobalSettings +import com.trafero.app.data.model.JobRow +import com.trafero.app.data.model.LibInfo +import com.trafero.app.data.model.NodeInfo +import com.trafero.app.data.model.PieStatBucket +import com.trafero.app.data.model.PieStats +import com.trafero.app.data.model.ResStats +import com.trafero.app.data.model.ServerStatus +import com.trafero.app.data.model.StagedRow +import com.trafero.app.data.model.WorkerInfo +import com.trafero.app.util.TraferoJson +import com.trafero.app.util.arr +import com.trafero.app.util.boolOr +import com.trafero.app.util.dblOr +import com.trafero.app.util.intOr +import com.trafero.app.util.obj +import com.trafero.app.util.str +import com.trafero.app.util.strOrNull +import kotlinx.coroutines.delay +import kotlinx.serialization.json.JsonElement +import kotlinx.serialization.json.JsonObject +import kotlinx.serialization.json.add +import kotlinx.serialization.json.buildJsonObject +import kotlinx.serialization.json.jsonPrimitive +import kotlinx.serialization.json.JsonPrimitive +import kotlinx.serialization.json.contentOrNull +import kotlinx.serialization.json.put +import kotlinx.serialization.json.putJsonArray +import kotlinx.serialization.json.putJsonObject + +data class TablePage(val array: List, val totalCount: Int) + +/** High-level operations over the Tdarr v2 API. */ +class TraferoRepo(private val client: TdarrClient) { + + /** + * Retry wrapper for read-like / polling calls over flaky links: up to two + * extra attempts after a NETWORK failure with 2 s / 5 s backoff. AUTH, + * SERVER and LEGACY errors surface immediately, and user-initiated + * mutations (pause, kill, scans, verdicts, settings writes) never pass + * through here so they are never silently repeated. + */ + private suspend fun attemptCall(block: suspend () -> T): T { + var attempt = 0 + while (true) { + try { + return block() + } catch (t: TraferoApiException) { + if (t.kind != TraferoApiException.Kind.NETWORK || attempt >= 2) throw t + delay(if (attempt == 0) 2_000L else 5_000L) + attempt++ + } + } + } + + /** Drop stale keep-alive sockets (called on app resume). */ + fun evictConnections() = client.evictConnections() + + // ---- basics ---- + + suspend fun status(): ServerStatus { + val j = attemptCall { client.getJson("status") } + return ServerStatus( + version = j.str("version"), + buildDate = j.str("buildDate"), + os = j.str("os"), + serverEngine = j.str("serverEngine"), + uptimeSeconds = j.str("uptime").toLongOrNull() ?: 0L + ) + } + + suspend fun login(): String { + val j = client.post("public/auth/login", buildJsonObject { + put("username", client.profile.username) + put("password", client.profile.password) + }) + return j.strOrNull("token") + ?: throw TraferoApiException(TraferoApiException.Kind.AUTH, "Login returned no token") + } + + // ---- generic table endpoint ---- + + suspend fun table( + type: String, + start: Int, + pageSize: Int, + filters: List> = emptyList(), + sorts: List> = emptyList(), + opts: JsonObject = JsonObject(emptyMap()) + ): TablePage { + val resp = attemptCall { client.post("client/" + type, buildJsonObject { + putJsonObject("data") { + put("start", start) + put("pageSize", pageSize) + putJsonArray("filters") { + filters.forEach { (id, value) -> + add(buildJsonObject { put("id", id); put("value", value) }) + } + } + putJsonArray("sorts") { + sorts.forEach { (id, desc) -> + add(buildJsonObject { put("id", id); put("desc", desc) }) + } + } + putJsonObject("opts") { opts.forEach { (k, v) -> put(k, v) } } + } + }) } + val arrElems = resp.arr("array").mapNotNull { it as? JsonObject } + val total = resp.intOr("totalCount", arrElems.size) + return TablePage(arrElems, total) + } + + // ---- parsing helpers ---- + + fun parseWorker(j: JsonObject, idOverride: String? = null): WorkerInfo = WorkerInfo( + id = idOverride ?: j.str("_id"), + workerType = j.str("workerType"), + idle = j.boolOr("idle"), + status = j.str("status"), + file = j.str("file"), + fps = j.str("fps"), + eta = j.str("ETA"), + percentage = j.intOr("percentage"), + startTime = j.str("startTime").toLongOrNull() ?: 0L, + lastPluginDetails = j.str("lastPluginDetails"), + jobId = j.obj("job").str("jobId") + ) + + fun parseNode(id: String, j: JsonObject): NodeInfo { + val workers = j.obj("workers")?.entries?.mapNotNull { (wid, w) -> + (w as? JsonObject)?.let { parseWorker(it, wid) } + } ?: emptyList() + val limits = j.obj("workerLimits")?.mapValues { e -> e.value.jsonPrimitive.content.toIntOrNull() ?: 0 } + ?: emptyMap() + val queues = j.obj("queueLengths")?.mapValues { e -> e.value.jsonPrimitive.content.toIntOrNull() ?: 0 } + ?: emptyMap() + return NodeInfo( + id = id, + name = j.str("nodeName"), + remoteAddress = j.str("remoteAddress"), + isPaused = j.boolOr("nodePaused"), + workerLimits = limits, + queueLengths = queues, + workers = workers + ) + } + + suspend fun nodes(): List { + val j = attemptCall { client.getJson("get-nodes") } as? JsonObject ?: return emptyList() + return j.mapNotNull { (id, v) -> (v as? JsonObject)?.let { parseNode(id, it) } } + .sortedBy { it.name } + } + + // ---- stats ---- + + private fun buckets(arr: kotlinx.serialization.json.JsonArray): List = + arr.mapNotNull { it as? JsonObject } + .map { PieStatBucket(it.str("name"), it.intOr("value")) } + .filter { it.value > 0 } + + suspend fun pies(libraryId: String = ""): PieStats { + val j = attemptCall { client.post("stats/get-pies", buildJsonObject { + putJsonObject("data") { put("libraryId", libraryId) } + }) } + val p = j.obj("pieStats") + return PieStats( + totalFiles = p.intOr("totalFiles"), + totalTranscodeCount = p.intOr("totalTranscodeCount"), + totalHealthCheckCount = p.intOr("totalHealthCheckCount"), + sizeDiffGB = p.dblOr("sizeDiff"), + transcodeStatus = buckets(p.obj("status").arr("transcode")), + healthCheckStatus = buckets(p.obj("status").arr("healthcheck")), + videoCodecs = buckets(p.obj("video").arr("codecs")) + ) + } + + suspend fun resStats(): ResStats { + val j = attemptCall { client.post("get-res-stats") } + return ResStats( + cpuPerc = j.obj("os").dblOr("cpuPerc"), + memUsedGB = j.obj("os").dblOr("memUsedGB"), + memTotalGB = j.obj("os").dblOr("memTotalGB"), + heapUsedMB = j.obj("process").dblOr("heapUsedMB") + ) + } + + // ---- database / settings ---- + + private suspend fun cruddb(data: JsonObject): JsonElement = + client.post("cruddb", buildJsonObject { put("data", data) }) + + suspend fun globalSettings(): GlobalSettings { + val j = attemptCall { cruddb(buildJsonObject { + put("collection", "SettingsGlobalJSONDB") + put("mode", "getById") + put("docID", "globalsettings") + putJsonObject("obj") { } + }) } + return GlobalSettings( + pauseAllNodes = j.boolOr("pauseAllNodes"), + ignoreSchedules = j.boolOr("ignoreSchedules"), + autoAcceptTranscodes = j.boolOr("autoAcceptTranscodes"), + prioritiseHealthChecks = j.boolOr("prioritiseHealthChecks") + ) + } + + suspend fun setGlobalSetting(key: String, value: Boolean) { + cruddb(buildJsonObject { + put("collection", "SettingsGlobalJSONDB") + put("mode", "update") + put("docID", "globalsettings") + putJsonObject("obj") { put(key, value) } + }) + } + + suspend fun libraries(): List { + val j = attemptCall { cruddb(buildJsonObject { + put("collection", "LibrarySettingsJSONDB") + put("mode", "getAll") + }) } as? kotlinx.serialization.json.JsonArray ?: return emptyList() + return j.mapNotNull { it as? JsonObject }.map { d -> + LibInfo( + id = d.str("_id"), + name = d.str("name"), + folder = d.str("folder"), + container = d.str("container"), + folderWatching = d.boolOr("folderWatching"), + flowId = d.str("flowId"), + processLibrary = d.boolOr("processLibrary", true), + sizeDiff = d.dblOr("sizeDiff"), + totalTranscodeCount = d.intOr("totalTranscodeCount"), + totalHealthCheckCount = d.intOr("totalHealthCheckCount") + ) + }.sortedBy { it.name.lowercase() } + } + + // ---- actions ---- + + suspend fun scanLibrary(dbID: String, folder: String, mode: String) { + client.post("scan-files", buildJsonObject { + putJsonObject("data") { + putJsonObject("scanConfig") { + put("dbID", dbID) + put("mode", mode) + put("arrayOrPath", folder) + } + } + }) + } + + suspend fun toggleFolderWatch(dbID: String, folder: String, status: Boolean) { + client.post("toggle-folder-watch", buildJsonObject { + putJsonObject("data") { + put("auto", false) + put("folder", folder) + put("dbID", dbID) + put("status", status) + } + }) + } + + suspend fun pauseNode(nodeID: String, paused: Boolean) { + client.post("update-node", buildJsonObject { + putJsonObject("data") { + put("nodeID", nodeID) + putJsonObject("nodeUpdates") { put("nodePaused", paused) } + } + }) + } + + suspend fun killWorker(nodeID: String, workerID: String) { + client.post("kill-worker", buildJsonObject { + putJsonObject("data") { put("nodeID", nodeID); put("workerID", workerID) } + }) + } + + suspend fun cancelWorkerItem(nodeID: String, workerID: String) { + client.post("cancel-worker-item", buildJsonObject { + putJsonObject("data") { + put("nodeID", nodeID); put("workerID", workerID); put("cause", "Cancelled from Trafero") + } + }) + } + + suspend fun alterWorkerLimit(nodeID: String, increase: Boolean, workerType: String) { + client.post("alter-worker-limit", buildJsonObject { + putJsonObject("data") { + put("nodeID", nodeID) + put("process", if (increase) "increase" else "decrease") + put("workerType", workerType) + } + }) + } + + suspend fun stagedVerdict(fileObj: JsonObject, verdict: String) { + client.post("transcode-user-verdict", buildJsonObject { + putJsonObject("data") { put("obj", fileObj); put("verdict", verdict) } + }) + } + + suspend fun recheckFile(id: String, dbID: String) { + client.post("rescan-file", buildJsonObject { + putJsonObject("data") { put("_id", id); put("DB", dbID) } + }) + } + + // ---- logs ---- + + suspend fun serverLogLines(pageNum: Int, pageSize: Int): List = + attemptCall { + client.getText("get-server-log", mapOf("pageNum" to pageNum.toString(), "pageSize" to pageSize.toString())) + }.lines().filter { it.isNotBlank() } + + suspend fun nodeLog(nodeID: String): List { + val j = attemptCall { client.post("get-node-log", buildJsonObject { + putJsonObject("data") { put("nodeID", nodeID) } + }) } + val text = if (j is JsonPrimitive) j.contentOrNull ?: j.toString() else j.toString() + return text.lines().filter { it.isNotBlank() } + } + + // ---- flow plugins ---- + + suspend fun flowPlugins(pluginType: String): List { + val resp = attemptCall { client.post("search-flow-plugins", buildJsonObject { + putJsonObject("data") { put("string", ""); put("pluginType", pluginType) } + }) } as? kotlinx.serialization.json.JsonArray + val plugins = resp?.firstOrNull() as? kotlinx.serialization.json.JsonArray ?: return emptyList() + return plugins.mapNotNull { it as? JsonObject }.map { d -> + FlowPluginInfo( + id = d.str("id").ifBlank { d.str("_id") }, + name = d.str("name").ifBlank { d.str("id") }, + description = d.str("description"), + inputMedia = d.str("inputMedia"), + isOutputPlugin = d.boolOr("outputPlugin") + ) + } + } + + companion object { + fun describeError(t: Throwable): String = when (t) { + is TraferoApiException -> when (t.kind) { + TraferoApiException.Kind.AUTH -> "Auth failed - check API key or login" + TraferoApiException.Kind.NETWORK -> t.message ?: "Network error" + TraferoApiException.Kind.LEGACY -> t.message ?: "Unsupported server" + TraferoApiException.Kind.SERVER -> t.message ?: "Server error" + } + else -> t.message ?: "Unexpected error" + } + } +} diff --git a/app/src/main/java/com/trafero/app/data/store/ServerStore.kt b/app/src/main/java/com/trafero/app/data/store/ServerStore.kt new file mode 100644 index 0000000..8e03e4c --- /dev/null +++ b/app/src/main/java/com/trafero/app/data/store/ServerStore.kt @@ -0,0 +1,62 @@ +package com.trafero.app.data.store + +import android.content.Context +import androidx.datastore.preferences.core.edit +import androidx.datastore.preferences.core.stringPreferencesKey +import androidx.datastore.preferences.preferencesDataStore +import com.trafero.app.data.model.ServerProfile +import com.trafero.app.util.TraferoJson +import kotlinx.coroutines.flow.Flow +import kotlinx.coroutines.flow.map +import kotlinx.serialization.builtins.ListSerializer + +private val Context.traferoDataStore by preferencesDataStore(name = "trafero_prefs") + +data class ServerBook(val profiles: List = emptyList(), val activeId: String? = null) { + val active: ServerProfile? get() = profiles.firstOrNull { it.id == activeId } ?: profiles.firstOrNull() +} + +class ServerStore(private val context: Context) { + + private val keyServers = stringPreferencesKey("servers_json") + private val keyActive = stringPreferencesKey("active_id") + + val book: Flow = context.traferoDataStore.data.map { prefs -> + val json = prefs[keyServers] + val list = if (json.isNullOrBlank()) emptyList() else + runCatching { + TraferoJson.decodeFromString(ListSerializer(ServerProfile.serializer()), json) + }.getOrDefault(emptyList()) + ServerBook(profiles = list, activeId = prefs[keyActive]) + } + + suspend fun upsert(profile: ServerProfile) { + context.traferoDataStore.edit { prefs -> + val book = decodeBook(prefs[keyServers], prefs[keyActive]) + val updated = book.profiles.filterNot { it.id == profile.id } + profile + prefs[keyServers] = TraferoJson.encodeToString(ListSerializer(ServerProfile.serializer()), updated) + if (book.active == null) prefs[keyActive] = profile.id + } + } + + suspend fun remove(id: String) { + context.traferoDataStore.edit { prefs -> + val book = decodeBook(prefs[keyServers], prefs[keyActive]) + val updated = book.profiles.filterNot { it.id == id } + prefs[keyServers] = TraferoJson.encodeToString(ListSerializer(ServerProfile.serializer()), updated) + if (prefs[keyActive] == id) prefs[keyActive] = updated.firstOrNull()?.id ?: "" + } + } + + suspend fun setActive(id: String) { + context.traferoDataStore.edit { prefs -> prefs[keyActive] = id } + } + + private fun decodeBook(serversJson: String?, activeId: String?): ServerBook { + val list = if (serversJson.isNullOrBlank()) emptyList() else + runCatching { + TraferoJson.decodeFromString(ListSerializer(ServerProfile.serializer()), serversJson) + }.getOrDefault(emptyList()) + return ServerBook(list, activeId?.takeIf { it.isNotBlank() }) + } +} diff --git a/app/src/main/java/com/trafero/app/di/AppContainer.kt b/app/src/main/java/com/trafero/app/di/AppContainer.kt new file mode 100644 index 0000000..4ab3cf7 --- /dev/null +++ b/app/src/main/java/com/trafero/app/di/AppContainer.kt @@ -0,0 +1,16 @@ +package com.trafero.app.di + +import android.app.Application +import com.trafero.app.data.api.TdarrClient +import com.trafero.app.data.model.ServerProfile +import com.trafero.app.data.store.ServerStore + +class AppContainer(app: Application) { + val serverStore = ServerStore(app) + + fun client(profile: ServerProfile): TdarrClient = TdarrClient(profile) +} + +class TraferoApp : Application() { + val container: AppContainer by lazy { AppContainer(this) } +} diff --git a/app/src/main/java/com/trafero/app/ui/AppRoot.kt b/app/src/main/java/com/trafero/app/ui/AppRoot.kt new file mode 100644 index 0000000..3406b67 --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/AppRoot.kt @@ -0,0 +1,175 @@ +package com.trafero.app.ui + +import androidx.compose.foundation.layout.padding +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.filled.Dns +import androidx.compose.material.icons.filled.Insights +import androidx.compose.material.icons.filled.PlayCircle +import androidx.compose.material.icons.filled.Search +import androidx.compose.material.icons.filled.MoreHoriz +import androidx.compose.material3.Icon +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.DropdownMenu +import androidx.compose.material3.DropdownMenuItem +import androidx.compose.material3.NavigationBar +import androidx.compose.material3.NavigationBarItem +import androidx.compose.material3.ExperimentalMaterial3Api +import androidx.compose.material3.Scaffold +import androidx.compose.material3.Text +import androidx.compose.material3.TextButton +import androidx.compose.material3.TopAppBar +import androidx.compose.runtime.Composable +import androidx.compose.runtime.CompositionLocalProvider +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.compositionLocalOf +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import kotlinx.coroutines.flow.filter +import kotlinx.coroutines.launch +import androidx.compose.ui.Modifier +import androidx.compose.ui.graphics.vector.ImageVector +import androidx.lifecycle.eventFlow +import androidx.navigation.NavHostController +import androidx.navigation.compose.NavHost +import androidx.navigation.compose.composable +import androidx.navigation.compose.currentBackStackEntryAsState +import androidx.navigation.compose.rememberNavController +import com.trafero.app.data.api.TdarrClient +import com.trafero.app.data.model.ServerProfile +import com.trafero.app.data.repo.TraferoRepo +import com.trafero.app.di.AppContainer +import com.trafero.app.ui.screens.flows.FlowsScreen +import com.trafero.app.ui.screens.jobs.JobsScreen +import com.trafero.app.ui.screens.library.LibraryScreen +import com.trafero.app.ui.screens.logs.LogsScreen +import com.trafero.app.ui.screens.more.MoreScreen +import com.trafero.app.ui.screens.nodes.NodesScreen +import com.trafero.app.ui.screens.onboarding.OnboardingScreen +import com.trafero.app.ui.screens.settings.SettingsScreen +import com.trafero.app.ui.screens.stats.StatsScreen + +val LocalRepo = compositionLocalOf { null } +val LocalServerCtx = compositionLocalOf { ServerCtx() } + +data class ServerCtx( + val refreshMs: Long = 15_000L, + val onError: (String) -> Unit = {} +) + +private data class Dest(val route: String, val label: String, val icon: ImageVector) + +private val bottomDests = listOf( + Dest("jobs", "Jobs", Icons.Default.PlayCircle), + Dest("library", "Library", Icons.Default.Search), + Dest("nodes", "Nodes", Icons.Default.Dns), + Dest("stats", "Stats", Icons.Default.Insights), + Dest("more", "More", Icons.Default.MoreHoriz) +) + +@Composable +fun AppRoot(container: AppContainer) { + val book by container.serverStore.book.collectAsState(initial = null) + val state = book ?: return + if (state.profiles.isEmpty()) { + OnboardingScreen(container, existing = null, onSaved = null) + return + } + val active = state.active ?: return + val repo = remember(active.id, active.baseUrl, active.apiKey, active.token, active.authMode) { + val client = TdarrClient(active) + TraferoRepo(client) + } + // On every return to foreground, drop pooled keep-alive sockets so slow + // links (NAT / VPN) don't write into silently-dead connections. + val lifecycleOwner = androidx.lifecycle.compose.LocalLifecycleOwner.current + androidx.compose.runtime.LaunchedEffect(repo) { + lifecycleOwner.lifecycle.eventFlow + .filter { it == androidx.lifecycle.Lifecycle.Event.ON_RESUME } + .collect { repo.evictConnections() } + } + var refreshMs by remember { mutableStateOf(15_000L) } + CompositionLocalProvider( + LocalRepo provides repo, + LocalServerCtx provides ServerCtx(refreshMs = refreshMs) + ) { + MainScaffold(container, state.profiles, active, refreshMs) { refreshMs = it } + } +} + +@OptIn(ExperimentalMaterial3Api::class) +@Composable +private fun MainScaffold( + container: AppContainer, + profiles: List, + active: ServerProfile, + refreshMs: Long, + onRefreshChange: (Long) -> Unit +) { + val nav = rememberNavController() + val backStack by nav.currentBackStackEntryAsState() + val currentRoute = backStack?.destination?.route + var serverMenu by remember { mutableStateOf(false) } + val scope = androidx.compose.runtime.rememberCoroutineScope() + Scaffold( + topBar = { + TopAppBar( + title = { + Text(active.label, color = MaterialTheme.colorScheme.onSurface) + }, + actions = { + androidx.compose.foundation.layout.Box { + TextButton(onClick = { serverMenu = true }) { Text("Switch") } + DropdownMenu(expanded = serverMenu, onDismissRequest = { serverMenu = false }) { + profiles.forEach { p -> + DropdownMenuItem( + text = { Text(p.label + if (p.id == active.id) " *" else "") }, + onClick = { + serverMenu = false + scope.launch { container.serverStore.setActive(p.id) } + } + ) + } + DropdownMenuItem( + text = { Text("Manage servers") }, + onClick = { + serverMenu = false + nav.navigate("settings") + } + ) + } + } + com.trafero.app.ui.common.RefreshIntervalMenu(refreshMs, onRefreshChange) + } + ) + }, + bottomBar = { + NavigationBar { + bottomDests.forEach { d -> + NavigationBarItem( + selected = currentRoute == d.route, + onClick = { nav.navigate(d.route) { launchSingleTop = true } }, + icon = { Icon(d.icon, contentDescription = d.label) }, + label = { Text(d.label) } + ) + } + } + } + ) { inner -> + NavHost( + navController = nav, + startDestination = "jobs", + modifier = Modifier.padding(inner) + ) { + composable("jobs") { JobsScreen(nav) } + composable("library") { LibraryScreen(nav) } + composable("nodes") { NodesScreen() } + composable("stats") { StatsScreen() } + composable("more") { MoreScreen(nav) } + composable("logs") { LogsScreen() } + composable("settings") { SettingsScreen(container) } + composable("flows") { FlowsScreen() } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/MainActivity.kt b/app/src/main/java/com/trafero/app/ui/MainActivity.kt new file mode 100644 index 0000000..80be940 --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/MainActivity.kt @@ -0,0 +1,26 @@ +package com.trafero.app.ui + +import android.os.Bundle +import androidx.activity.ComponentActivity +import androidx.activity.compose.setContent +import androidx.activity.enableEdgeToEdge +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.material3.Surface +import androidx.compose.ui.Modifier +import com.trafero.app.di.TraferoApp +import com.trafero.app.ui.theme.TraferoTheme + +class MainActivity : ComponentActivity() { + override fun onCreate(savedInstanceState: Bundle?) { + super.onCreate(savedInstanceState) + enableEdgeToEdge() + val container = (application as TraferoApp).container + setContent { + TraferoTheme { + Surface(modifier = Modifier.fillMaxSize()) { + AppRoot(container) + } + } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/common/Components.kt b/app/src/main/java/com/trafero/app/ui/common/Components.kt new file mode 100644 index 0000000..04b8b37 --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/common/Components.kt @@ -0,0 +1,198 @@ +package com.trafero.app.ui.common + +import androidx.compose.foundation.Canvas +import androidx.compose.foundation.clickable +import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.ColumnScope +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.size +import androidx.compose.foundation.layout.width +import androidx.compose.material3.Card +import androidx.compose.material3.CardDefaults +import androidx.compose.material3.DropdownMenu +import androidx.compose.material3.DropdownMenuItem +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.material3.TextButton +import androidx.compose.runtime.Composable +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.geometry.Offset +import androidx.compose.ui.geometry.Size +import androidx.compose.ui.graphics.Color +import androidx.compose.ui.graphics.drawscope.Stroke +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.text.style.TextOverflow +import androidx.compose.ui.unit.dp + +@Composable +fun SectionCard( + title: String? = null, + modifier: Modifier = Modifier, + content: @Composable ColumnScope.() -> Unit +) { + Card( + modifier = modifier.fillMaxWidth().padding(horizontal = 12.dp, vertical = 4.dp), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surfaceVariant.copy(alpha = 0.5f) + ) + ) { + Column(Modifier.padding(14.dp)) { + if (title != null) { + Text( + title, + style = MaterialTheme.typography.titleSmall, + fontWeight = FontWeight.SemiBold, + color = MaterialTheme.colorScheme.primary + ) + Spacer(Modifier.height(8.dp)) + } + content() + } + } +} + +@Composable +fun StatCard(label: String, value: String, modifier: Modifier = Modifier) { + SectionCard(modifier = modifier) { + Text(value, style = MaterialTheme.typography.headlineSmall, fontWeight = FontWeight.Bold) + Text( + label, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } +} + +@Composable +fun ErrorBanner(message: String, onRetry: (() -> Unit)? = null, modifier: Modifier = Modifier) { + Card( + modifier = modifier.fillMaxWidth().padding(12.dp), + colors = CardDefaults.cardColors(containerColor = MaterialTheme.colorScheme.errorContainer) + ) { + Row(Modifier.padding(12.dp), verticalAlignment = Alignment.CenterVertically) { + Text(message, modifier = Modifier.weight(1f), style = MaterialTheme.typography.bodyMedium) + if (onRetry != null) TextButton(onClick = onRetry) { Text("Retry") } + } + } +} + +/** Slim inline indicator shown when polling transiently fails but the + * screen still shows its last good data. */ +@Composable +fun ReconnectChip(modifier: Modifier = Modifier) { + androidx.compose.material3.Surface( + modifier = modifier.padding(horizontal = 12.dp, vertical = 4.dp), + shape = MaterialTheme.shapes.small, + color = MaterialTheme.colorScheme.secondaryContainer + ) { + Row( + Modifier.padding(horizontal = 10.dp, vertical = 4.dp), + verticalAlignment = Alignment.CenterVertically + ) { + androidx.compose.material3.CircularProgressIndicator( + Modifier.size(12.dp), strokeWidth = 2.dp, + color = MaterialTheme.colorScheme.onSecondaryContainer + ) + Spacer(Modifier.width(8.dp)) + Text( + "reconnecting...", + style = MaterialTheme.typography.labelMedium, + color = MaterialTheme.colorScheme.onSecondaryContainer + ) + } + } +} + +@Composable +fun EmptyBox(text: String, modifier: Modifier = Modifier) { + Box(modifier.padding(24.dp).fillMaxWidth(), contentAlignment = Alignment.Center) { + Text( + text, + style = MaterialTheme.typography.bodyLarge, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } +} + +@Composable +fun DonutChart( + slices: List>, + palette: List, + centerLabel: String, + modifier: Modifier = Modifier.size(150.dp) +) { + val total = slices.sumOf { it.second }.coerceAtLeast(1) + val bg = MaterialTheme.colorScheme.outlineVariant + Box(contentAlignment = Alignment.Center, modifier = modifier) { + Canvas(Modifier.fillMaxSize()) { + val stroke = size.minDimension * 0.22f + val d = size.minDimension - stroke + val offset = (size.width - d) / 2f + drawArc( + bg, 0f, 360f, false, + topLeft = Offset(offset, offset), size = Size(d, d), style = Stroke(stroke) + ) + var start = -90f + slices.forEachIndexed { i, (_, value) -> + val sweep = 360f * value / total + drawArc( + palette[i % palette.size], start, sweep, false, + topLeft = Offset(offset, offset), size = Size(d, d), style = Stroke(stroke) + ) + start += sweep + } + } + Text(centerLabel, style = MaterialTheme.typography.titleMedium, fontWeight = FontWeight.Bold) + } +} + +@Composable +fun LegendRow(name: String, value: Int, color: Color, modifier: Modifier = Modifier) { + Row(modifier.padding(vertical = 2.dp), verticalAlignment = Alignment.CenterVertically) { + Canvas(Modifier.size(10.dp)) { drawCircle(color) } + Spacer(Modifier.width(8.dp)) + Text( + name, style = MaterialTheme.typography.bodyMedium, + maxLines = 1, overflow = TextOverflow.Ellipsis, modifier = Modifier.weight(1f) + ) + Text(value.toString(), style = MaterialTheme.typography.bodyMedium, fontWeight = FontWeight.Medium) + } +} + +val ChartPalette: List = listOf( + Color(0xFF2E7D32), Color(0xFFFFA000), Color(0xFFC62828), Color(0xFF1565C0), + Color(0xFF6A1B9A), Color(0xFF00838F), Color(0xFF4E342E), Color(0xFFAD1457) +) + +@Composable +fun RefreshIntervalMenu( + intervalMs: Long, + onChange: (Long) -> Unit, + options: List> = listOf( + "Off" to 0L, "5s" to 5_000L, "15s" to 15_000L, "30s" to 30_000L, + "1m" to 60_000L, "5m" to 300_000L + ) +) { + var open by remember { mutableStateOf(false) } + Box { + TextButton(onClick = { open = true }) { + Text(options.firstOrNull { it.second == intervalMs }?.first ?: "Off") + } + DropdownMenu(expanded = open, onDismissRequest = { open = false }) { + options.forEach { (label, ms) -> + DropdownMenuItem(text = { Text(label) }, onClick = { open = false; onChange(ms) }) + } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/common/Format.kt b/app/src/main/java/com/trafero/app/ui/common/Format.kt new file mode 100644 index 0000000..1efb3d9 --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/common/Format.kt @@ -0,0 +1,38 @@ +package com.trafero.app.ui.common + +import java.util.Locale +import kotlin.math.abs + +object Fmt { + fun gb(bytes: Double): String { + val gb = bytes / 1_000_000_000.0 + return String.format(Locale.US, "%.2f GB", gb) + } + + fun gbSigned(v: Double): String = + (if (v > 0) "+" else "") + String.format(Locale.US, "%.2f GB", v) + + fun duration(ms: Long): String { + if (ms <= 0) return "-" + val s = ms / 1000 + val h = s / 3600 + val m = (s % 3600) / 60 + val sec = s % 60 + return if (h > 0) String.format(Locale.US, "%d:%02d:%02d", h, m, sec) + else String.format(Locale.US, "%d:%02d", m, sec) + } + + fun timeAgo(ms: Long): String { + if (ms <= 0) return "-" + val diff = System.currentTimeMillis() - ms + val m = diff / 60000 + return when { + m < 1 -> "just now" + m < 60 -> "$m min ago" + m < 1440 -> "${m / 60}h ago" + else -> "${m / 1440}d ago" + } + } + + fun fileName(path: String): String = path.substringAfterLast('/') +} diff --git a/app/src/main/java/com/trafero/app/ui/common/Polling.kt b/app/src/main/java/com/trafero/app/ui/common/Polling.kt new file mode 100644 index 0000000..43a5775 --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/common/Polling.kt @@ -0,0 +1,91 @@ +package com.trafero.app.ui.common + +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.lifecycle.Lifecycle +import androidx.lifecycle.compose.LocalLifecycleOwner +import androidx.lifecycle.repeatOnLifecycle +import com.trafero.app.data.api.TraferoApiException +import com.trafero.app.data.repo.TraferoRepo +import kotlinx.coroutines.delay +import kotlinx.coroutines.isActive + +/** + * Per-screen connection state for resilient polling. + * + * A transient NETWORK failure while the screen already holds data keeps that + * data visible and flips [reconnecting] (slim chip); everything else - AUTH, + * SERVER, or any failure with no data yet - returns a message for the full + * error banner. After [BACKOFF_AFTER] consecutive failures pollLoop slows to + * a 60 s cadence until one poll succeeds. + */ +class PollState { + var reconnecting by mutableStateOf(false) + private set + var consecutiveFailures = 0 + private set + + val backedOff: Boolean get() = consecutiveFailures >= BACKOFF_AFTER + + fun success() { + reconnecting = false + consecutiveFailures = 0 + } + + /** Returns a banner message, or null when the failure only shows the chip. */ + fun failure(t: Throwable, hasData: Boolean): String? { + consecutiveFailures++ + val transient = t is TraferoApiException && + t.kind == TraferoApiException.Kind.NETWORK && hasData + reconnecting = transient + return if (transient) null else TraferoRepo.describeError(t) + } + + /** Called when polling restarts (foreground return / key change): retry promptly. */ + fun reset() { + reconnecting = false + consecutiveFailures = 0 + } + + companion object { + const val BACKOFF_AFTER = 3 + const val BACKOFF_MS = 60_000L + } +} + +@Composable +fun rememberPollState(): PollState = remember { PollState() } + +/** + * Re-runs [action] immediately then every [intervalMs] (0 = run once). + * Polling is paused while the app is not RESUMED and restarts immediately + * when it comes back to the foreground. When [poll] reports repeated + * failures the interval is floored at 60 s until the next success. + */ +@Composable +fun pollLoop( + intervalMs: Long, + keys: List, + poll: PollState? = null, + action: suspend () -> Unit +) { + val lifecycleOwner = LocalLifecycleOwner.current + LaunchedEffect(intervalMs, keys) { + lifecycleOwner.repeatOnLifecycle(Lifecycle.State.RESUMED) { + poll?.reset() + while (isActive) { + action() + if (intervalMs <= 0L) break + val waitMs = + if (poll?.backedOff == true) intervalMs.coerceAtLeast(PollState.BACKOFF_MS) + else intervalMs + delay(waitMs) + } + } + } +} + diff --git a/app/src/main/java/com/trafero/app/ui/screens/flows/FlowsScreen.kt b/app/src/main/java/com/trafero/app/ui/screens/flows/FlowsScreen.kt new file mode 100644 index 0000000..e2cbc0e --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/flows/FlowsScreen.kt @@ -0,0 +1,75 @@ +package com.trafero.app.ui.screens.flows + +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.material3.Card +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Tab +import androidx.compose.material3.TabRow +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.text.style.TextOverflow +import androidx.compose.ui.unit.dp +import com.trafero.app.data.model.FlowPluginInfo +import com.trafero.app.data.repo.TraferoRepo +import com.trafero.app.ui.LocalRepo +import com.trafero.app.ui.common.EmptyBox +import com.trafero.app.ui.common.ErrorBanner + +private val flowTypes = listOf("inputs" to "input", "filters" to "filter", "actions" to "action", + "variables" to "variables", "outputs" to "output") + +@Composable +fun FlowsScreen() { + val repo = LocalRepo.current ?: return + var tab by remember { mutableStateOf(0) } + var plugins by remember { mutableStateOf?>(null) } + var error by remember { mutableStateOf(null) } + LaunchedEffect(tab) { + plugins = null + runCatching { repo.flowPlugins(flowTypes[tab].second) } + .onSuccess { plugins = it; error = null } + .onFailure { error = TraferoRepo.describeError(it) } + } + Column(Modifier.fillMaxSize()) { + TabRow(selectedTabIndex = tab) { + flowTypes.forEachIndexed { i, (label, _) -> + Tab(selected = tab == i, onClick = { tab = i }, text = { Text(label) }) + } + } + error?.let { ErrorBanner(it) } + Text("Flow building is done in the Tdarr web UI - Trafero lists plugins for reference.", + Modifier.padding(16.dp), style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant) + val loaded = plugins + when { + loaded == null -> Unit + loaded.isEmpty() -> EmptyBox("No plugins returned for this type") + else -> LazyColumn(Modifier.fillMaxSize()) { + items(loaded, key = { it.id }) { p -> + Card(Modifier.fillMaxWidth().padding(8.dp)) { + Column(Modifier.padding(12.dp)) { + Text(p.name.ifBlank { p.id }, fontWeight = FontWeight.SemiBold) + if (p.description.isNotBlank()) { + Text(p.description, style = MaterialTheme.typography.bodySmall, + maxLines = 3, overflow = TextOverflow.Ellipsis, + color = MaterialTheme.colorScheme.onSurfaceVariant) + } + } + } + } + } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/jobs/JobsScreen.kt b/app/src/main/java/com/trafero/app/ui/screens/jobs/JobsScreen.kt new file mode 100644 index 0000000..7ee5c3e --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/jobs/JobsScreen.kt @@ -0,0 +1,318 @@ +package com.trafero.app.ui.screens.jobs + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.foundation.lazy.rememberLazyListState +import androidx.compose.material3.Card +import androidx.compose.material3.CircularProgressIndicator +import androidx.compose.material3.LinearProgressIndicator +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedTextField +import androidx.compose.material3.Tab +import androidx.compose.material3.TabRow +import androidx.compose.material3.Text +import androidx.compose.material3.TextButton +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.derivedStateOf +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.rememberCoroutineScope +import androidx.compose.runtime.setValue +import androidx.compose.runtime.snapshotFlow +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.text.style.TextOverflow +import androidx.compose.ui.unit.dp +import androidx.navigation.NavController +import com.trafero.app.data.model.NodeInfo +import com.trafero.app.data.repo.TraferoRepo +import com.trafero.app.ui.LocalRepo +import com.trafero.app.ui.LocalServerCtx +import com.trafero.app.ui.common.EmptyBox +import com.trafero.app.ui.common.ErrorBanner +import com.trafero.app.ui.common.Fmt +import com.trafero.app.ui.common.ReconnectChip +import com.trafero.app.ui.common.pollLoop +import com.trafero.app.ui.common.rememberPollState +import com.trafero.app.util.dblOr +import com.trafero.app.util.intOr +import com.trafero.app.util.obj +import com.trafero.app.util.str +import kotlinx.coroutines.launch +import kotlinx.serialization.json.JsonObject +import kotlinx.serialization.json.put + +@Composable +fun JobsScreen(nav: NavController) { + val repo = LocalRepo.current ?: return + val ctx = LocalServerCtx.current + val tabs = listOf("Running", "Staged", "History", "Errors") + var tab by remember { mutableStateOf(0) } + Column(Modifier.fillMaxSize()) { + TabRow(selectedTabIndex = tab) { + tabs.forEachIndexed { i, t -> + Tab(selected = tab == i, onClick = { tab = i }, text = { Text(t) }) + } + } + when (tab) { + 0 -> RunningTab(repo, ctx.refreshMs) + 1 -> StagedTab(repo, ctx.refreshMs) + 2 -> HistoryTab(repo, ctx.refreshMs) + else -> ErrorsTab(repo, ctx.refreshMs) + } + } +} + +@Composable +private fun CenterLoader() { + Box(Modifier.fillMaxSize(), contentAlignment = Alignment.Center) { + CircularProgressIndicator() + } +} + +@Composable +private fun RunningTab(repo: TraferoRepo, refreshMs: Long) { + var nodes by remember { mutableStateOf?>(null) } + var error by remember { mutableStateOf(null) } + val scope = rememberCoroutineScope() + val poll = rememberPollState() + pollLoop(refreshMs, listOf("running"), poll) { + runCatching { repo.nodes() } + .onSuccess { nodes = it; error = null; poll.success() } + .onFailure { poll.failure(it, hasData = nodes != null)?.let { msg -> error = msg } } + } + val loaded = nodes + if (loaded == null) { if (error != null) ErrorBanner(error!!) else CenterLoader(); return } + val workers = loaded.flatMap { n -> n.workers.filter { !it.idle }.map { n to it } } + Column { + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + if (workers.isEmpty()) { + EmptyBox("No active workers - library is idle") + } else { + LazyColumn(Modifier.fillMaxSize()) { + items(workers, key = { it.first.id + "/" + it.second.id }) { (node, w) -> + Card(Modifier.fillMaxWidth().padding(8.dp)) { + Column(Modifier.padding(12.dp)) { + Text(Fmt.fileName(w.file.ifBlank { w.id }), fontWeight = FontWeight.SemiBold, + maxLines = 1, overflow = TextOverflow.Ellipsis) + Spacer(Modifier.height(4.dp)) + Text(node.name + " - " + w.workerType + " - " + w.status, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant) + w.lastPluginDetails.takeIf { it.isNotBlank() }?.let { + Text(it, style = MaterialTheme.typography.bodySmall, maxLines = 1, + overflow = TextOverflow.Ellipsis) + } + if (w.percentage > 0) { + Spacer(Modifier.height(6.dp)) + LinearProgressIndicator(progress = { w.percentage / 100f }, + modifier = Modifier.fillMaxWidth()) + } + Row(horizontalArrangement = Arrangement.SpaceBetween, + verticalAlignment = Alignment.CenterVertically, + modifier = Modifier.fillMaxWidth()) { + val bits = mutableListOf() + if (w.fps.isNotBlank()) bits.add(w.fps + " fps") + if (w.eta.isNotBlank()) bits.add("ETA " + w.eta) + if (w.percentage > 0) bits.add(w.percentage.toString() + "%") + Text(bits.joinToString(" "), style = MaterialTheme.typography.bodySmall) + TextButton(onClick = { + scope.launch { + runCatching { repo.cancelWorkerItem(node.id, w.id) } + .onFailure { error = TraferoRepo.describeError(it) } + } + }) { Text("Cancel") } + } + } + } + } + } + } + } +} + +@Composable +private fun StagedTab(repo: TraferoRepo, refreshMs: Long) { + var rows by remember { mutableStateOf?>(null) } + var total by remember { mutableStateOf(0) } + var error by remember { mutableStateOf(null) } + val scope = rememberCoroutineScope() + val poll = rememberPollState() + pollLoop(refreshMs, listOf("staged"), poll) { + runCatching { repo.table("staged", 0, 50) } + .onSuccess { rows = it.array; total = it.totalCount; error = null; poll.success() } + .onFailure { poll.failure(it, hasData = rows != null)?.let { msg -> error = msg } } + } + val loaded = rows + if (loaded == null) { + if (error != null) ErrorBanner(error!!) else CenterLoader() + } else { + Column { + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + Text("Staged for approval: " + total, Modifier.padding(16.dp), + style = MaterialTheme.typography.titleSmall) + if (loaded.isEmpty()) { + EmptyBox("Nothing staged") + } else { + LazyColumn(Modifier.fillMaxSize()) { + items(loaded, key = { it.str("_id") }) { row -> + Card(Modifier.fillMaxWidth().padding(horizontal = 8.dp, vertical = 4.dp)) { + Column(Modifier.padding(12.dp)) { + Text(Fmt.fileName(row.str("_id")), maxLines = 1, + overflow = TextOverflow.Ellipsis, fontWeight = FontWeight.SemiBold) + Text(row.obj("job").str("type") + " " + Fmt.timeAgo(row.str("start").toLongOrNull() ?: 0L), + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant) + Row(horizontalArrangement = Arrangement.End, modifier = Modifier.fillMaxWidth()) { + TextButton(onClick = { + scope.launch { + runCatching { repo.stagedVerdict(row, "approve") } + .onFailure { error = TraferoRepo.describeError(it) } + } + }) { Text("Approve") } + TextButton(onClick = { + scope.launch { + runCatching { repo.stagedVerdict(row, "reject") } + .onFailure { error = TraferoRepo.describeError(it) } + } + }) { Text("Reject") } + } + } + } + } + } + } + } + } +} + +@Composable +private fun HistoryTab(repo: TraferoRepo, refreshMs: Long) { + var query by remember { mutableStateOf("") } + var rows by remember { mutableStateOf?>(null) } + var total by remember { mutableStateOf(0) } + var error by remember { mutableStateOf(null) } + val pageSize = 25 + val filterKey = query.trim() + val poll = rememberPollState() + pollLoop(refreshMs, listOf("history", filterKey), poll) { + val filters = if (filterKey.isBlank()) emptyList() else listOf("file" to filterKey) + runCatching { repo.table("jobs", 0, pageSize, filters = filters, sorts = listOf("start" to true)) } + .onSuccess { rows = it.array; total = it.totalCount; error = null; poll.success() } + .onFailure { poll.failure(it, hasData = rows != null)?.let { msg -> error = msg } } + } + val loaded = rows + Column { + OutlinedTextField(value = query, onValueChange = { query = it }, + label = { Text("Filter by file name") }, singleLine = true, + modifier = Modifier.fillMaxWidth().padding(12.dp)) + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + if (loaded == null) { + if (error == null) CenterLoader() + } else { + Text("Job history (showing " + loaded.size + " of " + total + ")", + Modifier.padding(horizontal = 16.dp), style = MaterialTheme.typography.labelMedium) + LazyColumn(Modifier.fillMaxSize()) { + items(loaded, key = { it.str("_id") }) { row -> JobRowCard(row) } + } + } + } +} + +@Composable +private fun JobRowCard(row: JsonObject) { + val start = row.str("start").toLongOrNull() ?: 0L + val end = row.str("end").toLongOrNull() ?: 0L + val diff = row.dblOr("fileSizeDiffGB") + val status = row.str("status") + val statusColor = when { + status.contains("success", true) -> MaterialTheme.colorScheme.primary + status.contains("error", true) || status.contains("fail", true) -> MaterialTheme.colorScheme.error + else -> MaterialTheme.colorScheme.onSurfaceVariant + } + Card(Modifier.fillMaxWidth().padding(horizontal = 8.dp, vertical = 3.dp)) { + Column(Modifier.padding(12.dp)) { + Text(Fmt.fileName(row.str("file")), maxLines = 1, overflow = TextOverflow.Ellipsis, + fontWeight = FontWeight.Medium) + Row(Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.SpaceBetween) { + Text(row.obj("job").str("type") + " " + row.str("nodeNames") + " " + Fmt.duration(end - start), + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant, + maxLines = 1, overflow = TextOverflow.Ellipsis, modifier = Modifier.weight(1f)) + Text(status, style = MaterialTheme.typography.labelMedium, color = statusColor) + } + if (diff != 0.0) { + Text("Size change: " + Fmt.gbSigned(diff), style = MaterialTheme.typography.bodySmall) + } + } + } +} + +@Composable +private fun ErrorsTab(repo: TraferoRepo, refreshMs: Long) { + val stacks = listOf("Transcode fails" to "table1", "Health-check fails" to "table2", "Cancelled" to "table3") + LazyColumn(Modifier.fillMaxSize()) { + stacks.forEach { (label, table) -> + item(key = "hdr-" + table) { + Text(label, Modifier.padding(start = 16.dp, top = 12.dp, bottom = 4.dp), + style = MaterialTheme.typography.titleSmall, fontWeight = FontWeight.SemiBold, + color = MaterialTheme.colorScheme.primary) + } + item(key = "list-" + table) { StackList(repo, refreshMs, table) } + } + } +} + +@Composable +private fun StackList(repo: TraferoRepo, refreshMs: Long, table: String) { + var rows by remember(table) { mutableStateOf?>(null) } + var error by remember(table) { mutableStateOf(null) } + val poll = rememberPollState() + pollLoop(refreshMs, listOf("stack", table), poll) { + runCatching { + repo.table("status-tables", 0, 100, opts = kotlinx.serialization.json.buildJsonObject { put("table", table) }) + } + .onSuccess { rows = it.array; error = null; poll.success() } + .onFailure { poll.failure(it, hasData = rows != null)?.let { msg -> error = msg } } + } + val loaded = rows + Column { + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + when { + loaded == null -> Unit + loaded.isEmpty() -> Text("Empty", Modifier.padding(horizontal = 16.dp, vertical = 4.dp), + style = MaterialTheme.typography.bodySmall, color = MaterialTheme.colorScheme.outline) + else -> loaded.take(20).forEach { row -> + Card(Modifier.fillMaxWidth().padding(horizontal = 8.dp, vertical = 2.dp)) { + Column(Modifier.padding(10.dp)) { + Text(row.str("fileNameWithoutExtension").ifBlank { Fmt.fileName(row.str("file")) }, + maxLines = 1, overflow = TextOverflow.Ellipsis, + style = MaterialTheme.typography.bodyMedium) + val det = row.str("lastPluginDetails") + if (det.isNotBlank()) { + Text(det, maxLines = 2, overflow = TextOverflow.Ellipsis, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.error) + } + } + } + } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/library/LibraryScreen.kt b/app/src/main/java/com/trafero/app/ui/screens/library/LibraryScreen.kt new file mode 100644 index 0000000..4ad26d6 --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/library/LibraryScreen.kt @@ -0,0 +1,245 @@ +package com.trafero.app.ui.screens.library + +import androidx.compose.foundation.clickable +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.heightIn +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.material3.Button +import androidx.compose.material3.Card +import androidx.compose.material3.DropdownMenu +import androidx.compose.material3.DropdownMenuItem +import androidx.compose.material3.ExperimentalMaterial3Api +import androidx.compose.material3.ModalBottomSheet +import androidx.compose.material3.OutlinedTextField +import androidx.compose.material3.Text +import androidx.compose.material3.TextButton +import androidx.compose.material3.MaterialTheme +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.rememberCoroutineScope +import androidx.compose.runtime.setValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.font.FontFamily +import androidx.compose.ui.text.font.FontStyle +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.text.style.TextOverflow +import androidx.compose.ui.unit.dp +import androidx.navigation.NavController +import com.trafero.app.data.model.LibInfo +import com.trafero.app.data.repo.TraferoRepo +import com.trafero.app.ui.LocalRepo +import com.trafero.app.ui.LocalServerCtx +import com.trafero.app.ui.common.EmptyBox +import com.trafero.app.ui.common.ErrorBanner +import com.trafero.app.ui.common.Fmt +import com.trafero.app.ui.common.ReconnectChip +import com.trafero.app.ui.common.pollLoop +import com.trafero.app.ui.common.rememberPollState +import com.trafero.app.util.TraferoJson +import com.trafero.app.util.boolOr +import com.trafero.app.util.dblOr +import com.trafero.app.util.intOr +import com.trafero.app.util.obj +import com.trafero.app.util.str +import com.trafero.app.util.strOrNull +import kotlinx.coroutines.launch +import kotlinx.serialization.json.JsonArray +import kotlinx.serialization.json.JsonObject + +private val SortOptions = listOf( + "Name (A-Z)" to ("file" to false), + "Size (largest)" to ("fileSize" to true), + "Size (smallest)" to ("fileSize" to false) +) + +@OptIn(ExperimentalMaterial3Api::class) +@Composable +fun LibraryScreen(nav: NavController) { + val repo = LocalRepo.current ?: return + val ctx = LocalServerCtx.current + var query by remember { mutableStateOf("") } + var libId by remember { mutableStateOf(null) } + var sortIdx by remember { mutableStateOf(0) } + var libs by remember { mutableStateOf>(emptyList()) } + var rows by remember { mutableStateOf?>(null) } + var total by remember { mutableStateOf(0) } + var error by remember { mutableStateOf(null) } + var selected by remember { mutableStateOf(null) } + var libMenu by remember { mutableStateOf(false) } + var sortMenu by remember { mutableStateOf(false) } + val pageSize = 30 + val scope = rememberCoroutineScope() + + LaunchedEffect(Unit) { runCatching { repo.libraries() }.onSuccess { libs = it } } + + val filterKey = query.trim() + val poll = rememberPollState() + pollLoop(ctx.refreshMs, listOf("search", filterKey, libId, sortIdx), poll) { + val filters = buildList { + if (filterKey.isNotBlank()) add("file" to filterKey) + libId?.let { add("DB" to it) } + } + val sort = SortOptions[sortIdx].second + runCatching { repo.table("search", 0, pageSize, filters = filters, sorts = listOf(sort)) } + .onSuccess { rows = it.array; total = it.totalCount; error = null; poll.success() } + .onFailure { poll.failure(it, hasData = rows != null)?.let { msg -> error = msg } } + } + + Column(Modifier.fillMaxSize()) { + Row(Modifier.padding(horizontal = 12.dp), horizontalArrangement = Arrangement.spacedBy(8.dp)) { + OutlinedTextField(value = query, onValueChange = { query = it }, singleLine = true, + label = { Text("Search files") }, modifier = Modifier.weight(1f)) + } + Row(Modifier.padding(horizontal = 12.dp, vertical = 6.dp), horizontalArrangement = Arrangement.spacedBy(8.dp)) { + TextButton(onClick = { libMenu = true }) { + Text(libs.find { it.id == libId }?.name ?: "All libraries") + } + DropdownMenu(expanded = libMenu, onDismissRequest = { libMenu = false }) { + DropdownMenuItem(text = { Text("All libraries") }, onClick = { libId = null; libMenu = false }) + libs.forEach { l -> + DropdownMenuItem(text = { Text(l.name) }, onClick = { libId = l.id; libMenu = false }) + } + } + TextButton(onClick = { sortMenu = true }) { Text(SortOptions[sortIdx].first) } + DropdownMenu(expanded = sortMenu, onDismissRequest = { sortMenu = false }) { + SortOptions.forEachIndexed { i, (label, _) -> + DropdownMenuItem(text = { Text(label) }, onClick = { sortIdx = i; sortMenu = false }) + } + } + } + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + val loaded = rows + if (loaded == null) { + Unit // first load in flight; errors (if any) already shown by the banner above + } else if (loaded.isEmpty()) { + EmptyBox("No files found") + } else { + Text("Showing " + loaded.size + " of " + total + " files", + Modifier.padding(horizontal = 16.dp), style = MaterialTheme.typography.labelMedium) + LazyColumn(Modifier.fillMaxSize()) { + items(loaded, key = { it.str("_id") }) { row -> + FileCard(row) { selected = row } + } + } + } + } + + selected?.let { row -> + ModalBottomSheet(onDismissRequest = { selected = null }) { + FileDetailSheet(repo, row) { msg -> error = msg; selected = null } + } + } +} + +@Composable +private fun FileCard(row: JsonObject, onClick: () -> Unit) { + Card(Modifier.fillMaxWidth().padding(horizontal = 8.dp, vertical = 3.dp).clickable(onClick = onClick)) { + Column(Modifier.padding(12.dp)) { + Text(row.str("fileNameWithoutExtension"), maxLines = 1, overflow = TextOverflow.Ellipsis, + fontWeight = FontWeight.Medium) + val meta = buildList { + row.str("container").takeIf { it.isNotBlank() }?.let { add(it.uppercase()) } + row.str("video_codec_name").takeIf { it.isNotBlank() }?.let { add(it) } + row.str("video_resolution").takeIf { it.isNotBlank() }?.let { add(it) } + val size = row.dblOr("file_size") + if (size > 0) add(Fmt.gb(size)) + } + Text(meta.joinToString(" - "), style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant, maxLines = 1, + overflow = TextOverflow.Ellipsis) + row.str("lastPluginDetails").takeIf { it.isNotBlank() && it != "none" }?.let { + Text(it, style = MaterialTheme.typography.bodySmall, maxLines = 1, + overflow = TextOverflow.Ellipsis, color = MaterialTheme.colorScheme.outline) + } + } + } +} + +private fun streamsOf(row: JsonObject): List { + val sr = row.obj("scannerReads") ?: return emptyList() + val direct = sr.obj("ffProbeRead") + val parsed = direct ?: sr.strOrNull("ffProbeRead")?.let { + runCatching { TraferoJson.parseToJsonElement(it) as? JsonObject }.getOrNull() + } + return (parsed?.get("streams") as? JsonArray)?.mapNotNull { it as? JsonObject } ?: emptyList() +} + +@Composable +fun FileDetailSheet(repo: TraferoRepo, row: JsonObject, onActionDone: (String) -> Unit) { + val scope = rememberCoroutineScope() + var busy by remember { mutableStateOf(false) } + val streams = streamsOf(row) + Column(Modifier.padding(horizontal = 20.dp, vertical = 8.dp)) { + Text(row.str("fileNameWithoutExtension"), style = MaterialTheme.typography.titleMedium, + fontWeight = FontWeight.SemiBold) + Spacer(Modifier.height(4.dp)) + Text(row.str("file"), style = MaterialTheme.typography.bodySmall, fontFamily = FontFamily.Monospace, + maxLines = 2, overflow = TextOverflow.Ellipsis, color = MaterialTheme.colorScheme.outline) + Spacer(Modifier.height(10.dp)) + val info = buildList { + add("Container: " + row.str("container", "-")) + val size = row.dblOr("file_size") + if (size > 0) add("Size: " + Fmt.gb(size)) + row.str("video_codec_name").takeIf { it.isNotBlank() }?.let { add("Video: " + it) } + row.str("video_resolution").takeIf { it.isNotBlank() }?.let { add("Resolution: " + it) } + val dur = row.intOr("duration") + if (dur > 0) add("Duration: " + Fmt.duration(dur.toLong())) + add("Last checked: " + Fmt.timeAgo(row.str("lastHealthCheckDate").toLongOrNull() ?: 0L)) + } + info.forEach { Text(it, style = MaterialTheme.typography.bodyMedium) } + val plugin = row.str("lastPluginDetails") + if (plugin.isNotBlank()) { + Spacer(Modifier.height(8.dp)) + Text("Plugin output", style = MaterialTheme.typography.titleSmall, + color = MaterialTheme.colorScheme.primary) + Text(plugin, style = MaterialTheme.typography.bodySmall) + } + if (streams.isNotEmpty()) { + Spacer(Modifier.height(8.dp)) + Text("Streams (" + streams.size + ")", style = MaterialTheme.typography.titleSmall, + color = MaterialTheme.colorScheme.primary) + streams.forEach { s -> + val type = s.str("codec_type") + val codec = s.str("codec_name") + val lang = s.obj("tags").str("language") + val wh = listOf(s.str("width"), s.str("height")).filter { it.isNotBlank() }.joinToString("x") + val ch = s.str("channels") + val line = buildString { + append(type.ifBlank { "?" }) + if (codec.isNotBlank()) append(": " + codec) + if (wh.isNotBlank()) append(" " + wh) + if (ch.isNotBlank()) append(" " + ch + "ch") + if (lang.isNotBlank()) append(" [" + lang + "]") + } + Text(line, style = MaterialTheme.typography.bodySmall) + } + } + Spacer(Modifier.height(16.dp)) + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + Button(enabled = !busy, onClick = { + busy = true + scope.launch { + runCatching { repo.recheckFile(row.str("_id"), row.str("DB")) } + .onSuccess { onActionDone("Recheck queued") } + .onFailure { onActionDone(TraferoRepo.describeError(it)) } + busy = false + } + }) { Text("Re-check file") } + TextButton(onClick = { onActionDone("") }) { Text("Close") } + } + Spacer(Modifier.height(28.dp)) + } +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/logs/LogsScreen.kt b/app/src/main/java/com/trafero/app/ui/screens/logs/LogsScreen.kt new file mode 100644 index 0000000..1b2a656 --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/logs/LogsScreen.kt @@ -0,0 +1,86 @@ +package com.trafero.app.ui.screens.logs + +import androidx.compose.foundation.background +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.itemsIndexed +import androidx.compose.foundation.lazy.rememberLazyListState +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedButton +import androidx.compose.material3.OutlinedTextField +import androidx.compose.material3.Switch +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.font.FontFamily +import androidx.compose.ui.text.style.TextOverflow +import androidx.compose.ui.unit.dp +import androidx.compose.ui.unit.sp +import com.trafero.app.data.repo.TraferoRepo +import com.trafero.app.ui.LocalRepo +import com.trafero.app.ui.LocalServerCtx +import com.trafero.app.ui.common.ErrorBanner +import com.trafero.app.ui.common.EmptyBox +import com.trafero.app.ui.common.ReconnectChip +import com.trafero.app.ui.common.pollLoop +import com.trafero.app.ui.common.rememberPollState +import kotlinx.coroutines.launch +import androidx.compose.runtime.rememberCoroutineScope + +@Composable +fun LogsScreen() { + val repo = LocalRepo.current ?: return + val ctx = LocalServerCtx.current + var lines by remember { mutableStateOf?>(null) } + var error by remember { mutableStateOf(null) } + var filter by remember { mutableStateOf("") } + var follow by remember { mutableStateOf(true) } + val listState = rememberLazyListState() + val poll = rememberPollState() + pollLoop(if (follow) ctx.refreshMs else 0L, listOf("logs", follow), poll) { + runCatching { repo.serverLogLines(1, 500) } + .onSuccess { lines = it.reversed(); error = null; poll.success() } + .onFailure { poll.failure(it, hasData = lines != null)?.let { msg -> error = msg } } + } + val shown = lines?.let { l -> if (filter.isBlank()) l else l.filter { it.contains(filter, true) } } + Column(Modifier.fillMaxSize()) { + Row(Modifier.padding(12.dp), verticalAlignment = Alignment.CenterVertically, + horizontalArrangement = Arrangement.spacedBy(8.dp)) { + OutlinedTextField(value = filter, onValueChange = { filter = it }, singleLine = true, + label = { Text("Filter") }, modifier = Modifier.weight(1f)) + Column(horizontalAlignment = Alignment.CenterHorizontally) { + Text("Follow", style = MaterialTheme.typography.labelSmall) + Switch(checked = follow, onCheckedChange = { follow = it }) + } + } + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + val data = shown + if (data == null) { + if (error == null) EmptyBox("Waiting for server log...") + } else { + LazyColumn(state = listState, modifier = Modifier.fillMaxSize()) { + itemsIndexed(data) { _, line -> + val color = when { + line.contains("ERROR") -> MaterialTheme.colorScheme.error + line.contains("WARN") -> MaterialTheme.colorScheme.tertiary + else -> MaterialTheme.colorScheme.onSurface + } + Text(line, fontFamily = FontFamily.Monospace, fontSize = 11.sp, color = color, + maxLines = 2, overflow = TextOverflow.Ellipsis, + modifier = Modifier.fillMaxWidth().padding(horizontal = 10.dp, vertical = 1.dp)) + } + } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/more/MoreScreen.kt b/app/src/main/java/com/trafero/app/ui/screens/more/MoreScreen.kt new file mode 100644 index 0000000..142edad --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/more/MoreScreen.kt @@ -0,0 +1,26 @@ +package com.trafero.app.ui.screens.more + +import androidx.compose.foundation.clickable +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.padding +import androidx.compose.material3.Card +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import androidx.navigation.NavController + +@Composable +fun MoreScreen(nav: NavController) { + val items = listOf("Logs" to "logs", "Flows & plugins" to "flows", "Settings" to "settings") + Column(Modifier.fillMaxSize().padding(12.dp)) { + items.forEach { (label, route) -> + Card(Modifier.fillMaxWidth().padding(vertical = 6.dp).clickable { nav.navigate(route) }) { + Text(label, Modifier.padding(20.dp), style = MaterialTheme.typography.titleMedium) + } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/nodes/NodesScreen.kt b/app/src/main/java/com/trafero/app/ui/screens/nodes/NodesScreen.kt new file mode 100644 index 0000000..1686efb --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/nodes/NodesScreen.kt @@ -0,0 +1,146 @@ +package com.trafero.app.ui.screens.nodes + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.material3.Card +import androidx.compose.material3.IconButton +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Switch +import androidx.compose.material3.Text +import androidx.compose.material3.TextButton +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.filled.Add +import androidx.compose.material.icons.filled.Remove +import androidx.compose.material.icons.filled.Close +import androidx.compose.material3.Icon +import androidx.compose.runtime.Composable +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.rememberCoroutineScope +import androidx.compose.runtime.setValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.text.style.TextOverflow +import androidx.compose.ui.unit.dp +import com.trafero.app.data.model.NodeInfo +import com.trafero.app.data.repo.TraferoRepo +import com.trafero.app.ui.LocalRepo +import com.trafero.app.ui.LocalServerCtx +import com.trafero.app.ui.common.EmptyBox +import com.trafero.app.ui.common.ErrorBanner +import com.trafero.app.ui.common.Fmt +import com.trafero.app.ui.common.ReconnectChip +import com.trafero.app.ui.common.pollLoop +import com.trafero.app.ui.common.rememberPollState +import kotlinx.coroutines.launch + +@Composable +fun NodesScreen() { + val repo = LocalRepo.current ?: return + val ctx = LocalServerCtx.current + var nodes by remember { mutableStateOf?>(null) } + var error by remember { mutableStateOf(null) } + val poll = rememberPollState() + pollLoop(ctx.refreshMs, listOf("nodes"), poll) { + runCatching { repo.nodes() } + .onSuccess { nodes = it; error = null; poll.success() } + .onFailure { poll.failure(it, hasData = nodes != null)?.let { msg -> error = msg } } + } + val loaded = nodes + if (loaded == null) { + if (error != null) ErrorBanner(error!!) else Column(Modifier.fillMaxSize()) {} + } else if (loaded.isEmpty()) { + EmptyBox("No nodes connected") + } else { + LazyColumn(Modifier.fillMaxSize()) { + item { + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + } + items(loaded, key = { it.id }) { node -> NodeCard(repo, node) { e -> error = e } } + } + } +} + +@Composable +private fun NodeCard(repo: TraferoRepo, node: NodeInfo, onError: (String) -> Unit) { + val scope = rememberCoroutineScope() + var busy by remember { mutableStateOf(false) } + Card(Modifier.fillMaxWidth().padding(8.dp)) { + Column(Modifier.padding(14.dp)) { + Row(verticalAlignment = Alignment.CenterVertically) { + Column(Modifier.weight(1f)) { + Text(node.name.ifBlank { node.id }, fontWeight = FontWeight.SemiBold, + style = MaterialTheme.typography.titleMedium) + Text(node.remoteAddress, style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant) + } + Text("Paused", style = MaterialTheme.typography.labelMedium, + color = if (node.isPaused) MaterialTheme.colorScheme.error else MaterialTheme.colorScheme.outline) + Switch(checked = node.isPaused, enabled = !busy, onCheckedChange = { paused -> + busy = true + scope.launch { + runCatching { repo.pauseNode(node.id, paused) } + .onFailure { onError(TraferoRepo.describeError(it)) } + busy = false + } + }) + } + Spacer(Modifier.height(8.dp)) + Text("Queued: " + node.queueLengths.entries.joinToString { it.key + ": " + it.value }, + style = MaterialTheme.typography.bodySmall) + Spacer(Modifier.height(4.dp)) + node.workerLimits.forEach { (type, limit) -> + Row(verticalAlignment = Alignment.CenterVertically) { + Text(type, style = MaterialTheme.typography.bodyMedium, modifier = Modifier.weight(1f)) + IconButton(enabled = !busy, onClick = { + busy = true; scope.launch { + runCatching { repo.alterWorkerLimit(node.id, false, type) } + .onFailure { onError(TraferoRepo.describeError(it)) } + busy = false + } + }) { Icon(Icons.Default.Remove, contentDescription = "decrease") } + Text(limit.toString(), fontWeight = FontWeight.Bold) + IconButton(enabled = !busy, onClick = { + busy = true; scope.launch { + runCatching { repo.alterWorkerLimit(node.id, true, type) } + .onFailure { onError(TraferoRepo.describeError(it)) } + busy = false + } + }) { Icon(Icons.Default.Add, contentDescription = "increase") } + } + } + val active = node.workers.filter { !it.idle } + if (active.isNotEmpty()) { + Spacer(Modifier.height(8.dp)) + Text("Workers (" + active.size + ")", style = MaterialTheme.typography.titleSmall, + color = MaterialTheme.colorScheme.primary) + active.forEach { w -> + Row(verticalAlignment = Alignment.CenterVertically) { + Text(Fmt.fileName(w.file.ifBlank { w.id }), maxLines = 1, + overflow = TextOverflow.Ellipsis, + style = MaterialTheme.typography.bodySmall, modifier = Modifier.weight(1f)) + if (w.percentage > 0) Text(w.percentage.toString() + "% ", + style = MaterialTheme.typography.bodySmall) + IconButton(onClick = { + scope.launch { + runCatching { repo.killWorker(node.id, w.id) } + .onFailure { onError(TraferoRepo.describeError(it)) } + } + }) { Icon(Icons.Default.Close, contentDescription = "kill worker") } + } + } + } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/onboarding/Onboarding.kt b/app/src/main/java/com/trafero/app/ui/screens/onboarding/Onboarding.kt new file mode 100644 index 0000000..7d5615f --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/onboarding/Onboarding.kt @@ -0,0 +1,42 @@ +package com.trafero.app.ui.screens.onboarding + +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import com.trafero.app.data.model.ServerProfile +import com.trafero.app.di.AppContainer +import com.trafero.app.ui.screens.settings.ServerEditorForm + +@Composable +fun OnboardingScreen( + container: AppContainer, + existing: ServerProfile?, + onSaved: (() -> Unit)? +) { + Column(Modifier.fillMaxSize()) { + Column(Modifier.padding(20.dp)) { + Spacer(Modifier.height(32.dp)) + Text("Welcome to Trafero", style = MaterialTheme.typography.headlineMedium) + Spacer(Modifier.height(4.dp)) + Text( + "A companion app for your Tdarr server. Connect over your local network or VPN.", + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + ServerEditorForm( + container = container, + existing = existing, + onDone = { onSaved?.invoke() }, + modifier = Modifier.align(Alignment.CenterHorizontally) + ) + } +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/settings/ServerEditor.kt b/app/src/main/java/com/trafero/app/ui/screens/settings/ServerEditor.kt new file mode 100644 index 0000000..9dd5073 --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/settings/ServerEditor.kt @@ -0,0 +1,212 @@ +package com.trafero.app.ui.screens.settings + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.rememberScrollState +import androidx.compose.foundation.verticalScroll +import androidx.compose.material3.Button +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedTextField +import androidx.compose.material3.SegmentedButton +import androidx.compose.material3.SegmentedButtonDefaults +import androidx.compose.material3.SingleChoiceSegmentedButtonRow +import androidx.compose.material3.Switch +import androidx.compose.material3.Text +import androidx.compose.material3.TextButton +import androidx.compose.runtime.Composable +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.rememberCoroutineScope +import androidx.compose.runtime.setValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.input.PasswordVisualTransformation +import androidx.compose.ui.unit.dp +import com.trafero.app.data.api.TdarrClient +import com.trafero.app.data.api.TraferoApiException +import com.trafero.app.data.model.AuthMode +import com.trafero.app.data.model.ServerProfile +import com.trafero.app.di.AppContainer +import com.trafero.app.util.UrlUtil +import java.util.UUID +import kotlinx.coroutines.launch + +@Composable +fun ServerEditorForm( + container: AppContainer, + existing: ServerProfile?, + onDone: () -> Unit, + modifier: Modifier = Modifier +) { + val scope = rememberCoroutineScope() + var label by remember { mutableStateOf(existing?.label ?: "My Tdarr") } + var url by remember { mutableStateOf(existing?.baseUrl ?: "") } + var authMode by remember { mutableStateOf(existing?.authMode ?: AuthMode.NONE) } + var apiKey by remember { mutableStateOf(existing?.apiKey ?: "") } + var username by remember { mutableStateOf(existing?.username ?: "") } + var password by remember { mutableStateOf(existing?.password ?: "") } + var insecure by remember { mutableStateOf(existing?.allowInsecureTls ?: false) } + var timeoutSec by remember { mutableStateOf((existing?.timeoutSeconds ?: 20).toString()) } + var slow by remember { mutableStateOf(existing?.slowConnection ?: false) } + var statusMsg by remember { mutableStateOf(null) } + var statusOk by remember { mutableStateOf(false) } + var busy by remember { mutableStateOf(false) } + + fun candidate(token: String = existing?.token ?: ""): ServerProfile? { + val base = UrlUtil.normalizeBase(url) ?: return null + return ServerProfile( + id = existing?.id ?: UUID.randomUUID().toString(), + label = label.ifBlank { "Tdarr" }, + baseUrl = base, + authMode = authMode, + apiKey = apiKey.trim(), + username = username.trim(), + password = password, + token = token, + allowInsecureTls = insecure, + timeoutSeconds = timeoutSec.toIntOrNull()?.coerceIn(5, 120) ?: 20, + slowConnection = slow + ) + } + + fun testAndSave(save: Boolean) { + val profile = candidate() + if (profile == null) { + statusOk = false + statusMsg = "Invalid server address" + return + } + busy = true + statusMsg = null + scope.launch { + val result = runCatching { + var finalProfile = profile + val probe = TdarrClient(profile) + try { + if (profile.authMode == AuthMode.USER_PASS) { + val token = com.trafero.app.data.repo.TraferoRepo(probe).login() + finalProfile = profile.copy(token = token) + } + } finally { + probe.close() + } + val probe2 = TdarrClient(finalProfile) + try { + val version = com.trafero.app.data.repo.TraferoRepo(probe2).status().version + finalProfile to version + } finally { + probe2.close() + } + } + busy = false + result.fold( + onSuccess = { (savedProfile, version) -> + statusOk = true + statusMsg = "Connected - Tdarr $version" + if (save) { + container.serverStore.upsert(savedProfile) + onDone() + } + }, + onFailure = { t -> + statusOk = false + statusMsg = when (t) { + is TraferoApiException -> when (t.kind) { + TraferoApiException.Kind.AUTH -> + "Connected but auth rejected - try API key or login (${t.message})" + else -> t.message ?: "Connection failed" + } + else -> t.message ?: "Connection failed" + } + } + ) + } + } + + Column( + modifier.fillMaxWidth().verticalScroll(rememberScrollState()).padding(16.dp), + verticalArrangement = Arrangement.spacedBy(12.dp) + ) { + OutlinedTextField(value = label, onValueChange = { label = it }, label = { Text("Server name") }, singleLine = true, modifier = Modifier.fillMaxWidth()) + OutlinedTextField( + value = url, onValueChange = { url = it }, + label = { Text("Server URL (e.g. http://192.168.1.10:8265)") }, + supportingText = { Text("Scheme and port optional - defaults to http and 8265") }, + singleLine = true, modifier = Modifier.fillMaxWidth() + ) + Text("Authentication", style = MaterialTheme.typography.titleSmall) + SingleChoiceSegmentedButtonRow(Modifier.fillMaxWidth()) { + AuthMode.entries.forEachIndexed { i, mode -> + SegmentedButton( + selected = authMode == mode, + onClick = { authMode = mode }, + shape = SegmentedButtonDefaults.itemShape(index = i, count = AuthMode.entries.size) + ) { Text(mode.label()) } + } + } + when (authMode) { + AuthMode.API_KEY -> OutlinedTextField(value = apiKey, onValueChange = { apiKey = it }, + label = { Text("API key (Tdarr CLI auth)") }, singleLine = true, modifier = Modifier.fillMaxWidth()) + AuthMode.USER_PASS -> { + OutlinedTextField(value = username, onValueChange = { username = it }, + label = { Text("Username") }, singleLine = true, modifier = Modifier.fillMaxWidth()) + OutlinedTextField(value = password, onValueChange = { password = it }, + label = { Text("Password") }, singleLine = true, + visualTransformation = PasswordVisualTransformation(), modifier = Modifier.fillMaxWidth()) + } + AuthMode.NONE -> Text( + "No credentials will be sent. Works when server auth is disabled.", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + Row(verticalAlignment = Alignment.CenterVertically) { + Switch(checked = insecure, onCheckedChange = { insecure = it }) + Spacer(Modifier.padding(4.dp)) + Text("Allow self-signed certificates") + } + OutlinedTextField( + value = timeoutSec, + onValueChange = { timeoutSec = it.filter { c -> c.isDigit() } }, + label = { Text("Timeout (seconds)") }, + supportingText = { Text("Connect timeout - read scales x4.5 (default 20 s / 90 s)") }, + singleLine = true, + keyboardOptions = androidx.compose.foundation.text.KeyboardOptions( + keyboardType = androidx.compose.ui.text.input.KeyboardType.Number + ), + modifier = Modifier.fillMaxWidth() + ) + Row(verticalAlignment = Alignment.CenterVertically) { + Switch(checked = slow, onCheckedChange = { slow = it }) + Spacer(Modifier.padding(4.dp)) + Text("Slow connection (VPN / repeater) - doubles all timeouts") + } + statusMsg?.let { + Text( + it, + style = MaterialTheme.typography.bodyMedium, + color = if (statusOk) MaterialTheme.colorScheme.primary else MaterialTheme.colorScheme.error + ) + } + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + Button(onClick = { testAndSave(false) }, enabled = !busy) { Text(if (busy) "Testing..." else "Test connection") } + Button(onClick = { testAndSave(true) }, enabled = !busy) { Text("Save") } + if (existing == null) { + TextButton(onClick = onDone) { Text("Cancel") } + } + } + Spacer(Modifier.height(24.dp)) + } +} + +fun AuthMode.label(): String = when (this) { + AuthMode.NONE -> "None" + AuthMode.API_KEY -> "API key" + AuthMode.USER_PASS -> "Login" +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/settings/SettingsScreen.kt b/app/src/main/java/com/trafero/app/ui/screens/settings/SettingsScreen.kt new file mode 100644 index 0000000..36db1cf --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/settings/SettingsScreen.kt @@ -0,0 +1,192 @@ +package com.trafero.app.ui.screens.settings + +import androidx.compose.foundation.clickable +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.rememberScrollState +import androidx.compose.foundation.verticalScroll +import androidx.compose.material3.AlertDialog +import androidx.compose.material3.Card +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedButton +import androidx.compose.material3.Switch +import androidx.compose.material3.Text +import androidx.compose.material3.TextButton +import androidx.compose.runtime.Composable +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.rememberCoroutineScope +import androidx.compose.runtime.setValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.text.style.TextOverflow +import androidx.compose.ui.unit.dp +import com.trafero.app.data.model.LibInfo +import com.trafero.app.data.model.ServerProfile +import com.trafero.app.data.repo.TraferoRepo +import com.trafero.app.di.AppContainer +import com.trafero.app.ui.LocalRepo +import com.trafero.app.ui.LocalServerCtx +import com.trafero.app.ui.common.ErrorBanner +import com.trafero.app.ui.common.ReconnectChip +import com.trafero.app.ui.common.SectionCard +import com.trafero.app.ui.common.pollLoop +import com.trafero.app.ui.common.rememberPollState +import kotlinx.coroutines.launch + +@Composable +fun SettingsScreen(container: AppContainer) { + val repo = LocalRepo.current + val ctx = LocalServerCtx.current + val scope = rememberCoroutineScope() + val book by container.serverStore.book.collectAsState(initial = com.trafero.app.data.store.ServerBook()) + var error by remember { mutableStateOf(null) } + var settings by remember { mutableStateOf(null) } + var libs by remember { mutableStateOf>(emptyList()) } + var editing by remember { mutableStateOf(null) } + var addingNew by remember { mutableStateOf(false) } + var confirmDelete by remember { mutableStateOf(null) } + + val poll = rememberPollState() + pollLoop(ctx.refreshMs, listOf("settings"), poll) { + if (repo != null) { + runCatching { repo.globalSettings() to repo.libraries() } + .onSuccess { (g, l) -> settings = g; libs = l; error = null; poll.success() } + .onFailure { poll.failure(it, hasData = settings != null)?.let { msg -> error = msg } } + } + } + + val st = editing + if (st != null || addingNew) { + Column(Modifier.fillMaxSize()) { + Text(if (st == null) "Add server" else "Edit server", + Modifier.padding(20.dp), style = MaterialTheme.typography.headlineSmall) + ServerEditorForm(container = container, existing = st, onDone = { editing = null; addingNew = false }) + } + return + } + + Column(Modifier.fillMaxSize().verticalScroll(rememberScrollState())) { + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + settings?.let { g -> + SectionCard("Processing") { + ToggleRow("Pause all nodes", g.pauseAllNodes) { v -> + scope.launch { runCatching { repo?.setGlobalSetting("pauseAllNodes", v) } + .onFailure { error = TraferoRepo.describeError(it) } } + } + ToggleRow("Ignore schedules", g.ignoreSchedules) { v -> + scope.launch { runCatching { repo?.setGlobalSetting("ignoreSchedules", v) } + .onFailure { error = TraferoRepo.describeError(it) } } + } + } + } + + if (libs.isNotEmpty()) { + SectionCard("Libraries") { + libs.forEach { lib -> + LibRow(lib, repo) { msg -> if (msg != null) error = msg } + } + } + } + + SectionCard("Servers") { + book.profiles.forEach { p -> + Card(Modifier.fillMaxWidth().padding(vertical = 4.dp)) { + Row(Modifier.padding(12.dp), verticalAlignment = Alignment.CenterVertically) { + Column(Modifier.weight(1f)) { + Text(p.label, fontWeight = FontWeight.SemiBold) + Text(p.baseUrl + " - " + p.authMode.name, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant) + } + if (p.id == book.activeId) { + Text("Active", style = MaterialTheme.typography.labelMedium, + color = MaterialTheme.colorScheme.primary) + } else { + TextButton(onClick = { scope.launch { container.serverStore.setActive(p.id) } }) { + Text("Use") + } + } + TextButton(onClick = { editing = p }) { Text("Edit") } + TextButton(onClick = { confirmDelete = p }) { Text("Delete") } + } + } + } + OutlinedButton(onClick = { addingNew = true }, modifier = Modifier.fillMaxWidth()) { + Text("Add server") + } + } + Spacer(Modifier.height(30.dp)) + } + + confirmDelete?.let { p -> + AlertDialog( + onDismissRequest = { confirmDelete = null }, + title = { Text("Delete server?") }, + text = { Text("Remove " + p.label + " from Trafero?") }, + confirmButton = { + TextButton(onClick = { + scope.launch { container.serverStore.remove(p.id) } + confirmDelete = null + }) { Text("Delete") } + }, + dismissButton = { TextButton(onClick = { confirmDelete = null }) { Text("Cancel") } } + ) + } +} + +@Composable +private fun ToggleRow(label: String, checked: Boolean, onChange: (Boolean) -> Unit) { + Row(Modifier.fillMaxWidth().padding(vertical = 4.dp), verticalAlignment = Alignment.CenterVertically) { + Text(label, Modifier.weight(1f)) + Switch(checked = checked, onCheckedChange = onChange) + } +} + +@Composable +private fun LibRow(lib: LibInfo, repo: TraferoRepo?, onResult: (String?) -> Unit) { + val scope = rememberCoroutineScope() + Column(Modifier.fillMaxWidth().padding(vertical = 8.dp)) { + Row(verticalAlignment = Alignment.CenterVertically) { + Column(Modifier.weight(1f)) { + Text(lib.name, fontWeight = FontWeight.SemiBold) + Text(lib.folder, maxLines = 1, overflow = TextOverflow.Ellipsis, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant) + } + Column(horizontalAlignment = Alignment.CenterHorizontally) { + Text("Watch", style = MaterialTheme.typography.labelSmall) + Switch(checked = lib.folderWatching, onCheckedChange = { on -> + scope.launch { + runCatching { repo?.toggleFolderWatch(lib.id, lib.folder, on) } + .onFailure { onResult(TraferoRepo.describeError(it)) } + } + }) + } + } + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + OutlinedButton(onClick = { + scope.launch { + runCatching { repo?.scanLibrary(lib.id, lib.folder, "scanFindNew") } + .onFailure { onResult(TraferoRepo.describeError(it)) } + } + }) { Text("Scan new") } + OutlinedButton(onClick = { + scope.launch { + runCatching { repo?.scanLibrary(lib.id, lib.folder, "scanFresh") } + .onFailure { onResult(TraferoRepo.describeError(it)) } + } + }) { Text("Full scan") } + } + } +} diff --git a/app/src/main/java/com/trafero/app/ui/screens/stats/StatsScreen.kt b/app/src/main/java/com/trafero/app/ui/screens/stats/StatsScreen.kt new file mode 100644 index 0000000..0f9f99f --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/screens/stats/StatsScreen.kt @@ -0,0 +1,104 @@ +package com.trafero.app.ui.screens.stats + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.size +import androidx.compose.foundation.rememberScrollState +import androidx.compose.foundation.verticalScroll +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.unit.dp +import com.trafero.app.data.model.PieStats +import com.trafero.app.data.model.ResStats +import com.trafero.app.data.model.ServerStatus +import com.trafero.app.data.repo.TraferoRepo +import com.trafero.app.ui.LocalRepo +import com.trafero.app.ui.LocalServerCtx +import com.trafero.app.ui.common.ChartPalette +import com.trafero.app.ui.common.DonutChart +import com.trafero.app.ui.common.ErrorBanner +import com.trafero.app.ui.common.Fmt +import com.trafero.app.ui.common.LegendRow +import com.trafero.app.ui.common.ReconnectChip +import com.trafero.app.ui.common.SectionCard +import com.trafero.app.ui.common.StatCard +import com.trafero.app.ui.common.pollLoop +import com.trafero.app.ui.common.rememberPollState + +@Composable +fun StatsScreen() { + val repo = LocalRepo.current ?: return + val ctx = LocalServerCtx.current + var status by remember { mutableStateOf(null) } + var pies by remember { mutableStateOf(null) } + var res by remember { mutableStateOf(null) } + var error by remember { mutableStateOf(null) } + val poll = rememberPollState() + pollLoop(ctx.refreshMs, listOf("stats"), poll) { + runCatching { + Triple(repo.status(), repo.pies(), repo.resStats()) + }.onSuccess { (s, p, r) -> status = s; pies = p; res = r; error = null; poll.success() } + .onFailure { poll.failure(it, hasData = status != null)?.let { msg -> error = msg } } + } + Column(Modifier.fillMaxSize().verticalScroll(rememberScrollState())) { + error?.let { ErrorBanner(it) } + if (poll.reconnecting) ReconnectChip() + status?.let { s -> + SectionCard("Server") { + Text("Tdarr " + s.version + " (" + s.serverEngine + ")", fontWeight = FontWeight.SemiBold) + Text("Build " + s.buildDate + " - " + s.os, style = MaterialTheme.typography.bodySmall) + Text("Uptime " + Fmt.duration(s.uptimeSeconds * 1000), style = MaterialTheme.typography.bodySmall) + } + } + res?.let { r -> + Row(Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.spacedBy(0.dp)) { + StatCard("CPU", String.format("%.0f%%", r.cpuPerc), Modifier.weight(1f)) + StatCard("Memory", String.format("%.1f / %.0f GB", r.memUsedGB, r.memTotalGB), Modifier.weight(1f)) + } + } + pies?.let { p -> + Row(Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.spacedBy(0.dp)) { + StatCard("Files", p.totalFiles.toString(), Modifier.weight(1f)) + StatCard("Space saved", String.format("%.1f GB", p.sizeDiffGB), Modifier.weight(1f)) + } + SectionCard("Transcode status") { + Row(verticalAlignment = Alignment.CenterVertically) { + DonutChart(p.transcodeStatus.map { it.name to it.value }, ChartPalette, + p.transcodeStatus.sumOf { it.value }.toString(), Modifier.size(150.dp)) + Column(Modifier.weight(1f).padding(start = 16.dp)) { + p.transcodeStatus.forEachIndexed { i, b -> + LegendRow(b.name, b.value, ChartPalette[i % ChartPalette.size]) + } + } + } + } + SectionCard("Health-check status") { + p.healthCheckStatus.forEachIndexed { i, b -> + LegendRow(b.name, b.value, ChartPalette[i % ChartPalette.size]) + } + } + if (p.videoCodecs.isNotEmpty()) { + SectionCard("Video codecs") { + p.videoCodecs.sortedByDescending { it.value }.take(8).forEachIndexed { i, b -> + LegendRow(b.name, b.value, ChartPalette[i % ChartPalette.size]) + } + } + } + } + Spacer(Modifier.height(24.dp)) + } +} diff --git a/app/src/main/java/com/trafero/app/ui/theme/Theme.kt b/app/src/main/java/com/trafero/app/ui/theme/Theme.kt new file mode 100644 index 0000000..ecc6b8e --- /dev/null +++ b/app/src/main/java/com/trafero/app/ui/theme/Theme.kt @@ -0,0 +1,29 @@ +package com.trafero.app.ui.theme + +import android.os.Build +import androidx.compose.foundation.isSystemInDarkTheme +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.darkColorScheme +import androidx.compose.material3.dynamicDarkColorScheme +import androidx.compose.material3.dynamicLightColorScheme +import androidx.compose.material3.lightColorScheme +import androidx.compose.runtime.Composable +import androidx.compose.ui.graphics.Color +import androidx.compose.ui.platform.LocalContext + +private val GreenSeed = Color(0xFF2E7D32) +private val LightScheme = lightColorScheme(primary = GreenSeed) +private val DarkScheme = darkColorScheme(primary = Color(0xFF81C784)) + +@Composable +fun TraferoTheme(content: @Composable () -> Unit) { + val context = LocalContext.current + val scheme = when { + Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> + if (isSystemInDarkTheme()) dynamicDarkColorScheme(context) + else dynamicLightColorScheme(context) + isSystemInDarkTheme() -> DarkScheme + else -> LightScheme + } + MaterialTheme(colorScheme = scheme, content = content) +} diff --git a/app/src/main/java/com/trafero/app/util/JsonUtil.kt b/app/src/main/java/com/trafero/app/util/JsonUtil.kt new file mode 100644 index 0000000..e6aa3a7 --- /dev/null +++ b/app/src/main/java/com/trafero/app/util/JsonUtil.kt @@ -0,0 +1,34 @@ +package com.trafero.app.util + +import kotlinx.serialization.json.Json +import kotlinx.serialization.json.JsonArray +import kotlinx.serialization.json.JsonElement +import kotlinx.serialization.json.JsonObject +import kotlinx.serialization.json.contentOrNull +import kotlinx.serialization.json.jsonPrimitive + +val TraferoJson = Json { + ignoreUnknownKeys = true + isLenient = true + encodeDefaults = false + explicitNulls = false +} + +fun JsonElement?.str(key: String, default: String = ""): String = + runCatching { (this as? JsonObject)?.get(key)?.jsonPrimitive?.contentOrNull }.getOrNull() ?: default + +fun JsonElement?.strOrNull(key: String): String? = + runCatching { (this as? JsonObject)?.get(key)?.jsonPrimitive?.contentOrNull }.getOrNull() + +fun JsonElement?.intOr(key: String, default: Int = 0): Int = + runCatching { (this as? JsonObject)?.get(key)?.jsonPrimitive?.content?.toIntOrNull() }.getOrNull() ?: default + +fun JsonElement?.dblOr(key: String, default: Double = 0.0): Double = + runCatching { (this as? JsonObject)?.get(key)?.jsonPrimitive?.content?.toDoubleOrNull() }.getOrNull() ?: default + +fun JsonElement?.boolOr(key: String, default: Boolean = false): Boolean = + runCatching { (this as? JsonObject)?.get(key)?.jsonPrimitive?.content?.toBooleanStrictOrNull() }.getOrNull() ?: default + +fun JsonElement?.obj(key: String): JsonObject? = (this as? JsonObject)?.get(key) as? JsonObject + +fun JsonElement?.arr(key: String): JsonArray = (this as? JsonObject)?.get(key) as? JsonArray ?: JsonArray(emptyList()) diff --git a/app/src/main/java/com/trafero/app/util/UrlUtil.kt b/app/src/main/java/com/trafero/app/util/UrlUtil.kt new file mode 100644 index 0000000..d75f651 --- /dev/null +++ b/app/src/main/java/com/trafero/app/util/UrlUtil.kt @@ -0,0 +1,25 @@ +package com.trafero.app.util + +/** Normalizes whatever the user typed into a valid Tdarr server base URL. */ +object UrlUtil { + fun normalizeBase(raw: String, defaultPort: Int = 8265): String? { + var s = raw.trim() + if (s.isEmpty()) return null + var scheme = "http" + if (s.startsWith("https://", true)) { scheme = "https"; s = s.substring(8) } + else if (s.startsWith("http://", true)) { s = s.substring(7) } + s = s.substringBefore('#').substringBefore('?').trimEnd('/') + if (s.isEmpty()) return null + s = s.removeSuffix("/api/v2").removeSuffix("/api") + val lastColon = s.lastIndexOf(':') + val lastSlash = s.lastIndexOf('/') + val hostPart: String + val port: String? + if (lastColon > lastSlash) { + hostPart = s.substring(0, lastColon) + port = s.substring(lastColon + 1).takeIf { it.isNotEmpty() && it.all(Char::isDigit) } + } else { hostPart = s; port = null } + if (hostPart.isEmpty()) return null + return "$scheme://$hostPart:${port ?: defaultPort}" + } +} diff --git a/app/src/main/res/drawable/ic_launcher_background.xml b/app/src/main/res/drawable/ic_launcher_background.xml new file mode 100644 index 0000000..2c3cf8b --- /dev/null +++ b/app/src/main/res/drawable/ic_launcher_background.xml @@ -0,0 +1,6 @@ + + + + diff --git a/app/src/main/res/drawable/ic_launcher_foreground.xml b/app/src/main/res/drawable/ic_launcher_foreground.xml new file mode 100644 index 0000000..4b6d2f8 --- /dev/null +++ b/app/src/main/res/drawable/ic_launcher_foreground.xml @@ -0,0 +1,11 @@ + + + + + + diff --git a/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml new file mode 100644 index 0000000..b3e26b4 --- /dev/null +++ b/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml @@ -0,0 +1,6 @@ + + + + + + diff --git a/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml new file mode 100644 index 0000000..b3e26b4 --- /dev/null +++ b/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml @@ -0,0 +1,6 @@ + + + + + + diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml new file mode 100644 index 0000000..e12c9f8 --- /dev/null +++ b/app/src/main/res/values/strings.xml @@ -0,0 +1,4 @@ + + + Trafero + diff --git a/build.gradle.kts b/build.gradle.kts new file mode 100644 index 0000000..fd4a335 --- /dev/null +++ b/build.gradle.kts @@ -0,0 +1,6 @@ +plugins { + alias(libs.plugins.androidApplication) apply false + alias(libs.plugins.kotlinAndroid) apply false + alias(libs.plugins.kotlinCompose) apply false + alias(libs.plugins.kotlinSerialization) apply false +} diff --git a/gradle.properties b/gradle.properties new file mode 100644 index 0000000..c3baee4 --- /dev/null +++ b/gradle.properties @@ -0,0 +1,7 @@ +org.gradle.jvmargs=-Xmx4g -Dfile.encoding=UTF-8 -XX:+UseParallelGC +org.gradle.parallel=true +org.gradle.caching=true +android.useAndroidX=true +android.nonTransitiveRClass=true +kotlin.code.style=official +kotlin.incremental=true diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml new file mode 100644 index 0000000..0e3458f --- /dev/null +++ b/gradle/libs.versions.toml @@ -0,0 +1,39 @@ +[versions] +agp = "8.7.2" +kotlin = "2.0.21" +gradleWrapper = "8.10.2" +androidxActivityCompose = "1.9.3" +androidxLifecycle = "2.8.7" +androidxNavigationCompose = "2.8.4" +composeBom = "2024.10.01" +androidxDatastore = "1.1.1" +coroutines = "1.9.0" +kotlinxSerialization = "1.7.3" +okhttp = "4.12.0" +coreKtx = "1.13.1" +splashscreen = "1.0.1" + +[libraries] +composeBom = { module = "androidx.compose:compose-bom", version.ref = "composeBom" } +androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "androidxActivityCompose" } +androidx-core-ktx = { module = "androidx.core:core-ktx", version.ref = "coreKtx" } +androidx-lifecycle-runtime-compose = { module = "androidx.lifecycle:lifecycle-runtime-compose", version.ref = "androidxLifecycle" } +androidx-lifecycle-runtime-ktx = { module = "androidx.lifecycle:lifecycle-runtime-ktx", version.ref = "androidxLifecycle" } +androidx-lifecycle-viewmodel-compose = { module = "androidx.lifecycle:lifecycle-viewmodel-compose", version.ref = "androidxLifecycle" } +androidx-navigation-compose = { module = "androidx.navigation:navigation-compose", version.ref = "androidxNavigationCompose" } +androidx-datastore-preferences = { module = "androidx.datastore:datastore-preferences", version.ref = "androidxDatastore" } +compose-ui = { module = "androidx.compose.ui:ui" } +compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" } +compose-ui-tooling-preview = { module = "androidx.compose.ui:ui-tooling-preview" } +compose-material3 = { module = "androidx.compose.material3:material3" } +compose-material-icons-extended = { module = "androidx.compose.material:material-icons-extended" } +kotlinx-serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "kotlinxSerialization" } +kotlinx-coroutines-android = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-android", version.ref = "coroutines" } +okhttp = { module = "com.squareup.okhttp3:okhttp", version.ref = "okhttp" } +androidx-splashscreen = { module = "androidx.core:core-splashscreen", version.ref = "splashscreen" } + +[plugins] +androidApplication = { id = "com.android.application", version.ref = "agp" } +kotlinAndroid = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" } +kotlinCompose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" } +kotlinSerialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" } diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..a4b76b9530d66f5e68d973ea569d8e19de379189 GIT binary patch literal 43583 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 yu?e%!_ptzGB|8GrCfu%p?(_ zQccdaaVK$5bz;*rnyK{_SQYM>;aES6Qs^lj9lEs6_J+%nIiuQC*fN;z8md>r_~Mfl zU%p5Dt_YT>gQqfr@`cR!$NWr~+`CZb%dn;WtzrAOI>P_JtsB76PYe*<%H(y>qx-`Kq!X_; z<{RpAqYhE=L1r*M)gNF3B8r(<%8mo*SR2hu zccLRZwGARt)Hlo1euqTyM>^!HK*!Q2P;4UYrysje@;(<|$&%vQekbn|0Ruu_Io(w4#%p6ld2Yp7tlA`Y$cciThP zKzNGIMPXX%&Ud0uQh!uQZz|FB`4KGD?3!ND?wQt6!n*f4EmCoJUh&b?;B{|lxs#F- z31~HQ`SF4x$&v00@(P+j1pAaj5!s`)b2RDBp*PB=2IB>oBF!*6vwr7Dp%zpAx*dPr zb@Zjq^XjN?O4QcZ*O+8>)|HlrR>oD*?WQl5ri3R#2?*W6iJ>>kH%KnnME&TT@ZzrHS$Q%LC?n|e>V+D+8D zYc4)QddFz7I8#}y#Wj6>4P%34dZH~OUDb?uP%-E zwjXM(?Sg~1!|wI(RVuxbu)-rH+O=igSho_pDCw(c6b=P zKk4ATlB?bj9+HHlh<_!&z0rx13K3ZrAR8W)!@Y}o`?a*JJsD+twZIv`W)@Y?Amu_u zz``@-e2X}27$i(2=9rvIu5uTUOVhzwu%mNazS|lZb&PT;XE2|B&W1>=B58#*!~D&) zfVmJGg8UdP*fx(>Cj^?yS^zH#o-$Q-*$SnK(ZVFkw+er=>N^7!)FtP3y~Xxnu^nzY zikgB>Nj0%;WOltWIob|}%lo?_C7<``a5hEkx&1ku$|)i>Rh6@3h*`slY=9U}(Ql_< zaNG*J8vb&@zpdhAvv`?{=zDedJ23TD&Zg__snRAH4eh~^oawdYi6A3w8<Ozh@Kw)#bdktM^GVb zrG08?0bG?|NG+w^&JvD*7LAbjED{_Zkc`3H!My>0u5Q}m!+6VokMLXxl`Mkd=g&Xx z-a>m*#G3SLlhbKB!)tnzfWOBV;u;ftU}S!NdD5+YtOjLg?X}dl>7m^gOpihrf1;PY zvll&>dIuUGs{Qnd- zwIR3oIrct8Va^Tm0t#(bJD7c$Z7DO9*7NnRZorrSm`b`cxz>OIC;jSE3DO8`hX955ui`s%||YQtt2 z5DNA&pG-V+4oI2s*x^>-$6J?p=I>C|9wZF8z;VjR??Icg?1w2v5Me+FgAeGGa8(3S z4vg*$>zC-WIVZtJ7}o9{D-7d>zCe|z#<9>CFve-OPAYsneTb^JH!Enaza#j}^mXy1 z+ULn^10+rWLF6j2>Ya@@Kq?26>AqK{A_| zQKb*~F1>sE*=d?A?W7N2j?L09_7n+HGi{VY;MoTGr_)G9)ot$p!-UY5zZ2Xtbm=t z@dpPSGwgH=QtIcEulQNI>S-#ifbnO5EWkI;$A|pxJd885oM+ zGZ0_0gDvG8q2xebj+fbCHYfAXuZStH2j~|d^sBAzo46(K8n59+T6rzBwK)^rfPT+B zyIFw)9YC-V^rhtK`!3jrhmW-sTmM+tPH+;nwjL#-SjQPUZ53L@A>y*rt(#M(qsiB2 zx6B)dI}6Wlsw%bJ8h|(lhkJVogQZA&n{?Vgs6gNSXzuZpEyu*xySy8ro07QZ7Vk1!3tJphN_5V7qOiyK8p z#@jcDD8nmtYi1^l8ml;AF<#IPK?!pqf9D4moYk>d99Im}Jtwj6c#+A;f)CQ*f-hZ< z=p_T86jog%!p)D&5g9taSwYi&eP z#JuEK%+NULWus;0w32-SYFku#i}d~+{Pkho&^{;RxzP&0!RCm3-9K6`>KZpnzS6?L z^H^V*s!8<>x8bomvD%rh>Zp3>Db%kyin;qtl+jAv8Oo~1g~mqGAC&Qi_wy|xEt2iz zWAJEfTV%cl2Cs<1L&DLRVVH05EDq`pH7Oh7sR`NNkL%wi}8n>IXcO40hp+J+sC!W?!krJf!GJNE8uj zg-y~Ns-<~D?yqbzVRB}G>0A^f0!^N7l=$m0OdZuqAOQqLc zX?AEGr1Ht+inZ-Qiwnl@Z0qukd__a!C*CKuGdy5#nD7VUBM^6OCpxCa2A(X;e0&V4 zM&WR8+wErQ7UIc6LY~Q9x%Sn*Tn>>P`^t&idaOEnOd(Ufw#>NoR^1QdhJ8s`h^|R_ zXX`c5*O~Xdvh%q;7L!_!ohf$NfEBmCde|#uVZvEo>OfEq%+Ns7&_f$OR9xsihRpBb z+cjk8LyDm@U{YN>+r46?nn{7Gh(;WhFw6GAxtcKD+YWV?uge>;+q#Xx4!GpRkVZYu zzsF}1)7$?%s9g9CH=Zs+B%M_)+~*j3L0&Q9u7!|+T`^O{xE6qvAP?XWv9_MrZKdo& z%IyU)$Q95AB4!#hT!_dA>4e@zjOBD*Y=XjtMm)V|+IXzjuM;(l+8aA5#Kaz_$rR6! zj>#&^DidYD$nUY(D$mH`9eb|dtV0b{S>H6FBfq>t5`;OxA4Nn{J(+XihF(stSche7$es&~N$epi&PDM_N`As;*9D^L==2Q7Z2zD+CiU(|+-kL*VG+&9!Yb3LgPy?A zm7Z&^qRG_JIxK7-FBzZI3Q<;{`DIxtc48k> zc|0dmX;Z=W$+)qE)~`yn6MdoJ4co;%!`ddy+FV538Y)j(vg}5*k(WK)KWZ3WaOG!8 z!syGn=s{H$odtpqFrT#JGM*utN7B((abXnpDM6w56nhw}OY}0TiTG1#f*VFZr+^-g zbP10`$LPq_;PvrA1XXlyx2uM^mrjTzX}w{yuLo-cOClE8MMk47T25G8M!9Z5ypOSV zAJUBGEg5L2fY)ZGJb^E34R2zJ?}Vf>{~gB!8=5Z) z9y$>5c)=;o0HeHHSuE4U)#vG&KF|I%-cF6f$~pdYJWk_dD}iOA>iA$O$+4%@>JU08 zS`ep)$XLPJ+n0_i@PkF#ri6T8?ZeAot$6JIYHm&P6EB=BiaNY|aA$W0I+nz*zkz_z zkEru!tj!QUffq%)8y0y`T&`fuus-1p>=^hnBiBqD^hXrPs`PY9tU3m0np~rISY09> z`P3s=-kt_cYcxWd{de@}TwSqg*xVhp;E9zCsnXo6z z?f&Sv^U7n4`xr=mXle94HzOdN!2kB~4=%)u&N!+2;z6UYKUDqi-s6AZ!haB;@&B`? z_TRX0%@suz^TRdCb?!vNJYPY8L_}&07uySH9%W^Tc&1pia6y1q#?*Drf}GjGbPjBS zbOPcUY#*$3sL2x4v_i*Y=N7E$mR}J%|GUI(>WEr+28+V z%v5{#e!UF*6~G&%;l*q*$V?&r$Pp^sE^i-0$+RH3ERUUdQ0>rAq2(2QAbG}$y{de( z>{qD~GGuOk559Y@%$?N^1ApVL_a704>8OD%8Y%8B;FCt%AoPu8*D1 zLB5X>b}Syz81pn;xnB}%0FnwazlWfUV)Z-~rZg6~b z6!9J$EcE&sEbzcy?CI~=boWA&eeIa%z(7SE^qgVLz??1Vbc1*aRvc%Mri)AJaAG!p z$X!_9Ds;Zz)f+;%s&dRcJt2==P{^j3bf0M=nJd&xwUGlUFn?H=2W(*2I2Gdu zv!gYCwM10aeus)`RIZSrCK=&oKaO_Ry~D1B5!y0R=%!i2*KfXGYX&gNv_u+n9wiR5 z*e$Zjju&ODRW3phN925%S(jL+bCHv6rZtc?!*`1TyYXT6%Ju=|X;6D@lq$8T zW{Y|e39ioPez(pBH%k)HzFITXHvnD6hw^lIoUMA;qAJ^CU?top1fo@s7xT13Fvn1H z6JWa-6+FJF#x>~+A;D~;VDs26>^oH0EI`IYT2iagy23?nyJ==i{g4%HrAf1-*v zK1)~@&(KkwR7TL}L(A@C_S0G;-GMDy=MJn2$FP5s<%wC)4jC5PXoxrQBFZ_k0P{{s@sz+gX`-!=T8rcB(=7vW}^K6oLWMmp(rwDh}b zwaGGd>yEy6fHv%jM$yJXo5oMAQ>c9j`**}F?MCry;T@47@r?&sKHgVe$MCqk#Z_3S z1GZI~nOEN*P~+UaFGnj{{Jo@16`(qVNtbU>O0Hf57-P>x8Jikp=`s8xWs^dAJ9lCQ z)GFm+=OV%AMVqVATtN@|vp61VVAHRn87}%PC^RAzJ%JngmZTasWBAWsoAqBU+8L8u z4A&Pe?fmTm0?mK-BL9t+{y7o(7jm+RpOhL9KnY#E&qu^}B6=K_dB}*VlSEiC9fn)+V=J;OnN)Ta5v66ic1rG+dGAJ1 z1%Zb_+!$=tQ~lxQrzv3x#CPb?CekEkA}0MYSgx$Jdd}q8+R=ma$|&1a#)TQ=l$1tQ z=tL9&_^vJ)Pk}EDO-va`UCT1m#Uty1{v^A3P~83_#v^ozH}6*9mIjIr;t3Uv%@VeW zGL6(CwCUp)Jq%G0bIG%?{_*Y#5IHf*5M@wPo6A{$Um++Co$wLC=J1aoG93&T7Ho}P z=mGEPP7GbvoG!uD$k(H3A$Z))+i{Hy?QHdk>3xSBXR0j!11O^mEe9RHmw!pvzv?Ua~2_l2Yh~_!s1qS`|0~0)YsbHSz8!mG)WiJE| z2f($6TQtt6L_f~ApQYQKSb=`053LgrQq7G@98#igV>y#i==-nEjQ!XNu9 z~;mE+gtj4IDDNQJ~JVk5Ux6&LCSFL!y=>79kE9=V}J7tD==Ga+IW zX)r7>VZ9dY=V&}DR))xUoV!u(Z|%3ciQi_2jl}3=$Agc(`RPb z8kEBpvY>1FGQ9W$n>Cq=DIpski};nE)`p3IUw1Oz0|wxll^)4dq3;CCY@RyJgFgc# zKouFh!`?Xuo{IMz^xi-h=StCis_M7yq$u) z?XHvw*HP0VgR+KR6wI)jEMX|ssqYvSf*_3W8zVTQzD?3>H!#>InzpSO)@SC8q*ii- z%%h}_#0{4JG;Jm`4zg};BPTGkYamx$Xo#O~lBirRY)q=5M45n{GCfV7h9qwyu1NxOMoP4)jjZMxmT|IQQh0U7C$EbnMN<3)Kk?fFHYq$d|ICu>KbY_hO zTZM+uKHe(cIZfEqyzyYSUBZa8;Fcut-GN!HSA9ius`ltNebF46ZX_BbZNU}}ZOm{M2&nANL9@0qvih15(|`S~z}m&h!u4x~(%MAO$jHRWNfuxWF#B)E&g3ghSQ9|> z(MFaLQj)NE0lowyjvg8z0#m6FIuKE9lDO~Glg}nSb7`~^&#(Lw{}GVOS>U)m8bF}x zVjbXljBm34Cs-yM6TVusr+3kYFjr28STT3g056y3cH5Tmge~ASxBj z%|yb>$eF;WgrcOZf569sDZOVwoo%8>XO>XQOX1OyN9I-SQgrm;U;+#3OI(zrWyow3 zk==|{lt2xrQ%FIXOTejR>;wv(Pb8u8}BUpx?yd(Abh6? zsoO3VYWkeLnF43&@*#MQ9-i-d0t*xN-UEyNKeyNMHw|A(k(_6QKO=nKMCxD(W(Yop zsRQ)QeL4X3Lxp^L%wzi2-WVSsf61dqliPUM7srDB?Wm6Lzn0&{*}|IsKQW;02(Y&| zaTKv|`U(pSzuvR6Rduu$wzK_W-Y-7>7s?G$)U}&uK;<>vU}^^ns@Z!p+9?St1s)dG zK%y6xkPyyS1$~&6v{kl?Md6gwM|>mt6Upm>oa8RLD^8T{0?HC!Z>;(Bob7el(DV6x zi`I)$&E&ngwFS@bi4^xFLAn`=fzTC;aimE^!cMI2n@Vo%Ae-ne`RF((&5y6xsjjAZ zVguVoQ?Z9uk$2ON;ersE%PU*xGO@T*;j1BO5#TuZKEf(mB7|g7pcEA=nYJ{s3vlbg zd4-DUlD{*6o%Gc^N!Nptgay>j6E5;3psI+C3Q!1ZIbeCubW%w4pq9)MSDyB{HLm|k zxv-{$$A*pS@csolri$Ge<4VZ}e~78JOL-EVyrbxKra^d{?|NnPp86!q>t<&IP07?Z z^>~IK^k#OEKgRH+LjllZXk7iA>2cfH6+(e&9ku5poo~6y{GC5>(bRK7hwjiurqAiZ zg*DmtgY}v83IjE&AbiWgMyFbaRUPZ{lYiz$U^&Zt2YjG<%m((&_JUbZcfJ22(>bi5 z!J?<7AySj0JZ&<-qXX;mcV!f~>G=sB0KnjWca4}vrtunD^1TrpfeS^4dvFr!65knK zZh`d;*VOkPs4*-9kL>$GP0`(M!j~B;#x?Ba~&s6CopvO86oM?-? zOw#dIRc;6A6T?B`Qp%^<U5 z19x(ywSH$_N+Io!6;e?`tWaM$`=Db!gzx|lQ${DG!zb1Zl&|{kX0y6xvO1o z220r<-oaS^^R2pEyY;=Qllqpmue|5yI~D|iI!IGt@iod{Opz@*ml^w2bNs)p`M(Io z|E;;m*Xpjd9l)4G#KaWfV(t8YUn@A;nK^#xgv=LtnArX|vWQVuw3}B${h+frU2>9^ z!l6)!Uo4`5k`<<;E(ido7M6lKTgWezNLq>U*=uz&s=cc$1%>VrAeOoUtA|T6gO4>UNqsdK=NF*8|~*sl&wI=x9-EGiq*aqV!(VVXA57 zw9*o6Ir8Lj1npUXvlevtn(_+^X5rzdR>#(}4YcB9O50q97%rW2me5_L=%ffYPUSRc z!vv?Kv>dH994Qi>U(a<0KF6NH5b16enCp+mw^Hb3Xs1^tThFpz!3QuN#}KBbww`(h z7GO)1olDqy6?T$()R7y%NYx*B0k_2IBiZ14&8|JPFxeMF{vW>HF-Vi3+ZOI=+qP}n zw(+!WcTd~4ZJX1!ZM&y!+uyt=&i!+~d(V%GjH;-NsEEv6nS1TERt|RHh!0>W4+4pp z1-*EzAM~i`+1f(VEHI8So`S`akPfPTfq*`l{Fz`hS%k#JS0cjT2mS0#QLGf=J?1`he3W*;m4)ce8*WFq1sdP=~$5RlH1EdWm|~dCvKOi4*I_96{^95p#B<(n!d?B z=o`0{t+&OMwKcxiBECznJcfH!fL(z3OvmxP#oWd48|mMjpE||zdiTBdWelj8&Qosv zZFp@&UgXuvJw5y=q6*28AtxZzo-UUpkRW%ne+Ylf!V-0+uQXBW=5S1o#6LXNtY5!I z%Rkz#(S8Pjz*P7bqB6L|M#Er{|QLae-Y{KA>`^} z@lPjeX>90X|34S-7}ZVXe{wEei1<{*e8T-Nbj8JmD4iwcE+Hg_zhkPVm#=@b$;)h6 z<<6y`nPa`f3I6`!28d@kdM{uJOgM%`EvlQ5B2bL)Sl=|y@YB3KeOzz=9cUW3clPAU z^sYc}xf9{4Oj?L5MOlYxR{+>w=vJjvbyO5}ptT(o6dR|ygO$)nVCvNGnq(6;bHlBd zl?w-|plD8spjDF03g5ip;W3Z z><0{BCq!Dw;h5~#1BuQilq*TwEu)qy50@+BE4bX28+7erX{BD4H)N+7U`AVEuREE8 z;X?~fyhF-x_sRfHIj~6f(+^@H)D=ngP;mwJjxhQUbUdzk8f94Ab%59-eRIq?ZKrwD z(BFI=)xrUlgu(b|hAysqK<}8bslmNNeD=#JW*}^~Nrswn^xw*nL@Tx!49bfJecV&KC2G4q5a!NSv)06A_5N3Y?veAz;Gv+@U3R% z)~UA8-0LvVE{}8LVDOHzp~2twReqf}ODIyXMM6=W>kL|OHcx9P%+aJGYi_Om)b!xe zF40Vntn0+VP>o<$AtP&JANjXBn7$}C@{+@3I@cqlwR2MdwGhVPxlTIcRVu@Ho-wO` z_~Or~IMG)A_`6-p)KPS@cT9mu9RGA>dVh5wY$NM9-^c@N=hcNaw4ITjm;iWSP^ZX| z)_XpaI61<+La+U&&%2a z0za$)-wZP@mwSELo#3!PGTt$uy0C(nTT@9NX*r3Ctw6J~7A(m#8fE)0RBd`TdKfAT zCf@$MAxjP`O(u9s@c0Fd@|}UQ6qp)O5Q5DPCeE6mSIh|Rj{$cAVIWsA=xPKVKxdhg zLzPZ`3CS+KIO;T}0Ip!fAUaNU>++ZJZRk@I(h<)RsJUhZ&Ru9*!4Ptn;gX^~4E8W^TSR&~3BAZc#HquXn)OW|TJ`CTahk+{qe`5+ixON^zA9IFd8)kc%*!AiLu z>`SFoZ5bW-%7}xZ>gpJcx_hpF$2l+533{gW{a7ce^B9sIdmLrI0)4yivZ^(Vh@-1q zFT!NQK$Iz^xu%|EOK=n>ug;(7J4OnS$;yWmq>A;hsD_0oAbLYhW^1Vdt9>;(JIYjf zdb+&f&D4@4AS?!*XpH>8egQvSVX`36jMd>$+RgI|pEg))^djhGSo&#lhS~9%NuWfX zDDH;3T*GzRT@5=7ibO>N-6_XPBYxno@mD_3I#rDD?iADxX`! zh*v8^i*JEMzyN#bGEBz7;UYXki*Xr(9xXax(_1qVW=Ml)kSuvK$coq2A(5ZGhs_pF z$*w}FbN6+QDseuB9=fdp_MTs)nQf!2SlROQ!gBJBCXD&@-VurqHj0wm@LWX-TDmS= z71M__vAok|@!qgi#H&H%Vg-((ZfxPAL8AI{x|VV!9)ZE}_l>iWk8UPTGHs*?u7RfP z5MC&=c6X;XlUzrz5q?(!eO@~* zoh2I*%J7dF!!_!vXoSIn5o|wj1#_>K*&CIn{qSaRc&iFVxt*^20ngCL;QonIS>I5^ zMw8HXm>W0PGd*}Ko)f|~dDd%;Wu_RWI_d;&2g6R3S63Uzjd7dn%Svu-OKpx*o|N>F zZg=-~qLb~VRLpv`k zWSdfHh@?dp=s_X`{yxOlxE$4iuyS;Z-x!*E6eqmEm*j2bE@=ZI0YZ5%Yj29!5+J$4h{s($nakA`xgbO8w zi=*r}PWz#lTL_DSAu1?f%-2OjD}NHXp4pXOsCW;DS@BC3h-q4_l`<))8WgzkdXg3! zs1WMt32kS2E#L0p_|x+x**TFV=gn`m9BWlzF{b%6j-odf4{7a4y4Uaef@YaeuPhU8 zHBvRqN^;$Jizy+ z=zW{E5<>2gp$pH{M@S*!sJVQU)b*J5*bX4h>5VJve#Q6ga}cQ&iL#=(u+KroWrxa%8&~p{WEUF0il=db;-$=A;&9M{Rq`ouZ5m%BHT6%st%saGsD6)fQgLN}x@d3q>FC;=f%O3Cyg=Ke@Gh`XW za@RajqOE9UB6eE=zhG%|dYS)IW)&y&Id2n7r)6p_)vlRP7NJL(x4UbhlcFXWT8?K=%s7;z?Vjts?y2+r|uk8Wt(DM*73^W%pAkZa1Jd zNoE)8FvQA>Z`eR5Z@Ig6kS5?0h;`Y&OL2D&xnnAUzQz{YSdh0k zB3exx%A2TyI)M*EM6htrxSlep!Kk(P(VP`$p0G~f$smld6W1r_Z+o?=IB@^weq>5VYsYZZR@` z&XJFxd5{|KPZmVOSxc@^%71C@;z}}WhbF9p!%yLj3j%YOlPL5s>7I3vj25 z@xmf=*z%Wb4;Va6SDk9cv|r*lhZ`(y_*M@>q;wrn)oQx%B(2A$9(74>;$zmQ!4fN; z>XurIk-7@wZys<+7XL@0Fhe-f%*=(weaQEdR9Eh6>Kl-EcI({qoZqyzziGwpg-GM#251sK_ z=3|kitS!j%;fpc@oWn65SEL73^N&t>Ix37xgs= zYG%eQDJc|rqHFia0!_sm7`@lvcv)gfy(+KXA@E{3t1DaZ$DijWAcA)E0@X?2ziJ{v z&KOYZ|DdkM{}t+@{@*6ge}m%xfjIxi%qh`=^2Rwz@w0cCvZ&Tc#UmCDbVwABrON^x zEBK43FO@weA8s7zggCOWhMvGGE`baZ62cC)VHyy!5Zbt%ieH+XN|OLbAFPZWyC6)p z4P3%8sq9HdS3=ih^0OOlqTPbKuzQ?lBEI{w^ReUO{V?@`ARsL|S*%yOS=Z%sF)>-y z(LAQdhgAcuF6LQjRYfdbD1g4o%tV4EiK&ElLB&^VZHbrV1K>tHTO{#XTo>)2UMm`2 z^t4s;vnMQgf-njU-RVBRw0P0-m#d-u`(kq7NL&2T)TjI_@iKuPAK-@oH(J8?%(e!0Ir$yG32@CGUPn5w4)+9@8c&pGx z+K3GKESI4*`tYlmMHt@br;jBWTei&(a=iYslc^c#RU3Q&sYp zSG){)V<(g7+8W!Wxeb5zJb4XE{I|&Y4UrFWr%LHkdQ;~XU zgy^dH-Z3lmY+0G~?DrC_S4@=>0oM8Isw%g(id10gWkoz2Q%7W$bFk@mIzTCcIB(K8 zc<5h&ZzCdT=9n-D>&a8vl+=ZF*`uTvQviG_bLde*k>{^)&0o*b05x$MO3gVLUx`xZ z43j+>!u?XV)Yp@MmG%Y`+COH2?nQcMrQ%k~6#O%PeD_WvFO~Kct za4XoCM_X!c5vhRkIdV=xUB3xI2NNStK*8_Zl!cFjOvp-AY=D;5{uXj}GV{LK1~IE2 z|KffUiBaStRr;10R~K2VVtf{TzM7FaPm;Y(zQjILn+tIPSrJh&EMf6evaBKIvi42-WYU9Vhj~3< zZSM-B;E`g_o8_XTM9IzEL=9Lb^SPhe(f(-`Yh=X6O7+6ALXnTcUFpI>ekl6v)ZQeNCg2 z^H|{SKXHU*%nBQ@I3It0m^h+6tvI@FS=MYS$ZpBaG7j#V@P2ZuYySbp@hA# ze(kc;P4i_-_UDP?%<6>%tTRih6VBgScKU^BV6Aoeg6Uh(W^#J^V$Xo^4#Ekp ztqQVK^g9gKMTHvV7nb64UU7p~!B?>Y0oFH5T7#BSW#YfSB@5PtE~#SCCg3p^o=NkMk$<8- z6PT*yIKGrvne7+y3}_!AC8NNeI?iTY(&nakN>>U-zT0wzZf-RuyZk^X9H-DT_*wk= z;&0}6LsGtfVa1q)CEUPlx#(ED@-?H<1_FrHU#z5^P3lEB|qsxEyn%FOpjx z3S?~gvoXy~L(Q{Jh6*i~=f%9kM1>RGjBzQh_SaIDfSU_9!<>*Pm>l)cJD@wlyxpBV z4Fmhc2q=R_wHCEK69<*wG%}mgD1=FHi4h!98B-*vMu4ZGW~%IrYSLGU{^TuseqVgV zLP<%wirIL`VLyJv9XG_p8w@Q4HzNt-o;U@Au{7%Ji;53!7V8Rv0^Lu^Vf*sL>R(;c zQG_ZuFl)Mh-xEIkGu}?_(HwkB2jS;HdPLSxVU&Jxy9*XRG~^HY(f0g8Q}iqnVmgjI zfd=``2&8GsycjR?M%(zMjn;tn9agcq;&rR!Hp z$B*gzHsQ~aXw8c|a(L^LW(|`yGc!qOnV(ZjU_Q-4z1&0;jG&vAKuNG=F|H?@m5^N@ zq{E!1n;)kNTJ>|Hb2ODt-7U~-MOIFo%9I)_@7fnX+eMMNh>)V$IXesJpBn|uo8f~#aOFytCT zf9&%MCLf8mp4kwHTcojWmM3LU=#|{3L>E}SKwOd?%{HogCZ_Z1BSA}P#O(%H$;z7XyJ^sjGX;j5 zrzp>|Ud;*&VAU3x#f{CKwY7Vc{%TKKqmB@oTHA9;>?!nvMA;8+Jh=cambHz#J18x~ zs!dF>$*AnsQ{{82r5Aw&^7eRCdvcgyxH?*DV5(I$qXh^zS>us*I66_MbL8y4d3ULj z{S(ipo+T3Ag!+5`NU2sc+@*m{_X|&p#O-SAqF&g_n7ObB82~$p%fXA5GLHMC+#qqL zdt`sJC&6C2)=juQ_!NeD>U8lDVpAOkW*khf7MCcs$A(wiIl#B9HM%~GtQ^}yBPjT@ z+E=|A!Z?A(rwzZ;T}o6pOVqHzTr*i;Wrc%&36kc@jXq~+w8kVrs;%=IFdACoLAcCAmhFNpbP8;s`zG|HC2Gv?I~w4ITy=g$`0qMQdkijLSOtX6xW%Z9Nw<;M- zMN`c7=$QxN00DiSjbVt9Mi6-pjv*j(_8PyV-il8Q-&TwBwH1gz1uoxs6~uU}PrgWB zIAE_I-a1EqlIaGQNbcp@iI8W1sm9fBBNOk(k&iLBe%MCo#?xI$%ZmGA?=)M9D=0t7 zc)Q0LnI)kCy{`jCGy9lYX%mUsDWwsY`;jE(;Us@gmWPqjmXL+Hu#^;k%eT>{nMtzj zsV`Iy6leTA8-PndszF;N^X@CJrTw5IIm!GPeu)H2#FQitR{1p;MasQVAG3*+=9FYK zw*k!HT(YQorfQj+1*mCV458(T5=fH`um$gS38hw(OqVMyunQ;rW5aPbF##A3fGH6h z@W)i9Uff?qz`YbK4c}JzQpuxuE3pcQO)%xBRZp{zJ^-*|oryTxJ-rR+MXJ)!f=+pp z10H|DdGd2exhi+hftcYbM0_}C0ZI-2vh+$fU1acsB-YXid7O|=9L!3e@$H*6?G*Zp z%qFB(sgl=FcC=E4CYGp4CN>=M8#5r!RU!u+FJVlH6=gI5xHVD&k;Ta*M28BsxfMV~ zLz+@6TxnfLhF@5=yQo^1&S}cmTN@m!7*c6z;}~*!hNBjuE>NLVl2EwN!F+)0$R1S! zR|lF%n!9fkZ@gPW|x|B={V6x3`=jS*$Pu0+5OWf?wnIy>Y1MbbGSncpKO0qE(qO=ts z!~@&!N`10S593pVQu4FzpOh!tvg}p%zCU(aV5=~K#bKi zHdJ1>tQSrhW%KOky;iW+O_n;`l9~omqM%sdxdLtI`TrJzN6BQz+7xOl*rM>xVI2~# z)7FJ^Dc{DC<%~VS?@WXzuOG$YPLC;>#vUJ^MmtbSL`_yXtNKa$Hk+l-c!aC7gn(Cg ze?YPYZ(2Jw{SF6MiO5(%_pTo7j@&DHNW`|lD`~{iH+_eSTS&OC*2WTT*a`?|9w1dh zh1nh@$a}T#WE5$7Od~NvSEU)T(W$p$s5fe^GpG+7fdJ9=enRT9$wEk+ZaB>G3$KQO zgq?-rZZnIv!p#>Ty~}c*Lb_jxJg$eGM*XwHUwuQ|o^}b3^T6Bxx{!?va8aC@-xK*H ztJBFvFfsSWu89%@b^l3-B~O!CXs)I6Y}y#0C0U0R0WG zybjroj$io0j}3%P7zADXOwHwafT#uu*zfM!oD$6aJx7+WL%t-@6^rD_a_M?S^>c;z zMK580bZXo1f*L$CuMeM4Mp!;P@}b~$cd(s5*q~FP+NHSq;nw3fbWyH)i2)-;gQl{S zZO!T}A}fC}vUdskGSq&{`oxt~0i?0xhr6I47_tBc`fqaSrMOzR4>0H^;A zF)hX1nfHs)%Zb-(YGX;=#2R6C{BG;k=?FfP?9{_uFLri~-~AJ;jw({4MU7e*d)?P@ zXX*GkNY9ItFjhwgAIWq7Y!ksbMzfqpG)IrqKx9q{zu%Mdl+{Dis#p9q`02pr1LG8R z@As?eG!>IoROgS!@J*to<27coFc1zpkh?w=)h9CbYe%^Q!Ui46Y*HO0mr% zEff-*$ndMNw}H2a5@BsGj5oFfd!T(F&0$<{GO!Qdd?McKkorh=5{EIjDTHU`So>8V zBA-fqVLb2;u7UhDV1xMI?y>fe3~4urv3%PX)lDw+HYa;HFkaLqi4c~VtCm&Ca+9C~ zge+67hp#R9`+Euq59WhHX&7~RlXn=--m8$iZ~~1C8cv^2(qO#X0?vl91gzUKBeR1J z^p4!!&7)3#@@X&2aF2-)1Ffcc^F8r|RtdL2X%HgN&XU-KH2SLCbpw?J5xJ*!F-ypZ zMG%AJ!Pr&}`LW?E!K~=(NJxuSVTRCGJ$2a*Ao=uUDSys!OFYu!Vs2IT;xQ6EubLIl z+?+nMGeQQhh~??0!s4iQ#gm3!BpMpnY?04kK375e((Uc7B3RMj;wE?BCoQGu=UlZt!EZ1Q*auI)dj3Jj{Ujgt zW5hd~-HWBLI_3HuO) zNrb^XzPsTIb=*a69wAAA3J6AAZZ1VsYbIG}a`=d6?PjM)3EPaDpW2YP$|GrBX{q*! z$KBHNif)OKMBCFP5>!1d=DK>8u+Upm-{hj5o|Wn$vh1&K!lVfDB&47lw$tJ?d5|=B z^(_9=(1T3Fte)z^>|3**n}mIX;mMN5v2F#l(q*CvU{Ga`@VMp#%rQkDBy7kYbmb-q z<5!4iuB#Q_lLZ8}h|hPODI^U6`gzLJre9u3k3c#%86IKI*^H-@I48Bi*@avYm4v!n0+v zWu{M{&F8#p9cx+gF0yTB_<2QUrjMPo9*7^-uP#~gGW~y3nfPAoV%amgr>PSyVAd@l)}8#X zR5zV6t*uKJZL}?NYvPVK6J0v4iVpwiN|>+t3aYiZSp;m0!(1`bHO}TEtWR1tY%BPB z(W!0DmXbZAsT$iC13p4f>u*ZAy@JoLAkJhzFf1#4;#1deO8#8d&89}en&z!W&A3++^1(;>0SB1*54d@y&9Pn;^IAf3GiXbfT`_>{R+Xv; zQvgL>+0#8-laO!j#-WB~(I>l0NCMt_;@Gp_f0#^c)t?&#Xh1-7RR0@zPyBz!U#0Av zT?}n({(p?p7!4S2ZBw)#KdCG)uPnZe+U|0{BW!m)9 zi_9$F?m<`2!`JNFv+w8MK_K)qJ^aO@7-Ig>cM4-r0bi=>?B_2mFNJ}aE3<+QCzRr*NA!QjHw# z`1OsvcoD0?%jq{*7b!l|L1+Tw0TTAM4XMq7*ntc-Ived>Sj_ZtS|uVdpfg1_I9knY z2{GM_j5sDC7(W&}#s{jqbybqJWyn?{PW*&cQIU|*v8YGOKKlGl@?c#TCnmnAkAzV- zmK={|1G90zz=YUvC}+fMqts0d4vgA%t6Jhjv?d;(Z}(Ep8fTZfHA9``fdUHkA+z3+ zhh{ohP%Bj?T~{i0sYCQ}uC#5BwN`skI7`|c%kqkyWIQ;!ysvA8H`b-t()n6>GJj6xlYDu~8qX{AFo$Cm3d|XFL=4uvc?Keb zzb0ZmMoXca6Mob>JqkNuoP>B2Z>D`Q(TvrG6m`j}-1rGP!g|qoL=$FVQYxJQjFn33lODt3Wb1j8VR zlR++vIT6^DtYxAv_hxupbLLN3e0%A%a+hWTKDV3!Fjr^cWJ{scsAdfhpI)`Bms^M6 zQG$waKgFr=c|p9Piug=fcJvZ1ThMnNhQvBAg-8~b1?6wL*WyqXhtj^g(Ke}mEfZVM zJuLNTUVh#WsE*a6uqiz`b#9ZYg3+2%=C(6AvZGc=u&<6??!slB1a9K)=VL zY9EL^mfyKnD zSJyYBc_>G;5RRnrNgzJz#Rkn3S1`mZgO`(r5;Hw6MveN(URf_XS-r58Cn80K)ArH4 z#Rrd~LG1W&@ttw85cjp8xV&>$b%nSXH_*W}7Ch2pg$$c0BdEo-HWRTZcxngIBJad> z;C>b{jIXjb_9Jis?NZJsdm^EG}e*pR&DAy0EaSGi3XWTa(>C%tz1n$u?5Fb z1qtl?;_yjYo)(gB^iQq?=jusF%kywm?CJP~zEHi0NbZ);$(H$w(Hy@{i>$wcVRD_X|w-~(0Z9BJyh zhNh;+eQ9BEIs;tPz%jSVnfCP!3L&9YtEP;svoj_bNzeGSQIAjd zBss@A;)R^WAu-37RQrM%{DfBNRx>v!G31Z}8-El9IOJlb_MSoMu2}GDYycNaf>uny z+8xykD-7ONCM!APry_Lw6-yT>5!tR}W;W`C)1>pxSs5o1z#j7%m=&=7O4hz+Lsqm` z*>{+xsabZPr&X=}G@obTb{nPTkccJX8w3CG7X+1+t{JcMabv~UNv+G?txRqXib~c^Mo}`q{$`;EBNJ;#F*{gvS12kV?AZ%O0SFB$^ zn+}!HbmEj}w{Vq(G)OGAzH}R~kS^;(-s&=ectz8vN!_)Yl$$U@HNTI-pV`LSj7Opu zTZ5zZ)-S_{GcEQPIQXLQ#oMS`HPu{`SQiAZ)m1at*Hy%3xma|>o`h%E%8BEbi9p0r zVjcsh<{NBKQ4eKlXU|}@XJ#@uQw*$4BxKn6#W~I4T<^f99~(=}a`&3(ur8R9t+|AQ zWkQx7l}wa48-jO@ft2h+7qn%SJtL%~890FG0s5g*kNbL3I&@brh&f6)TlM`K^(bhr zJWM6N6x3flOw$@|C@kPi7yP&SP?bzP-E|HSXQXG>7gk|R9BTj`e=4de9C6+H7H7n# z#GJeVs1mtHhLDmVO?LkYRQc`DVOJ_vdl8VUihO-j#t=0T3%Fc1f9F73ufJz*adn*p zc%&vi(4NqHu^R>sAT_0EDjVR8bc%wTz#$;%NU-kbDyL_dg0%TFafZwZ?5KZpcuaO54Z9hX zD$u>q!-9`U6-D`E#`W~fIfiIF5_m6{fvM)b1NG3xf4Auw;Go~Fu7cth#DlUn{@~yu z=B;RT*dp?bO}o%4x7k9v{r=Y@^YQ^UUm(Qmliw8brO^=NP+UOohLYiaEB3^DB56&V zK?4jV61B|1Uj_5fBKW;8LdwOFZKWp)g{B%7g1~DgO&N& z#lisxf?R~Z@?3E$Mms$$JK8oe@X`5m98V*aV6Ua}8Xs2#A!{x?IP|N(%nxsH?^c{& z@vY&R1QmQs83BW28qAmJfS7MYi=h(YK??@EhjL-t*5W!p z^gYX!Q6-vBqcv~ruw@oMaU&qp0Fb(dbVzm5xJN%0o_^@fWq$oa3X?9s%+b)x4w-q5Koe(@j6Ez7V@~NRFvd zfBH~)U5!ix3isg`6be__wBJp=1@yfsCMw1C@y+9WYD9_C%{Q~7^0AF2KFryfLlUP# zwrtJEcH)jm48!6tUcxiurAMaiD04C&tPe6DI0#aoqz#Bt0_7_*X*TsF7u*zv(iEfA z;$@?XVu~oX#1YXtceQL{dSneL&*nDug^OW$DSLF0M1Im|sSX8R26&)<0Fbh^*l6!5wfSu8MpMoh=2l z^^0Sr$UpZp*9oqa23fcCfm7`ya2<4wzJ`Axt7e4jJrRFVf?nY~2&tRL* zd;6_njcz01c>$IvN=?K}9ie%Z(BO@JG2J}fT#BJQ+f5LFSgup7i!xWRKw6)iITjZU z%l6hPZia>R!`aZjwCp}I zg)%20;}f+&@t;(%5;RHL>K_&7MH^S+7<|(SZH!u zznW|jz$uA`P9@ZWtJgv$EFp>)K&Gt+4C6#*khZQXS*S~6N%JDT$r`aJDs9|uXWdbg zBwho$phWx}x!qy8&}6y5Vr$G{yGSE*r$^r{}pw zVTZKvikRZ`J_IJrjc=X1uw?estdwm&bEahku&D04HD+0Bm~q#YGS6gp!KLf$A{%Qd z&&yX@Hp>~(wU{|(#U&Bf92+1i&Q*-S+=y=3pSZy$#8Uc$#7oiJUuO{cE6=tsPhwPe| zxQpK>`Dbka`V)$}e6_OXKLB%i76~4N*zA?X+PrhH<&)}prET;kel24kW%+9))G^JI zsq7L{P}^#QsZViX%KgxBvEugr>ZmFqe^oAg?{EI=&_O#e)F3V#rc z8$4}0Zr19qd3tE4#$3_f=Bbx9oV6VO!d3(R===i-7p=Vj`520w0D3W6lQfY48}!D* z&)lZMG;~er2qBoI2gsX+Ts-hnpS~NYRDtPd^FPzn!^&yxRy#CSz(b&E*tL|jIkq|l zf%>)7Dtu>jCf`-7R#*GhGn4FkYf;B$+9IxmqH|lf6$4irg{0ept__%)V*R_OK=T06 zyT_m-o@Kp6U{l5h>W1hGq*X#8*y@<;vsOFqEjTQXFEotR+{3}ODDnj;o0@!bB5x=N z394FojuGOtVKBlVRLtHp%EJv_G5q=AgF)SKyRN5=cGBjDWv4LDn$IL`*=~J7u&Dy5 zrMc83y+w^F&{?X(KOOAl-sWZDb{9X9#jrQtmrEXD?;h-}SYT7yM(X_6qksM=K_a;Z z3u0qT0TtaNvDER_8x*rxXw&C^|h{P1qxK|@pS7vdlZ#P z7PdB7MmC2}%sdzAxt>;WM1s0??`1983O4nFK|hVAbHcZ3x{PzytQLkCVk7hA!Lo` zEJH?4qw|}WH{dc4z%aB=0XqsFW?^p=X}4xnCJXK%c#ItOSjdSO`UXJyuc8bh^Cf}8 z@Ht|vXd^6{Fgai8*tmyRGmD_s_nv~r^Fy7j`Bu`6=G)5H$i7Q7lvQnmea&TGvJp9a|qOrUymZ$6G|Ly z#zOCg++$3iB$!6!>215A4!iryregKuUT344X)jQb3|9qY>c0LO{6Vby05n~VFzd?q zgGZv&FGlkiH*`fTurp>B8v&nSxNz)=5IF$=@rgND4d`!AaaX;_lK~)-U8la_Wa8i?NJC@BURO*sUW)E9oyv3RG^YGfN%BmxzjlT)bp*$<| zX3tt?EAy<&K+bhIuMs-g#=d1}N_?isY)6Ay$mDOKRh z4v1asEGWoAp=srraLW^h&_Uw|6O+r;wns=uwYm=JN4Q!quD8SQRSeEcGh|Eb5Jg8m zOT}u;N|x@aq)=&;wufCc^#)5U^VcZw;d_wwaoh9$p@Xrc{DD6GZUqZ ziC6OT^zSq@-lhbgR8B+e;7_Giv;DK5gn^$bs<6~SUadiosfewWDJu`XsBfOd1|p=q zE>m=zF}!lObA%ePey~gqU8S6h-^J2Y?>7)L2+%8kV}Gp=h`Xm_}rlm)SyUS=`=S7msKu zC|T!gPiI1rWGb1z$Md?0YJQ;%>uPLOXf1Z>N~`~JHJ!^@D5kSXQ4ugnFZ>^`zH8CAiZmp z6Ms|#2gcGsQ{{u7+Nb9sA?U>(0e$5V1|WVwY`Kn)rsnnZ4=1u=7u!4WexZD^IQ1Jk zfF#NLe>W$3m&C^ULjdw+5|)-BSHwpegdyt9NYC{3@QtMfd8GrIWDu`gd0nv-3LpGCh@wgBaG z176tikL!_NXM+Bv#7q^cyn9$XSeZR6#!B4JE@GVH zoobHZN_*RF#@_SVYKkQ_igme-Y5U}cV(hkR#k1c{bQNMji zU7aE`?dHyx=1`kOYZo_8U7?3-7vHOp`Qe%Z*i+FX!s?6huNp0iCEW-Z7E&jRWmUW_ z67j>)Ew!yq)hhG4o?^z}HWH-e=es#xJUhDRc4B51M4~E-l5VZ!&zQq`gWe`?}#b~7w1LH4Xa-UCT5LXkXQWheBa2YJYbyQ zl1pXR%b(KCXMO0OsXgl0P0Og<{(@&z1aokU-Pq`eQq*JYgt8xdFQ6S z6Z3IFSua8W&M#`~*L#r>Jfd6*BzJ?JFdBR#bDv$_0N!_5vnmo@!>vULcDm`MFU823 zpG9pqjqz^FE5zMDoGqhs5OMmC{Y3iVcl>F}5Rs24Y5B^mYQ;1T&ks@pIApHOdrzXF z-SdX}Hf{X;TaSxG_T$0~#RhqKISGKNK47}0*x&nRIPtmdwxc&QT3$8&!3fWu1eZ_P zJveQj^hJL#Sn!*4k`3}(d(aasl&7G0j0-*_2xtAnoX1@9+h zO#c>YQg60Z;o{Bi=3i7S`Ic+ZE>K{(u|#)9y}q*j8uKQ1^>+(BI}m%1v3$=4ojGBc zm+o1*!T&b}-lVvZqIUBc8V}QyFEgm#oyIuC{8WqUNV{Toz`oxhYpP!_p2oHHh5P@iB*NVo~2=GQm+8Yrkm2Xjc_VyHg1c0>+o~@>*Qzo zHVBJS>$$}$_4EniTI;b1WShX<5-p#TPB&!;lP!lBVBbLOOxh6FuYloD%m;n{r|;MU3!q4AVkua~fieeWu2 zQAQ$ue(IklX6+V;F1vCu-&V?I3d42FgWgsb_e^29ol}HYft?{SLf>DrmOp9o!t>I^ zY7fBCk+E8n_|apgM|-;^=#B?6RnFKlN`oR)`e$+;D=yO-(U^jV;rft^G_zl`n7qnM zL z*-Y4Phq+ZI1$j$F-f;`CD#|`-T~OM5Q>x}a>B~Gb3-+9i>Lfr|Ca6S^8g*{*?_5!x zH_N!SoRP=gX1?)q%>QTY!r77e2j9W(I!uAz{T`NdNmPBBUzi2{`XMB^zJGGwFWeA9 z{fk33#*9SO0)DjROug+(M)I-pKA!CX;IY(#gE!UxXVsa)X!UftIN98{pt#4MJHOhY zM$_l}-TJlxY?LS6Nuz1T<44m<4i^8k@D$zuCPrkmz@sdv+{ciyFJG2Zwy&%c7;atIeTdh!a(R^QXnu1Oq1b42*OQFWnyQ zWeQrdvP|w_idy53Wa<{QH^lFmEd+VlJkyiC>6B#s)F;w-{c;aKIm;Kp50HnA-o3lY z9B~F$gJ@yYE#g#X&3ADx&tO+P_@mnQTz9gv30_sTsaGXkfNYXY{$(>*PEN3QL>I!k zp)KibPhrfX3%Z$H6SY`rXGYS~143wZrG2;=FLj50+VM6soI~up_>fU(2Wl@{BRsMi zO%sL3x?2l1cXTF)k&moNsHfQrQ+wu(gBt{sk#CU=UhrvJIncy@tJX5klLjgMn>~h= zg|FR&;@eh|C7`>s_9c~0-{IAPV){l|Ts`i=)AW;d9&KPc3fMeoTS%8@V~D8*h;&(^>yjT84MM}=%#LS7shLAuuj(0VAYoozhWjq z4LEr?wUe2^WGwdTIgWBkDUJa>YP@5d9^Rs$kCXmMRxuF*YMVrn?0NFyPl}>`&dqZb z<5eqR=ZG3>n2{6v6BvJ`YBZeeTtB88TAY(x0a58EWyuf>+^|x8Qa6wA|1Nb_p|nA zWWa}|z8a)--Wj`LqyFk_a3gN2>5{Rl_wbW?#by7&i*^hRknK%jwIH6=dQ8*-_{*x0j^DUfMX0`|K@6C<|1cgZ~D(e5vBFFm;HTZF(!vT8=T$K+|F)x3kqzBV4-=p1V(lzi(s7jdu0>LD#N=$Lk#3HkG!a zIF<7>%B7sRNzJ66KrFV76J<2bdYhxll0y2^_rdG=I%AgW4~)1Nvz=$1UkE^J%BxLo z+lUci`UcU062os*=`-j4IfSQA{w@y|3}Vk?i;&SSdh8n+$iHA#%ERL{;EpXl6u&8@ zzg}?hkEOUOJt?ZL=pWZFJ19mI1@P=$U5*Im1e_8Z${JsM>Ov?nh8Z zP5QvI!{Jy@&BP48%P2{Jr_VgzW;P@7)M9n|lDT|Ep#}7C$&ud&6>C^5ZiwKIg2McPU(4jhM!BD@@L(Gd*Nu$ji(ljZ<{FIeW_1Mmf;76{LU z-ywN~=uNN)Xi6$<12A9y)K%X|(W0p|&>>4OXB?IiYr||WKDOJPxiSe01NSV-h24^L z_>m$;|C+q!Mj**-qQ$L-*++en(g|hw;M!^%_h-iDjFHLo-n3JpB;p?+o2;`*jpvJU zLY^lt)Un4joij^^)O(CKs@7E%*!w>!HA4Q?0}oBJ7Nr8NQ7QmY^4~jvf0-`%waOLn zdNjAPaC0_7c|RVhw)+71NWjRi!y>C+Bl;Z`NiL^zn2*0kmj5gyhCLCxts*cWCdRI| zjsd=sT5BVJc^$GxP~YF$-U{-?kW6r@^vHXB%{CqYzU@1>dzf#3SYedJG-Rm6^RB7s zGM5PR(yKPKR)>?~vpUIeTP7A1sc8-knnJk*9)3t^e%izbdm>Y=W{$wm(cy1RB-19i za#828DMBY+ps#7Y8^6t)=Ea@%Nkt)O6JCx|ybC;Ap}Z@Zw~*}3P>MZLPb4Enxz9Wf zssobT^(R@KuShj8>@!1M7tm|2%-pYYDxz-5`rCbaTCG5{;Uxm z*g=+H1X8{NUvFGzz~wXa%Eo};I;~`37*WrRU&K0dPSB$yk(Z*@K&+mFal^?c zurbqB-+|Kb5|sznT;?Pj!+kgFY1#Dr;_%A(GIQC{3ct|{*Bji%FNa6c-thbpBkA;U zURV!Dr&X{0J}iht#-Qp2=xzuh(fM>zRoiGrYl5ttw2#r34gC41CCOC31m~^UPTK@s z6;A@)7O7_%C)>bnAXerYuAHdE93>j2N}H${zEc6&SbZ|-fiG*-qtGuy-qDelH(|u$ zorf8_T6Zqe#Ub!+e3oSyrskt_HyW_^5lrWt#30l)tHk|j$@YyEkXUOV;6B51L;M@=NIWZXU;GrAa(LGxO%|im%7F<-6N;en0Cr zLH>l*y?pMwt`1*cH~LdBPFY_l;~`N!Clyfr;7w<^X;&(ZiVdF1S5e(+Q%60zgh)s4 zn2yj$+mE=miVERP(g8}G4<85^-5f@qxh2ec?n+$A_`?qN=iyT1?U@t?V6DM~BIlBB z>u~eXm-aE>R0sQy!-I4xtCNi!!qh?R1!kKf6BoH2GG{L4%PAz0{Sh6xpuyI%*~u)s z%rLuFl)uQUCBQAtMyN;%)zFMx4loh7uTfKeB2Xif`lN?2gq6NhWhfz0u5WP9J>=V2 zo{mLtSy&BA!mSzs&CrKWq^y40JF5a&GSXIi2= z{EYb59J4}VwikL4P=>+mc6{($FNE@e=VUwG+KV21;<@lrN`mnz5jYGASyvz7BOG_6(p^eTxD-4O#lROgon;R35=|nj#eHIfJBYPWG>H>`dHKCDZ3`R{-?HO0mE~(5_WYcFmp8sU?wr*UkAQiNDGc6T zA%}GOLXlOWqL?WwfHO8MB#8M8*~Y*gz;1rWWoVSXP&IbKxbQ8+s%4Jnt?kDsq7btI zCDr0PZ)b;B%!lu&CT#RJzm{l{2fq|BcY85`w~3LSK<><@(2EdzFLt9Y_`;WXL6x`0 zDoQ?=?I@Hbr;*VVll1Gmd8*%tiXggMK81a+T(5Gx6;eNb8=uYn z5BG-0g>pP21NPn>$ntBh>`*})Fl|38oC^9Qz>~MAazH%3Q~Qb!ALMf$srexgPZ2@&c~+hxRi1;}+)-06)!#Mq<6GhP z-Q?qmgo${aFBApb5p}$1OJKTClfi8%PpnczyVKkoHw7Ml9e7ikrF0d~UB}i3vizos zXW4DN$SiEV9{faLt5bHy2a>33K%7Td-n5C*N;f&ZqAg#2hIqEb(y<&f4u5BWJ>2^4 z414GosL=Aom#m&=x_v<0-fp1r%oVJ{T-(xnomNJ(Dryv zh?vj+%=II_nV+@NR+(!fZZVM&(W6{6%9cm+o+Z6}KqzLw{(>E86uA1`_K$HqINlb1 zKelh3-jr2I9V?ych`{hta9wQ2c9=MM`2cC{m6^MhlL2{DLv7C^j z$xXBCnDl_;l|bPGMX@*tV)B!c|4oZyftUlP*?$YU9C_eAsuVHJ58?)zpbr30P*C`T z7y#ao`uE-SOG(Pi+`$=e^mle~)pRrdwL5)N;o{gpW21of(QE#U6w%*C~`v-z0QqBML!!5EeYA5IQB0 z^l01c;L6E(iytN!LhL}wfwP7W9PNAkb+)Cst?qg#$n;z41O4&v+8-zPs+XNb-q zIeeBCh#ivnFLUCwfS;p{LC0O7tm+Sf9Jn)~b%uwP{%69;QC)Ok0t%*a5M+=;y8j=v z#!*pp$9@!x;UMIs4~hP#pnfVc!%-D<+wsG@R2+J&%73lK|2G!EQC)O05TCV=&3g)C!lT=czLpZ@Sa%TYuoE?v8T8`V;e$#Zf2_Nj6nvBgh1)2 GZ~q4|mN%#X literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..94913af --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,7 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.2-bin.zip +networkTimeout=120000 +validateDistributionUrl=true +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..9d82f78 --- /dev/null +++ b/gradlew @@ -0,0 +1,160 @@ +#!/usr/bin/env bash + +############################################################################## +## +## Gradle start up script for UN*X +## +############################################################################## + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS="" + +APP_NAME="Gradle" +APP_BASE_NAME=`basename "$0"` + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD="maximum" + +warn ( ) { + echo "$*" +} + +die ( ) { + echo + echo "$*" + echo + exit 1 +} + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +case "`uname`" in + CYGWIN* ) + cygwin=true + ;; + Darwin* ) + darwin=true + ;; + MINGW* ) + msys=true + ;; +esac + +# Attempt to set APP_HOME +# Resolve links: $0 may be a link +PRG="$0" +# Need this for relative symlinks. +while [ -h "$PRG" ] ; do + ls=`ls -ld "$PRG"` + link=`expr "$ls" : '.*-> \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG=`dirname "$PRG"`"/$link" + fi +done +SAVED="`pwd`" +cd "`dirname \"$PRG\"`/" >/dev/null +APP_HOME="`pwd -P`" +cd "$SAVED" >/dev/null + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD="java" + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then + MAX_FD_LIMIT=`ulimit -H -n` + if [ $? -eq 0 ] ; then + if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then + MAX_FD="$MAX_FD_LIMIT" + fi + ulimit -n $MAX_FD + if [ $? -ne 0 ] ; then + warn "Could not set maximum file descriptor limit: $MAX_FD" + fi + else + warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" + fi +fi + +# For Darwin, add options to specify how the application appears in the dock +if $darwin; then + GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" +fi + +# For Cygwin, switch paths to Windows format before running java +if $cygwin ; then + APP_HOME=`cygpath --path --mixed "$APP_HOME"` + CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` + JAVACMD=`cygpath --unix "$JAVACMD"` + + # We build the pattern for arguments to be converted via cygpath + ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` + SEP="" + for dir in $ROOTDIRSRAW ; do + ROOTDIRS="$ROOTDIRS$SEP$dir" + SEP="|" + done + OURCYGPATTERN="(^($ROOTDIRS))" + # Add a user-defined pattern to the cygpath arguments + if [ "$GRADLE_CYGPATTERN" != "" ] ; then + OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" + fi + # Now convert the arguments - kludge to limit ourselves to /bin/sh + i=0 + for arg in "$@" ; do + CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` + CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option + + if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition + eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` + else + eval `echo args$i`="\"$arg\"" + fi + i=$((i+1)) + done + case $i in + (0) set -- ;; + (1) set -- "$args0" ;; + (2) set -- "$args0" "$args1" ;; + (3) set -- "$args0" "$args1" "$args2" ;; + (4) set -- "$args0" "$args1" "$args2" "$args3" ;; + (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; + (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; + (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; + (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; + (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; + esac +fi + +# Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules +function splitJvmOpts() { + JVM_OPTS=("$@") +} +eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS +JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME" + +exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@" diff --git a/keystore/README.md b/keystore/README.md new file mode 100644 index 0000000..d1abc8a --- /dev/null +++ b/keystore/README.md @@ -0,0 +1,42 @@ +# Release keystore + +The `.jks` files in this directory are gitignored — this repo ships with +**no checked-in keys**. Every developer (and the CI runner) generates +their own; see `.gitignore` rules under "Release keystore". + +## Generate a local dev keystore + +This is the keystore `signingConfigs.release` in `app/build.gradle.kts` +points at. Run from this directory: + +```bash +keytool -genkey -noprompt -v \ + -keystore release.jks \ + -keyalg RSA -keysize 2048 -validity 10000 \ + -alias trafero \ + -storepass trafero_dev_keystore \ + -keypass trafero_dev_keystore \ + -dname "CN=Trafero, OU=Local, O=Trafero, L=Local, ST=Local, C=NZ" +``` + +Store and key passwords are both `trafero_dev_keystore` — change them +before publishing anywhere real. + +## CI (Gitea Actions) + +`release.yml` mints one persistent keystore on the runner at +`/var/lib/gitea-runner/work/release.jks` (same parameters as above) and +copies it to `keystore/release.jks` for every build, so all CI release +APKs share one signing key and users can upgrade in place. + +**Important:** locally-built (and debug) APKs have a *different* +signature from CI release APKs — installing a CI release build over a +debug build requires an uninstall first. + +## For Play Store / F-Droid distribution + +Generate a **separate** production keystore, keep it outside the repo, +and switch `signingConfigs.release` to read credentials from +`~/.gradle/gradle.properties` or environment variables. Do **not** lose +the production keystore — without it you can never publish updates under +the same applicationId. diff --git a/scripts/ci/release-notes.py b/scripts/ci/release-notes.py new file mode 100755 index 0000000..0da844a --- /dev/null +++ b/scripts/ci/release-notes.py @@ -0,0 +1,88 @@ +#!/usr/bin/env python3 +"""Extract the release-notes section for one version from PREVIOUS_HISTORY.md. + +Trafero publishes its user-facing changelog through the Gitea Releases page: +for every tag push, `.gitea/workflows/release.yml` calls this script with +the released version. The matching `## v — ` section of +PREVIOUS_HISTORY.md becomes the release description and is also uploaded +next to the APKs as `Trafero--changes.md`. + +Usage: + release-notes.py [--out FILE] [--history FILE] [--no-footer] + +Exits 0 and prints the Markdown (to --out FILE or stdout) when the section +exists; exits 1 (message on stderr) when it doesn't — the workflow then +falls back to its generic "Release " body. +""" + +import argparse +import re +import sys +from pathlib import Path + +# "## v0.3.8.0 — 2026-09-16" -> group(1) = "0.3.8.0" +HEADING = re.compile(r"^##\s+v?([0-9]+(?:\.[0-9]+)*)\b") + +FOOTER = ( + "\n\n---\n\n" + "_Full history: PREVIOUS_HISTORY.md at the repository root. " + "In-depth developer notes: Trafero Development Plan \u00a710._\n" +) + + +def extract(history_text: str, version: str, footer: bool) -> str | None: + wanted = version.lstrip("vV").strip() + collected: list[str] = [] + in_section = False + for line in history_text.splitlines(): + match = HEADING.match(line) + if match: + in_section = match.group(1) == wanted + if in_section: + collected.append(line) + if not collected: + return None + body = "\n".join(collected).rstrip() + if not body: + return None + return body + (FOOTER if footer else "") + + +def main() -> int: + parser = argparse.ArgumentParser(description=__doc__.splitlines()[0]) + parser.add_argument("version", help="Version or tag, e.g. 0.3.8.0 or v0.3.8.0") + parser.add_argument("--out", type=Path, default=None, + help="Write the notes to this file instead of stdout") + parser.add_argument("--history", type=Path, default=None, + help="Path to PREVIOUS_HISTORY.md " + "(default: repo root, two levels above scripts/ci/)") + parser.add_argument("--no-footer", action="store_true", + help="Omit the standard cross-reference footer") + args = parser.parse_args() + + history_path = args.history or ( + Path(__file__).resolve().parents[2] / "PREVIOUS_HISTORY.md" + ) + if not history_path.is_file(): + print(f"release-notes: history file not found: {history_path}", + file=sys.stderr) + return 1 + + notes = extract(history_path.read_text(encoding="utf-8"), + args.version, footer=not args.no_footer) + if notes is None: + print(f"release-notes: no changelog section for {args.version} " + f"in {history_path.name}", file=sys.stderr) + return 1 + + if args.out: + args.out.write_text(notes, encoding="utf-8") + print(f"Wrote {len(notes)} chars for v{args.version.lstrip('vV')} " + f"to {args.out}") + else: + sys.stdout.write(notes) + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/settings.gradle.kts b/settings.gradle.kts new file mode 100644 index 0000000..f66a6c0 --- /dev/null +++ b/settings.gradle.kts @@ -0,0 +1,16 @@ +pluginManagement { + repositories { + google() + mavenCentral() + gradlePluginPortal() + } +} +dependencyResolutionManagement { + repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) + repositories { + google() + mavenCentral() + } +} +rootProject.name = "Trafero" +include(":app")