Awesome
mpv-youtube-chat
Display chat replays overlayed on top of the video for past Youtube livestreams and premiers using yt-dlp
Notes
- Untested on platforms other than Linux. If you are not using Linux you may need to manually set the script options
live-chat-directory
and/oryt-dlp-path
. - Does not currenly work for streams are premiers that are currently airing as the live chat won't finish downloading until the stream/premier finishes. If you try to load the chat in one that is active it will still start downloading the live chat, so keep that in mind.
- Downloading live chats can take awhile, especially for videos that have a very active chat and/or videos that are very long.
Requirements
- yt-dlp is required to download the live_chat.json
Usage
Binding load-chat
to a keybinding and press it in a video. If the video is being played locally it will look for video_filename_without_extension.live_chat.json
and load that if it exists. Otherwise, if you're watching from a URL, it will check if the video has a subtitle with the language live_chat
and if so, it will download it to the path stored in live-chat-directory
(see Options) with the filename video_id.live_chat.json
if it does not already exist in that path, otherwise it will just load it from disk.
Bindable actions
load-chat
-> attempts to load the live chat replay as specified in Usageunload-chat
-> unloads the currently loaded live chatchat-hidden
-> toggles the visibility of the live chat, optionally takesyes
orno
as a parameter to set it to that value instead of toggling itchat-anchor
-> cycle theanchor
option (see Options) from 1 through 9, optionally takes a value to set it directlybreak-anywhere
-> toggles the value of themessage-break-anywhere
option, optionally takesyes
orno
as a parameter to set it to that value instead of toggling it
To bind an action, use script-message
(e.g. CTRL+j script-message load-chat
)
Options
auto-load
(defaultno
) -> attempt to automatically load live chat when a video loadslive-chat-directory
(defaultC:/
on Windows andXDG_DATA_HOME/youtube-live-chats
on all other platforms) -> the directory to downloadlive_chat.json
files toyt-dlp-path
(defaultyt-dlp
) -> the path to youryt-dlp
executableshow-author
(defaultyes
) -> show the author's name with their messageauthor-color
(defaultrandom
) -> color of the author's name in the message, available values arerandom
,none
, or a specific hex value (without a #)author-border-color
(default000000
) -> color of the borders around the author's namemessage-color
(default toffffff
) -> color of the body text of a messagemessage-border-color
(default000000
) -> color of the borders around the body text of a messagefont
(default to the osd font) -> font to use for chat messagesfont-size
(default16
) -> font size for chat messagesborder-size
(default2
) -> border size for chat messagesmessage-duration
(default10000
) -> duration that each message is shown for in milisecondsmax-message-line-length
(default40
) -> the amount of characters before a message breaks into a new linemessage-break-anywhere
(defaultno
) -> whether line breaks in messages can happen anywhere or only after whole wordsmessage-gap
(default10
) -> additional spacing between chat messages, given as a percentage of the font heightanchor
(default1
) -> where chat displays on the screen in numpad notation (1
is bottom-left,7
is top-left,9
is top-right, etc.)
Plans
- Parse live chats as they download, circumventing the need to wait for the whole thing to download before loading the chat and also allowing currently active streams and premiers to be supported
- Support more chat message types. Currently regular messages and superchats (possible that some might be missed as of right now, there seems to be multiple formats for different kinds of messages and I'm not entirely sure what the difference is between these message formats are, if any) both work, I still need to add support memberships and paid stickers and possibly other kinds of messages I'm unaware of.
- Better message rendering. If chat is anchored to the right, every line of every message will also be anchored to the right which looks rather unpleasant. See if I can have the chat be anchored to the right while allowing individual lines to be anchored to the left