Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/patriksvensson/ghostly
Ghostly is a GitHub notification client for Windows 10/11
https://github.com/patriksvensson/ghostly
github github-client uwp windows-10 windows-11
Last synced: about 1 month ago
JSON representation
Ghostly is a GitHub notification client for Windows 10/11
- Host: GitHub
- URL: https://github.com/patriksvensson/ghostly
- Owner: patriksvensson
- License: mit
- Created: 2021-12-31T11:51:44.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-08-14T04:50:24.000Z (over 2 years ago)
- Last Synced: 2024-09-28T22:42:55.095Z (about 2 months ago)
- Topics: github, github-client, uwp, windows-10, windows-11
- Language: C#
- Homepage: https://ghostlyapp.net
- Size: 43.8 MB
- Stars: 282
- Watchers: 7
- Forks: 20
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/funding.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Ghostly
Ghostly is a GitHub notification client for Windows 10/11.
* A lot of notifications can be overwhelming sometimes. Organize your work by categorizing and filtering notifications just like you want to.
* Ghostly is built with offline use as a first class citizen. Synchronize your notifications when you're online and continue using Ghostly like normal when you're offline.
* Keeping track of notifications for issues, PRs, vulnerabilities or releases have never been easier. Ghostly have built in support for things such as rules for incoming notifications, categories, filters and a powerful query language.
* With a lot of notifications - even when categorized properly - it might sometimes be difficult to find that one thing that you're looking for. With the Ghostly query language, your notifications have never been easier to find.
* Whether you prefer a light or a dark theme, Ghostly got you covered. By default Ghostly respects your Windows theme, but you can easily override this in Ghostly's settings.
## How to install
The recommended way of installing Ghostly is via the Microsoft Store.
Ghostly requires Windows 10, version 1809 to run.
## Building Ghostly
### 1) Restore submodules
```
> git submodule init
> git submodule update
```
### 2) Install Cake
```
> dotnet tool restore
```
### 3) Create a GitHub OAUTH application
Go to your GitHub account settings and create a new OAUTH application
at https://github.com/settings/applications/new.
make sure to set the `authorization callback URL` to
`ghostly://github/callback`
After clicking `Register application`, make sure that you click the
button `Generate a new client secret`.
After this is done, write down the Client ID and the generated Client secret.
You're going to need them later to configure Ghostly.
### 4) Generate the code containing the client ID and client secret
From the root of the repository, run the following command.
Don't forget to insert the client ID and client secret from the previous step
```
> dotnet cake bootstrap.cake --client-id "MY-CLIENT-ID" --client-secret "MY-SECRET"
```
Once run, there should be a file at `./src/Ghostly.GitHub/GitHubSecrets.Generated.cs`.
Note that the OAUTH client ID and client secret does not grant you any rights on
behalf of the user who created it, so even though it's not the end of the world if
someone would disassemble our application, this file has been added to the .gitignore
and should not be checked in.
### 5) Build Ghostly
To build a full release for all available platforms, run the following from the command line:
```
> dotnet cake --full
```
Please note that this will take a while.
### 6) Run Ghostly
If everything went fine, there should artifacts available at
`./.artifacts/packages`.