Skip to content
SupportOpen app

Settings, privacy and troubleshooting

Change the plugin settings, check what the plugin sends to Screel, and fix sign-in and sync problems.

Open Edit → Editor Preferences → Plugins → Screel, or choose Editor preferences… in the Screel menu. These settings are per user.

Setting Default Effect
Environment Production The Screel service the plugin signs in to. Custom shows the Web Base Url, Auth Issuer and Api Base Url fields for a Screel server that your organization runs. A sign-in belongs to one environment, so a change needs a new sign-in.
Thumbnail Cache Entries 256 Scene thumbnails kept in memory for the marker track (16 to 4096).
Show success notifications On Shows success toasts and notes, such as “Scene 3 refined in Screel”, “Screel <version> is available.”, a stopped sign-in and “Clip render stopped.” Warnings, failures, sync errors, progress and a required update always show.
Share Viewport Peek Off Uploads a small viewport picture every few seconds while a sequence is linked and the editor is active. Teammates see it. See Privacy below.

Capture defaults, marker, clip render and sync options are project-wide and live under Edit → Project Settings → Plugins → Screel. Project settings… in the Screel menu opens them.

Still Format in the Capture defaults group sets the file of the marker and key stills and their clay pass:

Option Effect
JPEG The default. Quality 95. Several times smaller than PNG, so a sync is faster.
PNG Lossless. The files are several times larger.

The exact stills of a clip render and the Movie Render Queue stills use the same format. The depth and object ids passes stay PNG.

Capture Quality sets the size of stills and clips: Draft · 1280 px, Standard · 1920 px (the default) or High · 3840 px. The top of the Screel project settings shows What a sync sends: the size, format and bitrate of each file for the current settings.

Capture Aspect Policy decides what happens when the camera’s aspect ratio differs from the project’s. Native (the default) keeps the camera’s own aspect ratio. Letterbox fits the whole view and pads it with black bars. Crop fills the project frame and cuts off the rest.

Still Renderer in the Capture defaults group sets how a sync renders the stills of markers and keys:

Option Effect
Scene capture · TSR The default. Renders in the editor in under a second, with smooth edges and foliage.
Scene capture · TAA Renders in the editor in under a second. Fine detail is softer than with TSR.
Scene capture · FXAA The fastest. Edges and dithered foliage stay jagged.
Movie Render Queue Syncs the TSR still first. It then renders the stills again in a play session and replaces them, so each still matches a rendered clip. Each sync takes a few seconds longer. With the Letterbox or Crop aspect policy, stills keep the TSR capture.

The other project settings:

Group Setting Default Effect
Capture defaults Capture Passes beauty The passes of every capture. See Add passes.
Capture defaults Fade, Motion blur, Depth of field Off, Off, On See Capture settings.
Clip render Clip Subject Matte On Renders a subject matte beside each clip.
Clip render Clip Clay On Renders a lighting-only clay clip for each marker.
Clip render Clip Exact Stills On Updates the raw still and keys from the frames of the clip render. Needs the Native aspect policy.
Render graph Render Graph None The Movie Render Graph for clip renders and Send with render graph.
Markers Snap marker edges to camera cuts On An edge within half a second of a camera cut lands on the cut.
Markers Analyze frames for camera cut markers On Markers from camera cuts samples the frames and adds keys where the view changes.
Markers Marker Deleted Policy Ask each time What happens to the scene when you delete its marker: Ask each time, Keep the scene or Delete the scene.
Sync Default Sync Target Scenes What the link dialogs preselect under Sync to.
Objects Rules, Group Folder Depth, Min Listed Share, Subjects First See Object ids.

Change them in Editor Preferences → Keyboard Shortcuts.

Context Command Default
Screel Open in Screel Ctrl+Alt+O
Screel Send viewport to Screel None
Screel Open linked Screel sequence None
Screel markers Add Screel marker Shift+M
Screel markers Add Screel key Shift+K
Screel markers Recapture Screel marker Ctrl+Alt+R
Screel markers Send frame to Screel Ctrl+Alt+F
Screel markers Sync Screel markers now Ctrl+Alt+Y

