File: erc-status-sidebar.el.html

This package provides a HexChat-like sidebar for joined channels in ERC. It relies on the erc-track module, and displays all of the same information that erc-track does in the mode line, but in an alternative format in form of a sidebar.

Shout out to sidebar.el <https://github.com/sebastiencs/sidebar.el> and outline-toc.el <https://github.com/abingham/outline-toc.el> for the sidebar window management ideas.

Usage:

Use M-x erc-status-sidebar-open RET to open the ERC status sidebar in the current frame. Make sure that the erc-track module is active (this is the default).

Use M-x erc-status-sidebar-close RET to close the sidebar on the current frame. With a prefix argument, it closes the sidebar on all frames.

Use M-x erc-status-sidebar-kill RET to kill the sidebar buffer and close the sidebar on all frames.

In addition to the commands above, you can also try the all-in-one entry point erc-bufbar-mode(var)/erc-bufbar-mode(fun). See its doc string for usage.

If you want the status sidebar enabled whenever you use ERC, add bufbar to erc-modules. Note that this library also has a major mode, erc-status-sidebar-mode, which is for internal use.

Defined variables (19)

erc-bufbar-modeNon-nil if Erc-Bufbar mode is enabled.
erc-bufbar-mode-hookHook run after entering or leaving ‘erc-bufbar-mode’.
erc-status-sidebar--active-markerMarker indicating currently active buffer.
erc-status-sidebar--highlight-refresh-triggersTriggers enabled with ‘erc-status-sidebar-highlight-active-buffer’.
erc-status-sidebar--singular-pWhether to restrict the sidebar to a single frame.
erc-status-sidebar-buffer-nameName of the sidebar buffer.
erc-status-sidebar-channel-formatFunction used to format channel names for display in the sidebar.
erc-status-sidebar-channel-sortSorting function used to determine order of channels in the sidebar.
erc-status-sidebar-click-display-actionHow to display a buffer when clicked.
erc-status-sidebar-header-line-formatHeader line format for the status sidebar.
erc-status-sidebar-highlight-active-bufferWhether to highlight the selected window’s buffer in the sidebar.
erc-status-sidebar-mode-abbrev-tableAbbrev table for ‘erc-status-sidebar-mode’.
erc-status-sidebar-mode-hookHook run after entering ‘erc-status-sidebar-mode’.
erc-status-sidebar-mode-line-formatMode line format for the status sidebar.
erc-status-sidebar-mode-mapKeymap for ‘erc-status-sidebar-mode’.
erc-status-sidebar-mode-syntax-tableSyntax table for ‘erc-status-sidebar-mode’.
erc-status-sidebar-refresh-triggersHooks to refresh the sidebar on.
erc-status-sidebar-stylePreset style for rendering the sidebar.
erc-status-sidebar-widthDefault width of the sidebar (in columns).

Defined functions (32)

erc-bufbar-disable()
erc-bufbar-enable()
erc-bufbar-mode(&optional ARG)
erc-status-sidebar--open()
erc-status-sidebar--post-refresh(&rest IGNORE)
erc-status-sidebar--refresh-unless-input()
erc-status-sidebar--set-active-line(ERC-BUFFER)
erc-status-sidebar-all-target-buffers(PROCESS)
erc-status-sidebar-buffer-exists-p()
erc-status-sidebar-click(EVENT)
erc-status-sidebar-close(&optional ALL-FRAMES)
erc-status-sidebar-default-allsort(TARGET-BUFFERS)
erc-status-sidebar-default-chan-format(CHANNAME &optional NUM-MESSAGES ERC-FACE)
erc-status-sidebar-default-chansort(CHANLIST)
erc-status-sidebar-default-insert(CHANNAME CHANBUF CHANLIST)
erc-status-sidebar-display-window()
erc-status-sidebar-get-buffer()
erc-status-sidebar-get-channame(BUFFER)
erc-status-sidebar-get-window(&optional NO-CREATION)
erc-status-sidebar-kill()
erc-status-sidebar-mode()
erc-status-sidebar-mode--unhook()
erc-status-sidebar-open()
erc-status-sidebar-pad-hierarchy(BUFNAME BUFFER BUFLIST)
erc-status-sidebar-prefer-target-as-name(BUFFER)
erc-status-sidebar-recenter(ARG)
erc-status-sidebar-refresh()
erc-status-sidebar-scroll-down(LINES)
erc-status-sidebar-scroll-up(LINES)
erc-status-sidebar-set-window-preserve-size()
erc-status-sidebar-toggle()
erc-status-sidebar-writable(&rest BODY)

Defined faces (0)