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:
- Install
Node.js. You need at least version14.17. - Make sure you have
npm@7. This can be checked by runningnpm -v. If your version ofnpmis too old, update it usingnpm i -g npm@7 - Clone this repository (or your fork):
git clone https://github.com/josephdadams/TallyArbiter - Run
npm installin the project's root folder - Start the main server with
npm start - 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
UIdirectory withcd UI - Install its dependencies with
npm install - Start the local UI development server by running
npm start. - Open a browser and navigate to
http://localhost:4200.
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.
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 express.static().
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:
- Edit
package.jsonandpackage-lock.jsonand update the version tag to the new version number - Open the TallyArbiter repository in Git
- Run
git tag <new version tag> - Run
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.