Notifications and watching
Arbinel lets you choose, per repository, which events notify you, and whose activity to ignore. It also adds release notifications to your notification list. Your notifications show on the Inbox.
How notifications work
Section titled “How notifications work”You get a notification about an issue or pull request in the following cases:
- Watching the repository. Watching sends you events of the kinds you choose for that repository.
- Participating. You opened the issue, commented on it or reviewed it.
- Being mentioned.
Someone wrote
@yournamein the issue or a comment.
You can also subscribe to a single issue or pull request from Notifications in its sidebar, which works as in Forgejo. Forgejo’s email settings page covers subscriptions and email.
Watch a repository
Section titled “Watch a repository”Open Watch in the repository header. A menu lists four events:
| Option | Notifies you about |
|---|---|
| Participating and @mentions | Issues and pull requests you take part in, and mentions of you |
| All issues | Every issue and its comments |
| All pull requests | Every pull request and its comments, except pull requests marked as work in progress |
| Releases | Every new release |
Select the events you want, then close the menu. Arbinel saves the choice when the menu closes. Clearing every option stops watching the repository. The Unwatch all button also stops watching.
The menu starts with your default watch events ticked, apart from Participating and @mentions.
Activity on an issue you take part in shows in your notifications only when you watch the repository with Participating and @mentions selected, or when you subscribed to that issue. Email follows Forgejo’s rules and still reaches the author and assignees of an issue and everyone who commented on it.
Exclude authors in one repository
Section titled “Exclude authors in one repository”Excluded for this repository in the watch menu takes a list of users. Activity by those users in the repository does not notify you. An issue or pull request opened by an excluded user does not notify you either, even when someone else comments on it.
Notification settings
Section titled “Notification settings”Your notification settings at /user/settings/notifications add three sections to Forgejo’s email setting.
Default watch events
Section titled “Default watch events”Default Watch Events sets the events a repository starts with when you watch it. If you have not set them, the instance’s default applies.
Author exclusions
Section titled “Author exclusions”Author Exclusions applies to every repository you watch:
- Username pattern is a regular expression.
Activity by users whose username matches it does not notify you.
For example,
.*\[bot\]$matches usernames that end in[bot]. - Globally excluded users is a list of users whose activity does not notify you in any repository.
Watch on contribution
Section titled “Watch on contribution”Automatically watch repositories when you contribute makes you watch a repository after your first push to it.
If you have not set it, the instance’s AUTO_WATCH_ON_CHANGES setting applies.
Release notifications
Section titled “Release notifications”When a repository you watch with Releases selected publishes a release, you get a release notification. It shows on the Notifications tab of the Inbox with your other notifications, and in the unread count. You can mark it read or unread, but you cannot pin it. You do not get a notification for releases you publish yourself.
Release notifications appear in the web interface only. The notifications API does not list them.
Instance defaults
Section titled “Instance defaults”Admins set the starting events for users who have not chosen their own, in app.ini:
The value is the sum of the selected events: 1 for all issues, 2 for all pull requests, 4 for releases and 8 for participating and mentions.
The default 7 selects all issues, all pull requests and releases.
Differences from Forgejo
Section titled “Differences from Forgejo”In Forgejo, watching a repository notifies you about all its activity, and you cannot narrow it down. Forgejo shows no release notifications in the web interface.