الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Immich-Go: قم بتحميل صورك إلى خادم Immich الخاص بك

Immich-Go هي أداة مفتوحة المصدر مصممة لتسهيل تحميل مجموعات الصور الكبيرة إلى خادم Immich المستضاف ذاتيًا.

يمكنك الآن دعم عملي على Immich-go :

  • الراعي جيثب
  • التبرع باي بال

الميزات الرئيسية:

  • قم بتحميل صور Google Photos Takeouts الكبيرة بسهولة: تتفوق Immich-Go في التعامل مع الأرشيفات الضخمة التي تقوم بتنزيلها من صور Google باستخدام Google Takeout. يقوم بمعالجة هذه الأرشيفات بكفاءة مع الحفاظ على البيانات الوصفية القيمة مثل موقع GPS وتاريخ الالتقاط ومعلومات الألبوم.
  • التحميلات المرنة: لا يقتصر تطبيق Immich-Go على صور Google. يمكنك تحميل الصور مباشرة من مجلدات جهاز الكمبيوتر الخاص بك، وشجرة المجلدات، وأرشيفات ZIP.
  • التثبيت البسيط: لا يتطلب Immich-Go تثبيت NodeJS أو Docker. وهذا يجعل من السهل البدء، حتى بالنسبة لأولئك الأقل دراية بالبيئات التقنية.
  • إعطاء الأولوية للجودة: يتجاهل Immich-Go أي إصدارات ذات دقة أقل قد يتم تضمينها في Google Photos Takeout، مما يضمن حصولك على أفضل النسخ الممكنة على خادم Immich الخاص بك.
  • كومة من الصور المتتالية والصور الخام/JPG : قم بتجميع الصور ذات الصلة معًا في Immich.

أفضل ممارسات صور Google:

  • إخراج صورك:

    • اختر تنسيق ZIP عند إنشاء ملف Takeout الخاص بك لتسهيل عملية الاستيراد.
    • حدد أكبر حجم متاح للملف (50 جيجابايت) لتقليل عدد أجزاء الأرشيف.
    • تحميل جميع الأجزاء على جهاز الكمبيوتر الخاص بك.

  • استيراد صورك:

    • إذا كان ملف Takeout الخاص بك بتنسيق ZIP، فيمكنك استيراده مباشرةً دون الحاجة إلى فك ضغط الملفات أولاً.
    • من المهم استيراد جميع أجزاء النسخة الخارجية معًا، نظرًا لأن بعض البيانات قد تكون منتشرة عبر ملفات متعددة.
      استخدم /path/to/your/files/takeout-*.zip كاسم للملف.
    • بالنسبة لملفات ‎.tgz (أرشيفات القطران المضغوطة)، ستحتاج إلى فك ضغط جميع الملفات في مجلد واحد قبل الاستيراد. عند استخدام أداة الاستيراد، لا تنس خيار -google-photos .
    • يمكنك إزالة أي ملفات أو مجلدات غير مرغوب فيها من Takeout الخاص بك قبل الاستيراد.
    • لن تتسبب إعادة تشغيل عملية الاستيراد التي تمت مقاطعتها في حدوث أي مشكلات وستستأنف العمل من حيث توقفت.

  • لا يتم استيراد الكثير من الملفات : ما هي الخيارات؟

    • تحقق مما إذا كانت جميع أجزاء الإخراج قد تم تضمينها في المعالجة.
    • اطلب إخراجًا آخر، إما لمدة عام كامل أو بزيادات أقل.
    • فرض استيراد الملفات على الرغم من فقدان JSON. استخدم الخيار -upload-when-missing-JSON

للحصول على نظرة ثاقبة حول الأسباب الكامنة وراء هذا البديل لـ immich-cli ، يرجى قراءة الدافع هنا.

⚠️ هذه نسخة مبكرة، ولم يتم اختبارها على نطاق واسع بعد
⚠️ احتفظ بنسخة احتياطية من ملفاتك للسلامة

تنفيذ immich-go

