Documentation

1) Quickstart

• Create an account → /register
• Open /dashboard
• Drag & drop into Upload Center or click “Choose files”
• Pick protocol per link (HTTPS recommended; HTTP only for legacy tools)
• Set visibility (Private by default). Create a signed share link to share
• Copy link → paste in XAseco, Manialinks, Clubs, websites, messages

2) Core Principles

• Private by default • you decide what’s public
• Paste-ready direct links • stable, predictable URLs
• Per-link protocol (HTTP/HTTPS) for legacy compatibility
• No passwords • signed share tokens instead
• Fast at EU edge • low latency for TM servers & web clients
• Maps & assets first • GBX, replays, skins, images
• No ads • no trackers

3) Public Website

Focus on edge speed, signed links, paste-ready URLs, per-link protocol, and TrackMania formats.

4) Dashboard Overview

• Welcome card: email + Status/Settings
• Storage: file count, total size, usage %
• Abuse/Copyright: realtime screening + links
• Menu: News, Status, Changelog • Folders: create & organize
• Upload Center: Destination folder, Upload, drag-and-drop
• Search & Sort: text search + sort by date/name/size
• Table: Name, Date, Size, Privacy, Protocol, Actions (copy, download, rename, edit, star, delete, move)

5) Uploads

• Drag anywhere or use “Choose files”
• Per-file progress
• Pick destination folder before upload
• Uploads resumable where possible
• Tip: human-readable filenames (you can rename later)

6) Files & Folders

• Rename via pencil
• Move single/multiple (Bulk Move)
• Delete single/multiple
• Star important items
• Create & nest folders (e.g., Maps/FSR/Season-2025)

7) Privacy & Shares (no passwords)

• Visibility per file/folder: Private (default) ⇄ Public
• Folder shares: signed token links, revocable anytime
• Signed links beat passwords for temporary sharing
• Strict headers • directories are not indexed

8) HTTP vs HTTPS

• HTTPS (recommended): encrypted, modern clients
• HTTP (legacy): only when a tool cannot handle HTTPS
• Switch per link via Protocol dropdown

9) Links & Domains

• Direct paste-ready links for servers, Manialinks, Clubs, web
• Domains can vary per protocol/region (e.g., cdn.tmcdn.de)
• Version-safe URLs available (see Versioning & Cache)

10) Bulk Actions

• Select via checkboxes
• Actions: Move, Delete, Share, Mark/Unmark important
• Pick target for Move → confirm

11) Search & Sorting

• Search filenames (future: tags/types)
• Sort by newest/oldest/name/size
• Combine with folder filters

12) Keyboard Shortcuts

/            Focus search
Shift+Click  Range select
Del          Delete (confirm)
M            Move dialog
C            Copy link (single selection)

Shortcuts may vary by OS/browser.

13) Versioning & Cache

• Immutable assets: slugged/hashed paths for long-term caching
• Cache-busting: change slug or add version query (if your tool supports it)
• CDN headers: sane defaults (Cache-Control, ETag)

Example version-safe URL:
https://cdn.tmcdn.de/u/{user}/{slug}/panel.v2.jpg
https://cdn.tmcdn.de/u/{user}/{slug}?v=2

14) Integration Examples

XAseco (legacy HTTP)

; Example snippet (adjust to your tool)
[download]
url = http://cdn.tmcdn.de/u/yourname/maps/track1.GBX

Manialink (HTTPS)

<manialink id="tmcdn-demo">
  <stylesheet/>
  <frame>
    <quad posn="0 0 0" sizen="80 45" image="https://cdn.tmcdn.de/u/yourname/images/banner.webp"/>
    <label posn="0 -48 0" text="Download" url="https://cdn.tmcdn.de/u/yourname/maps/track1.GBX"/>
  </frame>
</manialink>

Club page / Website

<a href="https://cdn.tmcdn.de/u/yourname/maps/track1.GBX" rel="noopener">Download map</a>

15) API (optional)

If enabled, automate uploads & management. See /api for current details.

Upload (multipart)
curl -X POST https://tmcdn.de/api/uploads ^
  -H "Authorization: Bearer YOUR_TOKEN" ^
  -F "file=@track1.GBX" -F "folderId=fld_root"

List uploads
curl -H "Authorization: Bearer YOUR_TOKEN" "https://tmcdn.de/api/uploads?mine=1&limit=50"

Toggle public
curl -X PATCH https://tmcdn.de/api/uploads/UPL_ID ^
  -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" ^
  -d "{\"isPrivate\":false}"

Tokens: least privilege. Rate limits & response shapes may change.

16) Status & Changelog

• Status: /status (availability, incidents)
• Changelog: /changelog (filters, search, JSON export, RSS coming)
• Legend: NEW, IMPROVED, FIXED, SECURITY, CHANGED

17) Abuse, Copyright & Appeals

• Report abuse: /abuse
• Copyright / DMCA: /copyright
• Appeal: /appeal
• Realtime screening can auto-block illegal content and revoke shares

18) Admin Area (overview)

• Users (roles, quotas)
• System (domains, protocol defaults, header policies)
• Abuse queue & compliance
• News & changelog
• Monitoring (throughput, latency, error rates)

19) Best Practices

• Prefer HTTPS; use HTTP only for hard legacy cases
• Use clear folder structure & semantic names
• Star important files
• Review/revoke old shares regularly
• Avoid sensitive personal data; TMCDN is for game assets

20) Troubleshooting

• Legacy tool fails: try HTTP protocol; else keep HTTPS
• Upload stuck: reload dashboard, check network, retry; if persistent → contact support
• Share broken: token expired/revoked — create a new share
• Dev/UI: Objects as children → map arrays; “Expected </>, got ‘{’” → missing comma in JSX array; duplicate imports → fix paths/unique icons

21) FAQ

• Is TMCDN the same as TMX? → No. We only host & deliver.
• Do I need passwords for shares? → No, signed token links; revoke anytime.
• Switch HTTP/HTTPS per link? → Yes, Protocol dropdown.
• Are files public? → No, private by default.
• Limits? → Plan/quotas/rate limits; check account or support.

22) Glossary

• Share (token): signed, revocable link
• Edge: distributed delivery, low latency
• Legacy tools: older systems (e.g., XAseco) that may need HTTP
• GBX: TrackMania map/replay format