diff --git a/README.md b/README.md index bae5ac6..eb991cd 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,16 @@ # Sofie Chef -This is a small Electron application which is used to display a number of web pages in fullscreen. +This is the _Chef_ application of the [**Sofie** TV Automation System](https://github.com/nrkno/Sofie-TV-automation/), a small Electron app which is used to display web pages and camera inputs in fullscreen mode. The intended use to display HTML graphics and video with low latency directly out to a TV studio screen. + +### Repository-specific Info for Developers +* [Developer Info](DEVELOPER.md) +* [Contribution Guidelines](CONTRIBUTING.md) + +### General Sofie System Info +* [Documentation](https://nrkno.github.io/sofie-core/) +* [Releases](https://nrkno.github.io/sofie-core/releases) + +--- # Usage @@ -10,7 +20,7 @@ When the `config.json`-file is edited, the application applies the changes insta Most properties of the `config.json`-file are also automatically updated when moving or resizing the windows. -## Keyboard shortcuts +## Keyboard Shortcuts - `CTRL+Alt+SHIFT+F` Toggles fullscreen for the current (or last) selected window - `CTRL+Alt+SHIFT+I` Toggles DevTools (console) for the current (or last) selected window @@ -22,12 +32,12 @@ Most properties of the `config.json`-file are also automatically updated when mo See [config.ts](src/lib/config.ts) -## Tips for running in fullscreen +## Tips for Running in Fullscreen Mode Here are some tips for when you want to display something in fullscreen and want to avoid ANY overlays on top of the content (like popups). -### In general +### General Tips - In the config file, set: ```json @@ -37,10 +47,10 @@ ANY overlays on top of the content (like popups). } ``` -### When using Windows +### When Using Windows - Put the fullscreen window on a non-main display. - If the content is on the primary display, an accidental click on the Windows-key will open the start-menu which will display on top of the output. + If the content is on the primary display, an accidental click on the Windows key will open the Windows Start menu which will display on top of the output. # API @@ -66,7 +76,7 @@ _Note: If `apiKey` is set in config.json, all requests must include `?apiKey=API # For Developers -## Getting started +## Getting Started ```bash @@ -74,7 +84,7 @@ yarn dev # or npm run dev ``` -## Build binary +## Build Binary ```bash @@ -82,7 +92,7 @@ yarn build:binary ``` -## For web pages rendered in Sofie Chef +## For Web Pages Rendered in Sofie Chef If needed, the web page rendered inside Sofie Chef can be made aware that they are running inside by looking at the userAgent. @@ -111,9 +121,13 @@ The Websockets API is exposed on the port `apiPort+1`. A description of the data # For Maintainers -## Make a new release +## Making a New Release 1. `yarn release` 2. Push the branch (and tag!) to GitHub 3. Wait for the [Github Action](https://github.com/nrkno/sofie-chef/actions/workflows/create-release.yaml) to finish building the binaries. 4. Go to [Releases](https://github.com/nrkno/sofie-chef/releases) and publish the release draft. + +--- + +_The NRK logo is a registered trademark of Norsk rikskringkasting AS. The license does not grant any right to use, in any way, any trademarks, service marks or logos of Norsk rikskringkasting AS._