CDN Manager — User Guide

A private CDN file management system. Upload via FTP or browser, organize with color tags, share direct links, and automate with a REST API.

🔐 Logging In

Visit your CDN Manager URL and sign in with your assigned credentials.

📊 Dashboard Overview

After login, the dashboard is divided into four main areas:

🖼 Configuring FastStone Capture (FTP Upload)

FastStone Capture can automatically upload screenshots to your CDN via FTP. Here's how to set it up:

FTP Settings Reference

After Upload

Files uploaded via FastStone appear instantly in your dashboard the next time you load or refresh the page. They are automatically assigned the White color tag (meaning new / unreviewed).

The public URL for each file follows this pattern:

https://cdn.tasmoon.com/{your-username}/{filename.ext}

📱 Share Images from Your Phone

The CDN Manager works as an installable app on Android and iOS. Once installed, it appears as a destination in your phone's native Share menu — just like sharing to WhatsApp or Telegram.

Step 1 — Install the App

Step 2 — Share an Image

📂 Uploading via Drag & Drop

You can upload files directly from your browser without any FTP client. Any file type is supported.

📡 Using Any FTP Client

FileZilla, WinSCP, Cyberduck, or any other FTP client works. Use these settings:

FileZilla Specific

In FileZilla: Edit → Settings → FTP → Transfer Mode → Passive. Also go to Site Manager, create a new site and set Transfer Settings → Transfer mode → Passive.

🎨 Color Code System

Every file has a color dot in the file list. Colors help you visually organize and categorize files. Click any color dot to change it.

How to Change a Color

Filtering by Color

The color filter bar above the file list shows all colors with a count badge. Click any color to filter the file list. Combine with the search box for precise results.

🔍 Search & Filter

Use the search box in the top-right of the filter bar to search by filename. Filtering by color and searching by name work together simultaneously.

🖼️ Image Lightbox

Click any image thumbnail in the file list to open a fullscreen lightbox preview.

🗑 Deleting Files

⚡ REST API Reference

Each CDN account has its own api/ endpoint. All requests must include a valid Bearer token. The token is shown in the ⚙ Settings popup on your dashboard.

Base URL

https://cdn.tasmoon.com/{username}/api/

Authentication

Include your token as an Authorization header, or as a ?token= query parameter:

# Header method (recommended)
Authorization: Bearer your-api-token-here

# Query param method (for quick testing)
?token=your-api-token-here

Endpoints

// Response
{
  "ok": true,
  "total": 3,
  "files": [
    {
      "filename": "banner.png",
      "url":      "https://cdn.tasmoon.com/cto/banner.png",
      "size":     204800,
      "color":    "green",
      "added_at": 1711234567
    }
  ]
}

// Response
{
  "ok":       true,
  "filename": "screenshot.png",
  "url":      "https://cdn.tasmoon.com/cto/screenshot.png",
  "color":    "white",
  "size":     98304
}

{
  "ok": true,
  "filename": "photo.jpg",
  "url":      "https://cdn.tasmoon.com/cto/photo.jpg",
  "width":    4000,
  "height":   2252,
  "mime":     "image/jpeg",
  "size":     1601483,
  "color":    "green",
  "added_at": 1711234567
}

{
  "ok":           true,
  "size_before":  1601483,
  "size_after":   591427,
  "saved_bytes":  1010056
}

{
  "ok":      true,
  "v_cuts": [195, 392],
  "h_cuts": [260, 520],
  "tiles":   9
}

cURL Examples

# List all files
curl -H "Authorization: Bearer TOKEN" \
     "https://cdn.tasmoon.com/cto/api/?action=list"

# Upload a file
curl -H "Authorization: Bearer TOKEN" \
     -F "file=@/path/to/image.png" \
     "https://cdn.tasmoon.com/cto/api/?action=upload"

# Fetch image from URL and convert to WebP
curl -H "Authorization: Bearer TOKEN" \
     "https://cdn.tasmoon.com/cto/api/?action=upload_url_webp&url=https://example.com/photo.jpg&quality=85"

# Compress a file in place (70% quality)
curl -H "Authorization: Bearer TOKEN" \
     "https://cdn.tasmoon.com/cto/api/?action=compress&file=photo.jpg&quality=70"

# Resize to 50%
curl -H "Authorization: Bearer TOKEN" \
     "https://cdn.tasmoon.com/cto/api/?action=resize&file=photo.jpg&pct=50&format=webp"

# Slice into 4×4 grid
curl -H "Authorization: Bearer TOKEN" \
     "https://cdn.tasmoon.com/cto/api/?action=slice&file=photo.jpg&cols=4&rows=4&trim=1"

# Delete a file
curl -H "Authorization: Bearer TOKEN" \
     "https://cdn.tasmoon.com/cto/api/?action=delete&file=photo.jpg"

🤖 AI Integration (MCP & ChatGPT)

Your CDN can be controlled directly from AI assistants — Claude Desktop via MCP, or ChatGPT via Custom GPT Actions.

Claude Desktop — MCP Server

MCP (Model Context Protocol) lets Claude Desktop call your CDN as a set of tools. Claude can list files, compress, resize, slice, and more — all through natural language.

pip install mcp httpx

curl -o mcp_server.py https://cdn.tasmoon.com/{username}/mcp_server.py

{
  "mcpServers": {
    "cdn": {
      "command": "python3",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "CDN_API_BASE":  "https://cdn.tasmoon.com/{username}/api",
        "CDN_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Available tools in Claude

ChatGPT — Custom GPT Actions

You can connect the CDN API to a Custom GPT so ChatGPT can manage your files.

https://cdn.tasmoon.com/{username}/api/openapi.json

Example ChatGPT prompts

# Save an image from the web
Save https://example.com/photo.jpg to my CDN as WebP

# Compress and organize
Compress all files larger than 1MB to 70% quality

# Slice a spritesheet
Detect the gaps in spritesheet.png then slice it and trim the borders

🔗 n8n Integration

Use n8n's HTTP Request node to automate file uploads and management. Below is the complete setup for each use case.

// In a Set or Code node after the HTTP Request:
{{ $json.url }}

// Example response you'll receive:
{
  "ok": true,
  "filename": "report_2024.pdf",
  "url": "https://cdn.tasmoon.com/cto/report_2024.pdf",
  "color": "white",
  "size": 512000
}

Trigger (Schedule / Webhook)
        ↓
Generate or fetch the file
(Read Binary File / HTTP Request / etc.)
        ↓
Upload to CDN
HTTP Request POST → api/?action=upload
→ Get {{ $json.url }}
        ↓
Use the URL
(Send in Slack, email, save to Airtable, etc.)
        ↓
Tag as delivered
HTTP Request POST → api/?action=color { color: "green" }

🔑 Managing Your API Token

⚙️ Automatic Rules

💡 Tips & Best Practices

CDN Manager · cdn.tasmoon.com · Back to Dashboard