b5a82133ca
Do I really need the copyright symbol? I love how the proselint insists that I use the unicode character (which unicoding all the files sounds great to me). What could go wrong there? :-D
140 lines
4.6 KiB
Org Mode
140 lines
4.6 KiB
Org Mode
#+TITLE: IRC and Bitlbee Interface
|
|
#+AUTHOR: Howard X. Abrams
|
|
#+DATE: 2020-12-10
|
|
#+FILETAGS: :emacs:
|
|
|
|
A literate programming configuration file for IRC communiction.
|
|
|
|
#+BEGIN_SRC emacs-lisp :exports none
|
|
;;; ha-irc.el --- configuration for IRC communication. -*- lexical-binding: t; -*-
|
|
;;
|
|
;; © 2020-2022 Howard X. Abrams
|
|
;; This work is licensed under a Creative Commons Attribution 4.0 International License.
|
|
;; See http://creativecommons.org/licenses/by/4.0/
|
|
;;
|
|
;; Author: Howard X. Abrams <http://gitlab.com/howardabrams>
|
|
;; Maintainer: Howard X. Abrams
|
|
;; Created: December 10, 2020
|
|
;;
|
|
;; This file is not part of GNU Emacs.
|
|
;;
|
|
;; *NB:* Do not edit this file. Instead, edit the original literate file at:
|
|
;; ~/other/hamacs/ha-irc.org
|
|
;; And tangle the file to recreate this one.
|
|
;;
|
|
;;; Code:
|
|
#+END_SRC
|
|
* Introduction
|
|
My IRC /needs/ are basic, but I'm not sure which I want to use.
|
|
** Circe
|
|
The [[https://github.com/emacs-circe/circe][circe project]] (see the [[http://www.nongnu.org/circe/][old site]]) looks intriguing, and is still supported. See the [[https://github.com/emacs-circe/circe/wiki][wiki documentation]], but it has good defaults.
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(use-package circe
|
|
:init
|
|
(setq circe-reduce-lurker-spam t
|
|
lui-flyspell-p t
|
|
circe-network-options
|
|
'(("howardabrams.com"
|
|
:tls nil
|
|
:nick "howard-abrams"
|
|
:port 7777
|
|
:sasl-username "howard-abrams")))
|
|
:config
|
|
;; Trick to ignore the PART and QUIT messages:
|
|
(circe-set-display-handler "PART" (lambda (&rest ignored) nil))
|
|
(circe-set-display-handler "QUIT" (lambda (&rest ignored) nil))
|
|
|
|
(require 'circe-color-nicks)
|
|
(enable-circe-color-nicks))
|
|
#+END_SRC
|
|
* ZNC Server
|
|
I'm using my own ZNC server, and I need to log in with a password stored in my GPG auth storage:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(defun ha-circe-reconnect-password ()
|
|
"Send the reconnection password string."
|
|
(interactive)
|
|
|
|
(let* ((auth-results (auth-source-search :host "howardabrams.com" :port 7777 :max 1))
|
|
(auth-first (first auth-results))
|
|
(username (plist-get auth-first :user))
|
|
(password (funcall (plist-get auth-first :secret))))
|
|
(circe-command-QUOTE (format "PASS %s:%s" username password))))
|
|
#+END_SRC
|
|
|
|
But now we can call both the reconnect, as well as the password:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(defun ha-circe-reconnect ()
|
|
"Overlay interface to reconnect to my IRC server."
|
|
(interactive)
|
|
(circe-reconnect)
|
|
(sit-for 3)
|
|
(ha-circe-reconnect-password))
|
|
#+END_SRC
|
|
|
|
* Key Bindings
|
|
Quick way to start and jump to my IRC world.
|
|
#+BEGIN_SRC emacs-lisp
|
|
(defun ha-irc-persp-start ()
|
|
"Create an IRC workspace and start my IRC client."
|
|
(interactive)
|
|
(persp-switch "irc")
|
|
(circe "howardabrams.com"))
|
|
|
|
(defun ha-irc-persp-switch ()
|
|
"Switch to the IRC workspace and load the next buffer."
|
|
(interactive)
|
|
(persp-switch "irc")
|
|
(tracking-next-buffer))
|
|
#+END_SRC
|
|
|
|
And some global keys to display them:
|
|
#+BEGIN_SRC emacs-lisp
|
|
(ha-leader
|
|
"a i" '("irc switch" . ha-irc-persp-switch)
|
|
"a I" '("irc start" . ha-irc-persp-start))
|
|
#+END_SRC
|
|
|
|
Let's create a leader for this mode:
|
|
#+BEGIN_SRC emacs-lisp
|
|
(general-create-definer ha-circe-leader
|
|
:states '(normal visual motion)
|
|
:keymaps '(circe-channel-mode-map circe-server-mode-map)
|
|
:prefix "SPC m"
|
|
:global-prefix "<f17>"
|
|
:non-normal-prefix "S-SPC")
|
|
#+END_SRC
|
|
|
|
And a quick shortcut to call it:
|
|
#+BEGIN_SRC emacs-lisp
|
|
(ha-circe-leader
|
|
"o" '("next channel" . tracking-next-buffer)
|
|
"r" '("reconnect" . ha-circe-reconnect)
|
|
"p" '("send password" . ha-circe-reconnect-password))
|
|
#+END_SRC
|
|
* Display Configuration
|
|
Using the [[https://github.com/seagle0128/doom-modeline][Doom Modeline]] to add notifications:
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq doom-modeline-irc t)
|
|
(setq doom-modeline-irc-stylize 'identity)
|
|
#+END_SRC
|
|
* Technical Artifacts :noexport:
|
|
This will =provide= a code name, so that we can =require= this.
|
|
|
|
#+BEGIN_SRC emacs-lisp :exports none
|
|
(provide 'ha-irc)
|
|
;;; ha-irc.el ends here
|
|
#+END_SRC
|
|
|
|
#+DESCRIPTION: A literate programming configuration file for IRC.
|
|
|
|
#+PROPERTY: header-args:sh :tangle no
|
|
#+PROPERTY: header-args:emacs-lisp :tangle yes
|
|
#+PROPERTY: header-args :results none :eval no-export :comments no mkdirp yes
|
|
|
|
#+OPTIONS: num:nil toc:nil todo:nil tasks:nil tags:nil date:nil
|
|
#+OPTIONS: skip:nil author:nil email:nil creator:nil timestamp:nil
|
|
#+INFOJS_OPT: view:nil toc:nil ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js
|