#+DATE: 2023-02-21
#+OPTIONS: toc:nil num:nil

* How to use weechat to connect to matrix service

First, you should install [[https://weechat.org/][weechat]] on your computer. Then, go to the command-line and
initialize a weechat session:

#+begin_example bash
  weechat
#+end_example

*Note*: To learn first steps to begin with weechat, check the [[https://weechat.org/files/doc/weechat/stable/weechat_quickstart.en.html][documentation]]

Within the weechat session use the following command to load the `weechat-matrix` script:

#+begin_src bash
  /script load weechat-matrix.py
#+end_src

Set up username and password using the following in the weechat session:

#+begin_src bash
  /set matrix.server.matrix_org.username UserNameHere # Change "UserNameHere" for your username in matrix
  /set matrix.server.matrix_org.password PasswordHere # Change "PasswordHere" for your password in matrix
#+end_src

Connect to matrix server:

#+begin_src bash
/matrix connect matrix_org
#+end_src

Saving configuration:

#+begin_src bash
  /save
#+end_src

** And now, what?

Once in the channel you can use ~/~ to access the available commands, e.g.,

 * /buffer weechat: go to weechat buffer
 * /buffer user_name: got to "user_name" buffer

** References

- [[https://github.com/poljar/weechat-matrix][weechat-matrix on github]]
- [[https://matrix.org:443/_matrix/client/r0/login/sso/redirect?redirectUrl=http://127.0.0.1:60673
][Quickstart guide matrix]]