استخدام transcript1 من سطر الأوامر

للحصول على النص المفرغ من الطرفية، شغل transcript1 وأتبعه برابط فيديو أو مسار ملف صوت أو فيديو من جهازك. يدعم CLI روابط YouTube وX وTikTok وInstagram وFacebook وBluesky، والمنصات الإضافية بالإصدارات الموضحة أدناه. راجع المصادر والخيارات لقيود الروابط المدعومة. النسخة المستقلة من CLI تعمل دون Node.js.

روابط التواصل الاجتماعي تتطلب CLI 1.2.0 أو أحدث. الإصدار 1.1.0 وما قبله يقبل YouTube فقط، ويرفض الروابط الجديدة قبل إرسالها إلى API. حدث الأداة بالأمر transcript1 update.

هذا الحد الأدنى يخص المنصات الست الأصلية. لروابط Twitch وDailymotion وPinterest وLinkedIn وSnapchat، تحتاج إلى إصدار يتضمن دعمها؛ قد يرفضها إصدار أقدم محليا.

أرسل رابط منشور عام. إذا احتوى على عدة فيديوهات، نفرغ الأول فقط. صيغ الروابط القصيرة المقبولة وحدودها موضحة في المصادر والخيارات.

ثبت الأداة

للتثبيت على macOS أو Linux بمعمارية x64 أو ARM64، شغل:

curl -fsSL https://transcript1.com/install.sh | sh

يحفظ برنامج التثبيت الملف التنفيذي في ~/.local/bin، ويوضح لك كيف تضيفه إلى PATH إذا لزم الأمر. لتختار مجلدا آخر، حدد TRANSCRIPT1_INSTALL_DIR.

يمكنك أيضا استخدام الاختصار t1 بدلا من transcript1. وفي zsh، يضيف برنامج التثبيت alias transcript1='noglob transcript1' إلى ~/.zshrc حتى تعمل الروابط المحتوية على ? دون اقتباس. إذا لم ترد هذا التعديل، اضبط TRANSCRIPT1_NO_MODIFY_SHELL=1.

على Windows x64، نفذ الأمر التالي في PowerShell:

irm https://transcript1.com/install.ps1 | iex

يثبت البرنامج في %LOCALAPPDATA%\Programs\transcript1 ويضيف المجلد إلى PATH الخاص بالمستخدم. يضيف أيضا الاختصار t1.cmd. افتح طرفية جديدة بعد التثبيت ليصبح الأمر متاحا.

اربط الأداة بحسابك

ابدأ بالأمر:

transcript1 login

يفتح الأمر transcript1.com في المتصفح. إذا كنت متصلا عبر SSH أو تعمل دون شاشة، يعرض الرابط في الطرفية بدلا من فتحه. طابق الرمز في الطرفية مع الرمز على الصفحة، ثم اضغط «Approve». بعد الموافقة، يحفظ CLI مفتاحا باسم transcript1 CLI (<computer name>)؛ ستجده في صفحة «API keys».

إذا أردت عرض الرابط فقط دون فتح المتصفح، استخدم transcript1 login --no-browser.

إذا كان لديك مفتاح بالفعل، شغل transcript1 login --with-key والصقه. يمكنك أيضا تمريره عبر stdin، مثل transcript1 login < key.txt.

في CI أو عند تشغيل وكيل، استخدم متغير البيئة TRANSCRIPT1_API_KEY؛ له الأولوية على المفتاح المحفوظ. وإذا لم يكن للوكيل مفتاح أو طرفية تفاعلية، يمكنه تشغيل transcript1 login < /dev/null وإرسال رابط الموافقة إليك.

لإلغاء مفتاح CLI وحذفه من جهازك، شغل transcript1 logout. إذا تعذر إلغاؤه، تحذف الأداة النسخة المحلية وتطلب منك إلغاءه من صفحة «API keys». أما المفتاح الذي لصقته بنفسك، فألغه من الصفحة مباشرة.

أرسل رابط فيديو

transcript1 'https://youtu.be/dQw4w9WgXcQ'

ينتظر CLI اكتمال التفريغ، ثم يطبع النص على stdout. يبحث أولا عن ترجمة نصية مناسبة بلغة الفيديو الأصلية على YouTube وX وTikTok وBluesky وDailymotion وLinkedIn. إن لم تتوفر، يستخدم التفريغ الصوتي بالذكاء الاصطناعي. تظهر رسائل التقدم على stderr.

ضع الرابط بين علامتي اقتباس في zsh. من دونهما، يقسم & الأمر، ويتعامل zsh مع ? كنمط glob، إلا إذا استخدمت alias الذي أضافه برنامج التثبيت.

ارفع ملفا من جهازك

transcript1 interview.mp3
transcript1 -f srt -o interview.srt interview.mp3

أرسل ملفا حتى 2 GB، أي 2,000,000,000 بايت. نقبل امتدادات mp3 وwav وm4a وflac وogg وopus وmp4 وmov وwebm وmkv. يتولى CLI الرفع وينتظر النص المفرغ.

عالج عدة تسجيلات معا