While you are signed in, the plugin sends:

  • A presence heartbeat every 20 seconds with the Unreal project name, the engine version, the plugin version and the current level. It lets your own Screel tabs find your editor. The plugin clears it when you sign out or close the editor.
  • Your place in a linked sequence: the sequence, the playhead frame, the marker under it, the camera name and the sync progress. Teammates on the project see where you are.
  • A realtime connection to the Screel API, which carries sync state, presence and commands from Screel, such as “Open in Unreal”. An editor signed in with an API key does not open it.
  • Frames and media only when you send them. Marker captures, Send, passes and clip renders upload when you sync, send or render, and nothing else leaves the editor.

Share viewport peek is off by default. When you link your first sequence, the plugin offers it once with the buttons Share viewport peek and No thanks. No thanks ends the offer for good. Turn the peek on later in Editor Preferences → Plugins → Screel → Presence. When it is on, the plugin uploads a small viewport picture (about 320 pixels wide) every few seconds while a sequence is linked and the editor window is active. The plugin does not upload a viewport that has not changed. Teammates on the project can see it. Turn it off in the same place, or in the Presence section of the level toolbar’s send options (⋮). The plugin deletes its last peek picture when the editor shuts down.

The refresh token that keeps you signed in is stored in your user settings folder (Screel/auth.json). On Windows, the plugin seals it to your Windows user with DPAPI, so another user or another machine cannot read it. An editor signed in with an API key stores no token.

The plugin has no analytics and no crash reporting.

Sign-in says “Sign-in could not start: other apps hold the sign-in ports. Close them, then sign in again.” Another program is using ports 47391 to 47395. Close that program, or any other Unreal editor that is in the middle of a sign-in, and select Sign in again.

The browser opens but Unreal never signs in. A firewall or security tool may block local connections. Allow Unreal Editor to accept connections on 127.0.0.1; the plugin does not listen on any other address. The plugin gives up after five minutes. Select Sign in to try again.

The status line reads “Signed out” after a launch, or a sign-in ends with “Your Screel session ended. Sign in again.” Screel rejected the saved sign-in, for example after access was revoked. Select Sign in and finish the browser step. A launch without a network connection does not cause this.

The log reads “Screel refused the API key”. The key was revoked, expired or mistyped. Create a new key in Screel. See Sign in with an API key.

The log reads “The Screel API key does not start with scr_; it is ignored.” The key value is wrong. Copy the whole key again from Screel.

The status line reads “Screel unreachable — retrying”. The editor could not reach Screel at launch. It keeps your saved sign-in and retries in the background, so you do not need to sign in again.

The Sequencer status chip shows a red dot, and its tooltip reads “N pictures did not upload: …”. The marker synced, but some pictures did not upload. The affected markers stay in the count of markers to sync. Hover over the chip for the error code. A rate limit or a network failure retries on its own after a growing delay. If the message says “Your Screel storage is full. Free up space, then sync again.”, free up space in Screel, then edit a marker or click the status chip in the Sequencer toolbar.

The status line reads “Waiting for shaders…”. The plugin waits for shaders and assets to compile before it captures marker frames. It waits up to 15 seconds, then captures.

“This version of the Screel plugin is out of date. Update it to keep syncing.” (PLUGIN_OUTDATED). Screel needs a newer plugin version. Syncing stops until you update. Choose Get update in the “Update Screel to <version> to keep syncing.” notice, or install the new version, then restart the editor.

The plugin reads “The Unreal integration is not enabled on this account.” Contact support.

The status line reads “Reconnecting…” or Screel cannot reach the editor. Check your network connection. The plugin reconnects on its own.

A command says “Open … in Sequencer to run this”, naming a sequence. Screel aimed the command at a sequence that is not in focus. Open that sequence in Sequencer.

For anything else, see Support. Include your Screel account email and your engine version. Add the error code from the sync failure notice (Copy details copies it) or from the tooltip of the status chip.