نشانی (host[:port]) سرور IRC. برنامه senpai به طور پیش‌فرض از اتصالات TLS استفاده می‌کند مگر اینکه گزینه tls را روی false تنظیم کنید. اتصالات TLS به طور پیش‌فرض از درگاه 6697 و اتصالات متن آشکار از درگاه 6667 استفاده می‌کنند.

یک طرحواره (scheme) اختیاری می‌تواند مشخص شود (scheme://host[:port]):

• irc:// پیش‌فرض ضمنی است، TLS با توجه به مقدار پیکربندی tls فعال یا غیرفعال می‌شود.
• ircs:// پروتکل TLS را فعال می‌کند.
• irc+insecure:// پروتکل TLS را غیرفعال می‌کند (IRC متن آشکار).
• ircs+insecure:// پروتکل TLS را فعال می‌کند اما اعتبارسنجی گواهی TLS را نادیده می‌گیرد. این گزینه در برابر حملات غیرفعال MITM محافظت می‌کند اما در برابر حملات فعال MITM محافظتی ندارد.

نام مستعار شما، که با پیام IRC NICK ارسال می‌شود. این نام نباید شامل فاصله یا دونقطه (:) باشد.

نام واقعی شما، یا در واقع فیلدی که برای دیگران در دسترس خواهد بود و ممکن است شامل فاصله و دونقطه باشد. با پیام IRC USER ارسال می‌شود. به طور پیش‌فرض، مقدار nick استفاده می‌شود.

نام کاربری شما، که با پیام IRC USER ارسال می‌شود و همچنین برای احراز هویت SASL استفاده می‌گردد. به طور پیش‌فرض، مقدار nick استفاده می‌شود.

گذرواژه شما، که برای احراز هویت SASL استفاده می‌شود. همچنین به password-cmd مراجعه فرمایید.

به جای ارائه مستقیم گذرواژه احراز هویت SASL به صورت متن آشکار، می‌توانید دستوری را مشخص کنید که در زمان اجرا برای واکشی گذرواژه اجرا شود. این گزینه زمانی مفید است که گذرواژه‌های خود را در یک پرونده جداگانه (احتمالاً رمزنگاری‌شده) با استفاده از `gpg` یا یک مدیر گذرواژه خط فرمان مانند pass یا gopass ذخیره می‌کنید. اگر یک password-cmd ارائه شود، مقدار password نادیده گرفته شده و خط اول خروجی password-cmd برای ورود استفاده خواهد شد.

دستور و آرگومان‌ها از قبل توسط scfg نقل‌قول می‌شوند، بنابراین نیازی به نقل‌قول اضافی کل رشته دستور نیست. برای مثال:

password-cmd pass "Messaging/irc"

فهرستی از نام‌های کانال جداشده با فاصله که senpai به طور خودکار در زمان راه‌اندازی و اتصال مجدد به سرور به آن‌ها ملحق می‌شود. این دستورالعمل می‌تواند چندین بار مشخص شود.

این دستورالعمل هنگام استفاده از bouncer نباید استفاده شود، زیرا bouncer از قبل کانال‌های ذخیره‌شده را به خاطر سپرده و senpai را به طور خودکار به آن‌ها ملحق می‌کند.

فهرستی از کلیدواژه‌های جداشده با فاصله که در صورت بیان شدن توسط دیگران، یک اعلان و یک نشانگر نمایشی را ایجاد می‌کنند. این دستورالعمل می‌تواند چندین بار مشخص شود.

به طور پیش‌فرض، senpai از نام مستعار فعلی شما استفاده خواهد کرد.

فعال کردن ارسال نویسه زنگ (BEL) هنگام هایلایت شدن شما. پیش‌فرض غیرفعال است.

پیکربندی عرض بخش‌های مختلف رابط کاربری.

عرض بخش‌ها به عنوان زیردستورالعمل‌های دستورالعمل اصلی pane-widths تنظیم می‌شوند:

pane-widths {
    nicknames 16
}

این دستورالعمل از زیردستورالعمل‌های زیر پشتیبانی می‌کند:

nicknames

channels

members

text

فعال کردن رمزنگاری TLS. پیش‌فرض true است.

ارسال اعلان‌های تایپ که به دیگران اطلاع می‌دهد چه زمانی در حال تایپ پیام هستید. پیش‌فرض true است.

فعال یا غیرفعال کردن پشتیبانی از ماوس. پیش‌فرض true است.

فعال کردن بررسی املا با استفاده از harper-ls. نیازمند نصب بودن harper-ls است. در حال حاضر فقط انگلیسی است. پیش‌فرض false است.

تنظیمات رنگ‌های عناصر مختلف رابط کاربری.

رنگ‌ها را می‌توان با نام ("red")، با شماره (از 0 تا 255 برای 256 رنگ پیش‌فرض ترمینال؛ -1 به معنی پیش‌فرض)، یا با رنگ واقعی هگزادسیمال RGB (#rrggbb) تنظیم کرد.

رنگ‌ها به عنوان زیردستورالعمل‌های دستورالعمل اصلی colors تنظیم می‌شوند:

colors {
    prompt green
}

تنظیمات کلیدهای میانبر سفارشی صفحه کلید.

میانبرها با زیردستورالعمل‌های `<key> <action> [<params>...]` تعریف می‌شوند:

shortcuts {
    Alt+k cursor-delete-after
    Shift+Alt+Page_Up set-editor "/me slaps OP with a large trout"
}

کلیدها شامل تغییردهنده‌های اختیاری (Control/Shift/Alt/Super) و نام یک کلید هستند، که می‌تواند یک نویسه تحت‌اللفظی (مثلاً k) یا نامی برای آن کلید برگرفته از نام‌های کلید XKB باشد (در لینوکس، برای یافتن نام کلیدها به wev مراجعه کنید، مانند Page_Up، XF86AudioPlay).

یک میانبر سفارشی هر میانبر پیش‌فرضی را برای آن کلید بازنویسی خواهد کرد.

پیشرفته. تخلیه تمام داده‌های ارسالی و دریافتی در بافر خانه، که برای اشکال‌زدایی مفید است. پیش‌فرض false است.

پیشرفته. اجرای یک نمونه زودگذر و موقت بدون خواندن/نوشتن روی دیسک (به جز پیکربندی اولیه). می‌تواند برای نمونه‌های عمومی مفید باشد. پیش‌فرض false است.

پیشرفته. فعال کردن یکپارچه‌سازی با سیستم محلی (مانند اعلان‌ها از طریق DBus). غیرفعال کردن آن در سیستم‌هایی که قرار است از طریق SSH استفاده شوند می‌تواند مفید باشد. پیش‌فرض true است.

پیشرفته. برنامه senpai به طور پیش‌فرض بدون نیاز به اسکریپت هایلایت سفارشی به شما اطلاع‌رسانی می‌کند. مسیر جایگزین برای یک اسکریپت شل که هنگام هایلایت شدن شما اجرا شود. به طور پیش‌فرض، senpai به دنبال یک اسکریپت هایلایت شل در $XDG_CONFIG_HOME/senpai/highlight می‌گردد. اگر هیچ پرونده‌ای در آن مسیر یافت نشود و مسیر جایگزینی هم ارائه نشده باشد، اجرای دستور هایلایت غیرفعال می‌شود.

در صورت عدم تنظیم، $XDG_CONFIG_HOME به طور پیش‌فرض ~/.config/ است.

قبل از اجرای اسکریپت هایلایت، متغیرهای محیطی زیر مقداردهی می‌شوند:

اسکریپت‌های شل باید اطمینان حاصل کنند که متغیرها در پرونده اسکریپت در داخل نقل‌قول (QUOTED) قرار دارند، در غیر این صورت در معرض حملات تزریق شل (SHELL INJECTION ATTACKS) خواهید بود. اسکریپت‌های شل همچنین باید اطمینان حاصل کنند که نویسه‌هایی مانند '*' و '?' بسط داده نمی‌شوند.

نکته: هنگام ارسال این متغیرها به notify-send(1)، برخی از دیمن‌های اعلان از \ برای دنباله‌های گریز در بدنه استفاده می‌کنند که باعث می‌شود \ از پیام ناپدید شود یا اثرات جانبی ناخواسته‌ای (مانند خطوط جدید) ایجاد کند.

برای دور زدن این مشکل، می‌توانید با قطعه کد زیر بک‌اسلش را دو برابر کنید:

#!/bin/sh
escape() {
	printf "%s" "$1" | sed ´s#\\#\\\\#g´
}
notify-send "[$BUFFER] $SENDER" "$(escape "$MESSAGE")"

address irc.libera.chat
nickname Guest123456

address irc.libera.chat
nickname Guest123456
username senpai
realname "Guest von Lenon"
password-cmd gopass show irc/guest # use your favorite CLI password solution here
channel "#rahxephon"
pane-widths {
	nicknames 10
	channels 16
	members 16
}
colors {
	nicks extended
}
shortcuts {
    Alt+k cursor-delete-after
}