Gitify for YouTrack — a lightweight Tauri v2 desktop app that brings YouTrack Cloud notifications to the system tray with quick actions.
Grab the latest release from the Releases page.
| Platform | File |
|---|---|
| macOS (Apple Silicon) | .dmg (aarch64) |
| macOS (Intel) | .dmg (x86_64) |
| Windows | .msi or .exe |
| Linux (Debian/Ubuntu) | .deb |
| Linux (Other) | .AppImage |
This app is not code-signed. Your OS will block it by default. Follow the instructions below for your platform.
Option A — Right-click to open (simplest):
- Open Finder and navigate to the app (in
/Applicationsor wherever you dragged it) - Right-click (or Control-click) the app and select Open
- A dialog will appear saying the app is from an unidentified developer — click Open
- You only need to do this once; subsequent launches work normally
Option B — Remove the quarantine attribute:
xattr -cr /Applications/YouTrackd.appThen open the app normally.
Option C — System Settings (if the above don't work):
- Try to open the app (it will be blocked)
- Go to System Settings → Privacy & Security
- Scroll down — you'll see a message about YouTrackd being blocked
- Click Open Anyway
When you see the "Windows protected your PC" SmartScreen dialog:
- Click More info
- Click Run anyway
AppImage files need to be made executable first:
chmod +x YouTrackd_*.AppImage
./YouTrackd_*.AppImageFor .deb packages, install with:
sudo dpkg -i youtrackd_*.deb- Rust (stable)
- Node.js (LTS)
- pnpm
- Platform-specific dependencies:
- macOS: Xcode Command Line Tools (
xcode-select --install) - Linux:
sudo apt install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf - Windows: Microsoft C++ Build Tools, WebView2 (pre-installed on Windows 10+)
- macOS: Xcode Command Line Tools (
pnpm install
pnpm tauri devpnpm tauri buildReleases are fully automated via release-please and GitHub Actions. Versions are determined from Conventional Commits.
| Prefix | Version bump | Example |
|---|---|---|
fix: |
Patch (0.1.0 → 0.1.1) |
fix: prevent duplicate notifications |
feat: |
Minor (0.1.0 → 0.2.0) |
feat: add quick-assign action |
feat!: or BREAKING CHANGE: |
Major (0.x → 1.0.0) |
feat!: redesign settings API |
Other prefixes (chore:, docs:, ci:, refactor:, test:) do not trigger a release.
- Push conventional commits to
main— write your commits as usual. - Release PR appears automatically — release-please opens (or updates) a PR titled "chore(main): release vX.Y.Z". This PR bumps versions in
package.json,src-tauri/Cargo.toml, andsrc-tauri/tauri.conf.json, and generatesCHANGELOG.md. - Merge the Release PR — when you're ready to cut a release, merge it.
- Builds run automatically — GitHub Actions builds for macOS (ARM + Intel), Windows, and Linux. This takes roughly 15-20 minutes.
- Review the draft release — Go to GitHub Releases. The workflow creates a draft pre-release with all platform artifacts attached. Review, edit notes if needed, then click Publish release.
| Runner | Target | Artifacts |
|---|---|---|
macos-latest |
aarch64-apple-darwin |
.dmg, .app (Apple Silicon) |
macos-latest |
x86_64-apple-darwin |
.dmg, .app (Intel Mac) |
ubuntu-22.04 |
x86_64-unknown-linux-gnu |
.deb, .AppImage |
windows-latest |
x86_64-pc-windows-msvc |
.msi, .exe |
Before release-please can manage versions, you need to create a baseline tag so it knows where to start counting commits:
# 1. Commit all the release infrastructure (this should already be done)
git add -A
git commit -m "chore: add release-please and CI workflow"
# 2. Create the baseline v0.1.0 tag on this commit
git tag v0.1.0
# 3. Push everything
git push origin main --tagsAfter this, any conventional commits pushed to main will cause release-please to open a Release PR for the next version. You never need to manually create tags again.
This project uses v0.x.y pre-release versioning. All releases are marked as pre-release until v1.0.0.
For the workflow to function, ensure Settings > Actions > General > Workflow permissions is set to Read and write permissions.