Ce que fait cette page

Ce guide vous aide à configurer la fonction de streaming vidéo en direct sur votre site ComusThumbz. Une fois configurés, vos créateurs peuvent diffuser des vidéos en direct directement de leur navigateur à leurs fans, avec des conversations en temps réel, des pourboires et des émissions privées. Pensez-y comme mettre en place votre propre plateforme de streaming en direct Twitch ou OnlyFans.

[Screenshot: en direct-streaming-overview]

Pourquoi tu as besoin de ça

La fonctionnalité de streaming en direct permet aux créateurs de votre site:

• Aller directement en direct de leur navigateur (pas de logiciel spécial nécessaire)
• Vidéo en streaming avec très peu de retard (moins de 1 seconde)
• Dialoguez avec les téléspectateurs en temps réel
• Recevez des conseils pendant leur flux
• Offrir des spectacles individuels privés
• Contrôle qui peut regarder (gratuit, abonnés seulement, à la carte, etc.)

Pour les téléspectateurs, ils peuvent :

• Les créateurs de montres diffusent en direct
• Envoyer des messages dans le chat
• Envoyer des conseils aux créateurs
• Demander des spectacles privés

Avant de commencer

Ce dont vous aurez besoin

1. Un serveur séparé ou un VPS - Ce peut être le même serveur où ComusThumbz est installé, ou un autre. Minimum 2 Go RAM, 2 cœurs CPU recommandés.
2. Un domaine ou sous-domaine - Quelque chose comme streaming.yoursite.com
3. Environ 30-60 minutes - Pour le processus de configuration
4. Confort de base avec une ligne de commande - Vous devrez exécuter certaines commandes sur votre serveur

Vérifier si vous êtes prêt

Connectez-vous à votre serveur via SSH et exécutez ces commandes :

# Check if Docker is installed
docker --version

Vérifiez l'IP public de votre serveur

curl -s ifconfig.me

Si Docker n'est pas installé, ne vous inquiétez pas - le script d'installation peut l'installer pour vous.

Comprendre la configuration

Comment fonctionne la diffusion en direct

Creator's Browser -> Streaming Server -> Viewers' Browsers

1. Un créateur ouvre la page "Go Live" sur votre site
2. Leur webcam et leur microphone se connectent à votre serveur de streaming
3. Le serveur en streaming envoie la vidéo à tous les téléspectateurs qui regardent
4. Tout le monde peut discuter et envoyer des conseils en temps réel

Ce qui est installé

Le processus de configuration s'installe LiveKit, qui est le logiciel de serveur en streaming. Il fonctionne dans un conteneur Docker (pensez-y comme un mini-ordinateur autonome) sur votre serveur et gère tout le routage vidéo.

Étapes d'installation

Étape 1: Choisissez votre méthode d'installation

Il y a deux façons de configurer le serveur de streaming:

Option A: Installation automatisée (recommandée) - Un script fait tout pour toi
Option B: Configuration manuelle - Vous exécutez chaque commande vous-même (pour les utilisateurs avancés)

Nous recommandons l'option A pour la plupart des gens.

Option A : Installation automatisée (la plus facile)

1. Télécharger le script de configuration

1. Téléchargez le script d'installation depuis votre dossier d'installation ComusThumbz : tools/setuplivekitserver.sh
2. Téléchargez-le sur votre serveur de streaming (vous pouvez le mettre dans votre répertoire)

2. Rendre le script exécutable

Connectez-vous à votre serveur via SSH et lancez :

chmod +x setuplivekitserver.sh

3. Lancez le script de configuration

sudo ./setuplivekitserver.sh

Le script vous posera quelques questions, puis :

• Installez Docker si nécessaire
• Configurez votre pare-feu
• Configuration du serveur de streaming
• Générer des clés de sécurité

4. Sauvegardez vos lettres de créances

À la fin, le script vous montrera quelque chose comme:

API Credentials:
  API Key: APIxxxxxxxxxxxxxxxx
  API Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

5. Essai de l ' installation

Le script vous dira si tout fonctionne. Vous devriez voir un message disant "LiveKit fonctionne avec succès."

