A camera tally lights project capable of listening/fetching tally data from multiple sources or video switchers and arbitrating whether an end device is considered to be in Preview or Program. Supports many different switcher types and protocols as well as many types of tally output.
Installation instructions can be found here.
All documentation can be found here.
Contributions are always welcome. Here's a quick guide on how to setup your local development environment:
Node.js. You need at least version
- Make sure you have
npm@7. This can be checked by running
npm -v. If your version of
npmis too old, update it using
npm i -g npm@7
- Clone this repository (or your fork):
git clone https://github.com/josephdadams/TallyArbiter
npm installin the project's root folder
- Start the main server with
- Make any code changes desired
- Submit your work as a pull request
The UI lives in the
UI folder and is written using Angular.
If you want to make changes to the UI, you need to do the following:
- Navigate to the
- Install its dependencies with
- Start the local UI development server by running
- Open a browser and navigate to
When you make changes to the source code, the page in your browser will automatically reload.
The socket.io / REST API requests the UI makes are automatically proxied to
http://localhost:4455. That's the reason why the main server (see above) needs to be running.
npm install in the project's root folder (not in the UI directory) the UI is built automatically. As the UI's bundled dist files are excluded from the git repository in the
.gitignore file, this is needed to ensure users which install TallyArbiter from source also have bundled UI dist. This dist is also served by the main server using
The Desktop App is made with Electron. The main file is called
main.js (not to be confused with the
index.js, which is the server's entrypoint.)
The Electron App can be started with
npm run desktop. It will always show the generated UI dist, so in order to see changes made to the UI in the desktop app, you need to build the UI (see above).
The installer can be generated by running
npm run build-desktop.
Releasing a new version of Tally Arbiter:
package-lock.jsonand update the version tag to the new version number
- Open the TallyArbiter repository in Git
git tag <new version tag>
git push --tags
- Wait for the GitHub build actions to complete
- Open the releases page and to the the tags area
- Open the new version and update the description with the added features and patched bugs
- Press the publish button to publish the new version of TallyAbiter
Tally Arbiter was written by Joseph Adams and is distributed under the MIT License.
It is not sold, authorized, or associated with any other company or product.
To report a bug or open a feature request, please go to our issues page. If you would like to see more of @josephdadams's projects or send a word of encouragement his way, please visit techministry.blog.