senpai(1)

General Commands Manual

senpai(1)

نام (NAME)

senpai - شاگرد روزمره IRC شما

خلاصه دستور (SYNOPSIS)

senpai [options...] [link]

گزینه‌ها (OPTIONS)

-config <path>

استفاده از یک مسیر متفاوت برای فایل پیکربندی. ساختار آن در senpai(5) مستند شده است.

-nickname <nickname>

پیشرفته. نام مستعار برای اتصال. بر گزینه هم‌نام در فایل پیکربندی بازنویسی می‌شود.

-debug

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

-version

نمایش اطلاعات نسخه.

همچنین senpai می‌تواند با یک پیوند irc:// به یک سرور یا مقصد باز شود. در این صورت، پیوند در صورت وجود در یک نمونه فعال باز خواهد شد.

توضیحات (DESCRIPTION)

برنامه senpai یک کلاینت IRC است که برای باونسرها (bouncers) ساخته شده است. این برنامه از جدیدترین افزونه‌های IRC پشتیبانی می‌کند، از قبیل:

CHATHISTORY، senpai به‌جای نگهداری لاگ‌ها، تاریخچه را از سرور دریافت می‌کند،
@+typing، senpai زمانی را که دیگران در حال تایپ پیام هستند نشان می‌دهد،
BOUNCER، senpai به‌طور خودکار و هم‌زمان به همه شبکه‌های شما متصل می‌شود،
SEARCH، senpai می‌تواند پیام‌ها را به‌سرعت در سمت سرور جستجو کند،
FILEHOST، senpai می‌تواند فایل‌ها را روی باونسر بارگذاری کند،
و موارد بیشتری که در راهند!

پیکربندی (CONFIGURATION)

برنامه senpai آن را در مکان زیر جستجو می‌کند:

$XDG_CONFIG_HOME/senpai/senpai.scfg

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

برای کسب اطلاعات درباره ساختار پیکربندی، senpai(5) را ببینید.

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

رابط کاربری (USER INTERFACE)

رابط کاربری senpai از چندین بخش تشکیل شده است.

در سمت چپ، فهرست بافرها (buffer list)، کانال‌های پیوسته را نشان می‌دهد. بافر ویژه home جایی است که اعلان‌های سرور در آن نمایش داده می‌شوند. با یک گزینه پیکربندی می‌توان این فهرست را در پایین صفحه قرار داد. بافرها را می‌توان با کلیک میانی ماوس یا با دستور part بست.

در سمت راست، فهرست اعضا (member list)، اعضای پیوسته به کانال جاری را نشان می‌دهد.

در پایین، کادر ورودی (input field) جایی است که پیام‌ها یا دستورها را در آن تایپ می‌کنید (بخش COMMANDS را ببینید). به‌طور پیش‌فرض، هنگامی که پیامی را تایپ می‌کنید، senpai به دیگران در کانال اطلاع می‌دهد که در حال تایپ هستید.

در ردیف بالایی، خط وضعیت (status line) (یا... صرفاً یک خط در صورتی که رویدادی در جریان نباشد...) مکانی است که نشانگرهای تایپ در آن نشان داده می‌شوند (مانند "dan- is typing...").

در نهایت، خط زمانی (timeline) پیام‌ها در بقیه صفحه نمایش داده می‌شود.

برنامه senpai تقریباً در همه‌جا از ماوس پشتیبانی می‌کند (کلیک روی نام‌های مستعار، بافرها، اعضا، پیوندها؛ تغییر اندازه پانل‌ها؛ و ویژگی "دکمه‌ها"). در پایانه‌های پشتیبانی‌شده، نشانگر هنگام قرار گرفتن روی یک عنصر قابل کلیک، به شکل دست درمی‌آید.

به منظور انتخاب متن با ماوس، هنگام کلیک کردن و کشیدن ماوس، کلید SHIFT را نگه دارید. کلیک و کشیدن بدون نگه‌داشتن کلید SHIFT کار نخواهد کرد، چرا که senpai این رویدادها را برای مواردی از قبیل انتخاب کانال‌ها دریافت و مصرف می‌کند.

باز کردن پیوندها (OPENING LINKS)

به منظور باز کردن پیوندها، به راهنمای ترمینال خود مراجعه کنید. در اکثر ترمینال‌ها، باز کردن پیوندها با نگه‌داشتن CTRL یا SHIFT هنگام کلیک روی پیوند انجام می‌شود. در ترمینال foot، پیوندها را می‌توان با فشردن CTRL+SHIFT+O باز کرد.

