The current production-ready adapter is DouyinLivePlatformAdapter. The architecture keeps platform-specific logic isolated so Bilibili, Huya, Douyu, and Kuaishou can be added without changing application services.

Architecture

.
├─ src
│  ├─ LiveRecorder.Domain
│  │  ├─ Entities
│  │  └─ Enums
│  ├─ LiveRecorder.Application
│  │  ├─ Abstractions
│  │  ├─ Common
│  │  ├─ Models
│  │  └─ Services
│  ├─ LiveRecorder.Infrastructure
│  │  ├─ Persistence
│  │  ├─ Platforms
│  │  │  ├─ Douyin
│  │  │  ├─ Bilibili
│  │  │  └─ Huya
│  │  └─ Services
│  └─ LiveRecorder.WebApi
│     ├─ Controllers
│     └─ Middleware
└─ frontend
   └─ src
      ├─ api
      ├─ components
      ├─ router
      ├─ stores
      └─ views

Core design

Domain

LiveRoom: platform, room id, source URL, title, anchor, cover, availability status
RecordTask: recording state, quality, output format, ffmpeg process id, output path
RecordResult: final file or segment directory, file size, duration, final status
SystemLogEntry: persistent system log
AppSetting: runtime settings store
UserAccount, UserSession: lightweight token-based sign-in

Application

ILivePlatformAdapter
- ParseRoomAsync
- GetLiveStatusAsync
- GetStreamUrlAsync
ILivePlatformAdapterFactory
LiveRoomService
RecordService
SystemSettingsService
SystemLogService
AuthService

Infrastructure

DouyinHttpClient
- wraps User-Agent, Referer, Cookie, and ttwid handling
DouyinLivePlatformAdapter
- share-link resolution, room id extraction, status check, stream selection
FfmpegService
- single file mode, segmented mode, reconnect arguments, recording templates
LiveRoomPollingBackgroundService
- background polling scheduler for live detection and auto-start recording
LiveRecorderDbContext

Web API

AuthController
LiveRoomsController
RecordTasksController
LogsController
SettingsController
ApiTokenAuthenticationMiddleware
ExceptionHandlingMiddleware

Implemented features

Douyin adapter

resolve share links and redirects
extract real roomId
call https://live.douyin.com/webcast/room/web/enter/
preload ttwid when needed
parse both:
- live_core_sdk_data.pull_data.stream_data
- flv_pull_url / hls_pull_url_map
select the highest quality by default or respect configured quality

Background polling scheduler

configurable polling interval
configurable enable/disable switch
configurable auto-start switch
updates room status in background
auto-creates a recording task when a room is live and no task is running
also works as a recovery layer when ffmpeg exits unexpectedly while the room is still live

Recording enhancements

save format setting: MP4 or TS
save mode setting:
- SingleFile
- Segmented
recording template setting:
- StreamCopy
- BalancedMp4
- ArchiveTs
reconnect tuning:
- enable/disable reconnect
- max reconnect delay
- read/write timeout

Frontend

login page
live room management
recording task list
recording task detail
log viewer
system settings
route lazy loading
vendor chunk splitting in Vite

Settings exposed in UI

ffmpeg path
output root
default quality
live save format
save mode
recording template
segment duration
reconnect switch and reconnect delay
read/write timeout
background polling switch
auto-start-on-live switch
polling interval
Douyin User-Agent / Referer / Cookie

Run

Backend

dotnet restore LiveRecorder.sln
dotnet build LiveRecorder.sln --no-restore -m:1
dotnet run --project src/LiveRecorder.WebApi/LiveRecorder.WebApi.csproj --urls http://localhost:5000

Default account:

username: admin
password: Admin@123

Swagger:

http://localhost:5000/swagger

Frontend

cd frontend
npm install
npm run dev

Frontend dev server:

http://localhost:5173

Verified locally

dotnet build LiveRecorder.sln --no-restore -m:1
npm run build

Next steps

Implement full adapters for Bilibili, Huya, Douyu, and Kuaishou.
Add per-room recording preferences instead of relying only on global defaults.
Add full-text log search and time-range filters.
Replace lightweight token sessions with JWT or external SSO if needed.