README.md
Rama main · réplica de lectura del repositorio original.
# 🧩 Zotero self-hosted sync
**Patches for Morphe** that point the **Zotero Android app** at a **self-hosted Zotero sync server** (such as [altero](https://altero.run/)) instead of `zotero.org`.
## ❓ About
A single patch that rewrites the Zotero Android client's hardcoded endpoints to the server domain you enter when patching.
The Zotero Android application compiles its API host into the build and exposes no runtime setting for another server, so a self-hosted server can only be used with a patched client. This bundle supplies that patch:
- **Custom sync server** — at patch time you enter your server address (e.g. `https://zotero.example.org`). The patch rewrites the API base (`https://api.zotero.org`) and the streaming endpoint (`wss://stream.zotero.org`) accordingly, and uses `wss://<host>/stream` for live updates.
- **Nothing else to configure** — the login/approval flow, the account-approval URL and attachment upload URLs are all server-provided, so they follow the domain automatically. HTTPS is required.
> The server itself must implement the Zotero Web API and streaming API (e.g. [altero](https://github.com/eseifert/altero)). Only the official Android app is patched; the server is not touched.
## How to use these patches
Click here to add these patches to Morphe: https://morphe.software/add-source?github=raphaelbahat/zotero-self-hosted-sync
## 🩹 Patches list
<!-- PATCHES_START EXPANDED -->
> **[v1.0.4](https://github.com/raphaelbahat/zotero-self-hosted-sync/releases/tag/v1.0.4)** • `main` • 4 patches total
> **⚠️ One patch here is a workaround**
>
> `Recover attachments with an unusable modification time` exists because the Zotero Android app
> discards an attachment whose stored `mtime` it cannot parse instead of repairing it, so the file
> would never upload. It goes once the app handles that itself — the report is
> [zotero/zotero-android#351](https://github.com/zotero/zotero-android/issues/351).
>
> In the **Default** column, `✅` means the patch is applied when you patch the app, and `—`
> means you have to switch it on yourself.
<details open>
<summary>📦 Zotero • 4 patches</summary>
<br>
**🎯 Supported versions:**
| 1.0.0-247 |
| :---: |
| 💊 Patch | ✅ Default | 📜 Description | ⚙️ Options |
|----------|:---:|----------------|-----------|
| [Custom sync server](#custom-sync-server) | ✅ | Redirects Zotero's sync API and live-update stream to your own server. | • Server address<br>• Streaming address (optional) |
| [Custom sync server: allow cleartext streaming](#custom-sync-server-allow-cleartext-streaming) | ✅ | Adds the chosen streaming host to the app's cleartext allow-list when the stream URL is ws:// or http://. | • Server address<br>• Streaming address (optional) |
| [Enable verbose logging](#enable-verbose-logging) | — | **🧪 For development only.** Plants Timber's debug tree so the app's own log lines reach logcat — expect a lot of output, and do not patch this into a build you rely on. | |
| [Recover attachments with an unusable modification time](#recover-attachments-with-an-unusable-modification-time) | ✅ | **⏳ Temporary workaround** — the Zotero Android app discards an attachment whose stored modification time it cannot parse, instead of repairing it, so the file is never uploaded. Reported upstream: https://github.com/zotero/zotero-android/issues/351 | |
</details>
<!-- PATCHES_END -->
### 🛠️ Building locally
- Run `./gradlew buildAndroid`
- The built patches .mpp file is found in `patches/build/libs/patches-*.mpp`
- Patch the mpp file using [Morphe-Desktop](https://github.com/MorpheApp/morphe-desktop)
like any other patch bundle.
See the [Morphe documentation](https://github.com/MorpheApp/morphe-documentation) for more information.
## 📜 License
Anondev Zotero Patches are licensed under the [GNU General Public License v3.0](LICENSE)
## ⚖️ Not affiliated
This project is not affiliated with, endorsed by, or sponsored by the Corporation for Digital
Scholarship or the Zotero project. “Zotero” is a registered trademark of the Corporation for
Digital Scholarship, and is used here only to name the application these patches apply to.
It distributes **only patch code** — the `.mpp` bundle in each release — and never the Zotero
application, its source, or a patched APK. The Zotero software is licensed under the AGPLv3, and
Zotero's trademarks policy states that the AGPL grants no right to use the Zotero name in
connection with derivative works (<https://www.zotero.org/trademark>).
What you build with these patches is for your own use on a copy of the app you already have. If
you instead publish a patched APK, you are distributing an AGPLv3 derivative work and take on the
obligations that go with it — including the one above.