URLSCAN(1) General Commands Manual URLSCAN(1)

urlscan - مرور URLها در یک پیام ایمیل از درون ترمینال

urlscan [options] < message

urlscan [options] message

دستور urlscan یک پیام ایمیل منفرد را از ورودی استاندارد دریافت می‌کند، سپس فهرستی مبتنی بر ترمینال از URLهای موجود در پیام داده‌شده را نمایش می‌دهد. انتخاب یک URL از ماژول webbrowser پایتون برای تعیین این‌که کدام مرورگر باز شود استفاده می‌کند. در صورت تنظیم بودن، از متغیر محیطی BROWSER استفاده خواهد شد.

دستور urlscan در درجه اول برای استفاده به همراه برنامه ایمیل‌خوان mutt (1) در نظر گرفته شده است، اما با هر برنامه ایمیل مبتنی بر ترمینال دیگری نیز به خوبی کار می‌کند.

دستور urlscan شبیه به urlview(1) است، اما ویژگی‌های اضافی زیر را به همراه دارد:

1. پشتیبانی از کدگذاری‌های بیشتر پیام، مانند quoted-printable و base64.

2. استخراج و نمایش متن زمینه (context) پیرامون هر URL. تغییر وضعیت نمایش زمینه با کلید c. معکوس کردن ترتیب نمایش URLها با کلید R.

3. رونوشت URL جاری به انتخاب اصلی (primary selection) با کلید P یا به کلیپ‌بورد با کلید C.

4. پیوندها (URLها) به طور پیش‌فرض کوتاه می‌شوند تا در یک خط جا بگیرند. تغییر وضعیت کوتاه شدن یک یا تمام URLها با کلیدهای s یا S.

5. جستجوی افزایشی و غیرحساس به حروف بزرگ و کوچک با استفاده از /. پانویس عبارت جستجوی فعلی را نشان می‌دهد. فشردن مجدد / جستجو را بازنشانی می‌کند.

6. جابجایی چرخشی میان تمام پالت‌های رنگی موجود (رنگی و سیاه‌وسفید به طور پیش‌فرض موجود هستند) با استفاده از p. اجرای urlscan -g یک فایل ~/.config/urlscan/config.json برای ویرایش یا افزودن پالت‌ها و کلیدهای میانبر اضافی تولید می‌کند. برای گزینه‌های رنگی و مقادیر مجاز به نشانی زیر مراجعه کنید:

http://urwid.org/manual/displayattributes.html#display-attributes

عرض نمایش را با `--width` تعیین کنید.

7. کلید u در صورت نیاز نویسه‌های گریز (unescape) را از URL مشخص‌شده حذف می‌کند.

8. اجرای یک دستور با قرار دادن URL انتخابی به عنوان آرگومان، یا هدایت (pipe) کردن URL انتخابی به یک دستور با استفاده از آرگومان‌های --run-safe، --run و --pipe.

9. استفاده از l برای جابجایی چرخشی میان روش‌های باز شدن URLها از طریق ماژول webbrowser پایتون (پیش‌فرض)، xdg-open (در صورت نصب بودن) یا تابعی که در خط فرمان با --run-safe یا --run ارسال شده است. توابع --run و --run-safe مقدار --pipe را رعایت خواهند کرد.

10. کلید F1 منوی راهنما را نمایش می‌دهد.

11. پویش سرآیندهای خاص ایمیل برای یافتن URLها. در حال حاضر هنگام ارسال --headers سرآیندهای Link، Archived-At و List-* پویش می‌شوند.

12. قرار دادن چندین URL در صف برای باز کردن و باز کردن هم‌زمان همه آن‌ها با کلیدهای a و o.

