ZatsuDachi is a simple streaming chat viewer with an emphasis on supporting a multitude of streaming platforms at once! It uses a plugin based architecture to easily support additional platforms and ships with a web chat display designed to work with OBS browser sources! Additionally it is one of the few programs I am aware of capable of display a horizontal chat (just make the OBS source's height less than 200 pixels!)
Example from: https://vstream.com/c/@doxy_ai
Example from: https://vstream.com/c/@zovastria
Huge shout out to DreadExcalibur for the name!
Currently I provide first party support for the following platforms
- Twitch: (plugin can be downloaded here: https://gist.github.com/doxy-ai/8fae7aeb8890f5bed3e2fa7843af9084)
- Youtube: (plugin: https://gist.github.com/doxy-ai/f567236fd6320e721cbd127b11ca7cb0)
- Vstream: (plugin: https://gist.github.com/doxy-ai/364d9804d97c8d37285e7b8671d274d4)
- Kick: (plugin: https://gist.github.com/doxy-ai/f605f31922051151dc044494d1d9af56)
There is also an example of a profanity filter and a pinger which will play a sound notification when you recieve a new message after a break in the plugins/disabled folder, moving them up into the plugins folder should enable them with no extra configuration necessary!
If you have made a plugin for another platform (or a better version of one of these platforms) feel free to open a pull request!
- Download the latest version of Python 3.12 https://www.python.org/downloads/ (When installing it make sure to check the checkbox on the first page to add python to the path)
- Download an installer from the latest release: https://github.com/doxy-ai/ZatsuDachi/releases
- Run the installer selecting the platform plugins you would like to download
- Sit back and relax as everything is done for you!
- Run ZatsuDachi from the windows start menu (a terminal window and a GUI should appear)
- (optional) A URL (something along the lines of http://127.0.0.1:8080) should have been printed in the terminal window shown by step 4. You can paste that URL into a web browser or an OBS browser source to view your chat!
- Download the latest version of Python 3.12 https://www.python.org/downloads/ (When installing it make sure to check the checkbox on the first page to add python to the path)
- Click the green "Code" button in the top right and select "Download as Zip"
- Unzip ZatsuDachi somewhere and note where
- Open a terminal (this can be done by opening the start window on windows and typing cmd)
- Navigate to where you unzipped ZatsuDachi (cd <the folder from step 3>)
- Run
pip install colour flask==2.3.3 flask_socketio packaging customtkinter requests requests-html userpathsto install ZatsuDachi's dependencies. NOTE: If you are using linux you will need to install libtk using your package manager - (optional) Run
python downloadPlugin.pyto download one of the platform plugins above (this will automatically install its dependencies!) - Run
python zatsu.pyin the terminal we opened to launch ZatsuDachi - (optional) A URL (something along the lines of http://127.0.0.1:8080) should have been printed by step 8. You can paste that URL into a web browser or an OBS browser source to view your chat!
Q) The app launches but disappears immediately!
A) This usually means that when you installed python you forgot to check the box on the first page to add it to the path... go ahead and try to install it again making sure to check that box!
Q) How do I combine multiple streams from the same platform.
A) Each plugin only supports a single stream... that means you would need to go into the plugin folder and duplicate the appropriate plugin for each additional stream you want to view.
General setup guides can be found above!
If you need additional asstance the current best place to get it would be in the discord server: https://discord.gg/XWdrwyRgNQ Feel free to drop a message asking for help!
More specific instructions for some particular topics can be found here:
- Coming soon