klipper-auto-eject

طابعتك ثلاثية الأبعاد تفرّغ سريرها بنفسها بين الطبعات.
شفرة مطبوعة على رأس الطباعة تدفع القطع المنتهية إلى صندوق، ثم يتأكد المجس أن السرير فارغ،
وتبدأ الطباعة التالية وحدها. لأي طابعة تعمل بـ Klipper.

البداية خطوة بخطوة · كل ما تفعله · الأسئلة الشائعة · التوثيق (بالإنجليزية) · حل المشكلات (بالإنجليزية) · النقاشات · إزالة المشروع · English

             

_{تعمل مع Klipper وMoonraker، ومع Mainsail أو Fluidd، ومع OrcaSlicer أو PrusaSlicer أو SuperSlicer أو Cura. والوصول من الهاتف عبر Tailscale، وفحص البكرة مع Spoolman، ومع DEMON وغيره من مجموعات الماكرو. (عن هذه الشعارات)}

---

Warning

برنامج تجريبي (beta) يحرّك طابعتك وحده. شاهد عدة تجارب قبل أن تترك الطابعة وحدها، واقرأ صفحة السلامة أولًا.

طريقة العمل

عندما تنتهي الطباعة، تقوم الطابعة بما يلي:

1. تبرّد السرير ورأس الطباعة يدور بمروحته فوق القطع، حتى تنفصل القطع عن السطح.
2. تدفع القطع من فوق الحافة بشفرة مثبتة على رأس الطباعة: ببطء، وبقوة محركات أقل من المعتاد، فإذا علقت قطعة يتخطى المحرك خطوات بدل أن يكسر شيئًا.
3. تفحص السرير بلمس المجس مكان كل قطعة. القطعة التي ما زالت موجودة تُدفع مرة أخرى، أخفض وبقوة أكبر.
4. تبدأ الطباعة التالية من قائمة Moonraker، أو توقف القائمة إذا بقيت قطعة على السرير، فلا يُطبع شيء فوقها أبدًا.

تعرف الطابعة مكان كل قطعة لأن برنامج التقطيع يكتب حدود القطع داخل ملف G-code (خيار Label objects). لا شيء يحتاج إلى قياس باليد.

كل ما تفعله

كل سطر اختصار إلى صفحته.

تفريغ السرير

	باختصار
التبريد والدفع والفحص	بعد كل طبعة يبرد السرير، وتدفع الشفرة القطع، ويتأكد المجس أن السرير فارغ. والتبريد لا ينتظر إلى الأبد: في غرفة دافئة تُدفع القطع بعد مهلة محددة
رفيقة بالطابعة	تيار محركات أقل أثناء الدفع، يُضبط وحده لمشغلات TMC، فإذا علقت قطعة يتخطى المحرك خطوات بدل أن يكسر شيئًا. والقطعة التي تبقى تُدفع مرة أخرى، أخفض وبقوة أكبر، ثم تتوقف القائمة
ثلاث طرق للدفع (بالإنجليزية)	مسارات متجاورة تناسب أي ترتيب، أو قطعة في كل مرة، أو السرير كله؛ إلى الأمام أو الخلف أو اليسار أو اليمين
القطع الرفيعة (بالإنجليزية)	الطبعات المسطحة مثل الاستنسل، التي لا تمسكها الشفرة، تبقى على السرير وتنتظرك القائمة
إعادة التشغيل وانقطاع الكهرباء (بالإنجليزية)	تتذكر الطابعة أماكن القطع، وتضبط المحاور دون أن تلمسها، ولا تطبع فوقها أبدًا
صندوق القطع (بالإنجليزية)	يعدّ القطع في الصندوق تحت حافة السقوط، وينبّه عند 80 %، ويوقف الطبعة التالية عندما يمتلئ
المجسات (بالإنجليزية)	مجسات اللمس، والتي بجانب الفوهة، ومجسات التيار الدوامي، والطابعات بلا مجس أيضًا
EJECT_PURGE (بالإنجليزية)	حبة تنظيف تدفعها الشفرة، بدل خط تنظيف يتراكم على السرير

الإعداد

	باختصار
