catbox-cli

a simple CLI tool to upload files to catbox.moe or litterbox.catbox.moe

features ✅

• upload files up to 200MB to Catbox (permanent)
• upload files up to 1GB to Litterbox (temporary, with configurable expiry)
• supports Catbox userhash for uploads to your account
• allows anonymous uploads to Catbox
• progress indicator during upload

installation 📥

simply install the package with npm!

npm install catbox-cli -g

usage 💻

catbox ./path/to/file [OPTION]

options ⚙️

• --help
  show usage information

• --anon
  upload anonymously (no userhash)

• --userhash <hash>
  use a specific Catbox userhash for uploads (prompts to save as default if not set). if used without a file, saves the userhash as default

• --time <time>
  upload to Litterbox (temporary), valid times: 1h, 12h, 24h, 72h

examples 🔽

upload a file permanently to Catbox:

catbox ./myfile.png

upload a file permanently to Catbox anonymously:

catbox ./myfile.png --anon

upload a file to Catbox with your userhash:

catbox ./myfile.png --userhash YOUR_USERHASH

upload a file temporarily to Litterbox for a day:

catbox ./myfile.png --time 24h

notes 📝

• catbox uploads are limited to 200MB per file
• litterbox uploads are limited to 1GB per file and are deleted after the specified time
• you can set a default userhash by uploading with --userhash once
• if no userhash is provided, uploads are anonymous

credits ❤️

catbox API by catbox.moe, you can support them here! 🐾

license 📜

GNU AGPL v3