senpai(1) | General Commands Manual | senpai(1) |
NAME¶
senpai - your everyday IRC student
SYNOPSIS¶
senpai [options...]
OPTIONS¶
-config <path>
-nickname <nickname>
-debug
-version
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,
- SEARCH, senpai can search messages quickly server-side,
- FILEHOST, senpai can upload files to the bouncer,
- and more to come!
CONFIGURATION¶
senpai searches for it in the following location:
If unset, $XDG_CONFIG_HOME defaults to ~/.config or the platform's equivalent
For information about the configuration format, see senpai(5).
If the configuration file does not exist, a setup assistant will create one for you.
USER INTERFACE¶
The user interface of senpai consists of several parts.
On the left, the buffer list, shows joined channels. The special buffer home is where server notices are shown. The list can be put on the bottom of the screen with a configuration option. Buffers can be closed with the mouse middle click, or the part command.
On the right, the member list, shows members joined to the current channel.
On the bottom, 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 message timeline is displayed on the rest of the screen.
senpai supports the mouse almost everywhere (clicking on nicks, buffers, members, links; resizing panels; and features "buttons"). On supported terminals, the cursor will turn into a hand when over a clickable element.
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.
OPENING LINKS¶
In order to open links, refer to your terminal manual. On most terminals, opening links is done by holding CTRL, or SHIFT, while clicking the link. On the foot terminal, links can be opened by pressing CTRL+SHIFT+O.
A simple left click with no modifiers will make senpai try to preview the link, or open it. In order to skip the preview, open the link with a modifier, as specified above, instead of an unmodified left click.
KEYBOARD SHORTCUTS¶
CTRL-A
CTRL-E
CTRL-C
CTRL-F
CTRL-K
CTRL-U, PgUp
CTRL-D, PgDown
CTRL-N, ALT-RIGHT
CTRL-P, ALT-LEFT
SHIFT-RIGHT
SHIFT-LEFT
ALT-HOME
ALT-END
ALT-P
ALT-N
ALT-{1..9}
UP, DOWN, LEFT, RIGHT, HOME, END, BACKSPACE, DELETE
ENTER
TAB
CTRL-L
F7
F8
COMMANDS¶
If you type and send a message that starts with a slash (/), it will instead be interpreted as a command:
name is matched case-insensitively. It can be one of the following:
HELP [search]
JOIN <channel>
PART [channel] [reason]
QUIT [reason]
MOTD
NAMES
TOPIC [topic]
Otherwise, change the topic of the current channel to topic.
MUTE
This moves the channel to the end of the server, and greys its name out so that new messages do not change its color in the list. Highlights will still send a notification.
UNMUTE
PIN
UNPIN
MSG <target> <content>
REPLY <content>
ME <content>
NP
UPLOAD <file path>
QUOTE <raw message>
LIST [pattern]
BUFFER <index|name>
WHOIS <nickname>
WHOWAS <nickname>
NICK <nickname>
OPER <username> <password>
MODE <nick/channel> <flags> [args]
INVITE <nick> [channel]
KICK <nick> [channel] [message]
BAN <nick> [channel]
UNBAN <nick> [channel]
SEARCH <text>
AWAY [message]
BACK
VERSION [target]
ADMIN [target]
LUSERS
TIME [target]
INFO
LINKS
SHRUG
TABLEFLIP
STATS <query> [target]
CONNECT <target server> [<port> [remote server]]
SQUIT <server> [comment]
KILL <nick> [message]
REHASH
RESTART
WALLOPS [text]
SEE ALSO¶
AUTHORS¶
Creator/Sensei: Hubert Hirtz <hubert@hirtzfr.eu>!
Current maintainer: delthas <delthas@dille.cc>.
Sources are available at <https://git.sr.ht/~delthas/senpai>.
Patches are welcome by email at <~delthas/senpai-dev@lists.sr.ht>.
2025-04-14 |