تثبيت بسطر واحد	يسألك عما تريد بكلمات بسيطة، ويضيف ما يحتاجه printer.cfg، ويتحدّث من Mainsail أو Fluidd
الشفرة (بالإنجليزية)	ثلاث قطع مطبوعة تناسب معظم رؤوس الطباعة؛ بعرض 60 أو 80 أو 100 مم، أو أي مقاس من ملف OpenSCAD
الإعداد الموجّه	خمس نوافذ في Mainsail أو Fluidd، بلا تعديل ملفات وبلا مسطرة. ومع Voron Tap تقيس الشفرة نفسها
برنامج التقطيع	Label objects وسطر واحد في G-code النهاية، لـ OrcaSlicer وPrusaSlicer وSuperSlicer وCura
ماكروهاتك (بالإنجليزية)	الماكروهات الأصلية، وDEMON Klipper Essentials، وKlippain، وRatOS وغيرها
طباعة متتالية	قائمة مهام Moonraker: تبدأ الطبعة التالية بعد أن يفرغ السرير
الإعدادات (بالإنجليزية)	كل إعداد مشروح، في ملفك الخاص الذي لا تلمسه التحديثات
إزالة المشروع	سطر واحد يزيله كله

صفحة الويب

	باختصار
نظرة عامة	خريطة حية للسرير بالقطع ومسارات الدفع، وأزرار للإزالة أو التجربة
قائمة الطباعة	أضف الملفات بصورها، وحدد عدد النسخ، وابدأ القائمة أو أوقفها
فحص ملف	قبل الطباعة: هل القطع معلّمة، وهل تصل إليها الشفرة، والخطة على خريطة السرير
الشفرة والإعداد	الشفرة المقيسة، والإعداد، وقطع الاختبار، وما تلصقه في برنامج التقطيع
الإعدادات	كل إعداد بمفتاح أو خانة، وتغييراتي فقط
العتاد	اللوحات والمحركات والسخانات والمراوح والكمبيوتر والكاميرا، مباشرةً، وما فيها من خلل
التحديثات	ما تغيّر في Klipper منذ نسختك، وهل تحتاج اللوحات إعادة برمجة
الإبلاغ عن مشكلة	ما يطلبه بلاغ GitHub في نص واحد، دون عناوينك
صور المطبوعات	كل ملف بصورته ومدته وخيطه وخامته
بالعربية والإنجليزية	فاتحة أو داكنة، من اليمين إلى اليسار، وعلى الهاتف؛ واللغات الأخرى مرحب بها
جرّب العرض التجريبي	الصفحة كلها مع طابعة افتراضية، بلا طابعة

بعيدًا عن الطابعة

	باختصار
من أي مكان	Tailscale، شبكة خاصة مجانية بين أجهزتك: لا يُفتح شيء على الإنترنت
كتطبيق	يُثبَّت بأيقونته واختصاراته، وعلى الأيقونة رقم الطابعات التي تحتاجك
الإشعارات	عندما تحتاجك الطابعة، والصفحة مغلقة: في التطبيق، أو ntfy، أو Telegram، أو Discord
Spoolman	تتوقف القائمة قبل مهمة لا تكفيها البكرة المركّبة

طابعات كثيرة

	باختصار
مزرعة الطابعات	كل طابعات Klipper على الشبكة في صفحة واحدة، والتي تحتاجك أولًا؛ والطابعات الأخرى لا تحتاج أي تثبيت
أزرارها	اطبع، وأرسل ملفًا، وأوقف مؤقتًا، وألغِ، وابدأ القائمة، وإيقاف الطوارئ، والتشغيل والإطفاء، والإطفاء وحدها عندما لا يكون لديها عمل
الصيانة والتقرير اليومي	تذكير كل عدد من ساعات الطباعة، وملخص اليوم على الهواتف
طابعة واحدة أو مئة	تصفية، وبحث، وقائمة، ومجموعات حسب الرف أو الغرفة
قائمة واحدة للمزرعة كلها	ملف يُطبع 50 مرة: كل نسخة لأول طابعة متاحة
عدة طابعات معًا	أمر واحد، أو ملف واحد للطباعة، للطابعات التي تختارها
الإنتاج	ما صنعته كل طابعة اليوم أو في 7 أو 30 يومًا، مع ملف CSV، وبكرة كل منها
إعدادات لكل نوع من الطابعات	اضبط واحدة وانسخها للباقي، أو احفظها باسم للطابعة التالية
ملصق QR على كل طابعة	اطبعه وألصقه؛ كاميرا الهاتف تفتح صفحة تلك الطابعة
تحديث المزرعة كلها	نسخ كل الطابعات، وتحديث المتاحة منها من مكان واحد

