https://github.com/efskap/discord-notify
💬 Standalone notification program for Discord.
https://github.com/efskap/discord-notify
discord discord-notifications linux ripcord tray windows
Last synced: 5 months ago
JSON representation
💬 Standalone notification program for Discord.
- Host: GitHub
- URL: https://github.com/efskap/discord-notify
- Owner: efskap
- Created: 2020-04-30T01:22:19.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2021-12-17T08:25:20.000Z (over 4 years ago)
- Last Synced: 2024-06-20T08:10:14.592Z (about 2 years ago)
- Topics: discord, discord-notifications, linux, ripcord, tray, windows
- Language: Go
- Homepage:
- Size: 96.7 KB
- Stars: 18
- Watchers: 2
- Forks: 3
- Open Issues: 8
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
#  discord-notify
### Shows your Discord notifications, because Ripcord kinda doesn't.
Companion app for [Ripcord](https://cancel.fm/ripcord/) to supplant its notification system.
Targets Linux, but should work on Windows (only tested in Wine, albeit with some systray issues).
* Uses regular Discord notification settings.
* Displays notifications (w/ avatar) through your OS.
* But not when Ripcord is focused.
* Plays a sound (comes with Discord and Skype sounds)
* Shows an icon in the system tray
[Ripcord](https://cancel.fm/ripcord/) is an amazing alternative Discord client, largely because native programs tend to be snappier.
However, its notifications support is rather lacklustre, without a sound, and in plain text. Heck, until recently it didn't even tell you the name of the sender. Unfortunately it's closed source shareware, so I can't go in and tweak it to my liking.
## Install
### Latest pre-built binary
#### [Linux](https://github.com/efskap/discord-notify/releases/download/latest/discord-notify)
#### [Windows](https://github.com/efskap/discord-notify/releases/download/latest/discord-notify.exe)
### From source
```sh
git clone https://github.com/efskap/discord-notify
cd discord-notify
go generate && go install
```
(simply doing `go install https://github.com/efskap/discord-notify` as normal won't work because I'm using `replace` in `go.mod` for now... sorry)
## Usage
```sh
$ discord-notify -h
Usage of discord-notify:
-list-sounds
List available built-in sounds.
-sound string
MP3 to play on notifications (default "disc")
-systray
Show an icon in the system tray (default true)
-t string
Discord token
$ discord-notify -sound skaip -t your.token.abc
$ discord-notify -sound none -t your.token.abc -systray=false # muted with no system tray
```
There's no installer so just create a startup script that executes `discord-notify` with the token and sound you want.
You can pass in the token with `-t`, or for convenience put it in a file called `discord.token` in `$XDG_CONFIG_HOME` or one of `XDG_CONFIG_DIRS`.
e.g. On Linux it can go in `~/.config/discord.token` or `/etc/xdg/discord.token`, and on Windows it should be `%UserProfile%\Local Settings\Application Data\discord.token`
Built-in notification sounds can be selected through the system tray as well, but the chosen one is not saved as there's no mutable config yet. Custom sounds have to be passed on the command line because I haven't integrated a filepicker yet.