QTAKE Monitor User Guide 4.5
About
QTAKE Monitor is the client-side application that connects to QTAKE Stream, QTAKE Server, QTAKE Cloud, and other software or hardware products from the QTAKE ecosystem. It provides multi-camera live monitoring, clip browsing with advanced metadata filters, synchronized playback of multiple clips, metadata collaboration, and more. In a film location or inside a studio, it uses a local wired or wireless network to connect to the stream source. However, it can also connect to QTAKE Cloud over the internet to provide the most advanced remote workflow solution accessible worldwide. QTAKE Monitor app is available for iPhone, iPad, Mac, and Apple TV.
Live Streaming
QTAKE uses a proprietary QLS protocol designed to provide secure, ultra-low latency audio, video, and metadata streaming. QTAKE Stream has less than two frames of latency on the local network and less than four frames of latency over a fast internet connection. Internet connection to live stream requires QTAKE Cloud Stream service.
Playback and Notes
QTAKE Server provides independent clip playback and metadata editing through the QTAKE Monitor for iOS and Mac over the local network. Internet access to clips and metadata requires QTAKE Cloud Sync service.
Installation
Download the app from the Apple App Store on your selected device.
- QTAKE Monitor for iOS, iPadOS, macOS Catalina or later, and tvOS
iPad, iPhone, and Mac
The iOS and macOS version of QTAKE Monitor is the most advanced one. In addition to receiving up to 9 local or cloud streams, it provides access to QTAKE Server. This means you can independently browse and play recorded clips and edit rich clip metadata. QTAKE records proxy media on the fly, so remote playback in QTAKE Monitor is available only seconds after the camera cuts.
iOS and macOS System Requirements
Any iPhone, iPad, or iPod running iOS 13 or later.
Any Mac running macOS 10.15 or later.
Apple TV
QTAKE Monitor tvOS version is currently available for local and cloud streams only.
tvOS System Requirements
Any 4th or later generation Apple TV running tvOS 12.2 or later.
Windows, Linux, Android
The native QTAKE Monitor app is available only on Apple devices. The web interface is available for clients who wish to connect to QTAKE Cloud Stream from Windows, Linux, Android, or other platforms. See QTAKE Cloud for more info.
Configuration
Ports
In most cases, QTAKE Monitor requires no additional configuration for local network use. However, if you use QTAKE Monitor on a restrictive network, you may need to allow traffic on particular ports depending on the QTAKE Monitor functionality you want to use.
QTAKE Stream
To stream over the local network, enable traffic to and from the following ports on the QTAKE Video Assist System:
- TCP 7000, 7007
- UDP 8567
For QTAKE Cloud Stream, enable traffic to and from the following QTAKE Cloud ports in addition to the above:
- TCP 443, 8500
- UDP 8550, 8551
The QTAKE Cloud Service uses the following domain names:
- api.qtake.cloud
- live.qtake.cloud
- sync.qtake.cloud
- stream.qtake.live
Never rely on any particular IP addresses these currently resolve to. The stream.qtake.live record is updated on each new deployment of QTAKE Cloud service instances, which may happen at any time. If you use it to configure your firewall, ensure it polls for changes every few minutes.
QTAKE Sync
To access independent playback over the local network, enable traffic to and from the following ports on the QTAKE Server System:
- TCP 8500 – 8600
- TCP 44443
For QTAKE Cloud Sync, enable the above ports for the domain you received as part of your project link.
User Account
When you run the QTAKE Monitor app for the first time, you should create your user account. Local stream does not require a user account, but you need one to use Cloud stream and playback.
App Login
Open the QTAKE Monitor app and click the top-left button.
Click the LOG IN button inside the PROJECTS window.
Enter your EMAIL address and click LOG IN.
Enter a strong PASSWORD. The password must contain at least 3 of the following: lowercase letters, uppercase letters, digits, and special characters.
Optionally enter your FULL NAME for your co-workers to recognize you.
Click the SIGN UP button and wait for the activation email.
Web Login
Alternatively, you can use the web interface to create your user account. Click the following link to open your web browser and load the QTAKE Cloud login page.
Note that only existing users can use the initial page. If you haven’t registered for a QTAKE Cloud account, click the Don’t have an account? link. It will load the Sign Up page.
Enter your EMAIL and a strong PASSWORD. Optionally enter your FULL NAME to allow your co-workers to recognize you. After entering all required information, click the CREATE ACCOUNT button and await the activation email.
Account Activation
After creating an account in the QTAKE Monitor app or using the QTAKE Cloud website, you will receive an activation email to confirm your email address. Click the link contained in the activation email to finalize your QTAKE Cloud account registration.
Two-Factor Authentication
To provide a higher level of security, your QTAKE Cloud Account can be protected using two-factor authentication (TFA). Click the orange ENABLE TWO-FACTOR AUTHENTICATION button below the email address.
Alternatively, switch to the USERS list and swipe left on the user to reveal ACCOUNT SETTINGS.
Turn on TWO-FACTOR AUTHENTICATION and allow push notifications. You can authorize multiple devices for TFA and use account settings to manage them.
Authorizing Additional Devices
Authorized devices receive push notifications with verification codes when logging in to your account. You can authorize multiple devices at the same time. To authorize an additional device,
- Open the Users section in QTAKE Monitor (located to the left of the Projects tab) on an already-authorized device.
- Swipe to the left, over your email in the list, and choose Account Settings.
- You will be prompted for your account password.
- Find your device in the list of logged-in devices and select it.
- Click Authorize.
Recovering Account Access
After enabling TFA, you will receive an email containing your Account Recovery Key. Store this key in a secure location.
In case you lose access to your authorized device,
- Open the attached key on a new device and choose Copy to QTAKE Monitor (you might have to unhide this option by More).
- You will be prompted for your account password.
- On the next screen, disable Two-Factor Authentication.
- Re-enable Two-Factor Authentication. It will authorize your new device in addition to any previously authorized devices.
- Optionally, review the list of authorized devices below and remove any devices you no longer have access to.
Removing Account
If you want to remove your user account from the list of users, you can do so by tapping the Edit button in the top left corner of the window and then tapping the red minus button next to your user account. It will reveal the Forget button which will remove your account from the list. Please note this will only remove the account from the current device, not from QTAKE Cloud.
Deleting Account
If you wish to permanently delete your QTAKE Cloud Account, you can do so in the Users tab of QTAKE Monitor. Either tap Edit, then the red minus button next to your user account, or swipe to the left over the account line. Both will reveal an Account Settings button, which opens a view with account deletion (among other things).
Local Streaming Instructions
To start a local stream, establish a network connection between the streaming device and the device running QTAKE Monitor. A standard Wi-Fi router will do the job. You can use existing studio infrastructure too, but we recommend using a dedicated Wi-Fi network.
Enable Stream in QTAKE
Launch QTAKE and create a new project or load an existing project.
To enable remote discovery via Bonjour, enable STREAM in QTAKE.
Click the STREAM button in the bottom row of the interface to display the toolbar.
Now click the STREAM button.
See STREAM Menu for more information.
Scan QR Code in QTAKE Monitor
QTAKE Monitor application uses Bonjour network discovery to find QTAKE projects on the local network. To enable streaming between the QTAKE Monitor and the streaming device connect both devices to the same network.
Launch QTAKE Monitor on the iPad, and a window listing available QTAKE projects will appear. If you see no projects in the list, click the SCAN PROJECT LINK button.
Once you scan the QR code, the project name will appear in the list. Tap on the project name to connect. QTAKE Monitor will display two views and a “Waiting for approval…” message.
Approve the connection from QTAKE
When QTAKE Monitor attempts to connect to QTAKE, one of the sixteen buttons in the STREAM toolbar will become active, displaying the name of the device attempting to connect.
You can approve the connection by clicking on the button.
It will initiate streaming to the QTAKE Monitor application.
Long-clicking the STREAM button brings up the STREAM SETUP window.
Here you can get an overview of the clients connected to QTAKE Stream.
This window also allows you to enable TALKBACK from one of the connected clients and also set a CLIENT TITLE that will appear in the STREAM toolbar.
The FORGET button allows you to manually disconnect a client to make room for other clients to connect.
Note that an active client will try to reconnect even after being disconnected.
Talkback
When you enable TALKBACK, the client will see a TALK button in the QTAKE Monitor app (bottom right of the interface).
Then a QTAKE Monitor client can talk back to the QTAKE operator.
Only one client at a time can have talkback enabled.
Talkback can also be enabled directly from the STREAM toolbar by long-clicking the corresponding client button.
The button will appear brighter, and “Talk” will be added to the label to indicate that TALKBACK is enabled.
See the TALKBACK section for more information on setting up TALKBACK in QTAKE.
You can control the name of the machine running QTAKE as it appears in the app by going to System Preferences - Sharing and changing the Computer Name field.
Cloud Streaming Instructions
QTAKE provides remote streaming over the internet in case clients need to connect to the QTAKE stream from a remote location. It is called CLOUD STREAM because it uses QTAKE Cloud to provide a secure connection between a computer running QTAKE and a client device running QTAKE Monitor.
Enable Cloud Stream in QTAKE
On the QTAKE side, cloud streaming works the same way as local streaming, with a few exceptions:
- QTAKE computer has to be connected to the internet.
- QTAKE operator has to be logged in to QTAKE Cloud. See more in the QTAKE Cloud Login section.
- QTAKE operator’s Cloud Account has to have stream data. See more in the Cloud Stream Data section.
- QTAKE operator needs to invite QTAKE Monitor client. See more in the Cloud Stream section.
- After the client connects, a prompt in QTAKE will appear asking to enable cloud stream for this client.
Open Cloud Stream Link using QTAKE Monitor
Clients need to take the following steps to receive the Cloud stream:
- Device running QTAKE Monitor has to be connected to the internet.
- QTAKE Monitor user has to be logged in to QTAKE Cloud.
- Client needs to open an email from the QTAKE operator and click the link.
- QTAKE Monitor will open and load the project.
- After the QTAKE operator approves a connection, streaming will start automatically.
Open Cloud Stream Project on Apple TV
After logging into QTAKE Monitor for Apple TV, active projects associated with your QTAKE Cloud Account will automatically appear in the app. If there is no active stream from QTAKE at that time, the project will not appear.
UI
QTAKE Monitor supports up to nine views. These views mirror the views of the connected QTAKE system in their default, automatically patched state.
MAIN SCREEN in QTAKE Monitor consists of the top bar, view area, sidebars, and toolbars.
Top Bar
The top bar of the main screen is always visible to allow access to essential functions. The only exception is a full-screen mode, which you can access by reverse pinching the view.
OPEN PROJECT
The top-left button shows the title of the active project. Tap this button to open the PROJECTS window with the list of available projects. Each project has a name on the left side and a label on the right. Tap the project to initiate a connection to QTAKE.
- Orange LIVE label means the project is available for local network streaming.
- Pink LIVE label is displayed when the project is available for Cloud streaming over the internet.
- Green PLAY label marks the project available for clip playback and metadata editing.
- Gray PLAY label shows that the server is offline, but local playback is available, or your user has not been approved by QTAKE Server.
- Gray OFFLINE label means that the server is offline.
HELP SCREEN
Tap the HELP button in the project window to reveal touch controls.
- Tapping a view will make the view active. QTAKE Monitor will only play audio from the active view.
- Double tapping on either view will toggle between the DUAL/QUAD and SINGLE view.
- Long-pressing any view will show VIEW MENU.
- Swiping up or down will switch to the previous or next clip.
- Panning left or right will scrub the clip to the beginning or end.
- Swiping down with three fingers will pause that view.
- Swiping up using three fingers will lock the screen, mute the audio, or access settings.
- A reverse pinch will bring a view into fullscreen mode.
- Two-finger tap will take a screenshot.
SET ACTIVE VIEW
Next to the project button, you will see a button with V1, V2, V3, V4 segments. Use this control to switch the active view. The active view has a white outline. When QTAKE is recording, the outline will change color to red. QTAKE Monitor will only play audio from the active view.
VIEW LAYOUT
Long-press this button to switch between DUAL VIEW and QUAD VIEW mode. To switch to a single-view mode, double-tap the desired view.
REPLAY
Utilize this button to promptly access the last recorded take. Tap the arrow on the right of the REPLAY button to show RECENTLY SHOT and RECENTLY PLAYED clips, and tap any of them to load that into active view.
BROWSE
Tap this button to enter the BROWSER screen.
Long-press it to switch between FULL SCREEN and SPLIT SCREEN browser modes.
If the BROWSE button is not displayed, this could be because your user has not been approved by QTAKE Server or your user has no user role assigned.
LIVE
Use this button to load LIVE clips. The live clip is the clip that the camera is currently shooting. As soon as the camera cuts, a new live clip is created. Tap this button to edit the current take, shot, or scene metadata.
CLIP | MONITOR
The next button in the top bar is the **CLIP | MONITOR** segmented button. |
CLIP MODE
In the CLIP mode, the QTAKE Monitor user controls playback. Users can decide which clip to load and review. This mode also gives users access to shared metadata for each clip based on access permissions. Use this mode when you want to review takes independently of video village or when you want to edit notes.
MONITOR MODE
In the MONITOR mode, QTAKE Operator controls playback. It is a standard video village style of centralized control where QTAKE Monitor users passively monitor video assist feeds. Use this mode to remotely watch the QTAKE stream.
SELECT VIEW SOURCE
The last button in the top bar is the SOURCE selector for each view. There can be various sources available based on project type and access permissions. When the number of active streams changes, a red badge with the number of available streams appears on top of this button.
MONITOR
The MONITOR section will show available live-stream sources. Usually, there is a separate stream available for each camera.
DEVICE
The DEVICE section will show available devices, such as internal cameras or ScreenPort SDI devices, considering the user is approved to record or import clips.
DISK
The DISK section will show camera letters of recorded clips available for playback. Setting each view to a different camera letter lets you easily navigate multi-camera projects.
REHEARSAL
If the CLIP is marked as REHEARSAL in TAKE metadata, the view outline in the view area changes from a solid outline to a dashed outline. QTAKE operator can change this metadata attribute in QTAKE SHOOT ROOM -> CLIP toolbar -> TAKE or QTAKE Monitor user can change it by clicking R in the CLIP metadata TAKE section, considering the user has appropriate permissions granted by the QTAKE Server administrator.
Side Bar
Use the bottom-right button to show sidebar controls. It is a multi-purpose area, and you can switch it between various modes, depending on the project type and access permissions.
If any of the buttons below are not displayed, this could be because your user has not been approved by QTAKE Server administrator or your user has no User role assigned.
META
The META sidebar shows metadata for the active clip or project. Click the METADATA button to switch between clip and project metadata. Each metadata group uses a different color to make the navigation easier. Access permissions are based on metadata groups. You can have Read, Write, Add, and Remove field permission for each group, based on your user role. If you need to edit metadata for multiple clips simultaneously, select clips in the split browser and use the same sidebar to edit values.
IN-OUT
The IN-OUT sidebar shows in-out ranges for the active clip. Ranges marked by QTAKE Operator are using green color. User ranges are blue. Users can mark a unique range and annotate it with text or a drawing.
FX
FX sidebar is used to apply view effects.
DVE
DVE is used to apply simple 2D effects, such as scale, position, flip, and flop.
MASK
MASK effect is used to mark the region of interest and dim the outside area. You can also use a specified rectangle to crop the image using the CROP TO MASK tool.
ADMIN
If the user role is set to Administrator by QTAKE Server, the ADMIN sidebar will become available. Use this sidebar to approve users and devices, assign and edit roles and edit watermark settings.
Views
Views display video. QTAKE Monitor supports up to 9 Views. Each view can display a live stream or a recorded clip. Use the top-right SOURCE button to select the source for each view. HELP SCREEN section describes basic touch controls for Views.
PLAYBACK CONTROLS
Playback controls in QTAKE Monitor are invisible to avoid obstructing the image. Tap in the middle of a view to reveal them.
- PLAY PAUSE command is located in the bottom center of the image.
- PREVIOUS FRAME command is located in the bottom-left corner of the image.
- NEXT FRAME command is located in the bottom-right corner of the image.
- GO TO IN MARK command is located in the top-left corner of the image.
- GO TO OUT MARK command is located in the top-right corner of the image.
- SCRUB command uses the middle part of the image from left to right edge.
VIEW MENU
Long press any view to access VIEW MENU. This menu provides quick access to VIEW LAYOUT, CLIP OR MONITOR mode, BROWSE screen, and playback of the last recorded take.
HDR
QTAKE Monitor supports High Dynamic Range video in both live stream and playback modes. For best results, please set the Rendering to Deep Color (16-bit) in the Settings.
Screenshot and screen-recording prevention
When high-level content protection is required, QTAKE Operator can turn off Screenshot permission for both live stream and playback modes. It will prevent system-level screenshots, screen recordings, and in-app screenshot functionality.
Settings
Various aspects of QTAKE Monitor functionality can be adjusted using the SETTINGS page. You can access Settings using a three-finger swipe up.