mirror of
https://github.com/DerTyp7/teamspeak-obs-overlay.git
synced 2026-07-31 08:39:04 +02:00
Compare commits
22 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
59594125a5 | ||
|
|
32108d7a99 | ||
|
|
5c8d9721b2 | ||
|
|
24f3e6dd88 | ||
|
|
3461e2be0a | ||
|
|
456d09d647 | ||
|
|
09d24b2acd | ||
|
|
389033e795 | ||
|
|
76ee50e262 | ||
|
|
2fb3c47e33 | ||
|
|
7676e72ca1 | ||
|
|
7bd7786465 | ||
|
|
e27cd40234 | ||
|
|
13080ca9d1 | ||
|
|
a74ae8988f | ||
|
|
31b564d676 | ||
|
|
c9c31a3e64 | ||
|
|
db770ab2b1 | ||
|
|
9d3a30462c | ||
|
|
dbb171ef11 | ||
|
|
66e8f699e3 | ||
|
|
c8a44d5a5d |
65
README.md
65
README.md
@@ -8,48 +8,79 @@ This overlay uses the [Teamspeak 5 Remote App API](https://github.com/DerTyp7/re
|
|||||||

|

|
||||||
|
|
||||||
- [Teamspeak5-OBS-Overlay](#teamspeak5-obs-overlay)
|
- [Teamspeak5-OBS-Overlay](#teamspeak5-obs-overlay)
|
||||||
- [Setup](#setup)
|
- [Usage](#usage)
|
||||||
- [Customization (Parameters)](#customization-parameters)
|
- [Quick instructions (online usage only)](#quick-instructions-online-usage-only)
|
||||||
|
- [Instructions](#instructions)
|
||||||
|
- [Settings (Parameters)](#settings-parameters)
|
||||||
|
- [Are you using the **online** version (recommended version)?](#are-you-using-the-online-version-recommended-version)
|
||||||
|
- [Are you using the **offline** version?](#are-you-using-the-offline-version)
|
||||||
|
- [Adding Parameters](#adding-parameters)
|
||||||
- [Setup (Developer)](#setup-developer)
|
- [Setup (Developer)](#setup-developer)
|
||||||
- [Common Issues](#common-issues)
|
- [Common Issues](#common-issues)
|
||||||
- [The overlay is empty, but i'm connected to a Teamspeak 5 server](#the-overlay-is-empty-but-im-connected-to-a-teamspeak-5-server)
|
- [The overlay is empty, but i'm connected to a Teamspeak 5 server](#the-overlay-is-empty-but-im-connected-to-a-teamspeak-5-server)
|
||||||
|
|
||||||
## Setup
|
## Usage
|
||||||
|
|
||||||
1. Download the `ts5-overlay-{version}.html` of the latest release from [here](https://github.com/DerTyp7/ts5-obs-overlay/releases/latest)
|
### Quick instructions (online usage only)
|
||||||

|
|
||||||
1.1. (optional) You can rename the file. Just remember using the new file name in the future instead of `ts5-overlay-{version}.html`
|
1. Go into the Teamspeak 5 Settings and enable "Remote Apps"
|
||||||
2. Go into the Teamspeak 5 Settings and enable "Remote Apps"
|
2. Add a new Browser Source to your OBS Scene and enter `https://dertyp7.github.io/ts5-obs-overlay/` as URL
|
||||||
|
3. Set the width and height to your desired size (e.g. 1920x1080 OR 1280x720)
|
||||||
|
4. You should now receive a notification in Teamspeak 5 that the app is allowed to connect to your Teamspeak 5 client. Allow it.
|
||||||
|
|
||||||
|
### Instructions
|
||||||
|
|
||||||
|
1. Go into the Teamspeak 5 Settings and enable "Remote Apps"
|
||||||

|

|
||||||
|
|
||||||
3. Add a new Browser Source to your OBS Scene
|
2. Add a new Browser Source to your OBS Scene
|
||||||

|

|
||||||

|

|
||||||
|
|
||||||
4. Tick the checkbox "Local File" and select the downloaded `ts5-overlay-{version}.html`
|
3. Configure **Browser Source** (Use **ONE** of the following methods)
|
||||||
4.1. Set the width and height to your desired size (e.g. 1920x1080 OR 1280x720)
|
|
||||||

|
|
||||||
|
|
||||||
|
1. **Online Usage (recommended):** Enter **`https://dertyp7.github.io/ts5-obs-overlay/`** as URL
|
||||||
|
2. **Offline Usage (ignore this if you use the online usage above):**
|
||||||
|
1. Download the `ts5-overlay-{version}.html` of the latest release from [here](https://github.com/DerTyp7/ts5-obs-overlay/releases/latest)
|
||||||
|

|
||||||
|
1.1. (optional) You can rename the file. Just remember using the new file name in the future instead of `ts5-overlay-{version}.html`
|
||||||
|
2. Tick the checkbox "Local File" and select the downloaded `ts5-overlay-{version}.html`
|
||||||
|
|
||||||
|
4. Set the width and height to your desired size (e.g. 1920x1080 OR 1280x720)
|
||||||
5. You should now receive a notification in Teamspeak 5 that the app is allowed to connect to your Teamspeak 5 client. Allow it. (If you don't get a notification, restart Teamspeak 5 and OBS -> try again)
|
5. You should now receive a notification in Teamspeak 5 that the app is allowed to connect to your Teamspeak 5 client. Allow it. (If you don't get a notification, restart Teamspeak 5 and OBS -> try again)
|
||||||

|

|
||||||
|
|
||||||
### Customization (Parameters)
|
## Settings (Parameters)
|
||||||
|
|
||||||
You can customize the overlay by adding parameters to the URL of the Browser Source.
|
You can customize the overlay by **adding parameters** to the URL of the **Browser Source**.
|
||||||
|
|
||||||
|
### Are you using the **online** version (recommended version)?
|
||||||
|
|
||||||
|
1. Open your Browser Source settings
|
||||||
|
2. Start adding parameters like discribed in [Adding Parameters](#adding-parameters)
|
||||||
|
|
||||||
|
### Are you using the **offline** version?
|
||||||
|
|
||||||
1. Open your Browser Source settings
|
1. Open your Browser Source settings
|
||||||
2. **Untick** the checkbox "Local File"
|
2. **Untick** the checkbox "Local File"
|
||||||
3. Add `file://` to the beginning of the URL
|
3. Add `file://` to the beginning of the URL
|
||||||

|

|
||||||
4. Start adding parameters like discribed below
|
4. Start adding parameters like discribed in [Adding Parameters](#adding-parameters)
|
||||||
|
|
||||||
|
### Adding Parameters
|
||||||
|
|
||||||
Start by adding a `?` to the end of the URL and then add the parameters.
|
Start by adding a `?` to the end of the URL and then add the parameters.
|
||||||
To add multiple parameters, you have to seperate them with a `&`.
|
To add multiple parameters, you have to seperate them with a `&`.
|
||||||
|
|
||||||
Like this: `file://C:/Users/.../ts5-overlay-{version}.html?parameter1=value1¶meter2=value2`
|
Like this:
|
||||||
Real example: `file://C:/Users/.../ts5-overlay-{version}.html?remoteAppPort=5899&hideNonTalking=true&clientLimit=5`
|
**Online:** _`https://dertyp7.github.io/ts5-obs-overlay/?parameter1=value1¶meter2=value2`_
|
||||||
|
**Offline:** _`file://C:/Users/.../ts5-overlay-{version}.html?parameter1=value1¶meter2=value2`_
|
||||||
|
|
||||||
This is a list of all available parameters (all parameters are optional):
|
Real example:
|
||||||
|
**Online:** _`https://dertyp7.github.io/ts5-obs-overlay/?remoteAppPort=5899&hideNonTalking=true&clientLimit=5&showChannelName=true`_
|
||||||
|
**Offline:** _`file://C:/Users/.../ts5-overlay-{version}.html?remoteAppPort=5899&hideNonTalking=true&clientLimit=5&showChannelName=true`_
|
||||||
|
|
||||||
|
This is a **list** of **all available parameters** (all parameters are optional):
|
||||||
|
|
||||||
| Parameter | Description | Type | Default |
|
| Parameter | Description | Type | Default |
|
||||||
| ----------------- | ---------------------------------------- | ------- | --------------- |
|
| ----------------- | ---------------------------------------- | ------- | --------------- |
|
||||||
|
|||||||
2584
package-lock.json
generated
2584
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
13
package.json
13
package.json
@@ -1,7 +1,9 @@
|
|||||||
{
|
{
|
||||||
"name": "ts5-obs-overlay",
|
"name": "ts5-obs-overlay",
|
||||||
"private": true,
|
"private": true,
|
||||||
"version": "1.2.3",
|
"version": "1.3.1",
|
||||||
|
"description": "Overlay for OBS to show the current talking clients in your Teamspeak 5 Channel",
|
||||||
|
"homepage": "https://dertyp7.github.io/ts5-obs-overlay",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"dev": "vite",
|
"dev": "vite",
|
||||||
@@ -10,19 +12,18 @@
|
|||||||
"preview": "vite preview"
|
"preview": "vite preview"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@types/node": "^20.4.5",
|
"@types/node": "^20.8.3",
|
||||||
"jest": "^29.6.1",
|
|
||||||
"react": "^18.2.0",
|
"react": "^18.2.0",
|
||||||
"react-dom": "^18.2.0",
|
"react-dom": "^18.2.0",
|
||||||
"react-router-dom": "^6.14.2",
|
"react-router-dom": "^6.14.2",
|
||||||
"react-ts5-remote-app-api": "^1.1.1",
|
"react-ts5-remote-app-api": "^1.1.1",
|
||||||
"sass": "^1.64.1"
|
"sass": "^1.68.0"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@types/jest": "^29.5.2",
|
"@types/jest": "^29.5.2",
|
||||||
"@types/react": "^18.2.14",
|
"@types/react": "^18.2.23",
|
||||||
"@types/react-dom": "^18.2.7",
|
"@types/react-dom": "^18.2.7",
|
||||||
"@typescript-eslint/eslint-plugin": "^6.2.0",
|
"@typescript-eslint/eslint-plugin": "^6.7.4",
|
||||||
"@typescript-eslint/parser": "^6.2.1",
|
"@typescript-eslint/parser": "^6.2.1",
|
||||||
"@vitejs/plugin-react-swc": "^3.0.0",
|
"@vitejs/plugin-react-swc": "^3.0.0",
|
||||||
"eslint": "^8.45.0",
|
"eslint": "^8.45.0",
|
||||||
|
|||||||
@@ -11,9 +11,9 @@ export default function App() {
|
|||||||
remoteAppPort: parseInt(searchParams.get("remoteAppPort") ?? "5899"),
|
remoteAppPort: parseInt(searchParams.get("remoteAppPort") ?? "5899"),
|
||||||
auth: {
|
auth: {
|
||||||
identifier: "de.tealfire.obs",
|
identifier: "de.tealfire.obs",
|
||||||
version: "1.2.3",
|
version: "1.3.1",
|
||||||
name: "TS5 OBS Overlay",
|
name: "TS5 OBS Overlay",
|
||||||
description: "A OBS overlay for TS5 by DerTyp876",
|
description: "A OBS overlay for TS5 by DerTyp7",
|
||||||
},
|
},
|
||||||
logging: true,
|
logging: true,
|
||||||
});
|
});
|
||||||
|
|||||||
Reference in New Issue
Block a user