Want to take your software engineering career to the next level? Join the mailing list for career tips & advice Click here


slack client for emacs

Subscribe to updates I use emacs-slack

Statistics on emacs-slack

Number of watchers on Github 504
Number of open issues 50
Average time to close an issue 14 days
Main language Emacs Lisp
Average time to merge a PR about 23 hours
Open pull requests 8+
Closed pull requests 0+
Last commit over 2 years ago
Repo Created over 4 years ago
Repo Last Updated over 2 years ago
Size 1.18 MB
Organization / Authoryuya373
Page Updated
Do you use emacs-slack? Leave a review!
View open issues (50)
View emacs-slack activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Software engineers: It's time to get promoted. Starting NOW! Subscribe to my mailing list and I will equip you with tools, tips and actionable advice to grow in your career.
Evaluating emacs-slack for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


Emacs client for Slack




How to get token

;; I'm using use-package and el-get and evil

(el-get-bundle slack)
(use-package slack
  :commands (slack-start)
  (setq slack-buffer-emojify t) ;; if you want to enable emoji, default nil
  (setq slack-prefer-current-team t)
   :name "emacs-slack"
   :default t
   :client-id "aaaaaaaaaaa.00000000000"
   :client-secret "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
   :token "aaaa-sssssssssss-88888888888-hhhhhhhhhhh-jjjjjjjjjj"
   :subscribed-channels '(test-rename rrrrr)
   :full-and-display-names t

   :name "test"
   :client-id "3333333333.77777777777"
   :client-secret "cccccccccccccccccccccccccccccccc"
   :token "xxxx-yyyyyyyyyy-zzzzzzzzzzz-hhhhhhhhhhh-llllllllll"
   :subscribed-channels '(hoge fuga))

  (evil-define-key 'normal slack-info-mode-map
    ",u" 'slack-room-update-messages)
  (evil-define-key 'normal slack-mode-map
    ",c" 'slack-buffer-kill
    ",ra" 'slack-message-add-reaction
    ",rr" 'slack-message-remove-reaction
    ",rs" 'slack-message-show-reaction-users
    ",pl" 'slack-room-pins-list
    ",pa" 'slack-message-pins-add
    ",pr" 'slack-message-pins-remove
    ",mm" 'slack-message-write-another-buffer
    ",me" 'slack-message-edit
    ",md" 'slack-message-delete
    ",u" 'slack-room-update-messages
    ",2" 'slack-message-embed-mention
    ",3" 'slack-message-embed-channel
    "\C-n" 'slack-buffer-goto-next-message
    "\C-p" 'slack-buffer-goto-prev-message)
   (evil-define-key 'normal slack-edit-message-mode-map
    ",k" 'slack-message-cancel-edit
    ",s" 'slack-message-send-from-buffer
    ",2" 'slack-message-embed-mention
    ",3" 'slack-message-embed-channel))

(use-package alert
  :commands (alert)
  (setq alert-default-style 'notifier))

How to get token (the easy way)

  1. Log into the Slack team you're interested in with a web browser
  2. Open DevTools
  3. Open Network tab
  4. Search for (Ctrl-F) xoxs- and copy token from Query String Parameters

How to get token (the harder yet officially sanctioned way)

1. Get client-id and client-secret

  1. Go to https://api.slack.com/apps.
  2. Click Create New App.
  3. Fill App Name and Development Slack Team and click Create App.
  4. Client ID and Client Secret are listed in the App Credentials section.

2. Configure Redirect URL

  1. Click Permissions in the Add features and functionality of Building Apps for Slack section.
  2. Fill in the Redirect URLs section (slack-emacs defaults to: http://localhost:8080).
  3. click Save URLs.

3. Get token

  1. Call slack-register-team with above Client ID and Client Secret (ignore the Token prompt [i.e., just hit enter.]).
  2. Emacs' prompt will display: Enter the code your browser displayed:.
  3. Code appears in the browser's address bar like http://localhost:8080?code=181818181818.1819919191&state=, enter this code in the previous Emacs' prompt.
  4. Once you activate emacs-slack, token appears in the URL like: https://api.slack.com/apps/{APPID}/oauth.
  5. Save your token and pass it to the slack-register-team function along with the Client ID and Client Secret.


emacs-slack uses websocket to communicate with Slack, and need request to rtm.start method (you can also test your settings in that page's Tester tab to make sure things have been configured correctly). this request needs client scope when authorize and Slack does not yet have client scope in new OAuth scope. make sure slack-oauth2-auth requesting with client scope and prevent token migration. token_migration

How to use

I recommend to chat with slackbot for tutorial using slack-im-select.

Some terminology in the slack- functions:

  • im: An IM (instant message) is a direct message between you and exactly one other Slack user.
  • channel: A channel is a Slack channel which you are a member of
  • group. Any chat (direct message or channel) which isn't an IM is a group.

  • slack-register-team

    • set team configuration and create team.
    • :name, :client-id, and :client-secret are needed for arguments
  • slack-change-current-team

    • change slack-current-team var
  • slack-start

    • do authorize and initialize
  • slack-ws-close

    • turn off websocket connection
  • slack-group-select

    • select group from list
  • slack-im-select

    • select direct message from list
  • slack-channel-select

    • select channel from list
  • slack-group-list-update

    • update group list
  • slack-im-list-update

    • update direct message list
  • slack-channel-list-update

    • update channel list
  • slack-message-embed-mention

    • use to mention to user
  • slack-message-embed-channel

    • use to mention to channel
  • slack-file-upload

    • uploads a file
    • the command allows to choose many channels via select loop. In order to finish the loop input an empty string. For helm that's C+RET or M+TET. In case of Ivy it's C+M+j.


See alert.

emacs-slack open issues Ask a question     (View All Issues)
  • over 3 years Emacs 25 Support
  • over 3 years Can I scroll to bottom after jumping to a DM / channel?
  • over 3 years Alerts from direct messages can be improved
  • over 3 years Warning when linking youtube video
  • over 3 years [Documentation] `slack-message-custom-notifier` object arguments
  • almost 4 years Only first slack-register-team call seems to work
  • almost 4 years Rooms with unread messages / notifications
  • almost 4 years Support object scopes
  • almost 4 years Please create a release for melpa stable
  • almost 4 years persistent notification
  • almost 4 years Emacs freeze frequently
  • about 4 years All chat messages are displayed in the minibuffer
  • over 4 years Error (websocket): in callback `on-message': error: "Invalid search bound (wrong side of point)"
  • over 4 years Read credentials from authinfo file
  • over 4 years Alternate colors for nicks
  • over 4 years Direct messages do not not raise a mode line alert
  • over 4 years Update README with instructions on how to use emacs-slack?
emacs-slack open pull requests (View All Pulls)
  • Handle bot messages without text
  • Add company backend for slack
  • Escape & link messages
  • add `slack-buffer-buttonize-link` to `lui-pre-output-hook`
  • on buffer update, create buffer if it doesn't yet exist
  • Offload editing to lui
  • basic mpim support + some additional configurability
  • only delete editor window if there are more windows in frame
emacs-slack list of languages used
Other projects in Emacs Lisp