یک کلیک چپ ساده بدون کلیدهای تغییردهنده (modifier) باعث می‌شود senpai تلاش کند پیوند را پیش‌نمایش دهد یا آن را باز کند. برای صرف‌نظر از پیش‌نمایش، پیوند را به جای کلیک چپ ساده، با یک کلید تغییردهنده همان‌طور که در بالا مشخص شده باز کنید.

کلیدهای میانبر (KEYBOARD SHORTCUTS)

این میانبرها را می‌توان در پیکربندی سفارشی‌سازی کرد؛ senpai(5) را ببینید.

CTRL-A

انتقال مکان‌نما به ابتدای فیلد ورودی.

CTRL-E

انتقال مکان‌نما به انتهای فیلد ورودی.

CTRL-C

پاک کردن خط ورودی، یا آماده‌سازی برای خروج با افزودن /quit به خط ورودی.

CTRL-F

آماده‌سازی برای جستجو: افزودن /search به خط ورودی.

CTRL-K

آماده‌سازی برای پرش به یک بافر: افزودن /buffer به خط ورودی.

CTRL-ALT-V

آماده‌سازی برای بارگذاری کلیپ‌بورد: افزودن /upload به خط ورودی.

CTRL-U, PgUp

بالا رفتن در خط زمانی (تایم‌لاین).

CTRL-D, PgDown

پایین رفتن در خط زمانی (تایم‌لاین).

CTRL-N, ALT-RIGHT

رفتن به بافر بعدی.

CTRL-P, ALT-LEFT

رفتن به بافر قبلی.

SHIFT-RIGHT

رفتن به بافر خوانده‌نشده بعدی.

SHIFT-LEFT

رفتن به بافر خوانده‌نشده قبلی.

ALT-HOME

رفتن به اولین بافر.

ALT-END

رفتن به آخرین بافر.

ALT-P

رفتن به پیام برجسته (highlight) قبلی.

ALT-N

رفتن به پیام برجسته (highlight) بعدی، یا در صورت نبود، رفتن به انتهای خط زمانی (تازه‌ترین پیام‌ها).

ALT-{1..9}

رفتن به بافر از طریق اندیس (شماره بافر).

UP, DOWN, LEFT, RIGHT, HOME, END, BACKSPACE, DELETE

ویرایش متن در فیلد ورودی.

ENTER

ارسال محتویات فیلد ورودی.

TAB

باز کردن کادر تکمیل خودکار. گزینه تکمیل خودکار را با UP و DOWN انتخاب کرده و سپس برای تأیید، دوباره TAB را فشار دهید.

CTRL-L

تازه‌سازی پنجره.

نمایش/پنهان کردن فهرست عمودی کانال‌ها.

نمایش/پنهان کردن فهرست عمودی اعضا.

اگر پیامی بنویسید و ارسال کنید که با یک اسلش (/) آغاز شود، در عوض به عنوان یک دستور تفسیر خواهد شد:

/name argument1 argument2...

name بدون حساسیت به بزرگی و کوچکی حروف تطابق داده می‌شود. می‌تواند یکی از موارد زیر باشد:

HELP [search]

نمایش فهرست دستورها (یا دستورهایی که با عبارت‌های جستجوی مشخص‌شده مطابقت دارند).

JOIN <channel>

پیوستن به کانال مشخص‌شده.

PART [channel] [reason]

ترک کانال مشخص‌شده؛ در صورت حذف، پیش‌فرض کانال فعلی خواهد بود.

QUIT [reason]

خروج از senpai.

MOTD

نمایش پیام روز (MOTD).

NAMES

نمایش فهرست اعضای کانال فعلی. سطوح دسترسی (مانند @ برای "operator"، یا + برای "voice") به رنگ سبز نشان داده می‌شوند.

TOPIC [topic]

اگر topic حذف شود، موضوع کانال فعلی و، در صورت در دسترس بودن، فردی که آن را تنظیم کرده و زمانی که تنظیم شده است نمایش داده می‌شود.

در غیر این صورت، موضوع کانال فعلی را به topic تغییر می‌دهد.

MUTE

بی‌صدا کردن کانال فعلی. این کار از حواس‌پرتی توسط پیام‌های جدید در کانال‌های کم‌اهمیت جلوگیری می‌کند.

این دستور کانال را به انتهای سرور منتقل کرده و نام آن را خاکستری می‌کند تا پیام‌های جدید رنگ آن را در فهرست تغییر ندهند. موارد اشاره (Highlights) همچنان اعلان ارسال خواهند کرد.

