This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/contrib/!irc/erc/README.md
2015-05-25 00:50:38 -04:00

74 lines
2.3 KiB
Markdown

# ERC contribution layer for Spacemacs
<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc/generate-toc again -->
**Table of Contents**
- [ERC contribution layer for Spacemacs](#erc-contribution-layer-for-spacemacs)
- [Description](#description)
- [Features](#features)
- [Install](#install)
- [Layer](#layer)
- [OS X](#os-x)
- [Social graph](#social-graph)
- [Key bindings](#key-bindings)
<!-- markdown-toc end -->
## Description
Layer for [ERC IRC chat][].
## Features
- Highlight nicks (using [erc-hl-nicks][])
- Image inline support (using [erc-image][])
- Logging to ~/.emacs.d/.cache/erc-logs and ViewLogMode for viewing logs
(using [erc-view-log][])
- YouTube videos Thumbnails inline (using [erc-yt][])
- Social Graph for ERC messages (using [erc-social-graph][])
## Install
### Layer
To use this contribution add it to your `~/.spacemacs`
```elisp
(setq-default dotspacemacs-configuration-layers '(erc))
```
### OS X
It's recommended to install the [terminal-notifier gem][] so that you get
notifications via the OS X Notification Center.
### Social graph
[erc-social-graph][] needs graphviz to be installed on your system.
## Key bindings
Key Binding | Description
--------------|------------------------------------------------------------
`<SPC> a i e` | Starts ERC
`<SPC> a i E` | Starts ERC via TLS/SSL
`<SPC> a i i` | Switch to next active ERC buffer
`<SPC> m b` | Switch between ERC buffers
`<SPC> m d` | Interactively input a user action and send it to IRC.
`<SPC> m D` | Draw Social Graph using [erc-social-graph][]
`<SPC> m j` | Join a channel, executes the /join command
`<SPC> m n` | Run "/names #channel" in the current channel.
`<SPC> m l` | Run the /list command
`<SPC> m p` | Part from the channel
`<SPC> m q` | Quit server
**Note** If you want to connect securely to an IRC server, you must run
`erc-tls` command on <kbd>SPC a i E</kbd> instead of the `erc` command.
[ERC IRC chat]: http://www.emacswiki.org/emacs/ERC
[erc-hl-nicks]: https://github.com/leathekd/erc-hl-nicks
[erc-image]: https://github.com/kidd/erc-image.el
[erc-view-log]: https://github.com/Niluge-KiWi/erc-view-log
[erc-yt]: https://github.com/yhvh/erc-yt
[erc-social-graph]: https://github.com/vibhavp/erc-social-graph
[terminal-notifier gem]: https://github.com/alloy/terminal-notifier