BRAT (Gitea Fork)
A fork of 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/repoformat, 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 and johannrichard.