UNMUTE

لغو بی‌صدا بودن کانال فعلی. بخش MUTE را ببینید.

PIN

سنجاق کردن کانال فعلی. این کار کانال را به ابتدای فهرست بافر منتقل می‌کند.

UNPIN

برداشتن سنجاق کانال فعلی. بخش PIN را ببینید.

MSG <target> <content>

ارسال content به target.

REPLY <content>

پاسخ به آخرین فردی که پیام خصوصی فرستاده است.

ME <content>

ارسال یک پیام با پیشوند نام مستعار شما (یک کنش کاربری). اگر از مبدأ خانگی ارسال شود، به آخرین فردی که پیام خصوصی فرستاده پاسخ می‌دهد.

ارسال نام آهنگی که هم‌اکنون در سیستم پخش می‌شود. به صورت درونی از DBus/MPRIS استفاده می‌کند.

UPLOAD [file path]

بارگذاری یک فایل محلی در bouncer. اگر مسیری داده نشود، به جای آن محتوای فعلی کلیپ‌بورد را بارگذاری می‌کند (نیازمند wl-paste در Wayland یا xclip در X11؛ فقط لینوکس).

SCREENSHOT

گرفتن و بارگذاری یک نماگرفت در bouncer.

نیازمند پشتیبانی از D-Bus و xdg-desktop-portal است (برای نمونه Gnome، یا xdg-desktop-portal-wlr در sway).

QUOTE <raw message>

ارسال عین کلمه raw message بدون تغییر.

LIST [pattern]

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

BUFFER <index|name>

جابه‌جایی به بافر در موقعیت index، یا بافری که شامل name باشد. فهرست بافر بر اساس نام داده‌شده پالایش می‌شود؛ وارد کردن دستور اولین بافر موجود در فهرست را انتخاب می‌کند.

WHOIS <nickname>

دریافت اطلاعات درباره کاربری که متصل است.

WHOWAS <nickname>

دریافت اطلاعات درباره کاربری که اتصالش قطع شده است.

NICK <nickname>

تغییر نام مستعار شما.

OPER <username> <password>

ورود به یک حساب کاربری اپراتور.

MODE <nick/channel> <flags> [args]

تغییر حالت‌های کاربر یا کانال.

INVITE <nick> [channel]

دعوت از nick به channel (در صورت مشخص نشدن، کانال فعلی).

KICK <nick> [channel] [message]

اخراج nick از channel (در صورت مشخص نشدن، کانال فعلی) به همراه یک پیام/دلیل اخراج اختیاری.

BAN <nick> [channel]

مسدود کردن ورود nick به channel (در صورت مشخص نشدن، کانال فعلی).

UNBAN <nick> [channel]

اجازه ورود مجدد nick به channel (در صورت مشخص نشدن، کانال فعلی).

SEARCH <text>

جستجوی پیام‌های منطبق با متن مشخص‌شده، در کانال یا سرور فعلی. این دستور یک فهرست موقت را باز می‌کند که با کلید escape بسته می‌شود..PP

AWAY [message]

علامت‌گذاری خود به‌عنوان غایب، با یک پیام غیبت اختیاری. برای لغو از BACK استفاده کنید.

BACK

اعلام بازگشت خود از وضعیت غیبت (ببینید: AWAY).

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]

پخش همگانی یک پیام برای همه کاربران (پیشرفته).

متغیرهای محیطی استاندارد زیر پشتیبانی می‌شوند.

ALL_PROXY

نشانی (URL) یک پروکسی SOCKS برای استفاده هنگام اتصال به سرور.

SSL_CERT_DIR

فهرستی از دایرکتوری‌های جداشده با دونقطه حاوی گواهی‌های TLS مورد اعتماد، در قالب c_rehash متعلق به OpenSSL.

SSL_CERT_FILE

مسیر فایلی با کدگذاری PEM، حاوی فهرستی از گواهی‌های TLS مورد اعتماد.

همچنین ببینید (SEE ALSO)

senpai(5)

نویسندگان (AUTHORS)

سازنده/سنسی: Hubert Hirtz <hubert@hirtzfr.eu>!
نگه‌دارنده کنونی: delthas <delthas@dille.cc>.
کدهای منبع در https://git.sr.ht/~delthas/senpai در دسترس است.
از دریافت وصله‌ها از طریق ایمیل به <~delthas/senpai-dev@lists.sr.ht> استقبال می‌شود.

2026-06-02