الماكروهات تُختبر تلقائيًا مع كل تغيير، على إصدارات Jinja2 التي يستخدمها Klipper.

هل يناسبني؟

تحتاج إلى	لماذا	كيف تتأكد
طابعة تعمل بـ Klipper، مع Mainsail أو Fluidd	المشروع مبني من ماكروهات Klipper	تفتح الطابعة في المتصفح
سطح طباعة يترك القطع عندما يبرد	الشفرة تدفع، ولا تستطيع أن تقتلع القطع	القطعة بعد أن تبرد تنزلق بدفعة إصبع
برنامج تقطيع يستطيع تعريف القطع (Label objects)	بهذا تعرف الطابعة أين القطع	OrcaSlicer وPrusaSlicer وSuperSlicer، وCura مع إضافة Klipper
إمكانية طباعة شفرة من PETG أو ABS أو ASA	تُركّب على رأس الطباعة	ثلاث قطع صغيرة، حوالي 3 ساعات
يُنصح به: مجس	ليتأكد أن السرير فارغ قبل الطباعة التالية	Voron Tap، BLTouch، Klicky، مجس حثي…

لا يناسب طابعات دلتا، ولا الطابعات التي تعمل بـ Marlin أو Bambu Lab أو البرنامج الثابت الأصلي من Prusa.

كيف تبدأ

دليل المبتدئين يمشي معك في كل خطوة، ويخبرك كيف تتأكد أنها نجحت. باختصار:

1. افحص السرير: القطعة بعد أن تبرد يجب أن تنزلق بدفعة إصبع.
2. اطبع الشفرة من hardware/stl/: شفرة وذراع وقاعدة تثبيت.
3. ركّبها على رأس الطباعة، واضبط ارتفاعها بالمقياس المطبوع (hardware.md، بالإنجليزية).
4. ثبّت الماكروهات عبر SSH، بسطر واحد:

   cd ~ && if [ -d klipper-auto-eject ]; then git -C klipper-auto-eject pull --ff-only; else git clone https://github.com/ahmedbebars/klipper-auto-eject.git; fi && ./klipper-auto-eject/install.sh
   

   يسألك ماذا تريد في شاشة واحدة من العلامات (صفحة الويب؟ هاتفك؟ الإشعارات؟ أكثر من طابعة؟)، ويضيف ما يحتاجه printer.cfg، ثم يعيد تشغيل Klipper بنفسه إذا لم تكن الطابعة تطبع (التثبيت). وإزالته لاحقًا سطر واحد أيضًا (إزالة المشروع).
5. شغّل الإعداد الموجّه: اكتب AUTO_EJECT_SETUP في الطرفية (Console) واضغط الأزرار. مع Voron Tap تقيس الطابعة الشفرة بنفسها (بالصور، بالإنجليزية).
6. شاهد تجربة: اطبع مكعبين أو ثلاثة للاختبار، واتركها على السرير، وشغّل AUTO_EJECT.
7. برنامج التقطيع: فعّل Label objects، وأضف AUTO_EJECT HEIGHT=[max_layer_z] HOME=1 إلى كود النهاية، تحت ماكرو النهاية (slicer-setup.md، بالإنجليزية).
8. اطبع مهام متتالية: فعّل قائمة المهام في Moonraker (job queue)، وأضف إليها ما تشاء من الطبعات.

إزالة المشروع

سطر واحد يزيل كل شيء، فتعمل طابعتك كما كانت (ما الذي يزيله وما الذي يبقى):

~/klipper-auto-eject/install.sh --uninstall

ثم أعد تشغيل Klipper بالأمر FIRMWARE_RESTART، وليس أثناء الطباعة أبدًا.

صفحة الويب

