Ghlass (named from GitHub Glass) is a macOS application built with SwiftUI that brings a beautiful "Liquid Glass" design to your GitHub notifications.
This project was created with ❤️ + 🤖 by Pochi from TabbyML
It operates within your favorite IDE, VSCode, using a toolkit of commands to execute complex tasks, from code generation to project-wide refactoring.
- Liquid Glass Design: A modern, transparent aesthetic using SwiftUI materials.
- GitHub Integration: Securely sign in with your GitHub Personal Access Token.
- Notification Management: View, filter, and manage your notifications.
- Filter by Repository, Type (Issue, PR, etc.), and Unread status.
- Batch select and mark notifications as done.
- Optimized Performance: Local filtering ensures a smooth experience without constant re-fetching.
- Go to the latest release page
- Download the
Ghlass.dmgfile - Open the DMG and drag
Ghlass.appto your Applications folder
If you encounter a security warning when opening Ghlass (e.g., "cannot be opened because it is from an unidentified developer"), you can remove the quarantine attribute:
xattr -cr /Applications/Ghlass.appThen try opening the app again.
-
Clone the repository.
-
Run with Swift Package Manager:
swift run
-
Create a GitHub Personal Access Token (PAT) with the following scopes:
notifications- Required to read and manage your GitHub notificationsrepo- Required to access issue and pull request details
Click here to create a token with these permissions pre-selected
-
Enter your GitHub Personal Access Token in the Ghlass settings.
To build the .app bundle and a .dmg file for distribution:
-
Ensure you have the icon source file
icon.pngin the root directory if you want to regenerate the icon (optional, asAppIcon.icnsis already generated). -
Run the build script:
./scripts/build_app.sh
This will create
Ghlass.appandGhlass.dmgin the project root directory.