File Upload CLI Tool

A Node.js command-line tool for uploading files to the litterbox.catbox.moe file sharing service using curl.

Quick Start

Upload a file and receive a shareable URL:

CODEBLOCK0

Example:
CODEBLOCK1

Output:
CODEBLOCK2

Instructions

Step 1: Installation

Ensure Node.js v14+ and curl are installed:

Requirements:

• - Node.js v14+
• curl (included in Windows 10+, macOS, and most Linux distributions)

CODEBLOCK3

Step 2: Upload a File

Run the CLI tool with a file path:

CODEBLOCK4

Path Types:

• - Relative: INLINECODE0
• Absolute: node file-upload-cli.js /home/user/file.txt (Unix) or node file-upload-cli.js C:\Users\user\file.txt (Windows)
• With spaces: INLINECODE3

Step 3: Use the URL

The tool outputs a shareable URL that can be:

• - Shared with others
• Embedded in documents
• Used in applications

URL Format: INLINECODE4

Examples

Upload Different File Types

Text file:
CODEBLOCK5

Image:
CODEBLOCK6

PDF document:
CODEBLOCK7

Archive:
CODEBLOCK8

Large Files with Progress

For files larger than 1MB, the tool displays upload progress:

CODEBLOCK9

Output:
CODEBLOCK10

Cross-Platform Paths

Windows:
CODEBLOCK11

macOS/Linux:
CODEBLOCK12

Error Handling

The tool provides clear error messages for common issues:

Validation Errors (Exit Code 4)

No file path provided:
CODEBLOCK13

File not found:
CODEBLOCK14

Path is a directory:
CODEBLOCK15

File too large:
CODEBLOCK16

Empty file:
CODEBLOCK17

Network Errors (Exit Code 2)

Connection failure:
CODEBLOCK18

Timeout:
CODEBLOCK19

Service Errors (Exit Code 3)

File too large (service rejection):
CODEBLOCK20

Server error:
CODEBLOCK21

Service unavailable:
CODEBLOCK22

Security Considerations

File Access

• - The tool only reads the file you specify
• No directory traversal or unauthorized file access
• Files are not modified or deleted
• File path validation prevents malicious inputs

Network Security

• - Only communicates with https://litterbox.catbox.moe (HTTPS encrypted)
• Uses system curl command for secure file transmission
• No other external services are contacted
• No authentication tokens or API keys required
• Secure TLS connection for file transmission

Data Privacy

• - URLs are publicly accessible by anyone who has the link
• Files automatically expire after 72 hours
• No authentication or access control
• Do not upload sensitive, confidential, or private files
• User is responsible for file content and compliance

Dependencies

• - Native Node.js modules: child_process, fs, path, INLINECODE9
• System curl: Pre-installed on most systems, widely trusted and security-audited
• No external npm packages required

Limitations

• - Maximum file size: 1GB (litterbox.catbox.moe service limit)
• File expiry: Files are automatically deleted after 72 hours
• Upload timeout: 60 seconds
• Single file: One file per command (no batch uploads)
• No retry logic: Failed uploads must be manually retried
• Public URLs: All uploaded files are publicly accessible
• Requires curl: System must have curl installed

Technical Details

Implementation: file-upload-cli.js (Node.js script)

Exit Codes:

• - 0: Success
• INLINECODE12: General error
• INLINECODE13: Network error
• INLINECODE14: Service error
• INLINECODE15: Validation error

Requirements:

• - Node.js v14.0.0 or higher
• Internet connection
• Read access to the file being uploaded

Troubleshooting

"curl command not found"

• - Install curl on your system (included in Windows 10+, macOS, most Linux distributions)

"Permission denied"

• - Check file permissions: chmod +r file.txt (Unix)
• Ensure you have read access to the file

"Connection timeout"

• - Check internet connection
• Try again with a smaller file
• Verify firewall allows HTTPS connections

"Service error"

• - The litterbox.catbox.moe service may be temporarily down
• Wait a few minutes and try again
• Check service status at https://catbox.moe