1NHEKO(1) General Commands Manual NHEKO(1)
2
6 nheko - Desktop client for Matrix using Qt and C++17
7
9 nheko [OPTIONS]
10
12 The motivation behind the project is to provide a native desktop app
13 for Matrix that feels more like a mainstream chat app (Element,
14 Telegram etc) and less like an IRC client.
15
17 -h, --help
18 Displays help on commandline options.
19 --help-all
21 Displays help including Qt specific options.
22 -v, --version
24 Displays version information.
25 --debug
27 Alias for --log-level trace.
28 -l, --log-level <level>
30 Set the global log level, or a comma-separated list of
31 <component>=<level> pairs, or both. For example, to set the default
32 log level to warn but disable logging for the ui component, pass
33 warn,ui=off.
34 levels: trace debug info warning error critical off
36 components: crypto db mtx net qml ui
38 Log levels can also be set in the NHEKO_LOG_LEVEL environment
40 variable, using the same syntax. It will be overridden by this
41 command line option.
42 -L, --log-type <type>
44 Set the log output type. A comma-separated list is allowed. The
45 default is file,stderr.
46 types: file stderr none
48 The log type can also be set in the NHEKO_LOG_TYPE environment
50 variable, which will be overridden by this command line option.
51 -p <profile>, --profile <profile>
53 Creates a unique profile, which allows you to log into several
54 accounts at the same time and start multiple instances of nheko.
55 Use default to start with the default profile.
56
58 How do I add stickers and custom emojis?
59 Stickers and custom emojis are organized in image packs. There is one
60 user image pack that only your account has access to and there are room
61 image packs that are accessible by everyone in the room they are
62 defined in. You can activate a room image pack globally to use it in
63 any room.
64 To manage image packs in nheko, go to the room settings and enter the
66 Sticker & Emote Settings. You will see the Private pack (your user
67 image pack) and can edit it there. The Shortcode is a unique identifier
68 you use to select the image with and the Body is the alternate text
69 that is displayed on clients that don’t support images (like the alt
70 tag in HTML images).
71 If you have the necessary permissions you can create new room packs
73 with the button at the bottom of the image pack list. They are the same
74 as the user pack but you can create as many as you want and everyone in
75 the room can use them. It might be a good idea to create an extra room
76 just for your image packs to make sharing easier.
77
79 Completers spawn a popup with completion candidates when you type them
80 in the input line.
81 @
83 Open username completer.
84 #
86 Open room completer.
87 :
89 Open unicode emoji picker.
90 ~
92 Open custom emoji picker. Requires an image pack with custom
93 emojis. Selecting an emoji will add HTML code for the inline image
94 into the input line.
95
97 Room list
98 Ctrl-Up/Ctrl-Down
99 Navigate within the room list.
100 Ctrl-W
102 Close the currently open room.
103 Ctrl-K
105 Search and select rooms from the room list.
106 Alt-A, Ctrl-Shift-A
108 Select next room with activity.
109 Timeline/Messaging
111 PgUp/PgDn
112 Scroll timeline per page.
113 Alt-Up/Alt-Down
115 Reply to a message.
116 Up/Down
118 Edit a message.
119 Ctrl-E
121 Edit message currently selected as reply.
122 Alt-F
124 Forward message currently selected as reply.
125 Ctrl-P/Ctrl-N
127 Reenter previous/next message.
128 Ctrl-U
130 Delete everything in the input line.
131 Ctrl-Left/Ctrl-Right
133 Jump one word left/right in the input line.
134 Shift-Enter
136 Insert line break.
137 Enter
139 Submit message.
140
142 Commands only work when they are used at the beginning of text.
143 Custom messages
145 /me <message>
146 Send a message as an emote, where your username is prefixed.
147 /react <text>
149 Send a message as a reaction when you’re replying to a message.
150 /md <message>
152 Force Markdown when sending the current message.
153 /plain <message>
155 Force plain text when sending the current message.
156 /rainbow <message>
158 Send a message in rainbow colors.
159 /rainbowme <message>
161 Send a message as a rainbow-colored emote, where your username is
162 prefixed.
163 /notice <message>
165 Send a message as a notice.
166 /rainbownotice <notice>
168 Send a message as a rainbow-colored notice.
169 Room management
171 /join <roomname> [reason]
172 Join a room. reason is optional.
173 /knock <roomname> [reason]
175 Ask to join a room. reason is optional.
176 /part, /leave [reason]
178 Leave the current room. reason is optional.
179 /invite <username> [reason]
181 Invite a user into the current room. reason is optional.
182 /kick <username> [reason]
184 Kick a user from the current room. reason is optional.
185 /ban <username> [reason]
187 Ban a user from the current room. reason is optional.
188 /unban <username> [reason]
190 Unban a user. reason is optional.
191 /redact <username> [reason]
193 Redacts all visible messages of the specified user. You will run
194 into rate limits quickly.
195 /redact <eventid> [reason]
197 Redacts a specific event.
198 /roomnick <roomname>
200 Change your nickname in a single room.
201 Emoticons
203 /shrug [message]
204 Inserts ¯\_(ツ)_/¯ followed by an optional message.
205 /fliptable
207 Inserts (╯°□°)╯︵ ┻━┻
208 /unfliptable
210 Inserts ┯━┯╭( º _ º╭)
211 /sovietflip
213 Inserts ノ┬─┬ノ ︵ ( \\o°o)\\
214 Advanced
216 /clear-timeline
217 Removes all but the most recent messages from the currently
218 rendered timeline and then refetches it from the server; can be
219 used to fix some cache issues.
220 /reset-state
222 Fetches all the state events in the current room again; can be used
223 to fix some cache issues.
224 /rotate-megolm-session
226 Rotates the encryption key used to send encrypted messages in a
227 room.
228 /goto <address>
230 address can be one of:
231 <event ID>
233 Jumps to event with the specified ID and highlights it.
234 <message index>
236 Jumps to the message with the specified index and highlights
237 it.
238 <Matrix URI>
240 Handles Matrix URI as if you clicked on it.
241 /converttodm
243 Converts a room to a direct conversation.
244 /converttoroom
246 Converts a direct conversation to a normal room.
247
249 Configuration file
250 ${XDG_CONFIG_HOME:-~/.config}/nheko/nheko.conf
251 Log file
253 ${XDG_CACHE_HOME:-~/.cache}/nheko/nheko/nheko.log
254 Database
256 ${XDG_DATA_HOME:-~/.local/share}/nheko/nheko/*/data.mdb
257 Media cache
259 ${XDG_CACHE_HOME:-~/.cache}/nheko/nheko/media_cache
260
262 Please report issues on our bug tracker at
263 https://github.com/Nheko-Reborn/nheko/issues.
264nheko 0.11.1 2022-01-27 NHEKO(1)