أداة سطر الأوامر

ارفع من طرفك (terminal). أمر واحد، إخراج JSON للسكربتات، ورفع multipart قابل للاستئناف للملفات الكبيرة. الكود المصدر على GitHub.

تثبيت

Homebrew (macOS و Linux)

brew install storageto/tap/storageto

Go

go install github.com/storageto/cli/cmd/storageto@latest

تأكد من أن ~/go/bin موجود ضمن PATH.

ملفات ثنائية جاهزة (binaries) مُعدة مسبقًا

حمّل ملف tarball المناسب من إصدارات GitHub (macOS ARM/Intel، Linux ARM/Intel).

الاستخدام

ملف واحد

storageto upload photo.jpg

URL:     https://storage.to/FQxyz1234
Raw:     https://storage.to/r/FQxyz1234
Size:    2.1 MB
Expires: 2026-04-15T12:00:00Z

عدة ملفات

مرّر عدة مسارات أو نمطًا (glob) — سيتم تجميعها تلقائيًا ضمن مجموعة:

storageto upload file1.txt file2.txt file3.txt
storageto upload *.log
storageto upload src/**/*.go

الملفات الكبيرة

يتم تقسيم الملفات التي تزيد عن 5 جيجابايت تلقائيًا إلى أجزاء (chunked) ورفعها بالتوازي باستخدام multipart قابل للاستئناف. يتم طباعة التقدم مباشرةً داخل الإخراج:

  1.2 GB / 10.0 GB (12.0%)

اضغط Ctrl+C للإلغاء — يتم تنظيف عمليات الرفع الجزئية تلقائيًا على الخادم.

الوسوم (Flags)

وسم (Flag)	الوصف
`-c`, `--collection`	فرض إنشاء مجموعة (collection) حتى لملف واحد.
`-v`, `--verbose`	عرض مخرجات تقدم مفصلة.
`--json`	إخراج نتيجة بصيغة JSON (قابلة للقراءة آليًا وممتازة للسكربتات).
`--no-token`	رفع بشكل مجهول بالكامل — لا تقرأ ملف رمز الهوية ولا تكتبه.
`--api <url>`	تجاوز نقطة نهاية الـ API (الافتراضي: `https://storage.to`).
`-h`, `--help`	عرض المساعدة.

إخراج JSON

storageto upload photo.jpg --json

{
  "url": "https://storage.to/FQxyz1234",
  "raw_url": "https://storage.to/r/FQxyz1234",
  "filename": "photo.jpg",
  "size": 2202009,
  "human_size": "2.1 MB",
  "expires_at": "2026-04-15T12:00:00Z"
}

رمز الهوية

تخزّن أداة سطر الأوامر (CLI) قيمة رمز الزائر (visitor token) عشوائية عند الاستخدام الأول، حتى تشارك عمليات الرفع المتكررة من نفس الجهاز الحصة ونسبة الاستخدام. هذا ليس تسجيل دخول لحساب — بل هو مُعرّف خاص بكل جهاز.

نظام التشغيل (OS)	المسار
macOS	`~/Library/Application Support/storageto/token`
Linux	`~/.config/storageto/token`
Windows	`%AppData%\storageto\token`

استخدم --no-token لتخطي ملف الرمز بالكامل.

البرمجة النصية (Scripting)

مرّر ناتج --json إلى jq لاستخراج الرابط:

URL=$(storageto upload build.zip --json | jq -r '.url')
echo "Uploaded to $URL"

الإصدار والتحديثات

storageto version

مستخدِمو Homebrew: brew upgrade storageto. مستخدمو Go: أعد تشغيل go install باستخدام أحدث وسم.