openCountdown/README.MD

33 lines
1.5 KiB
Plaintext
Raw Normal View History

2022-07-23 18:15:14 +02:00
<img alt="openCountdown Logo" height="90px" src="https://git.project-name-here.de/Project-Name-Here/openCountdown/raw/branch/master/static/logo/logoProposal.svg">
2022-07-23 18:15:01 +02:00
2022-02-24 20:17:24 +01:00
# openCountdown
2022-07-15 17:29:43 +02:00
openCountdown is a professional software for event countdowns. It can be used in a live settings such as a music event.
Support for companion is currently being worked on [here](https://github.com/bitfocus/companion-module-pnh-opencountdown).
2022-07-15 23:59:48 +02:00
<a href="https://bitfocus.io/companion/?ref=pnh-Opencountdown" target="_new"><img alt="Controllable by Companion" src="https://bitfocus.io/companion-badge.png?ref=pnh-Opencountdown"></a>
2022-07-15 17:32:12 +02:00
# Installation
You can download complete binaries from the release tab.
## Development build
1. Download the repository
2022-11-13 00:46:18 +01:00
2. `npm install` to install dependencies
3. `npm start` to launch
2022-07-15 17:32:12 +02:00
### Startup Arguments
One can pass a `--headless` argument to start the server in headless mode. This will disable the GUI.
2022-07-15 18:40:30 +02:00
## Packaging
2022-11-13 00:46:18 +01:00
We've introduced a new packaging system. It is based on [electron-builder](https://www.electron.build/). This allows for easy packaging of the application for different platforms.
2022-07-15 18:40:30 +02:00
```bash
2022-11-13 00:46:18 +01:00
chmod +x ./build.sh
./build.sh
2022-07-15 18:40:30 +02:00
```
2022-11-13 00:46:18 +01:00
> Binary Builds may be faulty or non-working. They are not officially supported.
2022-07-15 17:29:43 +02:00
*Small disclaimer: Please do not use openCountdown for military or life-depending applications. Please also refrain from using openCountdown for launching rockets.*
2022-02-24 20:17:24 +01:00
# ToDo
2022-07-15 17:29:43 +02:00
Endpoint documentation is currently pretty thin. This will be changed in the future.
2022-07-15 17:30:03 +02:00
- [ ] Endpoint docs (in Progress)
2022-03-28 22:14:33 +02:00
- [ ] Better WS frames