Catbox Uploader

unlisted

by Louan Fontenele

An Imgur alternative for image uploads. Automatically upload pasted images/files to Catbox.moe (up to 200MB) instead of saving them locally.

Updated 3mo ago0BSD
View on GitHub

Catbox Uploader for Obsidian πŸ±πŸ“¦

Catbox Uploader is an Obsidian plugin that automatically uploads files pasted into the editor to Catbox.moe, inserting a direct link instead of saving the file locally.

Save space in your vault and share images easily!

A powerful alternative to Imgur, featuring unlimited uploads with files up to 200MB!

✨ Features

  • Automatic Uploads: Intercepts Ctrl+V (paste) events when files are detected.
  • Direct Links: Inserts ![](url) for images or [filename](url) for other files.
  • Anonymous or Account Uploads: Works out-of-the-box anonymously, or use your User Hash to save files to your Catbox account.
  • Cross-Platform: Works on Windows, Mac, Linux, iOS, and Android.

πŸš€ Usage

  1. Copy a file (image, video, etc.) from your computer or web browser.
  2. Paste (Ctrl+V) into an Obsidian note.
  3. The text ![Uploading X file(s)...] will appear.
  4. Once finished, it will be replaced by the permanent Catbox URL.

βš™οΈ Settings

Go to Settings > Catbox Uploader:

  • User Hash (Optional): Enter your key from catbox.moe/user/manage.php to link uploads to your account.
    • Leave empty for anonymous uploads.
    • πŸ”΄ IMPORTANT: Your userhash is private and sensitive. Do not share it! Anyone with this key can manage your account (delete files, etc.).
    • ℹ️ Security Note: This plugin only performs uploads. It contains no logic to edit or delete files on your account or your computer.

πŸ“₯ Installation

Manual

  1. Clone or download this repository.

  2. Run npm install in the plugin folder.

  3. Build the plugin:

    npm run build

  4. Copy main.js, manifest.json, and styles.css to your vault's .obsidian/plugins/obsidian-catbox-uploader folder.

  5. Enable in Community Plugins.

⚠️ Privacy & Terms

By using this plugin, you agree to Catbox.moe's Terms of Service.

  • Anonymous uploads cannot be deleted later.
  • Do not upload illegal or prohibited content.

πŸ™ Credits

Developed by Louan Fontenele. Powered by Catbox.moe.

πŸ“„ License

MIT License

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.