حالت نمایش فشرده؛ متن زمینه (context) پیرامون هر URL را نشان نمی‌دهد.
حذف URLهای تکراری از فهرست URLها.
استفاده از <expression> به جای مجموعه پیش‌فرض عبارت‌های منظم (regular expressions)، برای هر نوع تطبیق. این گزینه مثلاً در مواردی مفید است که بخواهید پیوندهای 'mailto:' یا هر الگوی دیگری که ممکن است urlscan به عنوان URL تفسیر کند (مانند '<filename>.<extension>') را نادیده بگیرید. مثال کاربرد:


$ urlscan --regex 'https?://.+.216

اجرای <expression> به جای باز کردن URL با مرورگر. از {} در <expression> برای جایگذاری URL استفاده کنید. مثال‌ها:


$ urlscan --run-safe 'tmux set buffer {}'

تولید ~/.config/urlscan/config.json با گزینه‌های پیش‌فرض.
شروع برنامه با پنهان بودن منوی سرآیند.
پویش سرآیندهای خاص پیام برای یافتن URLها. در حال حاضر Link، Archived-At و List-* پویش می‌شوند.
غیرفعال کردن رابط انتخاب و چاپ پیوندها در خروجی استاندارد. مفید برای اسکریپت‌نویسی (گزینه --compact را اعمال می‌کند).
هدایت (pipe) کردن URL انتخابی به دستوری که توسط `--run-safe` یا `--run` تعیین شده است. در صورتی که دستور پشتیبانی کند، این روش ترجیح داده می‌شود زیرا امن‌تر بوده و نسبت به نویسه‌های خاص موجود در URL سازگارتر است. مثال:


$ urlscan --run-safe 'xclip -i' --pipe file.txt

معکوس کردن ترتیب نمایش URLها.
اجرای <expression> به جای باز کردن URL با مرورگر. از {} در <expression> برای جایگذاری URL استفاده کنید. ویژگی‌های پوسته مانند | و > قابل استفاده هستند، اما امنیت کمتری دارد. مثال‌ها:


$ urlscan --run 'echo {} | xclip -i' file.txt

خروج از urlscan پس از باز کردن یا رونوشت گرفتن از یک پیوند منفرد مرورگر.


$ urlscan -s file.txt

تنظیم عرض نمایش.
خط‌های خالی و نشانه‌های تعلیق (...) نمایش داده نشوند.
تنظیم حالت رنگ urwid. پیش‌فرض "16" است. "true" برابر با 2**24 رنگ و "mono" برابر با ۱ رنگ است.
چاپ نسخه urlscan.

برای یکپارچه‌سازی urlscan با mutt، دو دستور زیر را در ~/.muttrc قرار دهید:

macro index,pager \cb "<pipe-message> urlscan<Enter>" "call urlscan to extract URLs out of a message"

macro attach,compose \cb "<pipe-entry> urlscan<Enter>" "call urlscan to extract URLs out of a message"

پس از قرار گرفتن این خطوط در فایل پیکربندی mutt، فشردن Control-b به شما امکان می‌دهد پیوندهای موجود در پیام انتخاب‌شده را مرور کرده و باز کنید.

به عنوان روش جایگزین، می‌توانید پیام را با استفاده از عملگر '|' به urlscan هدایت (pipe) کنید. این کار می‌تواند برای اعمال پرچم‌های مختلف (مانند گزینه‌های '-d' یا '-c') مفید باشد.

دستور urlscan -g را اجرا کنید تا ~/.config/urlscan/config.json تولید شود. همه کلیدها فهرست خواهند شد. می‌توانید مواردی را که تغییری نمی‌کنند همان‌طور باقی بگذارید یا حذف کنید.

برای لغو انتساب یک کلید، آن را برابر "" قرار دهید. برای مثال: "P": ""

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

$HOME/.config/urlscan/config.json

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

/usr/share/doc/urlscan/README, urlview(1), mutt(1)

این صفحه راهنما توسط Daniel Burrows <dburrows@debian.org> و Scott Hansen <tech@firecat53.net> نوشته شده است.

16 August 2026