# BRAT (Gitea Fork) A fork of [obsidian42-brat](https://github.com/TfTHacker/obsidian42-brat) that adds support for **self-hosted Gitea/Forgejo instances** alongside GitHub. ## What is this? BRAT (Beta Reviewers Auto-update Tester) lets you install and auto-update beta Obsidian plugins directly from any git forge that supports releases. This fork extends the original to work with **any Gitea instance** — not just GitHub. ## Usage Open the BRAT command palette and choose **"Add a beta plugin for testing"**, then paste a repository URL: | Source | Format | Example | |---|---|---| | **GitHub** | `user/repo` or `https://github.com/user/repo` | `TfTHacker/obsidian42-brat` | | **Gitea** | `https://git.your-instance.com/user/repo` | `https://gitea.mithrilforge.dev/olivier/BindThem` | The plugin auto-detects the provider from the URL host: `github.com` is GitHub, any other host is Gitea/Forgejo. Gitea addresses may include a port (`https://git.lan:3000/user/repo`) or a sub-path install (`https://example.com/gitea/user/repo`); a pasted browser URL such as `…/user/repo/releases/tag/v1.0` is reduced to the repository. ### Access tokens - **Global token** (settings): GitHub only. It is never sent to a Gitea/Forgejo host. - **Per-plugin token**: set in the add-plugin dialog; sent only to that plugin's host. Use it for private Gitea repos. ## Installation Download the latest release assets (`main.js`, `manifest.json`, `styles.css`) and place them in: ``` .obsidian/plugins/obsidian42-brat-gitea/ ``` Then enable **BRAT (Gitea Fork)** in Settings → Community Plugins. ## Features - Install plugins from **GitHub** (bare `user/repo` format, backward compatible) - Install plugins from **Gitea / Forgejo** (full URL format) - Per-plugin token management via Obsidian SecretStorage - Frozen version pinning, incompatible plugin overrides - Theme installation and updates - Same UI and commands as the original BRAT ## Credits Original BRAT by [TfTHacker](https://github.com/TfTHacker/obsidian42-brat) and [johannrichard](https://github.com/johannrichard).