immich-go هي أداة سطر أوامر يجب تشغيلها من نافذة طرفية.
يستخدم برنامج immich-go واجهة برمجة تطبيقات Immich. ومن ثم فهو يحتاج إلى عنوان الخادم ومفتاح API صالح.

على أصدقاء Linux وmacOS وFreeBSD: 

./immich-go -server=URL -key=KEY -general_options COMMAND -command_options... {path/to/files}

مهم

يتعين على مستخدمي macOS السماح بشكل صريح بتشغيل immich-go. افتح الخصوصية والأمان > إعدادات الأمان للسماح بذلك

على أنظمة ويندوز: 

.immich - go - server = URL - key = KEY - general_options COMMAND - command_options.. . {path / to / files}

كيف يتم التعامل مع الخيارات المنطقية

الخيارات المنطقية لها قيمة افتراضية موضحة أدناه. يؤدي ذكر أي خيار على السطر المشترك إلى تغيير الخيار إلى TRUE. لفرض خيار على FALSE، استخدم الصيغة التالية: -option=FALSE .

مثال: Immich-go تحقق من شهادة SSL الخاصة بالخادم. يمكنك تعطيل هذا السلوك عن طريق تشغيل خيار skip-verify-ssl . فقط قم بإضافة -skip-verify-ssl . -skip-verify-ssl يعادل -skip-verify-ssl=TRUE . لإيقاف تشغيل الميزة (وهو السلوك الافتراضي)، استخدم -skip-verify-ssl=FALSE

خيارات مشتركة مع كافة الأوامر

