spacemacs/layers/+chat/slack
Benjamin Reynolds 8131ed977a Add various slack keybindings
The only readily available keybinding for joining channels in slack is for
joining public channels. This commit adds bindings for joining private
channels, (called groups in emacs-slack) as well as a keybinding for
slack-select-rooms which allows joining a channel, group, or DM.

This commit also rebinds the major mode `k` to slack-select-rooms, which puts it
more in line with how the related keybinding in the slack client works.
2017-04-28 22:29:43 -04:00
..
img Move slack layer to +chat directory 2016-06-04 00:20:36 -04:00
packages.el Add various slack keybindings 2017-04-28 22:29:43 -04:00
README.org Add various slack keybindings 2017-04-28 22:29:43 -04:00

Slack layer

/TakeV/spacemacs/media/commit/fe564eade5789abb1d410d05cbff499c0bc360c3/layers/+chat/slack/img/slack.png

Description

This layer provides an interface to the Slack chat service via the emacs-slack package. Where possible, this layer aims to reuse keybindings from the IRC packages in Spacemacs.

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add slack to the existing dotspacemacs-configuration-layers list in this file.

Configuration

Follow the instructions in the emacs-slack package for obtaining your client ID, client secret, and token.

To test that everything is alright put the following snippet in your dotspacemacs/user-config() replacing client-id, client-secret and token with your info.

Important Do not keep private data in your dotfile. You can put your private stuff elsewhere (like Dropbox for instance) and load the file in your dotfile.

(slack-register-team
  :name "emacs-slack"
  :default t
  :client-id "my@email.address"
  :client-secret "mypassword"
  :token "token"
  :subscribed-channels '(general slackbot))

Key bindings

Key Binding Description
SPC a C d Direct message someone
SPC a C g Join a group (private channel)
SPC a C j Join a channel
SPC a C q Close connection
SPC a C r Join a channel, group, or direct messge
SPC a C s (Re)connects to Slack
SPC m c Embed mention of channel
SPC m e Edit message at point
SPC m j Join a channel
SPC m d Direct message someone
SPC m m Embed mention of user
SPC m p Load previous messages
SPC m q Quit Slack

The following bindings are provided to mimic bindings in the official Slack client.

Key Binding Description
SPC m @ Embed mention of user
SPC m # Embed mention of channel
SPC m k Join a channel, group, and direct message

In insert state, one can also use @ and # directly without the leader key prefix.