صفحة اختيارية اسمها الإزالة التلقائية، ورابطها Auto-eject في القائمة الجانبية لـ Mainsail. فيها خريطة حية للسرير تظهر عليها القطع ومسارات الدفع، وأزرار للإزالة أو للتجربة، وقائمة الطباعة، وفحص يخبرك قبل الطباعة هل يمكن تفريغ السرير من ملف ما تلقائيًا، وإعداد الشفرة، وكل الإعدادات، وعتاد الطابعة. بالإنجليزية أو العربية، بوضع فاتح أو داكن، وعلى الهاتف أيضًا.

~/klipper-auto-eject/install.sh --web

يطلب كلمة المرور مرة واحدة، من أجل خادم الويب. التفاصيل في صفحة الويب. ويمكنك أيضًا تجربة نسخة العرض دون طابعة.

على هاتفك، كتطبيق

من أي مكان: الأمر install.sh --remote يجهّز Tailscale، وهي شبكة خاصة مجانية بين أجهزتك، فتفتح الطابعة من هاتفك أينما كنت، دون فتحها على الإنترنت (من الهاتف). وعبر HTTPS تُثبَّت الصفحة كتطبيق له أيقونته الخاصة، والأمر install.sh --push يرسل إليه إشعارًا عندما تحتاجك الطابعة، حتى وهو مغلق (الإشعارات).

مزرعة الطابعات

الأمر install.sh --farm على طابعة واحدة يضع كل طابعات Klipper على شبكتك في صفحة واحدة، والتي تحتاجك تظهر أولًا. زر ابحث في الشبكة يجدها ويضيفها، والطابعات الأخرى لا تحتاج أي تثبيت (مزرعة الطابعات). وهي مصنوعة لطابعة واحدة أو لمئة: تصفية، وبحث، وقائمة بسطر لكل طابعة، ومجموعات حسب الرف أو الغرفة، وتحديث المزرعة كلها من مكان واحد، للطابعات التي لا تفعل شيئًا فقط.

عتاد الطابعة

تبويب العتاد يعرض كل ما يقوله Klipper وMoonraker عن الطابعة، مباشرة: كل لوحة ومدى سلامة اتصالها (USB أو CAN)، وكل محرك وتحذيرات مشغّله، والسخانات، والمراوح، والكمبيوتر، والحساسات، والكاميرا، مع سطر واحد يقول هل كل شيء طبيعي. ومع install.sh --push تصل التحذيرات المهمة إلى هاتفك والصفحة مغلقة: مروحة توقفت، أو محرك ساخن، أو كابل بدأ يتلف (صفحة الويب).

الشفرة

_{مركّبة على Voron Trident 450 برأس طباعة Stealthburner، وشفرة بعرض 100 مم.}

ثلاث قطع مطبوعة تُربط بمسامير M3. كل وصلة فيها فتحات طولية، لذلك تناسب معظم رؤوس الطباعة: قاعدة التثبيت تقبل مسامير رأس طباعة المسافة بينها 28–50 مم (أو رباطًا)، ويُضبط الارتفاع والمسافة إلى الأمام داخل الفتحات. الشفرات متاحة بعرض 60 و80 و100 مم، وملف OpenSCAD المصدري يصنع أي مقاس آخر. انظر hardware.md.

تقيس نفسها. مع Voron Tap أو أي مجس يلمس بالفوهة، تطبع قطعة صغيرة وتتركها على السرير. تلمسها الطابعة بالفوهة، ثم بالشفرة، وتحسب ارتفاع الشفرة وبعدها أمام الفوهة، في 2–3 دقائق.

التوافق

نوع الطابعة	الحالة	ملاحظات
CoreXY (Voron وRatRig وVzBot وSovol SV08…)	✅	مثالية: السرير لا يتحرك
كارتيزية بسرير ثابت	✅
طابعة بسرير متحرك (Ender 3، أو مثل Prusa MK3) تعمل بـ Klipper	✅	ادفع إلى اليسار أو اليمين، حتى لا يهز السرير المتحرك القطع
Klipper من الشركة المصنعة (Creality K1، Qidi، Sovol)	⚠️	تعمل إذا كنت تستطيع تعديل الإعدادات، وكان البرنامج الثابت قريبًا من النسخة الرسمية
دلتا	❌	التخطيط يفترض سريرًا مستطيلًا
Marlin وBambu Lab والبرنامج الثابت الأصلي من Prusa	❌	Klipper فقط