المعلمة وصف القيمة الافتراضية
-use-configuration=path/to/config/file يحدد ملف التكوين المراد استخدامه.
يتم تخزين عنوان URL للخادم ومفتاح API في ملف تكوين immich-go. ويمكن حذفها للأشواط القادمة.		 لينكس $HOME/.config/immich-go/immich-go.json
ويندوز %AppData%immich-goimmich-go.json
macOS $HOME/Library/Application Support/immich-go/immich-go.json
-server=URL عنوان URL لخدمة Immich، على سبيل المثال http://:2283 أو https://your-domain.tld
-api=URL عنوان URL لنقطة نهاية Immich api (http://container_ip:3301)
-device-uuid=VALUE فرض تعريف الجهاز $HOSTNAME
-client-timeout=duration ضبط المهلة لمكالمات الخادم. المدة عبارة عن رقم عشري بلاحقة وحدة، مثل "300ms" أو "1.5m" أو "45m". وحدات الوقت الصالحة هي "ms"، "s"، "m"، "h". 5m
-skip-verify-ssl تخطي التحقق من SSL للاستخدام مع الشهادات الموقعة ذاتيًا false
-key=KEY مفتاح تم إنشاؤه بواسطة المستخدم. الصور التي تم تحميلها ستكون مملوكة لمالك المفتاح.
-log-level=LEVEL اضبط إسهاب السجل كما يلي:
- ERROR : عرض الأخطاء فقط
- WARNING : نفس السابق بالإضافة إلى خطأ غير محظور
- INFO : رسائل المعلومات		 INFO
-log-file=/path/to/log/file كتابة كافة الرسائل إلى ملف لينكس $HOME/.cache/immich-go/immich-go_YYYY-MM-DD_HH-MI-SS.log
Windows %LocalAppData%immich-goimmich-go_YYYY-MM-DD_HH-MI-SS.log
macOS $HOME/Library/Caches/immich-go/immich-go_YYYY-MM-DD_HH-MI-SS.log
-log-json قم بإخراج السجل كملف JSON محدد الأسطر false
-time-zone=time_zone_name قم بتعيين المنطقة الزمنية للتواريخ دون معلومات المنطقة الزمنية المنطقة الزمنية للنظام
-no-ui تعطيل واجهة المستخدم false
-debug-counters تمكين إنشاء ملف CSV بجانب ملف السجل false
-api-trace تمكين تتبع مكالمات API false

upload الأمر

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

التبديل والخيارات:

المعلمة وصف القيمة الافتراضية
-album="ALBUM NAME" قم باستيراد الأصول إلى ألبوم Immich ALBUM NAME .
-dry-run معاينة جميع الإجراءات كما سيتم تنفيذها. FALSE
-create-album-folder قم بإنشاء ألبومات immich بعد أسماء المجلدات. FALSE
-use-full-path-album-name استخدم المسار الكامل للملف لتحديد اسم الألبوم. FALSE
-album-name-path-separator يحدد كيفية ضم المجلدات (الفرعية) المتعددة، إن وجدت
-create-stacks كومة JPG / الخام أو رشقات نارية. FALSE
-stack-jpg-raw التحكم في تراص الصور بتنسيق jpg/raw. FALSE
-stack-burst السيطرة على رشقات نارية التراص. FALSE
-select-types=".ext,.ext,.ext..." قائمة الامتدادات المقبولة
-exclude-types=".ext,.ext,.ext..." قائمة الملحقات المستبعدة
-when-no-date=FILE|NOW عندما لا يمكن تحديد تاريخ الالتقاط، استخدم تاريخ الملف أو الوقت الحالي الآن. FILE
-exclude-files=pattern تجاهل الملفات بناءً على النمط. غير حساس لحالة الأحرف. كرر الخيار لكل نمط تحتاجه. @eaDir/
@__thumb/
SYNOFILE_THUMB_*.*
Lightroom Catalog/
thumbnails/

اختيار التاريخ:

ضبط الاستيراد بناءً على تواريخ محددة:

المعلمة وصف
-date=YYYY-MM-DD استيراد الصور الملتقطة في يوم معين.
-date=YYYY-MM حدد الصور الملتقطة خلال شهر معين.
-date=YYYY حدد الصور التي تم التقاطها خلال سنة معينة.

استبعاد الملفات بناءً على النمط

استخدم -exclude-files=PATTERN لاستبعاد ملفات أو أدلة معينة من التحميل. كرر الخيار لكل نمط تحتاجه. يتم استبعاد الدلائل التالية تلقائيًا:

  • @eaDir/
  • @__إبهام/
  • SYNOFILE_THUMB_*.*
  • كتالوج لايت روم/
  • الصور المصغرة/
  • .DS_Store/

على سبيل المثال، يستبعد الأمر التالي أي ملفات في الدلائل تسمى النسخ الاحتياطي أو المسودة وأي ملف ينتهي اسمه بـ "نسخة)" كـ PXL_20231006_063121958 (نسخة أخرى).jpg: 

immich-go -server=xxxxx -key=yyyyy upload -exclude-files=backup/ -exclude-files=draft/ -exclude=copy). *  /path/to/your/files

خيارات صور جوجل:

خيارات متخصصة لإدارة صور Google:

المعلمة وصف القيمة الافتراضية
-google-photos الاستيراد من أرشيف منظم لصور Google، وإعادة إنشاء الألبومات المقابلة.
-from-album="GP Album" قم بإنشاء الألبوم في immich واستيراد أصول الألبوم.
-create-albums يتحكم في إنشاء ألبومات صور Google في Imich. TRUE
-keep-untitled-albums يتم استيراد الألبومات بدون عنوان إلى immich مع اسم المجلد كعنوان. FALSE
-use-album-folder-as-name استخدم اسم المجلد بدلاً من عنوان الألبوم. FALSE
-keep-partner يحدد تضمين أو استبعاد الصور الملتقطة بواسطة الشريك. TRUE
-partner-album="partner's album" استيراد الأصول من الشريك إلى ألبوم معين.
-discard-archived لا تستورد الأصول المؤرشفة. FALSE
-auto-archive أرشفة الصور التي تم أرشفتها أيضًا في صور Google تلقائيًا TRUE
-upload-when-missing-JSON قم بتحميل الصور غير المرتبطة بملف بيانات تعريف JSON FALSE

اقرأ هنا لتفهم سبب صعوبة التعامل مع خدمة أخذ الطعام من Google Photos.

كشف الانفجار

