How okdargy/fxtiktok works
fxTikTok is a TikTok-to-embed service: a request for a TikTok link is routed by the Worker, TikTok data is fetched and parsed, then page templates produce metadata for Discord and other embed consumers. Generated media and ActivityPub-style responses are served by a separate offload application. The README also documents direct media, slideshow pagination, captions, high-quality playback, profile/live embeds, and Prometheus metrics. Edges reflect the excerpts and source-index references; unsampled behavior is not inferred.
Main entry points: src/index.ts Worker routes · tiktok.ts TikTok scraping · generate.ts Media routes · templates/index.ts Template exports
Components 21
Request routing
- Worker routes
src/index.ts - Media routes
src/generate.ts - Offload server
src/offload.ts
TikTok data
- TikTok scraping
src/services/tiktok.ts - TikTok data types
src/types - API types
src/types/API.ts
Embed and media output
- Activity builder
src/util/generateActivity.tsx - Alternate metadata
src/util/generateAlternate.tsx - Video embed
src/templates/pages/VideoResponse.tsx - Profile embed
src/templates/pages/ProfileResponse.tsx - Live embed
src/templates/pages/LiveResponse.tsx - Status pages
src/templates/pages - Template exports
src/templates/index.ts - Metadata helper
src/util/metaHelper.tsx - Formatting
src/util/format.ts - Activity IDs
src/util/activityId.ts
Operations
- Request metrics
src/metrics.ts
Other components
- Embed consumer
- TikTok
- Redis cache
- Prometheus
Connections 28
- Embed consumer → Worker routes: requests embeds
README.md - Worker routes → TikTok scraping: fetches TikTok data
src/index.ts - TikTok scraping → TikTok: fetches pages
src/services/tiktok.ts - TikTok scraping → Redis cache: reads and writes cache
src/services/tiktok.ts - Worker routes → Template exports: renders responses
src/index.ts - Worker routes → Profile embed: renders profile
src/index.ts - Template exports → Video embed: exports template
src/templates/index.ts - Template exports → Live embed: exports template
src/templates/index.ts - Template exports → Status pages: exports templates
src/templates/index.ts - Video embed → Metadata helper: builds metadata
src/templates/pages/VideoResponse.tsx - Profile embed → Metadata helper: builds metadata
src/templates/pages/ProfileResponse.tsx - Live embed → Metadata helper: builds metadata
src/templates/pages/LiveResponse.tsx - Video embed → Activity builder: uses page count
src/templates/pages/VideoResponse.tsx - Profile embed → Formatting: formats counts
src/templates/pages/ProfileResponse.tsx - Live embed → Formatting: formats live stats
src/templates/pages/LiveResponse.tsx - Metadata helper → Activity IDs: builds activity ID
src/util/metaHelper.tsx - Worker routes → Media routes: mounts media routes
src/index.ts - Media routes → TikTok scraping: fetches video data
src/generate.ts - Media routes → Activity builder: builds activity response
src/generate.ts - Media routes → Alternate metadata: builds alternate response
src/generate.ts - Activity builder → TikTok scraping: fetches video data
src/util/generateActivity.tsx - Offload server → Media routes: serves media routes
src/offload.ts - Offload server → Activity builder: serves activity output
src/offload.ts - Worker routes → Request metrics: wraps routes
src/index.ts - Embed consumer → Request metrics: scrapes metrics
README.md - Request metrics → Prometheus: exposes metrics
README.md - TikTok scraping → TikTok data types: parses typed data
src/services/tiktok.ts - TikTok data types → API types: includes API schema