Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pehlicd/Slack-DND
Simple status bar app for managing Slack DND mode.
https://github.com/pehlicd/Slack-DND
Last synced: 26 days ago
JSON representation
Simple status bar app for managing Slack DND mode.
- Host: GitHub
- URL: https://github.com/pehlicd/Slack-DND
- Owner: pehlicd
- License: mit
- Created: 2022-10-29T19:04:23.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-22T17:46:00.000Z (5 months ago)
- Last Synced: 2024-08-03T09:04:31.318Z (4 months ago)
- Language: Python
- Size: 40 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- Mac-Menubar-Megalist - Slack DND
README
# Slack DND 💤
```
_____ __ __ ____ _ ______
/ ___// /___ ______/ /__ / __ \/ | / / __ \
\__ \/ / __ `/ ___/ //_/ / / / / |/ / / / /
___/ / / /_/ / /__/ ,< / /_/ / /| / /_/ /
/____/_/\__,_/\___/_/|_| /_____/_/ |_/_____/
```
Slack DND is a simple MacOS status bar application that allows you to set your Slack status to Do Not Disturb (DND) mode.
It is useful for those who want to avoid distractions during their work hours.
## Configuration
Slack DND requires a Slack API token to work. You can get one by following the instructions below:
1. Go to https://api.slack.com
2. Create an app (or use an existing one) with selecting **from scratch** option.
3. From the sidebar, go to **OAuth & Permissions** and scroll down to the **User Token Scopes** section.
4. Give following permissions to your app:
- `dnd:write`
- `dnd:read`
5. Install the app to your workspace. After installation, you will see a **User OAuth Access Token**. Copy it and paste it to the Slack DND app at startup for once. (You can also change it later from the app's configuration file `$HOME/.slack-dnd/config.json`.)
## Installation
### From Releases
Run following command in your favorite terminal:
```bash
curl -sL https://github.com/pehlicd/Slack-DND/releases/download/latest/Slack.DND.tar.gz | tar -zx -C /Applications
```
### From Source Code
1. Clone the repository and navigate to the project directory.
2. Install required dependencies with `pip3 install -r requirements.txt`.
3. Run `python3 setup.py py2app` to build the application.
4. Copy the application to your Applications folder with `cp dist/Slack\ DND.app/Contents/MacOS/Slack\ DND ~/Applications/Slack\ DND` command.
5. You are ready to go! Run **Slack DND** 💤
## Contribution
See [Contribution Guide](CONTRIBUTING.md).