حاليًا يتم الكشف عن الرشقات التي تتبع هذا المخطط:

  • xxxxxx_BURSTnnn.*
  • xxxxxx_BURSTnnn_COVER.*
  • xxxxxxx.RAW-01.COVER.jpg وxxxxxx.RAW-02.ORIGINAL.dng
  • xxxxxxx.RAW-01.MP.COVER.jpg وxxxxxx.RAW-02.ORIGINAL.dng
  • xxxxxxxIMG_xxxxx_BURSTyyyymmddhhmmss.jpg و xxxxxIMG_xxxxxxx_BURSTyyyymmddhhmmss_COVER.jpg (Huawei Nexus 6P)
  • yyyymmdd_hhmmss_xxx.jpg (سامسونج)

يجب أن يتم التقاط جميع الصور خلال نفس الدقيقة. ستكون صورة الغلاف هي الصورة الأصلية للمكدس

الكشف عن زوجين JPG/RAW

يجب أن يتم التقاط كلتا الصورتين في نفس الدقيقة. ستكون صورة JPG هي الغلاف.

يرجى فتح قضية لتغطية المزيد من الاحتمالات.

مثال للاستخدام: تحميل أرشيف إخراج صور Google

للتوضيح، إليك أمر استيراد الصور من أرشيف التقاط صور Google الذي تم التقاطه في الفترة ما بين 1 يونيو و30 يونيو 2019، أثناء إنشاء الألبومات تلقائيًا: 

./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ upload
-create-albums -google-photos -date=2019-06 ~ /Download/takeout- * .zip

تحديد البيانات الوصفية

Immich-go احصل على أول البيانات المتاحة بالترتيب التالي.

تاريخ الالتقاط:

  • إخراج صور جوجل
    1. صور Google JSON حقل photoTakenTime
    2. اسم ملف الصورة: ex PXL_20220909_154515546.jpg
    3. بيانات exif الخاصة بالصورة
  • استيراد المجلد
    1. ملف XMP
    2. اسم ملف الصورة: ex PXL_20220909_154515546.jpg
    3. مسار ملف الصورة: ex /photos/2022/11/09/IMG_1234.HEIC
    4. بيانات exif الخاصة بالصورة

موقع جي بي إس:

  • إخراج صور جوجل
    1. حقل صور Google JSON geoDataExif
    2. geoData الميدانية لصور Google JSON
    3. locationEnrichment الميداني لألبوم صور Google JSON
    4. بيانات exif الخاصة بالصورة
  • استيراد المجلد
    1. ملف XMP
    2. بيانات exif الخاصة بالصورة

عند استيراد أرشيف إخراج من صور Google:

يأخذ immich-go تاريخ الصورة من ملف JSON المرتبط.

يتجاهل الخادم التاريخ الذي يقدمه immich-go ويأخذ تاريخ MP4 حتى عندما يكون غير صحيح.
راجع رقم 322. الطابع الزمني للإنشاء من البيانات التعريفية خاطئ

عند استيراد الصور من الدليل:

يحاول Immich-go تحديد تاريخ الالتقاط باستخدام اسم الملف أو مسار الملف.

السابق:

طريق تاريخ التقاط الصورة
الصور/الالبوم/PXL_20220909_154515546.jpg 2022-09-09 15:51:55
الصور/الممسوحة ضوئيا/19991231.jpg 1999-12-31 00:00:00
الصور/20221109/IMG_1234.HEIC 2022-11-19 00:00:00
الصور/2022.11.09T20.30/IMG_1234.HEIC 2022-11-19 20:30:00
Photos/2022/11/09/IMG_1234.HEIC 2022-11-19 00:00:00

إذا لم يكن من الممكن استخدام المسار لتحديد تاريخ الالتقاط، فاقرأ metadata للملف أو exif .

الأمر duplicate

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

التبديل والخيارات:

المعلمة وصف القيمة الافتراضية
-yes افترض نعم لجميع الأسئلة FALSE
-date تحقق من أن الأصول فقط لها تاريخ التقاط في النطاق المحدد 1850-01-04,2030-01-01
-ignore-tz-errors تجاهل اختلاف المنطقة الزمنية عند البحث عن التكرارات FALSE
-ignore-extension تجاهل امتدادات نوع الملف عند البحث عن التكرارات FALSE