يمكنك إرسال أكثر من ملف أو رابط، أو تحديد مجلد كامل:

transcript1 interview.mp3 lecture.mp4
transcript1 -o transcripts/ ./recordings
transcript1 --jobs 4 -o transcripts/ interview.mp3 'https://youtu.be/dQw4w9WgXcQ'

تعمل أنماط الملفات مثل recordings/*.mp3 على Windows أيضا. عند تحديد مجلد، يعالج CLI ملفات الصوت والفيديو الموجودة فيه مباشرة، مرتبة بالاسم. ومع عدة مدخلات، يحفظ ملفا لكل تسجيل في ./transcripts افتراضيا. لضبط عدد التسجيلات التي تعالج معا، استخدم --jobs بقيمة من 1 إلى 20؛ الافتراضي 2.

للقراءة من stdin، استخدم - وضع رابطا أو مسار ملف في كل سطر. مثلا، على macOS أو Linux:

transcript1 -o transcripts/ - < inputs.txt

يتجاهل CLI الأسطر الفارغة والأسطر التي تبدأ بالرمز #. وإذا تكرر المدخل نفسه تماما، يعالجه مرة واحدة فقط.

مع مدخل واحد، يحدد -o اسم الملف الذي سيحفظ النص. إذا كان المسار مجلدا موجودا أو ينتهي بالرمز /، يحفظ الملف داخله. ومع عدة مدخلات، يجب أن يحدد -o مجلدا. ينشئ CLI مجلد الحفظ إذا لم يكن موجودا.

إذا كان ملف النص موجودا بالفعل لرابط YouTube أو ملف محلي، يتخطاه CLI. لإعادة المعالجة والكتابة فوقه، أضف --overwrite:

transcript1 --overwrite -o transcripts/ ./recordings

اختر التنسيق والإعدادات

لإظهار المتحدث والطابع الزمني مع النص، شغل:

transcript1 --speakers --timestamps --language en interview.mp3

لا تستخدم --speakers مع --source captions. عند auto، يؤدي تمييز المتحدثين إلى استخدام الصوت مباشرة بدلا من الترجمة النصية. ما زال دعم الترجمة النصية في YouTube وX كما كان، وتتوفر أيضا مسارات TikTok وBluesky وDailymotion وLinkedIn. خارج YouTube، التوقيت للمقاطع فقط، وتكون القيمة words: null حتى للمسارات المنشأة تلقائيا. راجع المصادر والخيارات لمعرفة إمكانات كل منصة وكيفية اختيار اللغة.

استخدم CLI في سكربت أو مع وكيل

إذا كان وكيلك يستطيع تشغيل أوامر shell، يمكنه تثبيت CLI وتعيين TRANSCRIPT1_API_KEY ثم تشغيل transcript1 <link> أو transcript1 <file>. أما إذا كان يستخدم MCP، فاتبع إعداد خادم MCP.

استخدم --json ليصدر stdout سطر JSON لكل مدخل بمجرد انتهاء معالجته. لن تظهر رسائل تقدم أو ملخصات أو إشعارات تحديث:

transcript1 --json 'https://youtu.be/dQw4w9WgXcQ'

للمهمة المنتهية، تحصل على كائن التفريغ من API مع الحقلين input وreused. إذا حفظ CLI النص في ملف، يحتوي السطر على file بدلا من transcript. وإذا وقع خطأ قبل إنشاء معرف، تحصل على input وكائن error بحقلين هما code وmessage. وعند تخطي مدخل، تحصل على input وskipped بقيمة exists أو out_of_minutes، ومعهما file متى انطبق ذلك. قيمة exists تخص روابط YouTube والملفات المحلية فقط.

إذا أرسلت مدخلا واحدا دون -o، يضع --json النص المفرغ داخل الكائن ويتجاهل -f. وإذا أرسلت عدة مدخلات دون -o، يحفظ النصوص في ./transcripts ويضع file بدلا من transcript في كل سطر JSON. عند الحفظ إلى ملف، يحدد -f تنسيق الملف دائما. ولإخفاء التقدم والملخصات فقط مع إبقاء النصوص والأخطاء، استخدم -q أو --quiet.

يمكنك بدء التفريغ والعودة إليه لاحقا:

transcript1 --no-wait interview.mp3
transcript1 get <id>

خذ المعرف الذي طبعه الأمر الأول وضعه مكان <id>. يطبع --no-wait المعرف والحالة، أو كائن JSON إذا أضفت --json. أما get، فينتظر انتهاء التفريغ، ويقبل -f و-o و--timestamps و--no-wait و--json و-q.

حدث الأداة

transcript1 update

عندما يكون stderr متصلا بطرفية، يبحث CLI عن إصدار أحدث مرة واحدة على الأكثر كل 24 ساعة، وينبهك إذا وجده. لتعطيل الفحص، اضبط TRANSCRIPT1_NO_UPDATE_CHECK=1. يخفي --json و-q إشعار التحديث أيضا.

اقرأ رمز الخروج في سكربتك

للاطلاع على جميع الأوامر والخيارات، شغل transcript1 --help أو transcript1 دون معاملات.