Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yannickglt/alfred-slack
The Slack workflow for Alfred app
https://github.com/yannickglt/alfred-slack
alfred alfred-workflow alfred3-workflow slack
Last synced: about 1 month ago
JSON representation
The Slack workflow for Alfred app
- Host: GitHub
- URL: https://github.com/yannickglt/alfred-slack
- Owner: yannickglt
- License: gpl-2.0
- Created: 2014-08-01T07:32:46.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2021-03-17T22:10:13.000Z (over 3 years ago)
- Last Synced: 2024-06-21T18:14:54.422Z (3 months ago)
- Topics: alfred, alfred-workflow, alfred3-workflow, slack
- Language: PHP
- Homepage:
- Size: 1.19 MB
- Stars: 326
- Watchers: 8
- Forks: 32
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
alfred-slack
============[![Gitter](https://badges.gitter.im/yannickglt/alfred-slack.svg)](https://gitter.im/yannickglt/alfred-slack?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
Open conversation with a contact in Slack
# To start
1. Download and install [Slack.alfredworkflow](https://github.com/packal/repository/raw/master/com.yannickglt.alfred2.slack/slack.alfredworkflow)
2. Create a custom app for your team following [these steps](#create-an-app-for-your-team).
3. Once you have your client ID and Secret, visit the address [https://yannickglt.github.io/alfred-slack/](https://yannickglt.github.io/alfred-slack/) to generate a unique code for authentication in the Workflow.
1. Enter your team name in the first field and your client ID in the second one, then click on the button "Generate code".
![image](https://user-images.githubusercontent.com/1006426/46915167-2494ff80-cfa8-11e8-81cd-25ff613cfdf4.png)
2. Authorize the app to access your Slack team with the rights below.
![image](https://user-images.githubusercontent.com/1006426/46915174-38d8fc80-cfa8-11e8-8aae-9b3da44db2c2.png)
3. Copy your generated unique code in your clipboard.
![image](https://user-images.githubusercontent.com/1006426/46915183-50b08080-cfa8-11e8-9a70-12fe531185e0.png)
4. Launch the slack workflow with the parameter `--add-client` followed by the concatenation of the generated unique code and client Secret separated by a colon (e.g.: `UNIQUE_CODE:CLIENT_SECRET`).
You can add several clients if you want to collaborate with several teams. You just need to repeat the two last steps.
Example:
```
slack --add-client 1234567890.123456789012|1234567890.123456789012.abcdef1234:1234567890abcdef1234567890abcdef
```
5. Launch the cache refresh by taping the command `--refresh`.Example:
```
slack --refresh
```
**The cache refresh may take up to several minutes depending on your organization size.**
6. Enjoy!Note: install the [Packal Updater](http://www.packal.org/workflow/packal-updater) workflow if you want automatic updates.
# How to use
- List channels or groups to open in the Slack app:```
slack
```
![image](https://cloud.githubusercontent.com/assets/1006426/10527597/a4c81c44-7391-11e5-9009-625d1e6957f1.png)- List users to open in the Slack app:
```
slack
```
![image](https://cloud.githubusercontent.com/assets/1006426/10527601/aa77ab3c-7391-11e5-9e04-1b937ef35206.png)- Open a channel, group or user in the Slack app:
```
slack
```
![image](https://user-images.githubusercontent.com/1006426/29512380-5298e878-8662-11e7-9968-1ae765d4d75c.gif)- List messages from a specific channel, group or user:
```
slack
```
![image](https://cloud.githubusercontent.com/assets/1006426/10527030/918dd7f2-738e-11e5-9ea1-4bf74a0dd9cb.png)- Send a message to a channel, group or user:
```
slack
```
![image](https://cloud.githubusercontent.com/assets/1006426/10527561/6966d26c-7391-11e5-8907-ee2999e3ef36.png)- Mark all channels as read
```
slack --mark
```- List the files within the team
```
slack --files
```- List the items starred
```
slack --stars
```- Search both messages and files
```
slack --search
```- Set the user presence (either active or away)
```
slack --presence
```- Set the custom status
```
slack --status
```### Create an app for your team
1. Go to the URL [https://api.slack.com/apps/new](https://api.slack.com/apps/new) and click on the button `Create a Slack app`.![image](https://cloud.githubusercontent.com/assets/1006426/25681953/9067e094-3056-11e7-9f8d-4ea2b0627eff.png)
2. Give it an app name e.g.: "Alfred Workflow", select your team in the list and click on the button `Create App`.
![image](https://cloud.githubusercontent.com/assets/1006426/25682019/d5db3450-3056-11e7-8f24-470463ce6dd5.png)
3. Note the client ID and Secret!
![image](https://cloud.githubusercontent.com/assets/1006426/25771653/e8aba62a-3257-11e7-88e0-050723b7058e.png)
> :warning: Never share the client secret on the web or on public repository
4. Go to the section OAuth & Permissions (under the Features category), add the two redirect URLs `http://yannickglt.github.io/alfred-slack/` and `https://yannickglt.github.io/alfred-slack/` and click on `Save URLs`.
![image](https://user-images.githubusercontent.com/1006426/29512021-5b623578-8661-11e7-96b4-6650e735b4f4.png)