MOSH/ Troubleshooting
On this pageMac PKG installation failsHDR or unsupported color rejectedIngest storage and free spaceDefault scratch locationSupport-assisted external scratchLOAD FAILED or unsupported mediaPerson analysis or unexpected boundariesExport fails or audio is missingA session is gone after reopeningEffects versus failuresContact supportMac Adobe installer 1.0.21
Reference

Troubleshooting MOSH

Mac PKG installation fails

The 1.0.8 PKG can reject a genuine existing 1.0.8 app because of an older-receipt preinstall guard. This is a confirmed reinstall bug, not a proven explanation for every clean-install failure.

Stop repeated installs. Capture the exact message and contact support with the filename, macOS version, Mac chip and whether MOSH was already installed. A support-provided signed 1.0.8 DMG can avoid the PKG script; see installation. Do not erase license receipts, reset activations, remove quarantine or bypass Gatekeeper.

A reported clean-install failure on Apple Silicon/macOS 14.4 remains under investigation. Its cause and recovery are not established; there is no fixed installer version to announce.

HDR or unsupported color rejected

Mac 1.0.8 rejects HLG (arib-std-b67), PQ (smpte2084) and BT.2020-tagged inputs. Some other unsupported matrices also fail. An 8-bit H.264 MP4 can still contain HDR tags.

  1. Preserve the original.
  2. In a color-managed editor or converter, create a separate SDR Rec.709 copy with actual tone mapping and gamut conversion.
  3. Export consistent Rec.709 primaries, transfer and matrix metadata.
  4. Check appearance, duration and audio before loading the new copy.

Relabeling metadata or changing the extension is not conversion. This guidance is not an automatic MOSH conversion feature or a universally tested converter recipe.

Ingest storage and free space

This guidance applies to Mac Standalone 1.0.8, not Windows or editor plugins. MOSH decodes a working frame store. A small compressed source movie can need much more scratch space while it is being processed.

The disk admission estimate is approximately:

width × height × 1.5 × frame count × 1.2 + 1,073,741,824 bytes

The 1.5 term is the 8-bit YUV 4:2:0 frame store; 20% allows for working media/motion data, and 1 GiB adds headroom. Frame count comes from metadata or duration and average frame rate. Displayed GB values are decimal billions rounded to one decimal place. This is an estimate, not an exact prediction or reserved space. Other work can consume free space after the check.

Preserve the original. Prepare a separate shorter or lower-resolution compatible copy outside MOSH, then retry with enough free space on the actual scratch volume. For HDR footage, make a genuinely color-managed SDR Rec.709 copy as described in HDR preparation. No specific target duration or exactly matching the displayed shortfall guarantees success. Never erase source media or licensing files to make room.

Default scratch location

Ordinary launch uses:

~/Library/Application Support/GFMoshSessions-v2/

MOSH adds its own session and clip folders there. Loading a source from an external SSD does not move scratch to that SSD. An external export destination also does not redirect ingest scratch. Mac 1.0.8 has no in-app scratch picker or persistent scratch-location preference.

The 12 GiB session cap evicts older unprotected clips; it is not a maximum ingest size or storage guarantee. Loaded clips are protected from eviction, so an active cache can exceed that size. Normal quit attempts to remove only the verified session owned by that process. Do not assume all old crash sessions are purged, use symlinks to relocate caches, or delete active/unknown session directories.

Support-assisted external scratch

Mac 1.0.8 supports GFMOSH_CACHE_PARENT for one launch. A retained installed 1.0.8 run successfully imported, played and exported with an external parent. That establishes the capability on the tested Mac/filesystem; it does not qualify every SSD format, mount, permissions or configuration. A separate human Terminal walkthrough is not established by that test.

Ask support to confirm the folder and app paths before using this launch pattern:

  1. Export any result you need and quit MOSH normally. It has no editable saved sessions; do not start a second instance alongside one already running.
  2. Connect the SSD and confirm it is mounted. In Finder, create a dedicated folder such as MOSH Scratch, with adequate free space and write access. It must already exist on a filesystem device different from your home filesystem. Do not create a lookalike mount path when the drive is disconnected.
  3. For an app installed at /Applications/MOSH.app, the support-assisted direct-launch pattern is:
GFMOSH_CACHE_PARENT="/Volumes/Your SSD/MOSH Scratch" "/Applications/MOSH.app/Contents/MacOS/GFMosh"

Replace the quoted parent placeholder with the exact existing folder; a different app installation needs its actual executable path. This sets the variable for that process only. It does not change global environment, preferences, permissions, activation or license scope. A later normal Finder launch uses the default scratch parent again.

  1. Load a compatible clip normally. Keep the SSD connected during ingest, playback and export. Export before quitting; do not disconnect the drive or delete its scratch folder during the session.

MOSH appends its owned GFMoshSessions-v2 session namespace beneath the parent. Missing, unavailable, root or same-device parents are refused; do not assume an internal-drive fallback. No global environment change, security bypass, privileged cleanup, license reset or background service is part of this procedure.

LOAD FAILED or unsupported media

Use a regular local MOV, MP4 or AVI movie. Containers can hold unsupported video or audio codecs. Record the exact message, codec, dimensions and color information; preserve the original. Let ingest finish before replacing the source. Ingest can be canceled; export cancellation is not promised.

Person analysis or unexpected boundaries

Mac 1.0.8 detects people only, using a 16×16 block mask. Hair and fine edges need review. With no person detected, Subject stays clean and Background affects the frame. An analysis failure is an error; try All to avoid separation. Do not assume Windows uses the same qualified path.

Export fails or audio is missing

Choose a new destination and check free space. Test a short clip. ProRes 422 is initially selected; compatible AAC can be retained, while PCM needs a compatible MOV/ProRes path. Unsupported audio is not silently guaranteed. Check the full exported duration, picture, timing and sound. There is no export frame-rate selector; every codec, variable frame rate and multitrack source is not qualified.

A session is gone after reopening

Mac 1.0.8 has no editable session save/reopen. Its ingest cache is session-local. Normal quit attempts to remove the verified owned session; blanket cleanup of old crash-orphan folders is not guaranteed. Keep original source/donor files and export before closing.

Effects versus failures

Smears, broken motion prediction and abrupt melt transitions can be intentional. Installer or activation failure, crashes, LOAD FAILED, unsuccessful export, unexpected missing audio/duration and damage to original media are failures or unsupported inputs. Experimental visuals do not excuse them.

Contact support

Email Faceworldinstruments@gmail.com with MOSH, your purchased format, app/installer version, OS/chip, steps and the exact message or a cropped screenshot. Send order details privately. Do not attach private download links, signed receipts, license files or client footage.

Mac Adobe installer 1.0.21

The customer-delivered MOSH Adobe Installer for Mac 1.0.21.pkg is separate from the tested 1.0.22 build. The 1.0.21 package has a trusted installer signature and Apple notarization, but it contains neither MOSH Activation.app nor a Resolve OpenFX component.

Do not assume this package installs a Mac activation helper or Resolve effect, or apply another version’s installation/activation acceptance to it. Package contents alone do not show whether an existing activated Adobe setup can run. If a fresh installation needs a helper or your order promises Resolve and supplies no separate Mac component, contact support about the exact download. Preserve working installations and activation receipts; do not rename orders, delete license state or buy again to work around a missing component.

Contact Support

MOSH / Faceworld VideoReviewed October 14, 2026