مثال للاستخدام: قم بتنظيف خادم immich بعد دمج أرشيف صور Google والملفات الأصلية

يقوم هذا الأمر بفحص محتوى خادم immich، وإزالة الصور الأقل جودة، والحفاظ على الألبومات. 

./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ duplicate -yes

stack الأوامر

تم تقديم إمكانية تكديس الصور مع الإصدار 1.83 immich . دعنا نستخدمه لتجميع الصور المتتابعة وصور jpg/الخام معًا.

التبديل والخيارات:

المعلمة وصف القيمة الافتراضية
-yes افترض نعم لجميع الأسئلة FALSE
-date=date_range تحقق من أن الأصول فقط لها تاريخ التقاط في النطاق المحدد 1850-01-04,2030-01-01

tool الأوامر

يقدم هذا الأمر أدوات سطر الأوامر للتعامل مع خادم immich الخاص بك

album delete [regexp]

يحذف هذا الأمر الألبومات التي تتطابق مع النمط المحدد

مفاتيح

-yes افترض نعم على جميع الأسئلة (الافتراضي: FALSE).

مثال 

./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ tool album delete d {4}- d {2}- d {2}

يحذف هذا الأمر جميع الألبومات التي تم إنشاؤها باستخدام النمط YYYY-MM-DD

تثبيت

التثبيت من إصدار Github:

يعد تثبيت immich-go عملية مباشرة. تفضل بزيارة صفحة الإصدار الأحدث وحدد الملف الثنائي المتوافق مع نظامك:

  • داروين ذراع 64، x86-64
  • لينكس Arm-64، Armv6-64، x86-64
  • ويندوز أرم-64، x86-64
  • ذراع Freebsd-64، x86-64

قم بتنزيل الأرشيف المطابق لنظام التشغيل/البنية الخاصة بك على جهازك وقم بفك ضغطه.

افتح أمر windows، وانتقل إلى الدليل الذي يوجد به immich-go، واكتب الأمر immich-go مع المعلمات والأمر الإلزامي.

⚠️ يرجى ملاحظة أن إصدار Linux x86-64 هو الإصدار الوحيد الذي تم اختباره.

التثبيت من المصادر

بالنسبة للتثبيت المستند إلى المصدر، تأكد من توفر أدوات تطوير لغة Go الضرورية (https://go.dev/doc/install). قم بتنزيل الملفات المصدر أو استنساخ المستودع. 

go build -ldflags " -X 'main.version= $( git describe --tag ) ' -X 'main.date= $( date ) ' "

التثبيت مع نيكس

يتم تعبئة immich-go مع nix ويتم توزيعه عبر nixpkgs. يمكنك تجربة immich-go دون تثبيته باستخدام: 

nix-shell -I " nixpkgs=https://github.com/NixOS/nixpkgs/archive/nixos-unstable-small.tar.gz " -p immich-go
# Or with flakes enabled
nix run " github:nixos/nixpkgs?ref=nixos-unstable-small#immich-go " -- -help

أو يمكنك إضافة immich-go إلى configuration.nix الخاص بك في قسم environment.systemPackages .

شكر وتقدير

مجد لفريق Immich لمشروعهم المذهل! ؟

يستخدم هذا البرنامج مكتبات الطرف الثالث التالية:

  • https://github.com/rivo/tعرض واجهة المستخدم الطرفية
  • github.com/rwcarlsen/goexif للحصول على تاريخ الالتقاط من ملفات JPEG
  • github.com/thlib/go-timezone-local لإدارة المنطقة الزمنية لنظام التشغيل Windows

الشكر الجزيل للقائمين على المشروع:

  • Rodneyosodo gitub CI، اذهب linter، والمشورة
  • إدارة سيجماهور SSL
  • ألبوم مشاركة الشريك Mrwulf
  • erkexzcx تحديد التاريخ بناءً على مسار الملف واسم الملف
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل