# Gitify

[![CI Workflow][ci-workflow-badge]][github-actions] [![Release Workflow][release-workflow-badge]][github-actions] [![Coverage][coverage-badge]][coverage] [![Quality Gate Status][quality-badge]][quality] [![Renovate enabled][renovate-badge]][renovate] [![Contributors][contributors-badge]][github] [![Downloads - Total][downloads-total-badge]][website] [![Downloads - Latest Release][downloads-latest-badge]][website] [![OSS License][license-badge]][license] [![Latest Release][github-release-badge]][github-releases] [![Homebrew Cask][homebrew-cask-badge]][homebrew-cask]

> Git Notifications on your menu bar. Available on macOS, Windows and Linux.

![Gitify][gitify-social]

---

## Features

- 🔔 Unified notifications from your Git platforms
- ⚒️ Multi-forge: GitHub Cloud, GitHub Enterprise, Gitea, Forgejo, Codeberg
- 💻 Cross-platform: macOS, Windows, and Linux
- 🎨 Customizable settings, filters and themes
- 🖥️ Tray/menu bar integration
- ⚡ Fast, native experience

## Supported forges

Gitify uses a forge adapter pattern so notifications can come from any compatible Git forge, not just GitHub.

| Forge                                           | Status | Notifications | Mark read | Mark done | Unsubscribe | Enriched details |
| ----------------------------------------------- | ------ | :-----------: | :-------: | :-------: | :---------: | :--------------: |
| **GitHub** Cloud                                | ✅     |      ✅       |    ✅     |    ✅     |     ✅      |        ✅        |
| **GitHub** Enterprise Server (< 3.13)           | ✅     |      ✅       |    ✅     |    ❌     |     ✅      |        ✅        |
| **GitHub** Enterprise Server (≥ 3.13)           | ✅     |      ✅       |    ✅     |    ✅     |     ✅      |        ✅        |
| **GitHub** Enterprise Cloud with Data Residency | ✅     |      ✅       |    ✅     |    ✅     |     ✅      |        ✅        |
| **Gitea** (incl. Forgejo, Codeberg)             | ✅     |      ✅       |    ✅     |     —     |      —      |        —         |
| **GitLab** (todos)                              | 💭     |       —       |     —     |     —     |      —      |        —         |
| **Bitbucket** Cloud                             | 💭     |       —       |     —     |     —     |      —      |        —         |
| **Azure DevOps**                                | 💭     |       —       |     —     |     —     |      —      |        —         |
| **Gerrit**                                      | 💭     |       —       |     —     |     —     |      —      |        —         |

<details>
<summary><strong>Status legend</strong></summary>

| Symbol | Meaning                                          |
| ------ | ------------------------------------------------ |
| ✅     | Supported                                        |
| ❌     | Unsupported                                      |
| 🧪     | Experimental (rough edges expected)              |
| 🚧     | In progress (adapter is being worked on)         |
| 💭     | Considering (open to a maintainer picking it up) |

</details>

> [!NOTE]
> _A new forge needs an [adapter](src/renderer/utils/forges/) plus a designated maintainer. See [our contributing guide](CONTRIBUTING.md#multi-forge-support) for the full policy._

## Quick Start

1. **Download** Gitify for free from [gitify.io][website].
2. **Install** and launch the app for your platform.
3. **Authenticate** with one or many supported accounts and start receiving notifications.

#### Homebrew

macOS users can also install via [Homebrew][brew]

```shell
brew install gitify
```

## Build & Development

To build and run Gitify locally:

```shell
pnpm install
pnpm build
pnpm dev
```

See [CONTRIBUTING.md](CONTRIBUTING.md) for full development and contribution instructions.

## FAQ

See our [Gitify FAQs][faqs] for answers to common questions.

## Community & Support

- Open an [issue][github-issues] for bugs or feature requests
- See [CONTRIBUTING.md](CONTRIBUTING.md) for more ways to get involved

## License

Gitify is licensed under the MIT Open Source license.
For more information, see [LICENSE](LICENSE).

<!-- LINK LABELS -->

[website]: https://gitify.io
[faqs]: https://gitify.io/faq
[gitify-social]: https://raw.githubusercontent.com/gitify-app/website/master/public/images/social.png
[github]: https://github.com/gitify-app/gitify
[github-actions]: https://github.com/gitify-app/gitify/actions
[github-issues]: https://github.com/gitify-app/gitify/issues
[github-releases]: https://github.com/gitify-app/gitify/releases/latest
[github-website]: https://github.com/gitify-app/website
[github-website-pulls]: https://github.com/gitify-app/website/pulls
[brew]: https://brew.sh/
[homebrew-cask]: https://formulae.brew.sh/cask/gitify
[coverage-badge]: https://img.shields.io/sonar/coverage/gitify-app_gitify?server=https%3A%2F%2Fsonarcloud.io&logo=sonarqubecloud
[coverage]: https://sonarcloud.io/summary/new_code?id=gitify-app_gitify
[quality-badge]: https://img.shields.io/sonar/quality_gate/gitify-app_gitify?server=https%3A%2F%2Fsonarcloud.io&logo=sonarqubecloud
[quality]: https://sonarcloud.io/summary/new_code?id=gitify-app_gitify
[ci-workflow-badge]: https://img.shields.io/github/actions/workflow/status/gitify-app/gitify/ci.yml?logo=github&label=CI
[release-workflow-badge]: https://img.shields.io/github/actions/workflow/status/gitify-app/gitify/release.yml?logo=github&label=Release
[downloads-total-badge]: https://img.shields.io/github/downloads/gitify-app/gitify/total?label=downloads@all&logo=github
[downloads-latest-badge]: https://img.shields.io/github/downloads/gitify-app/gitify/latest/total?logo=github
[contributors-badge]: https://img.shields.io/github/contributors/gitify-app/gitify?logo=github
[license]: LICENSE
[license-badge]: https://img.shields.io/github/license/gitify-app/gitify?logo=github
[github-release-badge]: https://img.shields.io/github/v/release/gitify-app/gitify?logo=github
[homebrew-cask-badge]: https://img.shields.io/homebrew/cask/v/gitify?logo=homebrew&logoColor=white
[renovate]: https://github.com/gitify-app/gitify/issues/576
[renovate-badge]: https://img.shields.io/badge/renovate-enabled-brightgreen.svg?logo=renovate&logoColor=white