senpai - your everyday IRC student
-config <path>
Use a different path for the configuration file.
-nickname <nickname>
Advanced. Nick name to connect as. Overrides the
configuration item of the same name.
-debug
Advanced. Show all IRC messages that are received
from/sent to the server.
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!
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).
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.
Buffers can be closed with the mouse middle click, or the part
command.
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
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.
CTRL-A
Move the cursor to the beginning of the input
field.
CTRL-E
Move the cursor to the end of the input field.
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.
SHIFT-RIGHT
Go to the next unread buffer.
SHIFT-LEFT
Go to the previous unread 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.
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.
LIST [pattern]
List public channels, optionally matching the specified
pattern.
BUFFER <name>
Switch to the buffer containing name.
WHOIS <nickname>
Get information about someone who is connected.
WHOWAS <nickname>
Get information about someone who is disconnected.
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] [message]
Eject nick from channel (the current
channel if not given) with an optional kick message/reason.
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.
AWAY [message]
Mark yourself as away, with an optional away
message.
BACK
Mark yourself as back from being away.
VERSION [target]
Query the server software version.
ADMIN [target]
Query the server administrative information.
LUSERS
Query the server user information.
TIME [target]
Query the server local time.
INFO
Query server information.
LINKS
Query the servers of the network.
SHRUG
Send a shrug emoji to the current channel.
¯\_(ツ)_/¯
TABLEFLIP
Send a table flip emoji to the current channel.
(╯°□°)╯︵
┻━┻
STATS <query> [target]
Query server statistics (advanced).
CONNECT <target server> [<port> [remote
server]]
Connect a server to the network (advanced).
SQUIT <server> [comment]
Disconnects a server from the network (advanced).
KILL <nick> [message]
Eject someone from the server (advanced).
REHASH
Make the server reload its configuration
(advanced).
RESTART
Make the server restart (advanced).
WALLOPS [text]
Broadcast a message to all users (advanced).
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>.