Option B: Installation manuelle (avancée)

Si vous préférez effectuer l'installation manuellement ou si le script automatisé ne fonctionne pas pour votre serveur, suivez les étapes d'installation manuelle détaillées du guide technique.

Connexion de ComusThumbz au serveur de streaming

Maintenant que votre serveur de streaming fonctionne, vous devez dire à votre installation ComusThumbz comment vous y connecter.

Étape 1: Activer la fonctionnalité

1. Log into your Admin Panel
2. Go to Admin Panel > Settings > Feature Toggles
3. Find Live Streaming and turn it ON
4. Click Save Changes

Step 2: Add Your Streaming Server Details

You need to add three pieces of information to your configuration file.

1. Log into your web server via SFTP or File Manager
2. Navigate to ct/dat/config.inc.php
3. Open the file for editing
4. Add these lines at the end of the file (before the closing ?> if there is one):

// LiveKit WebRTC Streaming Configuration
define('LIVEKITHOST', 'wss://streaming.yoursite.com/livekit/');
define('LIVEKITAPIKEY', 'paste-your-api-key-here');
define('LIVEKITAPISECRET', 'paste-your-api-secret-here');

1. Replace the values:

• streaming.yoursite.com - Your streaming server domain
• paste-your-api-key-here - The API Key from Step 4 of the installation
• paste-your-api-secret-here - The API Secret from Step 4 of the installation

1. Save the file

Step 3: Verify It's Working

1. Log into your site as a user who has creator access
2. Go to My Account > Go Live (in your user settings)
3. You should see the "Go Live" page with webcam options
4. If you see an error message instead, something isn't configured correctly

Testing Your Setup

Complete Streaming Test

Follow these steps to verify everything is working:

1. Prepare a Creator Account

You need an account with creator privileges to test.

1. Go to Admin Panel > Users > User Management
2. Find the user you want to test with
3. Click Edit
4. Make sure Is Creator is set to Yes
5. Save

2. Start a Test Stream

1. Log in as the creator
2. Go to My Account > Go Live
3. Fill in a stream title (like "Test Stream")
4. Set access to Free (so anyone can watch)
5. Click Start Streaming
6. When your browser asks for camera/microphone permission, click Allow
7. You should see your webcam preview on screen

3. Watch the Stream as a Viewer

1. Open a different browser (or incognito/private window)
2. Visit your site and go to Live Streams in the main menu
3. You should see your test stream listed
4. Click on it to watch
5. The video should appear within 1-2 seconds

4. Test the Chat

1. In the viewer window, type a message in the chat box and press Enter
2. The message should appear in both the viewer and broadcaster windows
3. This confirms real-time communication is working

5. End the Stream

1. Back in the broadcaster window, click End Stream
2. The stream should disappear from the Live Streams page
3. The viewer should see a message that the stream has ended

Where Creators and Viewers Go

For Creators (Broadcasters)

Go Live Page: Settings > Go Live

On this page, creators can:

• Select their camera and microphone
• Set a title and description for their stream
• Choose who can watch (free, password protected, subscribers only, pay-per-view, or tip goal)
• See their viewer count
• Read and respond to chat messages
• See tip notifications
• Accept or decline private show requests

For Viewers

Stream Directory: Live Streams (in main navigation)

This page shows:

• All active streams as a grid of preview cards
• Number of viewers watching each stream
• Creator's profile picture and name

Watch Stream Page: Clicking on any stream opens the viewer page

On this page, viewers can:

• Watch the live video
• Chat with the creator and other viewers
• Send tips
• Request a private show (if they have enough tokens)

Common Tasks

Restarting the Streaming Server

If your streams aren't working, sometimes you just need to restart the server:

# Log into your streaming server via SSH
docker restart livekit

Wait 10 seconds, then test again.

Checking if the Streaming Server is Running

# Log into your streaming server via SSH
docker ps | grep livekit

If you see a line with "livekit" in it, the server is running. If you don't see anything, start it:

cd /opt/livekit
docker compose up -d

Viewing Server Logs

If something isn't working and you need to see what's happening:

