catbox-upload-api

Node.js package to upload files to catbox.moe and litterbox.catbox.moe — usable as a library, a CLI tool, or a standalone Express server.

Install (once published)

npm install catbox-upload-api

Use as a library

const { uploadFile, uploadFromUrl, uploadTemp } = require('catbox-upload-api');

// Upload a local file
const link = await uploadFile('./photo.jpg');
console.log(link); // https://files.catbox.moe/xxxxxx.jpg

// Upload from a remote URL
const link2 = await uploadFromUrl('https://example.com/image.png');

// Temporary upload (auto-expires: '1h', '12h', '24h', '72h')
const tempLink = await uploadTemp('./video.mp4', '1h');

// Video upload - auto-picks permanent (<=200MB) or temporary (up to 1GB) hosting
const video = await uploadVideo('./movie.mp4', { time: '72h' });
console.log(video); // { url: '...', temporary: false|true, sizeMB: '45.2' }

Use as a CLI

npx catbox-upload-api ./photo.jpg
npx catbox-upload-api --url https://example.com/image.png
npx catbox-upload-api --video ./movie.mp4
npx catbox-upload-api --video ./movie.mp4 24h

Use as a server (optional)

Requires express and multer (listed as optional dependencies):

npm install express multer
npm start

Endpoints:

• POST /upload — multipart form, field name file
• POST /upload-url — JSON body { "url": "..." }
• POST /upload-video — multipart form, field name file, optional field/query time (1h,12h,24h,72h, default 72h). Files ≤200MB go to permanent catbox storage; larger files (up to 1GB) go to temporary litterbox storage.

Publish to npm registry (npmjs.com)

1. Create an account at npmjs.com if you don't have one.
2. Login from terminal:

   npm login

3. Check the package name is free (rename name in package.json if catbox-upload-api is taken):

   npm view catbox-upload-api

4. Publish:

   npm publish

5. Done — anyone can now run npm install catbox-upload-api.

Tip: bump version in package.json (e.g. 1.0.1) before every new npm publish.