Skip to main content
DouyinLiveRecorder can send push notifications whenever a monitored streamer starts or stops broadcasting. Notifications are dispatched in a background thread and do not block recording.

​
Supported channels

Seven push channels are available. You can enable one or more simultaneously.
ChannelKey in configDescription
WeChat (XiZhi)微信WeChat push via the XiZhi webhook service
DingTalk钉钉DingTalk group robot webhook with optional @mention
Email邮箱SMTP email with SSL or plain-text support
TelegramTGTelegram Bot API via BotFather token
BARKBARKiOS push via the Bark app
NTFYNTFYSelf-hosted or ntfy.sh push notifications
PushPlusPUSHPLUSPushPlus WeChat/email push service

​
Configuration

All notification settings live in the [推送配置] section of config/config.ini. 
[推送配置]
# 可选微信|钉钉|tg|邮箱|bark|ntfy|pushplus 可填多个
直播状态推送渠道 =
钉钉推送接口链接 =
微信推送接口链接 =
bark推送接口链接 =
bark推送中断级别 = active
bark推送铃声 =
钉钉通知@对象(填手机号) =
钉钉通知@全体(是/否) = 否
tgapi令牌 =
tg聊天id(个人或者群组id) =
smtp邮件服务器 =
是否使用SMTP服务SSL加密(是/否) =
SMTP邮件服务器端口 =
邮箱登录账号 =
发件人密码(授权码) =
发件人邮箱 =
发件人显示昵称 =
收件人邮箱 =
ntfy推送地址 = https://ntfy.sh/xxxx
ntfy推送标签 = tada
ntfy推送邮箱 =
pushplus推送token =
自定义推送标题 =
自定义开播推送内容 =
自定义关播推送内容 =
只推送通知不录制(是/否) = 否
直播推送检测频率(秒) = 1800
开播推送开启(是/否) = 是
关播推送开启(是/否)= 否

​
Key settings explained

​
Selecting channels — 直播状态推送渠道

Set this field to the name(s) of the channel(s) you want to use. The value is compared case-insensitively against the keys 微信, 钉钉, 邮箱, TG, BARK, NTFY, and PUSHPLUS. 
直播状态推送渠道 = TG
To enable multiple channels at once, separate them with commas. The same applies to API URLs and recipient addresses — multiple values can be comma-separated (both half-width , and full-width ， are accepted).
直播状态推送渠道 = TG,BARK
微信推送接口链接 = https://xizhi.qqoq.net/aaa.send,https://xizhi.qqoq.net/bbb.send
收件人邮箱 = alice@example.com,bob@example.com

​
Push-only mode — 只推送通知不录制

Set to 是 to monitor streamers and send notifications without saving any video. Useful when you only want alerts and do not need recordings. 
只推送通知不录制(是/否) = 是
直播推送检测频率(秒) = 300
When push-only mode is active, the tool sleeps for 直播推送检测频率(秒) seconds between each status check instead of starting an FFmpeg recording process.

​
Go-live notifications — 开播推送开启

Controls whether a notification is sent when a streamer goes live. Enabled by default. 
开播推送开启(是/否) = 是
Default push message when no custom content is set: 
直播间状态更新：[直播间名称] 正在直播中，时间：[时间]

​
Stream-end notifications — 关播推送开启

Controls whether a notification is sent when a live stream ends. Disabled by default. 
关播推送开启(是/否) = 是
Default push message when no custom content is set: 
直播间状态更新：[直播间名称] 直播已结束！时间：[时间]

​
Custom titles and message content

You can override the default notification title and message body for both go-live and stream-end events. 
自定义推送标题 = 直播提醒
自定义开播推送内容 = [直播间名称] 开始直播了！\n时间：[时间]
自定义关播推送内容 = [直播间名称] 已下播。\n时间：[时间]
The placeholders [直播间名称] and [时间] are replaced at runtime with the streamer’s display name and the current timestamp (YYYY-MM-DD HH:MM:SS). Use \n to insert a newline in the message body.
If 自定义推送标题 is left empty, the title defaults to 直播间状态更新通知.

​
Next steps

Push channels

Setup instructions and required credentials for each of the 7 supported push channels.

Build docs developers (and LLMs) love

Get started for freeTalk to us