NoteIM Image Uploader

Upload images to NoteIM CDN with one click - no registration, no configuration required!

✨ Features

Image Upload

• 🎯 Zero Configuration - No registration or login required
• ⚡ Auto-Activation - Automatically activates on first use
• 📋 Clipboard Support - Paste images directly from clipboard
• 📁 File Upload - Select and upload image files
• 📊 File Management - View, copy URLs, and delete uploaded files

Markdown Sharing 🆕

• 🚀 One-Click Share - Share Markdown documents with a single shortcut (Cmd/Ctrl+Alt+S)
• 🔗 Short Links - Generate beautiful shareable links
• ⏰ Expiration Control - Set expiration time (1 hour to permanent)
• 🔒 Password Protection - Optional password protection for sensitive content
• 📊 View Tracking - See how many times your share has been viewed

Account & Security

• 🔑 API Key Access - Use your API Key to manage content on https://www.noteim.com
• 📈 Statistics - Track your uploads and storage usage
• 🔒 Secure - Device-based authentication with API keys
• 🌐 Cross-Platform - Works on Windows, macOS, and Linux

🚀 Quick Start

1. Install the extension from VSCode marketplace
2. Copy an image to your clipboard
3. Press Cmd+Alt+V (Mac) or Ctrl+Alt+V (Windows/Linux)
4. Done! The image is uploaded and Markdown inserted automatically

That's it! No registration, no configuration needed. Your device is automatically activated on first use.

📋 Commands

Access these commands via Command Palette (Cmd/Ctrl+Shift+P):

Image Management

• NoteIM: Paste Image - Paste and upload clipboard image (Cmd/Ctrl+Alt+V)
• NoteIM: Upload Image - Select and upload an image file
• NoteIM: Show Uploaded Files - View and manage your uploaded files
• NoteIM: Show Statistics - View upload statistics

Markdown Sharing 🆕

• NoteIM: Share Markdown - Share current Markdown document (Cmd/Ctrl+Alt+S)
• NoteIM: Show My Shares - View and manage your shared documents

Account & Settings

• NoteIM: Show API Key - View your API Key and website access instructions
• NoteIM: Reset Device - Clear device authentication

⚙️ Configuration

Go to VSCode Settings → Extensions → NoteIM Configuration:

{
  "noteim.apiUrl": "https://api.noteim.com",  // API endpoint
  "noteim.localPath": "./images"               // Temporary local path
}

💡 How It Works

Device-Based Authentication

• Each device gets a unique API key on first use
• API key is securely stored locally
• No account creation required
• Multi-device support (each device has its own key)

Workflow

1. First Upload
   ↓
2. Auto-register device (< 1 second)
   ↓
3. Get API key
   ↓
4. Upload file
   ↓
5. Insert Markdown

Subsequent uploads use the stored API key automatically!

📊 File Management

Use NoteIM: Show Uploaded Files to:

• View all your uploaded files
• Copy file URLs
• Copy Markdown format
• Delete unwanted files

🚀 Markdown Sharing (New!)

Quick Share

1. Open any Markdown file
2. Press Cmd+Alt+S (Mac) or Ctrl+Alt+S (Windows/Linux)
3. Choose expiration time (1 hour, 24 hours, 7 days, 30 days, or permanent)
4. Optionally set a password
5. Share link is automatically copied to clipboard!

Share Options

• Permanent Links - Never expire
• Time-Limited - Auto-expire after set duration
• Password Protected - Secure sensitive content
• View Counter - Track how many views your share gets

Manage Shares

Run NoteIM: Show My Shares to:

• View all your shared documents
• Copy share URLs
• Delete old shares
• See view statistics

🔑 Access Your Content on the Web

Get Your API Key

1. Run command: NoteIM: Show API Key
2. Your API Key will be displayed
3. Copy it to clipboard

Use on Website

Visit https://www.noteim.com and sign in with your API Key to:

• View all uploaded images in a beautiful gallery
• Manage your shared Markdown documents
• See detailed statistics and analytics
• Download or delete content
• Configure account settings

Note: Your API Key is like a password - keep it secure and don't share it publicly!

🔒 Security & Privacy

• API keys are stored securely using VSCode Secrets API
• Device IDs are generated from machine information
• No personal data is collected
• Files are uploaded to NoteIM CDN with geographic distribution

🆘 Troubleshooting

"Upload failed: Authentication failed"

Run NoteIM: Reset Device and try uploading again to reactivate.

"Network error"

Check your internet connection and firewall settings.

"No image in clipboard"

Make sure you have copied an image (not a file path) to your clipboard.

📝 Changelog

See CHANGELOG.md for version history.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This extension is provided as-is for educational and personal use.

🌐 Resources

• API Documentation: https://api.noteim.com
• GitHub: https://github.com/okmdx/okmd-vscode
• Issues: https://github.com/okmdx/okmd-vscode/issues

💬 Support

If you encounter any issues or have suggestions:

1. Check the troubleshooting section above
2. Search existing GitHub issues
3. Create a new issue with detailed information

Enjoy effortless image uploads with NoteIM! 🎉