# Show the last 50 lines of the log
docker logs --tail 50 livekit

Watch the log in real-time (press Ctrl+C to stop)

docker logs -f livekit

Updating the Streaming Server

Every few months, you may want to update to the latest version:

# Pull the latest version
docker pull livekit/livekit-server:latest

Restart with the new version

docker compose down
docker compose up -d

Troubleshooting

Streams Won't Start

What you see: Creator clicks "Start Streaming" but nothing happens or an error appears.

How to fix it:

1. Check that the feature is enabled in Admin Panel > Settings > Feature Toggles
2. Verify the creator account has Is Creator set to Yes
3. Check your config.inc.php file has the three LIVEKIT settings
4. Verify the streaming server is running: docker ps | grep livekit

Viewers Can't Connect

What you see: The Live Streams page loads but clicking a stream shows an error or black screen.

How to fix it:

1. Make sure your firewall allows traffic on these ports:

• TCP: 7880, 7881
• UDP: 50000-60000

1. Check that your LIVEKITHOST uses wss:// (not ws://) if your site uses HTTPS
2. Verify your SSL certificate is valid if using HTTPS

Chat Works But Video is Black

What you see: Viewers can send chat messages but the video never appears.

How to fix it:

This usually means the UDP ports are blocked. On your streaming server:

# Open the UDP port range
sudo ufw allow 50000:60000/udp

Then restart the streaming server and try again.

"You Already Have an Active Stream" Error

What you see: Creator tries to go live but gets an error saying they already have a stream.

How to fix it:

This happens if a previous stream didn't end properly (browser crash, etc.). You can manually end it:

1. Go to Admin Panel > Live Streams (if you have this page)
2. Find the stuck stream and click End Stream

Or ask a developer to run this SQL command:

UPDATE tblLiveStreams
SET status = 'ended', endedat = NOW()
WHERE creatorid = [USERID] AND status IN ('waiting', 'live');

Replace [USERID] with the creator's user ID number.

Stream Previews Not Showing

What you see: The Live Streams directory page shows streams but no preview images.

How to fix it:

1. Check that the uploads/streamsnapshots/ folder exists
2. Make sure the folder is writable (permission 755 or 777)
3. Wait a few seconds - previews are captured every 30 seconds during a live stream

Tips for New Users

Access Control Options Explained

When creators start a stream, they choose who can watch:

Creators can change these settings for each stream.

Understanding Private Shows

Private shows are one-on-one streams between a creator and a single viewer. Here's how they work:

1. A viewer watches a public stream
2. They click Request Private Show
3. They set how many minutes they want
4. The request appears to the creator
5. If the creator accepts:

• The public stream ends
• A new private stream starts
• Only the requesting viewer can watch
• Tokens are deducted per minute automatically

1. When time runs out (or someone ends it), the private show ends

Creators set their per-minute rate in their creator profile settings.

Security and Privacy

What's Protected

• All video streams are encrypted in transit
• Tokens (payment for access) are generated by the server, not the browser
• Viewers can only join rooms they have permission for
• Chat messages are stored in your database

What to Watch For

• Require SSL/HTTPS - Always use wss:// in your LIVEKIT_HOST setting for production sites
• Monitor reported streams - Have a moderation system for inappropriate content
• Set up rate limiting - Prevent chat spam by limiting how fast users can send messages
• Review your firewall - Only open the ports mentioned in this guide

Related Pages

Getting Help

If you're stuck:

1. Check the logs - Run docker logs livekit to see what the streaming server is reporting
2. Test the connection - Make sure you can reach your streaming server from a browser
3. Verify your config - Double-check the three LIVEKIT settings in config.inc.php
4. Check the forum - Other users may have solved the same issue
5. Contact support - Provide the output of docker ps and docker logs --tail 50 livekit

What's Next?

Once your live streaming is set up:

1. Promote the feature - Let your creators know they can now go live
2. Create a guide for creators - Write simple instructions for your specific audience
3. Set token prices - Decide pricing for pay-per-view and private shows
4. Monitor usage - Watch server resources to see if you need to upgrade
5. Gather feedback - Ask creators and viewers what they like or what needs improvement