902 lines
26 KiB
HTML
902 lines
26 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en"><head>
|
||
<link rel="preload" href="../static/fonts/comfortaa-v30-subset-regular.woff2" as="font" type="font/woff2" crossorigin>
|
||
<link rel="preload" href="../static/fonts/ubuntu-v15-latin-regular.woff2" as="font" type="font/woff2" crossorigin>
|
||
<link rel="preload" href="../static/fonts/ubuntu-v15-subset-500.woff2" as="font" type="font/woff2" crossorigin>
|
||
<link rel="preload" href="../static/img/libera-color.svg" as="image" type="image/svg+xml">
|
||
<meta charset="utf-8">
|
||
<meta content="IE=edge" http-equiv="X-UA-Compatible">
|
||
<meta content="width=device-width, initial-scale=1" name="viewport"><!-- Begin Jekyll SEO tag v2.8.0 -->
|
||
<title>Configuring SASL for Emacs ERC | Libera Chat</title>
|
||
<meta name="generator" content="Jekyll v3.9.2" />
|
||
<meta property="og:title" content="Configuring SASL for Emacs ERC" />
|
||
<meta property="og:locale" content="en_GB" />
|
||
<meta name="description" content="These instructions were originally contributed by androclus. Thanks!" />
|
||
<meta property="og:description" content="These instructions were originally contributed by androclus. Thanks!" />
|
||
<link rel="canonical" href="emacs-erc.html" />
|
||
<meta property="og:url" content="https://libera.chat/guides/emacs-erc" />
|
||
<meta property="og:site_name" content="Libera Chat" />
|
||
<meta property="og:type" content="article" />
|
||
<meta property="article:published_time" content="2022-10-03T18:36:48+00:00" />
|
||
<meta name="twitter:card" content="summary" />
|
||
<meta property="twitter:title" content="Configuring SASL for Emacs ERC" />
|
||
<meta name="twitter:site" content="@liberachat" />
|
||
<meta property="article:publisher" content="liberachat" />
|
||
<script type="application/ld+json">
|
||
{"@context":"https://schema.org","@type":"TechArticle","dateModified":"2022-10-03T18:36:48+00:00","datePublished":"2022-10-03T18:36:48+00:00","description":"These instructions were originally contributed by androclus. Thanks!","headline":"Configuring SASL for Emacs ERC","url":"https://libera.chat/guides/emacs-erc"}</script>
|
||
<!-- End Jekyll SEO tag -->
|
||
<link rel="icon" type="image/svg+xml" href="../static/img/libera-color.svg">
|
||
<link rel="alternate icon" href="../favicon.ico">
|
||
<!-- Stylesheets -->
|
||
<style>/*! modern-normalize v1.0.0 | MIT License | https://github.com/sindresorhus/modern-normalize */
|
||
*,::after,::before{box-sizing:border-box}:root{-moz-tab-size:4;tab-size:4}html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}body{font-family:system-ui,-apple-system,'Segoe UI',Roboto,Helvetica,Arial,sans-serif,'Apple Color Emoji','Segoe UI Emoji'}hr{height:0;color:inherit}abbr[title]{text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Consolas,'Liberation Mono',Menlo,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}::-moz-focus-inner{border-style:none;padding:0}:-moz-focusring{outline:1px dotted ButtonText}:-moz-ui-invalid{box-shadow:none}legend{padding:0}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}</style>
|
||
<style>@font-face {
|
||
/* comfortaa-regular - subset */
|
||
font-family: 'Comfortaa';
|
||
src: url('../static/fonts/comfortaa-v30-subset-regular.woff2') format('woff2'), url('../static/fonts/comfortaa-v30-subset-regular.woff') format('woff'), url('../static/fonts/comfortaa-v30-subset-regular.ttf') format('truetype');
|
||
font-style: normal;
|
||
font-weight: 400;
|
||
font-display: swap;
|
||
/* . C L a b e h i r t */
|
||
unicode-range: U+002E, U+0043, U+004C, U+0061-0062, U+0065, U+0068-0069, U+0072, U+0074;
|
||
}
|
||
|
||
@font-face {
|
||
/* ubuntu-regular - latin */
|
||
font-family: 'Ubuntu';
|
||
src: local(''), url('../static/fonts/ubuntu-v15-latin-regular.woff2') format('woff2'), url('../static/fonts/ubuntu-v15-latin-regular.woff') format('woff'), url('../static/fonts/ubuntu-v15-latin-regular.ttf') format('truetype');
|
||
font-style: normal;
|
||
font-weight: 400;
|
||
font-display: swap;
|
||
}
|
||
|
||
@font-face {
|
||
/* ubuntu-500 - subset */
|
||
font-family: 'Ubuntu';
|
||
src: local(''), url('../static/fonts/ubuntu-v15-subset-500.woff2') format('woff2'), url('../static/fonts/ubuntu-v15-subset-500.woff') format('woff'), url('../static/fonts/ubuntu-v15-subset-500.ttf') format('truetype');
|
||
font-style: normal;
|
||
font-weight: 500;
|
||
font-display: swap;
|
||
/* C c e n o t */
|
||
unicode-range: U+0043 U+0063 U+0065 U+006E U+006F U+0074;
|
||
}
|
||
|
||
:root {
|
||
--header-height: 4rem;
|
||
--content-inline-padding: 1.3rem;
|
||
--content-max-width: 80ch;
|
||
/* define our palette for all themes */
|
||
--white: #fff;
|
||
--gray-100: #f3f4f6;
|
||
--gray-200: #e5e7eb;
|
||
--gray-300: #d1d5db;
|
||
--gray-400: #9ca3af;
|
||
--gray-800: #1f2937;
|
||
--gray-900: #111827;
|
||
--brand-purple: #5555ff;
|
||
--brand-pink: #ff55dd;
|
||
/* light-theme vars */
|
||
--c-bg: var(--gray-100);
|
||
--c-bg-secondary: var(--white);
|
||
--c-text: var(--gray-800);
|
||
--c-border: var(--gray-300);
|
||
--c-hl: var(--brand-pink);
|
||
--c-hl-secondary: var(--brand-purple);
|
||
--c-text-on-hl: var(--gray-800);
|
||
--c-text-on-hl-secondary: var(--white);
|
||
}
|
||
|
||
@media (prefers-color-scheme: dark) {
|
||
:root {
|
||
--c-bg: var(--gray-800);
|
||
--c-bg-secondary: var(--gray-900);
|
||
--c-text: var(--gray-200);
|
||
--c-border: var(--gray-400);
|
||
}
|
||
}
|
||
|
||
* {
|
||
color: var(--c-text);
|
||
box-sizing: border-box;
|
||
font-family: Ubuntu, sans-serif;
|
||
letter-spacing: .1ch;
|
||
}
|
||
|
||
main *, .hero * {
|
||
line-height: 1.5;
|
||
}
|
||
|
||
body {
|
||
background-color: var(--c-bg);
|
||
min-height: 100vh;
|
||
display: grid;
|
||
grid-template-rows: var(--header-height) min-content auto auto min-content;
|
||
grid-template-columns: 1fr;
|
||
grid-template-areas: "header" "hero" "main" "aside" "footer";
|
||
}
|
||
|
||
a {
|
||
text-decoration: underline;
|
||
text-underline-offset: .05rem;
|
||
}
|
||
|
||
a:hover {
|
||
text-underline-offset: .25rem;
|
||
color: var(--c-hl);
|
||
}
|
||
|
||
h1, h2, h3, h4, h5, h6, p {
|
||
word-break: break-word;
|
||
scroll-margin-block-start: 4.5rem;
|
||
}
|
||
|
||
h1, h2, h3, h4, h5, h6, strong {
|
||
font-weight: 500;
|
||
}
|
||
|
||
em {
|
||
font-style: italic;
|
||
}
|
||
|
||
h1, h2, h3, h4, h5, h6 {
|
||
margin-block-end: 0;
|
||
}
|
||
|
||
h1+*, h2+*, h3+*, h4+*, h5+*, h6+* {
|
||
margin-block-start: 0;
|
||
}
|
||
|
||
main h1 {
|
||
font-size: 2.25rem;
|
||
}
|
||
|
||
main h2 {
|
||
font-size: 1.5rem;
|
||
}
|
||
|
||
main h3 {
|
||
font-size: 1.25rem;
|
||
}
|
||
|
||
main :is(h2, h3, h4, h5, h6) a {
|
||
text-decoration: none;
|
||
position: relative;
|
||
}
|
||
|
||
main :is(h2, h3, h4, h5, h6) a:hover::before {
|
||
content: '#';
|
||
position: absolute;
|
||
left: -1.5ch;
|
||
bottom: 0;
|
||
font-weight: normal;
|
||
font-size: 1rem;
|
||
}
|
||
|
||
@media screen and (min-width: 800px) {
|
||
body {
|
||
grid-template-columns: min-content 8fr;
|
||
grid-template-rows: 4rem min-content auto min-content;
|
||
grid-template-areas: "header header" "hero hero" "aside main" "footer footer";
|
||
}
|
||
}
|
||
|
||
.skiplink {
|
||
z-index: 9999;
|
||
transform: translateY(calc(-100% - 1rem));
|
||
display: block;
|
||
position: absolute;
|
||
height: 4rem;
|
||
padding: var(--content-inline-padding);
|
||
background-color: var(--c-bg);
|
||
border-inline-end: 1px solid var(--c-border);
|
||
border-block-end: 1px solid var(--c-border);
|
||
}
|
||
|
||
.skiplink:focus {
|
||
z-index: 9999;
|
||
transform: translateY(0);
|
||
}
|
||
|
||
header {
|
||
grid-area: header;
|
||
height: var(--header-height);
|
||
border-block-end: 1px solid var(--c-border);
|
||
background-color: var(--c-bg-secondary);
|
||
position: sticky;
|
||
top: 0;
|
||
z-index: 1000;
|
||
display: flex;
|
||
flex-direction: row;
|
||
flex-wrap: nowrap;
|
||
justify-content: space-between;
|
||
}
|
||
|
||
header a {
|
||
text-decoration: none;
|
||
}
|
||
|
||
header .logo {
|
||
display: flex;
|
||
flex-wrap: nowrap;
|
||
align-items: center;
|
||
height: 100%;
|
||
padding-inline-start: var(--content-inline-padding);
|
||
}
|
||
|
||
header .logo img {
|
||
padding-block-end: .3rem;
|
||
}
|
||
|
||
header .logo h1 {
|
||
margin: 0;
|
||
margin-bottom: -.4rem;
|
||
font-size: 1.7rem;
|
||
line-height: 1;
|
||
font-family: Comfortaa, Ubuntu, sans-serif;
|
||
font-weight: bold;
|
||
}
|
||
|
||
header .nav-toggle {
|
||
display: block;
|
||
border-inline-start: 1px solid var(--c-border);
|
||
padding: 0 1rem;
|
||
display: flex;
|
||
align-items: center;
|
||
cursor: pointer;
|
||
}
|
||
|
||
header nav details summary, header nav a {
|
||
border-block-end: 1px solid var(--c-border);
|
||
padding: 1rem;
|
||
display: flex;
|
||
align-items: center;
|
||
cursor: pointer;
|
||
white-space: nowrap;
|
||
}
|
||
|
||
header nav details summary::before {
|
||
content: "►";
|
||
padding-inline-end: .3rem;
|
||
}
|
||
|
||
header nav details[open] summary::before {
|
||
content: "▼";
|
||
}
|
||
|
||
header nav .nav-close {
|
||
display: none;
|
||
}
|
||
|
||
header nav.show .nav-close {
|
||
display: flex;
|
||
}
|
||
|
||
header nav {
|
||
transform: translateY(calc(-100% - 1rem));
|
||
display: flex;
|
||
flex-direction: column;
|
||
justify-content: flex-start;
|
||
position: fixed;
|
||
right: 0;
|
||
top: 0;
|
||
bottom: 0;
|
||
background-color: var(--c-bg-secondary);
|
||
min-width: 20rem;
|
||
max-width: 30rem;
|
||
border-inline-start: 1px solid var(--c-border);
|
||
z-index: 10000;
|
||
}
|
||
|
||
header nav.show, header nav:focus-within {
|
||
transform: translateY(0);
|
||
}
|
||
|
||
header nav details summary.highlight, header nav a.highlight {
|
||
background-color: var(--c-hl);
|
||
color: var(--c-text-on-hl);
|
||
font-weight: 500;
|
||
}
|
||
|
||
header nav details summary:hover, header nav a:hover {
|
||
background-color: var(--c-bg);
|
||
}
|
||
|
||
header nav details summary.highlight:hover, header nav a.highlight:hover {
|
||
background-color: var(--c-hl-secondary);
|
||
color: var(--c-text-on-hl-secondary);
|
||
}
|
||
|
||
header nav details {
|
||
display: flex;
|
||
flex-direction: column;
|
||
position: relative;
|
||
}
|
||
|
||
header nav details a {
|
||
padding-inline-start: 2.5rem;
|
||
}
|
||
|
||
@media screen and (min-width: 950px) {
|
||
header .nav-toggle, header .nav-close, header nav.show .nav-close {
|
||
display: none;
|
||
}
|
||
header nav {
|
||
transform: initial;
|
||
display: flex;
|
||
flex-direction: row;
|
||
justify-content: flex-end;
|
||
position: initial;
|
||
background-color: initial;
|
||
min-width: unset;
|
||
max-width: unset;
|
||
border-inline-start: none;
|
||
}
|
||
header nav.show, header nav:focus-within {
|
||
transform: initial;
|
||
}
|
||
header nav details summary, header nav a {
|
||
border-block-end: none;
|
||
border-inline-start: 1px solid var(--c-border);
|
||
border-inline-end: 1px solid var(--c-border);
|
||
padding: 0 1rem;
|
||
display: flex;
|
||
margin-inline-start: -1px;
|
||
align-items: center;
|
||
height: 100%;
|
||
}
|
||
header nav details:last-of-type summary {
|
||
border-inline-end: none;
|
||
}
|
||
header nav details[open] summary {
|
||
border-block-end: 1px solid var(--c-border);
|
||
height: calc(100% + 1px);
|
||
}
|
||
header nav details div {
|
||
position: absolute;
|
||
right: 0;
|
||
}
|
||
header nav details div a {
|
||
background-color: var(--c-bg-secondary);
|
||
border-block-end: 1px solid var(--c-border);
|
||
padding: 1rem;
|
||
}
|
||
}
|
||
|
||
main {
|
||
grid-area: main;
|
||
padding: 0 var(--content-inline-padding);
|
||
max-width: var(--content-max-width);
|
||
min-width: 0;
|
||
width: 100%;
|
||
margin: 2rem auto;
|
||
}
|
||
|
||
nav.article-nav {
|
||
display: flex;
|
||
flex-direction: row;
|
||
justify-content: center;
|
||
}
|
||
|
||
nav.article-nav div {
|
||
width: 33%;
|
||
text-align: center;
|
||
}
|
||
|
||
footer {
|
||
grid-area: footer;
|
||
align-self: end;
|
||
background-color: var(--c-bg-secondary);
|
||
border-block-start: 1px solid var(--c-border);
|
||
padding: .5rem var(--content-inline-padding);
|
||
display: flex;
|
||
flex-direction: row;
|
||
flex-wrap: wrap;
|
||
justify-content: space-between;
|
||
}
|
||
|
||
footer div {
|
||
line-height: 2;
|
||
}
|
||
|
||
footer div .mobile-hide {
|
||
display: none;
|
||
}
|
||
|
||
footer div a {
|
||
white-space: nowrap;
|
||
}
|
||
|
||
footer div a:not([rel*=license]), footer div .copyright {
|
||
display: block;
|
||
}
|
||
|
||
@media screen and (min-width: 800px) {
|
||
footer div {
|
||
line-height: 1.5;
|
||
}
|
||
|
||
footer div:last-of-type {
|
||
padding-inline-start: 1rem;
|
||
}
|
||
|
||
footer div .mobile-hide {
|
||
display: inline;
|
||
}
|
||
|
||
footer div a:not([rel*=license]), footer div .copyright {
|
||
display: initial;
|
||
}
|
||
}
|
||
</style>
|
||
|
||
|
||
<style>aside {
|
||
grid-area: aside;
|
||
background-color: var(--c-bg-secondary);
|
||
/* padding: var(--content-inline-padding); */
|
||
border-block-start: 1px solid var(--c-border);
|
||
width: 100%;
|
||
height: min-content;
|
||
align-self: end;
|
||
display: flex;
|
||
flex-direction: column;
|
||
justify-content: flex-start;
|
||
min-width: 30ch;
|
||
overflow-y: auto;
|
||
}
|
||
|
||
aside .title {
|
||
margin-block-end: 0;
|
||
margin-inline: var(--content-inline-padding);
|
||
margin-block-start: 1rem;
|
||
margin-block-end: .5rem;
|
||
font-size: 2rem;
|
||
font-weight: 500;
|
||
}
|
||
|
||
aside details:not(:last-child) {
|
||
border-block-end: 1px solid var(--c-border);
|
||
}
|
||
|
||
aside details summary, aside a {
|
||
padding: 1rem;
|
||
display: flex;
|
||
align-items: center;
|
||
cursor: pointer;
|
||
white-space: nowrap;
|
||
}
|
||
|
||
aside a {
|
||
text-decoration: none;
|
||
}
|
||
|
||
aside details summary::before {
|
||
content: "►";
|
||
padding-inline-end: .3rem;
|
||
}
|
||
|
||
aside details[open] summary::before {
|
||
content: "▼";
|
||
}
|
||
|
||
aside details summary:hover, aside a:hover, aside a.active {
|
||
background-color: var(--c-bg);
|
||
}
|
||
|
||
aside details {
|
||
display: flex;
|
||
flex-direction: column;
|
||
position: relative;
|
||
}
|
||
|
||
aside details a {
|
||
padding-inline-start: 2.5rem;
|
||
}
|
||
|
||
@media screen and (min-width: 800px) {
|
||
aside {
|
||
border-block-start: none;
|
||
border-inline-end: 1px solid var(--c-border);
|
||
width: max-content;
|
||
height: 100%;
|
||
}
|
||
}
|
||
</style>
|
||
|
||
<link rel="stylesheet" href="../static/css/additional-styles.css">
|
||
<script src="../static/js/header-links.js" defer></script>
|
||
</head>
|
||
<body><a class="skiplink" href="emacs-erc.html#main">Skip to content</a>
|
||
<header>
|
||
<a class="logo" href="../index.html" aria-label="Libera Chat, back to start page">
|
||
<img alt="" src="../static/img/libera-color.svg" height="48px" data-proofer-ignore>
|
||
<h1>Libera.​Chat</h1>
|
||
</a>
|
||
|
||
<a id="nav-toggle" class="nav-toggle hidden" aria-controls="main-nav"><span>Navigation</span></a>
|
||
|
||
<nav class="" id="main-nav" aria-labelledby="nav-toggle" role="menubar">
|
||
<a id="nav-close" class="nav-close hidden" aria-controls="main-nav"><span>Close</span></a>
|
||
|
||
|
||
<details>
|
||
<summary
|
||
|
||
>About</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../policies.html"
|
||
|
||
><span>Network Policies</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../guidelines.html"
|
||
|
||
><span>Channel Guidelines</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../news.html"
|
||
|
||
><span>Blog & News</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../about.html"
|
||
|
||
><span>About Libera Chat</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../bylaws.html"
|
||
|
||
><span>Bylaws</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../minutes.html"
|
||
|
||
><span>Meeting Minutes</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../annual-reports.html"
|
||
|
||
><span>Annual Reports</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../sponsors.html"
|
||
|
||
><span>Sponsors</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
|
||
<details>
|
||
<summary
|
||
|
||
>Contribute</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../contributing/donate.html"
|
||
|
||
><span>Donate</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../contributing/sponsor.html"
|
||
|
||
><span>Sponsor Us</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="../contributing/development.html"
|
||
|
||
><span>Development</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
|
||
<a role="menuitem" href="../chanreg.html"><span>Channel Namespaces</span></a>
|
||
|
||
|
||
|
||
<a role="menuitem" href="../guides.html"><span>Guides</span></a>
|
||
|
||
|
||
|
||
<a role="menuitem" href="faq.html"><span>FAQ</span></a>
|
||
|
||
|
||
|
||
<details>
|
||
<summary
|
||
class="highlight"
|
||
>Connect</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="https://web.libera.chat"
|
||
rel="noopener noreferrer"
|
||
><span>Webchat</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="ircs://irc.libera.chat:6697"
|
||
|
||
><span>irc.libera.chat:6697 (TLS)</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
href="connect.html"
|
||
|
||
><span>How to Connect</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
</nav>
|
||
</header>
|
||
<script async>
|
||
const navToggle = document.querySelector('#nav-toggle')
|
||
const navClose = document.querySelector('#nav-close')
|
||
const mainNav = document.querySelector('#main-nav')
|
||
|
||
// progressive enhancement!
|
||
navToggle.classList.remove('hidden')
|
||
navClose.classList.remove('hidden')
|
||
|
||
navToggle.addEventListener('click', event => {
|
||
event.preventDefault()
|
||
mainNav.classList.toggle('show')
|
||
})
|
||
navClose.addEventListener('click', event => {
|
||
event.preventDefault()
|
||
mainNav.classList.remove('show')
|
||
})
|
||
</script>
|
||
<aside role="menu">
|
||
<span class="title">Guides</span>
|
||
|
||
|
||
<details open>
|
||
<summary>About IRC</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="basics.html"
|
||
><span>Basics of IRC</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="faq.html"
|
||
><span>Frequently Asked Questions</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="clients.html"
|
||
><span>Choosing an IRC client</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
<details open>
|
||
<summary>Helping you connect</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="connect.html"
|
||
><span>Connecting to Libera.Chat</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="webchat.html"
|
||
><span>Using Our Webchat</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="sasl.html"
|
||
><span>Using SASL</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="https://libera.chat/guides/certfp"
|
||
><span>Using CertFP</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
<details open>
|
||
<summary>Using the network</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="registration.html"
|
||
><span>Nickname Registration</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="sendpass.html"
|
||
><span>Resetting your Password</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="cloaks.html"
|
||
><span>Cloaks</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="findingchannels.html"
|
||
><span>Finding Channels</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="channels.html"
|
||
><span>Using Channels</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="usermodes.html"
|
||
><span>User Modes</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
|
||
<details open>
|
||
<summary>Running a channel</summary>
|
||
|
||
<div>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="creatingchannels.html"
|
||
><span>Creating Channels</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="channelmodes.html"
|
||
><span>Channel Modes</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="bots.html"
|
||
><span>Network bots</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="catalyst.html"
|
||
><span>Catalysing and De-escalation</span></a>
|
||
|
||
<a
|
||
role="menuitem"
|
||
|
||
href="helpers.html"
|
||
><span>Advice for Helpers</span></a>
|
||
|
||
</div>
|
||
</details>
|
||
|
||
</aside>
|
||
<main id="main">
|
||
|
||
<h1>Configuring SASL for Emacs ERC</h1>
|
||
|
||
<p>These instructions were originally contributed by androclus. Thanks!</p>
|
||
|
||
<p><a href="https://www.emacswiki.org/emacs/ERC">ERC</a> is an IRC client which comes as a
|
||
package for Emacs. A script is used to provide SASL support; you should first
|
||
download <a href="https://github.com/syl20bnr/spacemacs/blob/master/layers/%2Bchat/erc/local/erc-sasl/erc-sasl.el">erc-sasl.el from GitHub</a>
|
||
and save it into one of the directories listed in your emacs <code class="language-plaintext highlighter-rouge">load-path</code>.</p>
|
||
|
||
<p>Once the script is downloaded, add the following to your <code class="language-plaintext highlighter-rouge">.emacs</code> or <code class="language-plaintext highlighter-rouge">init.el</code>
|
||
file in your ERC section:</p>
|
||
|
||
<div class="language-elisp highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">;; Require ERC-SASL package</span>
|
||
<span class="p">(</span><span class="nb">require</span> <span class="ss">'erc-sasl</span><span class="p">)</span>
|
||
|
||
<span class="c1">;; Add SASL server to list of SASL servers (start a new list, if it did not exist)</span>
|
||
<span class="p">(</span><span class="nv">add-to-list</span> <span class="ss">'erc-sasl-server-regexp-list</span> <span class="s">"irc\\.libera\\.chat"</span><span class="p">)</span>
|
||
|
||
<span class="c1">;; Redefine/Override the erc-login() function from the erc package, so that</span>
|
||
<span class="c1">;; it now uses SASL</span>
|
||
<span class="p">(</span><span class="nb">defun</span> <span class="nv">erc-login</span> <span class="p">()</span>
|
||
<span class="s">"Perform user authentication at the IRC server. (PATCHED)"</span>
|
||
<span class="p">(</span><span class="nv">erc-log</span> <span class="p">(</span><span class="nb">format</span> <span class="s">"login: nick: %s, user: %s %s %s :%s"</span>
|
||
<span class="p">(</span><span class="nv">erc-current-nick</span><span class="p">)</span>
|
||
<span class="p">(</span><span class="nv">user-login-name</span><span class="p">)</span>
|
||
<span class="p">(</span><span class="nb">or</span> <span class="nv">erc-system-name</span> <span class="p">(</span><span class="nv">system-name</span><span class="p">))</span>
|
||
<span class="nv">erc-session-server</span>
|
||
<span class="nv">erc-session-user-full-name</span><span class="p">))</span>
|
||
<span class="p">(</span><span class="k">if</span> <span class="nv">erc-session-password</span>
|
||
<span class="p">(</span><span class="nv">erc-server-send</span> <span class="p">(</span><span class="nb">format</span> <span class="s">"PASS %s"</span> <span class="nv">erc-session-password</span><span class="p">))</span>
|
||
<span class="p">(</span><span class="nv">message</span> <span class="s">"Logging in without password"</span><span class="p">))</span>
|
||
<span class="p">(</span><span class="nb">when</span> <span class="p">(</span><span class="nb">and</span> <span class="p">(</span><span class="nv">featurep</span> <span class="ss">'erc-sasl</span><span class="p">)</span> <span class="p">(</span><span class="nv">erc-sasl-use-sasl-p</span><span class="p">))</span>
|
||
<span class="p">(</span><span class="nv">erc-server-send</span> <span class="s">"CAP REQ :sasl"</span><span class="p">))</span>
|
||
<span class="p">(</span><span class="nv">erc-server-send</span> <span class="p">(</span><span class="nb">format</span> <span class="s">"NICK %s"</span> <span class="p">(</span><span class="nv">erc-current-nick</span><span class="p">)))</span>
|
||
<span class="p">(</span><span class="nv">erc-server-send</span>
|
||
<span class="p">(</span><span class="nb">format</span> <span class="s">"USER %s %s %s :%s"</span>
|
||
<span class="c1">;; hacked - S.B.</span>
|
||
<span class="p">(</span><span class="k">if</span> <span class="nv">erc-anonymous-login</span> <span class="nv">erc-email-userid</span> <span class="p">(</span><span class="nv">user-login-name</span><span class="p">))</span>
|
||
<span class="s">"0"</span> <span class="s">"*"</span>
|
||
<span class="nv">erc-session-user-full-name</span><span class="p">))</span>
|
||
<span class="p">(</span><span class="nv">erc-update-mode-line</span><span class="p">))</span>
|
||
</code></pre></div></div>
|
||
|
||
<p>Finally, update your connection function to include your NickServ password,
|
||
for example when using <a href="https://www.emacswiki.org/emacs/ErcSSL">erc-tls</a>:</p>
|
||
|
||
<div class="language-elisp highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">(</span><span class="nv">erc-tls</span> <span class="ss">:server</span> <span class="s">"irc.libera.chat"</span> <span class="ss">:port</span> <span class="mi">6697</span> <span class="ss">:nick</span> <span class="s">"YourNick"</span>
|
||
<span class="ss">:full-name</span> <span class="s">"Text to display as your realname/gecos"</span>
|
||
<span class="ss">:password</span> <span class="s">"NickServPassword"</span><span class="p">)</span><span class="err">)</span>
|
||
</code></pre></div></div>
|
||
|
||
<p>This guide makes use of content adapted from John2x’s
|
||
<a href="https://emacs.stackexchange.com/questions/47572/how-to-open-an-irc-session-using-sasl">answer on StackExchange</a>,
|
||
licensed under <a href="https://creativecommons.org/licenses/by-sa/4.0/">CC-BY-SA 4.0</a>.</p>
|
||
|
||
<p>Additional helpful ERC configuration advice may be found on
|
||
<a href="https://www.john2x.com/emacs.html">John2x’s home page</a>.</p>
|
||
|
||
|
||
|
||
</main><footer>
|
||
<div>
|
||
<span class="copyright">© Libera Chat's contributors 2021</span>
|
||
(<a rel="license noopener noreferrer" href="../LICENSE-content.txt">Content CC BY-NC-SA</a>,
|
||
<a rel="license noopener noreferrer" href="../LICENSE-code.txt">Code MIT</a>)
|
||
<span class="mobile-hide">/</span>
|
||
<a href="../atom.xml">Feed (atom)</a>
|
||
<span class="mobile-hide">/</span>
|
||
<a href="../privacy.html">Privacy</a>
|
||
</div>
|
||
<div>
|
||
<a rel="me noopener noreferrer" href="https://fosstodon.org/@liberachat">Mastodon</a>
|
||
<span class="mobile-hide">/</span>
|
||
<a href="https://github.com/Libera-Chat/libera-chat.github.io" rel="noopener noreferrer">GitHub</a>
|
||
<span class="mobile-hide">/</span>
|
||
<a href="https://twitter.com/liberachat" rel="noopener noreferrer">Twitter</a>
|
||
<span class="mobile-hide">/</span>
|
||
<a href="https://facebook.com/liberachat" rel="noopener noreferrer">Facebook</a>
|
||
</div>
|
||
</footer>
|