obs-ss-plugin-webui/README.md
Decobus 1d4b1eefba
Some checks failed
Lint and Build / build (20) (push) Has been cancelled
Lint and Build / build (22) (push) Has been cancelled
Initial commit - OBS Source Switcher Plugin UI
Complete Next.js application for managing OBS Source Switcher
- Stream management with multiple screen layouts
- Team management CRUD operations
- SQLite database integration
- OBS WebSocket API integration
- Updated to latest versions (Next.js 15.4.1, React 19.1.0, Tailwind CSS 4.0.0)
- Enhanced .gitignore for privacy and development
2025-07-15 22:15:57 -04:00

1.2 KiB

This is a Next.js app to control multiple OBS Source Switchers

Configuration

The application uses a configurable directory for storing files and the database. To update the directory: create .env.local in the root of the project.

.env.local should look like:

FILE_DIRECTORY=C:\\OBS\\source-switching

If no .env.local file is created, it will default to ./files, as seen in config.js

  const config = {
    FILE_DIRECTORY: path.resolve('./files'),
  };

In the "Source Switcher" properties in OBS, at the bottom, is a setting called Current Source File. Enable that, point it to the location of one of the text files, and put the read interval to 1000ms. Your source will change whenever the text file changes to a source that is defined in the Source Switcher properties

The list of available sources is defined in a SQLite3 DB, location set in the api/setActive.ts route.

npm install and npm run dev to run it.

This is my first Next.js app and I am not a Javascript Developer professionally, use at your own risk.