الاختبار الميداني: أول التجارب على عتاد حقيقي تجري على Voron Trident 450 مع Voron Tap. تقارير الطابعات الأخرى مرحب بها جدًا: شارك تجربتك هنا.

الأوامر اليومية

الأمر	ماذا يفعل
AUTO_EJECT	يبرّد، ويدفع القطع خارج السرير، ثم يفحص السرير
AUTO_EJECT DRY=1	يمر بالمسار فوق السرير دون دفع
AUTO_EJECT HOME=1	بعد إعادة التشغيل: يضبط المحاور بأمان حول القطع، ثم يزيلها
AUTO_EJECT_CLEAR	أزلت القطع بيدك: ينساها
AUTO_EJECT_SETUP	الإعداد الموجّه
AUTO_EJECT_SET KEY=cool_temp VALUE=35	يغيّر إعدادًا واحدًا ويحفظه

كل الأوامر والخيارات: commands.md (بالإنجليزية).

التوثيق

ابدأ من هنا	الإعداد	كل يوم	الضبط الدقيق والمساعدة
البداية خطوة بخطوة	الشفرة	الأوامر	الإعدادات
الأسئلة الشائعة	التثبيت	التكامل	طرق الدفع
قاموس المصطلحات	الإعداد الموجّه	الاسترداد	المجسات
السلامة	برنامج التقطيع	صفحة الويب	حل المشكلات
الشروحات بالعربية	إزالة المشروع
		من الهاتف
		الإشعارات
		مزرعة الطابعات

الصفحات المكتوبة بالعربية مذكورة في الشروحات بالعربية، وروابط باقي الصفحات تفتح النسخة الإنجليزية.

المساهمة

بلاغات الأخطاء، وملاحظاتك عن طابعتك، وطلبات الدمج (pull requests) كلها مرحب بها؛ انظر CONTRIBUTING.md (بالإنجليزية). إذا شغّلت المشروع على طابعتك، شارك من فضلك شفرتك وإعداداتك في النقاشات ليبدأ منها الآخرون. وترجمات صفحة الويب مرحب بها أيضًا (الطريقة). أما الثغرة الأمنية فتُبلَّغ في بلاغ خاص لا في issue علني: انظر SECURITY.md (بالإنجليزية).

الرخصة

رخصة GNU GPLv3، وهي نفس رخصة Klipper. © 2026 Ahmed Bebars.

الشروحات بالعربية

الصفحة	محتواها
البداية خطوة بخطوة	الطريق كله خطوة بخطوة للمبتدئين، من فحص السرير إلى طباعة مهام متتالية
التثبيت	سكربت التثبيت، والتثبيت باليد، والتحديث، وإلغاء التثبيت
إزالة المشروع	سطر واحد يزيله من الطابعة، وما الذي يبقى بعده
صفحة الويب	صفحة الإزالة التلقائية في Mainsail: تثبيتها وما تعرضه
من الهاتف	مراقبة الطابعة والتحكم فيها من هاتفك من أي مكان، دون فتحها على الإنترنت
الإشعارات	رسالة على هاتفك عندما تحتاجك الطابعة، أو عندما تنتهي طباعة
مزرعة الطابعات	كل طابعات شبكتك في صفحة واحدة، تجدها وحدها؛ والطابعات الأخرى لا تحتاج أي تثبيت
البكرة وSpoolman	مع Spoolman، تتوقف القائمة قبل مهمة لا تكفيها البكرة المركّبة على الطابعة
برامج اللوحات	بعد تحديث Klipper، سطر واحد يجعل برنامج كل لوحة على نسخة Klipper
الأسئلة الشائعة	إجابات قصيرة: هل تخدش السرير، هل أحتاج مجسًا، كم تستغرق…
السلامة	ما الذي قد يحدث خطأ، وما تراقبه قبل أن تترك الطابعة وحدها

باقي الصفحات بالإنجليزية، وتجدها كلها في فهرس التوثيق.