1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
senpai(1)
# NAME
senpai - your everyday IRC student
# SYNOPSIS
*senpai* [options...]
# OPTIONS
*-config* <path>
Use a different path for the configuration file.
*-debug*
Show all IRC messages that are received from/sent to the server.
# DESCRIPTION
senpai is an IRC client made for bouncers. It supports the newest IRC
extensions, such as:
- _CHATHISTORY_, senpai fetches history from the server instead of keeping logs,
- _@+typing_, senpai shows when others are typing a message,
- _BOUNCER_, senpai connects to all your networks at once automatically,
- and more to come!
# CONFIGURATION
senpai needs a configuration file to start. It searches for it in the following
location:
$XDG_CONFIG_HOME/senpai/senpai.scfg
If unset, $XDG_CONFIG_HOME defaults to *~/.config*.
For information about the configuration format, see *senpai*(5).
# USER INTERFACE
The user interface of senpai consists of 4 parts. Starting from the bottom:
The *buffer list*, shows joined channels. The special buffer *home* is where
server notices are shown. This list can be put on the left of the screen with
the _chan-column-width_ configuration option.
On the row above, the *input field* is where you type in messages or commands
(see *COMMANDS*). By default, when you type a message, senpai will inform
others in the channel that you are typing.
On the row above, the *status line* (or... just a line if nothing is
happening...) is where typing indicators are shown (e.g. "dan- is typing...").
Finally, the *timeline* is displayed on the rest of the screen. Several types
of messages are in the timeline:
- User messages are shown with their nicknames,
- User actions (*/me*) are shown with an asterisk (*\**) followed by the user's
nickname,
- Status messages, such as joins, parts, topics and name lists, are shown with
two dashes (*--*),
- Notices are shown with an asterisk (*\**) followed by the user nickname and a
colon
# SELECTING TEXT
In order to select text with a mouse, hold SHIFT while clicking and dragging
the mouse. *Clicking and dragging without holding SHIFT will not work, as
senpai eats these events for eg selecting channels.*
# KEYBOARD SHORTCUTS
*CTRL-C*
Clear input line.
*CTRL-U*, *PgUp*
Go up in the timeline.
*CTRL-D*, *PgDown*
Go down in the timeline.
*CTRL-N*, *ALT-RIGHT*
Go to the next buffer.
*CTRL-P*, *ALT-LEFT*
Go to the previous buffer.
*ALT-HOME*
Go to the first buffer.
*ALT-END*
Go to the last buffer.
*ALT-P*
Go to the previous highlight
*ALT-N*
Go to the next highlight, or to the (most recent) end of the timeline if
there is none.
*ALT-{1..9}*
Go to buffer by index.
*UP*, *DOWN*, *LEFT*, *RIGHT*, *HOME*, *END*, *BACKSPACE*, *DELETE*
Edit the text in the input field.
*ENTER*
Sends the contents of the input field.
*TAB*
Trigger the auto-completion. Press several times to cycle through
completions.
*CTRL-L*
Refresh the window.
*F7*
Show/hide the vertical channel list.
*F8*
Show/hide the vertical member list.
# COMMANDS
If you type and send a message that starts with a slash (*/*), it will instead
be interpreted as a command:
/_name_ argument1 argument2...
_name_ is matched case-insensitively. It can be one of the following:
*HELP* [search]
Show the list of command (or a commands that match the given search terms).
*JOIN* <channel>
Join the given channel.
*PART* [channel] [reason]
Part the given channel, defaults to the current one if omitted.
*QUIT* [reason]
Quits senpai.
*MOTD*
Show the message of the day (MOTD).
*NAMES*
Show the member list of the current channel. Powerlevels (such as _@_ for
"operator", or _+_ for "voice") are shown in green.
*TOPIC* [topic]
If _topic_ is omitted, show the topic of the current channel and, if
available, the person who set it and the time when it has been set.
Otherwise, change the topic of the current channel to _topic_.
*MSG* <target> <content>
Send _content_ to _target_.
*REPLY* <content>
Reply to the last person who sent a private message.
*ME* <content>
Send a message prefixed with your nick (a user action). If sent from home,
reply to the last person who sent a private message.
*NP*
Send the current song that is being played on the system. Uses DBus/MPRIS
internally.
*QUOTE* <raw message>
Send _raw message_ verbatim.
*BUFFER* <name>
Switch to the buffer containing _name_.
*NICK* <nickname>
Change your nickname.
*OPER* <username> <password>
Log in to an operator account.
*MODE* <nick/channel> <flags> [args]
Change channel or user modes.
*INVITE* <nick> [channel]
Invite _nick_ to _channel_ (the current channel if not given).
*KICK* <nick> [channel]
Eject _nick_ from _channel_ (the current channel if not given).
*BAN* <nick> [channel]
Ban _nick_ from entering _channel_ (the current channel if not given).
*UNBAN* <nick> [channel]
Allow _nick_ to enter _channel_ again (the current channel if not given).
*SEARCH* <text>
Search messages matching the given text, in the current channel or server.
This opens a temporary list, which can be closed with the escape key.
# SEE ALSO
*senpai*(5)
# AUTHORS
Creator/Sensei: Hubert Hirtz <hubert@hirtzfr.eu>!++
Current maintainer: delthas <delthas@dille.cc>.++
Sources are available at <https://git.sr.ht/~taiite/senpai>.++
Patches are welcome by email at <~delthas/senpai-dev@lists.sr.ht>.
|
