commit 312858e8f64032c09cd22b40d3c5b788029ebe9c Author: nick Date: Mon Sep 21 17:46:29 2026 +1200 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. 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 0000000..a4b76b9 Binary files /dev/null and b/gradle/wrapper/gradle-wrapper.jar differ 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")