emacs-org/notes/emacs-matrix.org

Emacs Matrix Client — Ement.el

• Matrix v Emacsu — Ement.el
  • Instalace
  • Server a účet
  • Automatické připojení
  • Klávesové zkratky (SPC o M)
    • Inteligentní otevření panelu (SPC o M o)
    • V místnosti (room buffer)
  • E2EE
  • Konfigurace v config.el
  • Místnosti
  • Časté problémy
  • Reference

Matrix v Emacsu — Ement.el

Ement.el je nativní Matrix klient pro Emacs. Plná integrace s Doom Emacs přes prefix SPC o M (uppercase M — SPC o m je obsazeno mu4e).

Instalace

Balíček je deklarovaný v packages.el:

(package! ement)

Po přidání spustit:

~/.emacs.d/bin/doom sync

Server a účet

• Homeserver: https://matrix.apps.sukany.cz
• User ID: @martin:sukany.cz
• E2EE: zakázáno na straně serveru (encryption: false v OpenClaw config) — Pantalaimon se nepoužívá a není potřeba

Automatické připojení

Emacs se automaticky připojí při startu (doom-after-init-hook) pomocí uložené session. Nepotřebuješ zadávat heslo — token je uložen v souboru:

~/.doom.d/ement-sessions.el

Při prvním použití (nebo po výmazu session souboru) spusť SPC o M c a zadej:

Homeserver URL: https://matrix.apps.sukany.cz
User ID: @martin:sukany.cz
Password: (interaktivně)

Po úspěšném připojení se session uloží a příště je připojení automatické.

Klávesové zkratky (SPC o M)

Zkratka	Funkce
SPC o M o	Otevřít panel (inteligentní — viz níže)
SPC o M c	Připojit (ement-connect)
SPC o M C	Odpojit
SPC o M l	Seznam místností
SPC o M r	Otevřít místnost
SPC o M d	Přímá zpráva uživateli
SPC o M j	Připojit se k místnosti
SPC o M n	Notifikace (nové zprávy)
SPC o M m	Zmínky (@martin)

Inteligentní otevření panelu (SPC o M o)

my/ement-open se chová podle aktuálního stavu:

• Již připojeno → okamžitě otevře seznam místností
• Session soubor existuje → obnoví bez zadání hesla, po sync otevře místnosti
• Žádná session → interaktivní ement-connect, pak otevře místnosti

V místnosti (room buffer)

Klávesa	Akce
RET	Napsat zprávu
M-RET	Compose buffer (pro delší text)
S-RET	Odpovědět na zprávu na pointu
n / p	Další / předchozí zpráva
SPC	Scroll dolů + označit přečtené
?	Transient menu (všechny akce)
s r	Reakce (emoji)
C-k	Smazat vlastní zprávu
r m	Seznam členů
M-g M-l	Přejít na seznam místností

E2EE

E2EE je na serveru zakázáno — veškerá komunikace mezi Emacs klientem a homeserverem probíhá nešifrovaně (ale přes HTTPS). Toto je záměrné rozhodnutí: Megolm session errors způsobovaly nečitelné zprávy na iOS zařízeních, spolehlivost je důležitější.

Pantalaimon se nepoužívá a není potřeba instalovat.

Konfigurace v config.el

Relevantní sekce (viz ~/.doom.d/config.el):

• ement-sessions-file — nastaven na ~/.doom.d/ement-sessions.el (před načtením balíčku)
• ement-save-sessions t — session se uloží při kill-emacs
• ement-auto-sync t — na pozadí se synchronizuje automaticky
• ement-room-show-avatars nil — avatary jsou vypnuty (výkon)
• ement-notify-mentions-p t — notifikace při zmínkách

Místnosti

Název	Room ID	Použití
Daneel - AI assistant	!bVBXrchJJVQRoyHQwU:sukany.cz	Hlavní DM s Daneel
Email summaries	!okPPZiCqKrzZeGkpzv:sukany.cz	Email notifikace
Nakopni se (Daneel)	!moHRlJaLrwEBYDDzGg:sukany.cz	Nakopni se kurz
Sprava serveru	!NmZsNYaigZZensbSIi:sukany.cz	Infra01 monitoring
Weekly review	!rHpupKCgxNRJoomtij:sukany.cz	Týdenní přehledy

Časté problémy

Problém	Příčina	Řešení
Auto-connect nefunguje	Session soubor chybí nebo poškozený	SPC o M c pro nové přihlášení
"Invalid homeserver"	Špatná URL	Zkontrolovat https://matrix.apps.sukany.cz
Zprávy se nezobrazují	Session expirovala	SPC o M C → SPC o M c
Pomalý start	Avatary zapnuty	(setq ement-room-show-avatars nil)

Reference

• ement.el GitHub
• Konfigurace: ~/.doom.d/config.el (sekce MATRIX)
• Session soubor: ~/.doom.d/ement-sessions.el