An Electron-based standalone application for Social Stream Ninja.

• 🔌 No requirement to keep visible - Capture social media chats without keeping popups visible and open
• 💬 Multi-Platform Support - Websocket support for YouTube, Twitch, TikTok, and more
• 🔊 Text-to-Speech - Built-in TTS with Kokoro-82M model

Download the latest release for your platform from the Releases page.

Social Stream Ninja is available in the AUR (Arch User Repository):

# Using yay
yay -S socialstreamninja

# Using paru
paru -S socialstreamninja

# Manual installation
git clone https://aur.archlinux.org/socialstreamninja.git
cd socialstreamninja
makepkg -si

• Node.js 18 or higher
• npm 8 or higher
• Python (for native module compilation)

# Clone the repository
git clone https://github.com/steveseguin/ssn_app.git
cd ssn_app

# Install dependencies
npm install

# Run in development mode
npm run start2

# Windows
npm run build:win32

# macOS (x64 and arm64)
npm run build:darwin

# Linux
npm run build:linux

# Raspberry Pi
npm run build:rpi

1. Launch the application
2. Load Social Stream Ninja or your custom social stream ninja URL
3. Configure your chat sources
4. Add the window capture to OBS

For detailed usage instructions, visit the Social Stream Ninja documentation.

If YouTube sign-in loops or quota still appears to hit the default project in SSAPP, check the following:

1. In SSAPP, use External browser sign-in for YouTube.
2. In the YouTube websocket page, open Use your own YouTube API quota and add your own Google API key.
3. After saving credentials, sign out/in again in the YouTube source so requests use your key's quota project.
4. In Google Cloud, ensure YouTube Data API v3 is enabled in the same project as that API key.
5. For SSAPP/Electron, do not lock the API key to HTTP referrer restrictions.
6. If Google asks for authorized domains on consent setup, add socialstream.ninja (you do not need to add youtube.com).

The app stores configuration in:

• Windows: %APPDATA%/socialstream/
• macOS: ~/Library/Application Support/socialstream/
• Linux: ~/.config/socialstream/

Official releases are signed. You can verify the authenticity using the included code-signing-cert.pem file. See CODE_SIGNING.md for details.

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

• Social Stream Ninja - The web application and Chrome extension
• VDO.Ninja - WebRTC live streaming tool

• 📖 Project Homepage
• 💬 Discord Community
• 🐛 Report Issues

• Built with Electron
• TTS powered by Kokoro-82M
• Part of the VDO.Ninja ecosystem