Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
hummelstrand authored Nov 22, 2023
1 parent 71542eb commit 2a41b30
Showing 1 changed file with 24 additions and 10 deletions.
34 changes: 24 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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
Expand All @@ -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
Expand All @@ -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

Expand All @@ -66,23 +76,23 @@ _Note: If `apiKey` is set in config.json, all requests must include `?apiKey=API

# For Developers

## Getting started
## Getting Started

```bash

yarn dev # or npm run dev

```

## Build binary
## Build Binary

```bash

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.

Expand Down Expand Up @@ -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._

0 comments on commit 2a41b30

Please sign in to comment.