https://github.com/nevylish/livechat
👾📺 Twitch/OBS - Inspiré par les gars hilarants de la cacabox.
https://github.com/nevylish/livechat
livechat obs obs-studio overlay twitch
Last synced: about 2 months ago
JSON representation
👾📺 Twitch/OBS - Inspiré par les gars hilarants de la cacabox.
- Host: GitHub
- URL: https://github.com/nevylish/livechat
- Owner: Nevylish
- License: gpl-3.0
- Created: 2025-06-04T20:23:07.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-05T02:09:36.000Z (4 months ago)
- Last Synced: 2025-06-05T02:09:38.829Z (4 months ago)
- Topics: livechat, obs, obs-studio, overlay, twitch
- Language: TypeScript
- Homepage: https://livechat.nevylish.fr/
- Size: 48.8 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎥 LiveChat
**Un overlay OBS qui permet à vos amis d'afficher des médias sur votre flux**
## 📝 À propos
LiveChat est un bot Discord et un overlay OBS Studio qui permet d'afficher une image, une vidéo ou jouer un son sur un flux en direct, par exemple, depuis une simple commande Discord.
Plusieurs streameurs peuvent utiliser le même serveur Discord, et les utilisateurs pourront choisir à quel streameur envoyer leur média.
## 🚀 Utilisation
### Pour les streameurs
1. **Ajoutez le bot Discord** sur votre serveur privé via le lien ci-dessous :
```
https://discord.com/oauth2/authorize?client_id=1379921658109890610
```
2. **Configurez OBS Studio** :
- Ajoutez une nouvelle source de type "Navigateur"
- Dans le champ URL, entrez :
```
https://livechat.nevylish.fr/overlay.html?username=VOTRE_PSEUDO_TWITCH&guildId=ID_DE_VOTRE_SERVEUR
```
- Remplacez `VOTRE_PSEUDO_TWITCH` par votre pseudo Twitch
- Remplacez `ID_DE_VOTRE_SERVEUR` par l'ID de votre serveur Discord
3. **Utilisez le bot** :
- Tapez `/livechat` dans votre serveur Discord
- Sélectionnez votre pseudo dans la liste
- Ajoutez l'URL du média que vous souhaitez afficher
### Pour les "viewers"
1. Rejoignez le serveur Discord du streameur
2. Utilisez la commande `/livechat` pour partager des médias
- Sélectionnez le pseudo du streameur à qui vous voulez envoyer le média
- Ajoutez l'URL du média
3. Vos médias s'afficheront instantanément dans le stream du streameur sélectionné
> ⚠️ **Attention** : Gardez à l'esprit que tous les membres présents sur le serveur pourront utiliser la commande /LiveChat et faire apparaître n'importe quoi sur votre flux, n'invitez pas n'importe qui.
### 📁 Formats de médias supportés
LiveChat ne supporte que les liens directs vers des fichiers médias. Voici comment partager vos médias :
1. Envoyez votre média dans un canal Discord (formats acceptés : .mp4, .webm, .mkv, .mov, .mp3, .wav, .ogg, .jpg, .png, .gif)
2. Faites un clic droit sur le fichier et sélectionnez "Copier le lien"
3. Utilisez ce lien dans la commande `/livechat`
> ⚠️ **Important** : Les liens YouTube, TikTok, ou autres plateformes de streaming ne sont pas supportés. Vous devez d'abord télécharger le média et l'envoyer sur Discord.
## 💻 Pour les développeurs
### Prérequis
- Node.js 18 ou supérieur
- npm ou pnpm
- Un serveur Discord
- OBS Studio
### Installation
1. **Cloner le repository**
```bash
git clone https://github.com/nevylish/LiveChat.git
cd LiveChat
```
2. **Installer les dépendances**
```bash
npm install
```
3. **Configurer l'environnement**
Créez un fichier `.env` à la racine du projet :
```env
LIVECHAT_PORT=port_du_serveur_web
TOKEN=token_de_votre_bot_discord
```
4. **Lancer l'application**
```bash
npm run dev
#et
npm run start
```
### Architecture du projet
```
LiveChat/
├── src/
│ ├── core/ # Cœur de l'application
│ │ ├── commands/ # Commandes Discord
│ │ ├── modules/ # Modules utilitaires
│ │ ├── DiscordClient.ts # Classe du bot Discord
│ │ └── LiveChatServer.ts # Classe du serveur web et socket
│ ├── public/ # Fichiers statiques
│ └── index.ts # Point d'entrée
├── dist/ # Fichiers compilés
├── .env # Variables d'environnement
├── .prettierrc # Configuration du formatage
├── docker-compose.yml # Configuration Docker
├── Dockerfile # Configuration de l'image Docker
├── package.json # Dépendances et scripts
└── tsconfig.json # Configuration TypeScript
```
### Scripts disponibles
| Commande | Description |
| ---------------- | --------------------------------------------------------------------- |
| `npm run dev` | Compile le TypeScript en mode watch (recompilation automatique) |
| `npm run build` | Compile le TypeScript pour la production |
| `npm run start` | Lance l'application |
| `npm run clean` | Nettoie le dossier de build (dist/) et recopie les fichiers statiques |
| `npm run format` | Formate le code avec Prettier |
## 🐳 Docker
### Déploiement rapide
Le projet peut être déployé facilement avec Docker Compose.
```bash
# Cloner le repository
git clone https://github.com/nevylish/LiveChat.git
cd LiveChat
# Configurer les variables d'environnement
cp .env.example .env
# Éditez .env avec vos paramètres
# Lancer avec Docker Compose
docker-compose up -d
```
## 🤝 Contribution
Ce projet est ouvert aux contributions !
## 📄 Licence
Ce projet est sous licence GPL-3.0. Voir le fichier `LICENSE` pour plus de détails.
## 📞 Contact
- **Email** : bonjour@nevylish.fr
---