Requirements

• Web app - a recent version of Chrome, Safari or Firefox (Chrome recommended), on desktop or mobile devices.
• Desktop app - Windows 10 (64-bit) or later, or macOS 13 or later. Apple Silicon and Intel Macs are supported.
• Export size is up to 4096 px per side: 4096 x 4096 for images, about 4096 x 2304 for video. On mobile devices, up to 2048 px per side.
• Export times depend on GPU speed, export size, duration and frame rate.

Desktop App PRO

The desktop app for Mac and Windows is included with Mosh-Pro. It adds:

• Runs locally, with no internet connection needed after registration.
• Spout / Syphon output for live video to other apps.
• Pop Out Preview that stays on top of other windows.
• Projects and presets saved as files on your computer.

Installation

• Download the desktop app from the web app’s account panel, or from the links in your purchase email.
  • Windows: Double-click the ‘Mosh-Pro Setup.exe’ file to run the installer.
  • macOS: Double-click the ‘Mosh-Pro.dmg’ file, then drag the Mosh-Pro app icon to your Applications folder.
• The first time you run Mosh-Pro you will be asked to enter your license key. Internet connection is required for one-time registration.
• Mosh-Pro may be installed on up to 3 computers for each license.

Updating

• To install the latest version, use Help -> Check for Updates….
• See the Version History for what’s new.
• Your license information and presets are kept when updating.
• The web app is always the latest version. Reload the page to update.

Accounts and Licenses

Mosh-Pro licenses can be used on both web and desktop.

Web app

• The web app asks you to sign in the first time you export. Sign in with email and password, or with Google.
• Click the account button at top right to open your account panel. It shows your plan, your license key and the desktop app downloads.
• Bought Mosh-Pro before, or bought on the website? Enter your license key in the account panel to make your account Pro.
• Can’t find your key? It’s in your purchase email, and in the account panel once it’s linked. Still stuck? Email support@moshpro.app.
• A Pro account can be signed in on 2 browsers at a time.

Desktop app

• Each license can be registered on up to 3 computers.
• Use Help -> Check License… to view your license details and see which computers are registered.
• To move your license to another computer, click Deregister This Device. This frees up a slot so you can register another computer.
• An internet connection is required to view registered devices and to deregister a device.

Managing Subscriptions

• To cancel, change card, or switch between monthly and yearly, click Manage billing in the web app’s account panel, or use the Manage your subscription link in your purchase email.
• Cancelling keeps Pro until the end of the period you’ve paid for.
• Subscriptions bought through Gumroad are managed through Gumroad (see below).

Gumroad Customers

• Your license key keeps working in the desktop app, and now unlocks the web app too. Sign in to the web app and enter your key in the account panel.
• Your key is in your Gumroad receipt email (search for “Mosh”), or log in to gumroad.com.
• Gumroad subscriptions keep renewing through Gumroad at your current price. Manage or cancel them from your Gumroad receipt email or gumroad.com.

Loading Media

• Drag a file onto the app to load it, or click Load File or Use Webcam. Supported input file types are: MP4, MOV, WEBM, MKV, M4V, GIF, PNG, JPG, WEBP, AVIF and BMP.
• Click a preset in the Presets tab at right to apply a ready-made look.
• Click the Mosh button to randomize effects, or use the Effects tab at right to toggle effects and change their settings. Use Cmd-Z to undo a Mosh.
• Click the Export button to save your media. On the web app, exports go to your Downloads folder. In Chrome and Edge you can pick a folder in Settings -> General -> Export To.

Top and Bottom Bars

• The top bar has the main menu (File, View, Effects, Presets, Help), the image / video toggle that picks what you export, the Settings button and the account button. Free accounts also see an Upgrade button.

• The bottom bar has the play / pause button, the mute button (when there is audio), the playback time, and the Mosh and Export buttons. The playback bar above it seeks through the video.
• Tap the space bar to toggle playback.

Webcam and Mic Recording

• Use File -> Use Webcam to use your webcam as the source. The Source row shows Webcam.
• Click Record to record a take, and Stop to end it. The take becomes the source, so you can Mosh it, record again, or export it.
• To record audio from a mic, set Settings -> Audio -> Audio Input to MIC. A mic take becomes the audio for the export.
• Only the latest take of each kind is kept.

Projects PRO

Projects save your work, with its media, effects and settings, so you can come back to it later.

• File -> New Project starts a new project.
• File -> Save Project and Save Project As… save the current project.
• File -> Open Project… opens the Projects window, where you can search, open, rename, export or delete projects (on desktop, remove them from the list). Use Cmd-Y to show or hide it.
• On the web app, projects are kept in your browser. Use File -> Import Project… and Export Project… to move a project file to and from your computer or the desktop app.
• If a project’s media file has moved, Mosh-Pro looks for it by name. If it can’t be found, use Locate Folder… to search a folder for it (desktop app, Chrome and Edge).

Settings

Click the Settings button at top right, or press Cmd-, to open the settings window. It has Export, General and Audio tabs. The Audio tab shows when exporting video, except GIF.

Export Settings

• Format - video file format (MP4 / WEBM / GIF) or image file format (PNG / JPG). We recommend MP4 for large or long videos, or WEBM if transparency is required. GIF is good for short, small loops.
• Size - pixel size. Pixel size is the main factor for export render time. Check Maintain Aspect Ratio to keep the source’s aspect ratio, or Match Source to take the size from the loaded media. Free exports are capped at 1024 px (512 px for GIF, 1280 px for images) and carry a watermark; larger is PRO.
• Duration - export length in seconds. If export duration is longer than the source, video is looped. Over 10 seconds (5 for GIF) is PRO.
• Frame Rate - frames per second. Higher values are smoother but give larger files.
• Quality - we recommend the default (High) for the best quality and file size. MP4 and WEBM only.

When you load media with a different size, Mosh-Pro asks whether to change the export settings to match.

General Settings

• Export To - folder to save exports to. On the web app, exports go to Downloads; in Chrome and Edge you can pick a folder.
• Web Cam - select the webcam used by File -> Use Webcam. Check Flip Horizontally to mirror the webcam image.
• Back Color - the background color, used where media or effects are transparent.
• Back Opacity - set to 0 to export media with a transparent background. MP4 and JPG are always opaque.
• BPM PRO - check to sync modulator loop times to a BPM (see Modulators). Type in the BPM value, or use BPM Tap to tap it in.
• Fonts PRO - click Add Fonts… to add TTF or OTF fonts for the Caption effect, or Link System Fonts… to use fonts installed on your computer (desktop app, Chrome and Edge).
• Preview - on the desktop app, check Always On Top to keep the Pop Out Preview above other windows.
• Live Output - on the desktop app, check Send to Spout or Send to Syphon for live video output. See Spout / Syphon Output.

Audio Settings

• Export Audio - whether to export audio. MP4 and WEBM only.
• Gain - use the Gain slider and the volume meter to set how input volume drives the audio modulators (see Audio Modulators).
• Smoothing - higher smoothing gives slower changes. Lower smoothing gives faster, jumpier animation.
• Reduce Noise - reduces noise in quiet signals while keeping the dynamics of louder ones.
• Audio Input - the audio used for export and for the audio modulators:
  • SOURCE - the source video’s own sound. Shown for video with an audio track.
  • FILE - an audio file (MP3, WAV, M4A, OGG or FLAC). Use Audio Start with the export duration to make an audio loop.
  • MIC - a microphone. A Record button appears next to Export, and records live audio until you press Stop.
  • NONE - shown in place of SOURCE when the source has no sound.

Effects

The Effects tab is where you add and dial in effects. Effects are applied from top to bottom. Drag effects to change the order. For every effect and its controls, see the Effects Guide.

• The first row is the Source: your loaded media. It is always on and can’t be moved or deleted.
• Each effect has, left to right:
  • The arrow, to open the effect’s settings.
  • The effect’s name, and an icon for content, generator, mask and group effects.
  • The toggle, to turn the effect on and off.
  • Lock. Locked effects are not changed by the Mosh button.
  • The ⋮ menu, to Rename, Duplicate or Delete the effect.
• Use Effects in the main menu to Disable All Effects, Remove All Effects, Load Default Effects or Randomize Order.
• Use View -> Effects (Cmd-B) to show the Effects tab.
• Right-click a slider to reset it to its default value. Drag a number up or down to change it, holding Shift for fine changes.
• Click the modulator button beside a slider to animate it. See Modulators.
• Click the keyframe button beside a slider to add keyframes. See Keyframes. A slider can use a modulator and keyframes at the same time.

Add Effects

Use the buttons at the top of the Effects tab to add effects: Add (every type), Add Effect, Add Content, Add Generator, Add Mask and Add Group. Click a name to add it, or type to search. You can add the same effect more than once.

Effects and features with a PRO pill can be used and previewed on a free account. Free exports leave them out: Pro effects are switched off, and audio modulators, keyframes and BPM timing are ignored.

Source

The Source row holds your loaded media. Open it to see:

• File - the loaded file. Click Load… to replace it, or drop a new file on the app. Click the info button for the file’s details.
• Trim - check to trim a video, and set its In and Out times.
• Speed - playback speed for video. Speed changes the sound’s pitch too, like tape.
• Stretch To Fit - fill the frame, ignoring the file’s proportions.
• Repeat - tile the media across the frame.
• Transform - position, scale and rotation.

Content Effects

Content effects bring their own picture into the stack, rather than changing the image. They are composited over the effects above with their own Blend Mode and Opacity, and are only affected by the effects below them. To add effects to a content effect without changing the effects above, put both in a group with Isolate checked.

• Media PRO - load an extra image or video. It has the same controls as the Source, plus Blend Mode and Opacity. Videos follow the main timeline.
• Caption PRO - text over the image, with font, size, alignment, color and outline options. Add fonts in Settings -> General -> Fonts.
• Audio Visualizer PRO - a bar graph of the current audio input (see Audio Settings).

Generators PRO

Generators draw patterns from scratch: Color Gradient, Noise, God Rays, Falling Lines, Plasma, Ripples, Stars, Stripes, Grid and Dots. They sit under your effects, so the effects work on them too. Use Opacity, Blend Mode, Position, Scale and Rotation to mix them with your media, or the Mask blend mode to use a generator as a mask.

Check the Effects Guide for details.

Mask Effects PRO

Mask effects show or hide the effect directly above them in selected areas of the image. Masks work by brightness: white shows the effect, black hides it.

• To mask several effects, put them in a group and add the mask directly below the group.
• Duplicate a mask effect to duplicate its mask.
• Check Show Mask to see the current mask. On Mask, Mask Draw and Remove Background, check Invert to flip it.

The mask effects are:

• Mask - use an image file as a mask.
• Mask Blocks - an animated mask of random pixel blocks.
• Mask Draw - draw the mask with the mouse in the preview. Drawing slower gives a smaller brush. Check Erase to erase, and click Clear to clear the mask.
• ChromaKey - makes a selected color transparent, for example to remove a green-screen background.
• Remove Background - masks people out of the image, removing the background behind them. It only finds people, not animals or objects.

Groups

Groups let you organize effects, apply effects to part of the stack without changing the effects above, and mask several effects with one mask.

• Click Add Group at the top of the Effects tab to add a group.
• Drag effects in and out of a group. Groups can be opened, closed and dragged like other effects.
• To mask a whole group, add a mask effect directly below it.

The Isolate checkbox controls what the effects inside the group start from:

• Unchecked (default) - the group’s effects apply to the effects above, like regular effects.
• Checked - the group starts from a blank transparent image, so its effects only change what’s in the group. Use this to add effects to a content effect without changing the effects above.

Blend Mode controls how the group’s result is combined with the effects above. Use Opacity to mix between the group’s result and the image.

• Normal - the group’s result is drawn over the effects above.
• Additive, Multiply, Screen, Softlight, Difference - standard blend modes.
• Behind - the effects above stay on top, and the group only shows where they are transparent.
• Mask - the group’s result is used as a mask for the effect directly above it, like a Mask effect. This lets you build a mask from several effects.

Modulators

Modulators change effect settings over time, to bring more variety into your video loops. Modulators work in video export mode. Click the modulator button beside a slider to turn its modulator on.

• Type:
  • Linear - changes steadily over the loop.
  • Sine - a smooth wave. Good for looping back to the starting value.
  • Bounce - quick rise, slow fall. Good for bouncing effects.
  • Step - jumps between Min and Max.
  • Noise - a smooth random value that loops.
  • Rand - jumpier random values.
  • Const - stays at Max. Useful with Chance.
  • Audio PRO - needs an audio input. See Audio Modulators.
  • MIDI PRO - see MIDI Modulators.
• Speed - how fast the value changes within the loop.
• Loop - check to make effects loop seamlessly. Uncheck to change slowly over the whole export (see Modulator Speed).
• Min / Max - the range of values.
• Chance - how often the modulator is on. Below 100% it drops out at random. Good for switching effects on and off at random.
• Right-click the modulator button to copy and paste modulator settings between sliders.

Modulator Speed

Modulators use one of 3 time scales:

• With Loop checked, modulators loop seamlessly within the loop time, about 4 seconds, based on the export duration.
• With Loop unchecked, modulators loop over the whole export duration. This allows slower speeds.
• With BPM checked in Settings -> General, the loop time follows the BPM.

Audio Modulators PRO

Audio modulators use the volume of the audio input to drive effect settings, for audio reactive videos.

• Use Freq to pick a frequency range: all, low (kick drum), mid (melody) or hi (hi-hats).
• The frequency display shows which part of the audio drives the modulator.
• Select cust to draw a rectangle on the display around the part of the audio you want to use.
• Use Settings -> Audio -> Gain and Smoothing to set the input volume and smoothing for all audio modulators.

MIDI Modulators PRO

MIDI modulators let you control effect settings from a MIDI controller or a DAW.

• Click Learn, then move a knob or press a key on your controller. The CC and Device boxes show what’s connected. Click Forget to disconnect it.
• Knobs and sliders map to the setting’s range. Keyboard notes use the note’s velocity.
• MIDI works in the desktop app, and in Chrome and Firefox on the web app. Your browser asks for MIDI access the first time.
• MIDI modulators work live and are not recorded into exports. To record or stream live moshing we recommend OBS.
• To send MIDI from a DAW on the same computer, you may need to route its MIDI out back into the computer. On Mac, use Audio MIDI Setup.
• To test whether Mosh-Pro can see your MIDI device, use this MIDI Test page.

Keyframes PRO

Keyframes let you set exact values at exact times, for precise animation. Click the keyframe button beside a slider to add keyframes to it. The Keyframes panel opens under the preview, listing every parameter with keyframes. Use View -> Keyframes (Cmd-K) to show or hide it.

• Click to add a keyframe. Drag a keyframe to move it.
• Right-click a keyframe to delete it.
• Right-click the graph to Copy All, Paste All or Delete All keyframes.
• Use the - and + buttons to change the grid size.
• Use the scrub bar to seek the preview. The dotted line shows the playback time.
• Drag the top edge of the panel to change its height.
• A parameter can have a modulator and keyframes at the same time. The modulator moves the value, and the keyframes scale how far it moves.

Presets

Presets save and load combinations of effects. Mosh comes with a set of Featured presets.

• The Presets tab at right shows your presets as thumbnails. Click one to apply it. Search by name, or switch between grid and list view. Use the ⋮ menu on one of your own presets to Rename, Export or Delete it. Check View -> Preset Browser to show it as a column at left instead.
• Applying presets is free. Saving and changing presets is PRO.

The Folder and Preset rows at the top of the sidebar pick the preset folder and preset, and have these buttons:

• Add Folder - create a new preset folder.
• Update - save the current effects to the selected preset.
• Revert - go back to the preset’s last saved settings.
• Delete - delete the selected preset.
• Add - save the current effects as a new preset.

More preset commands:

• Presets -> Next Preset and Previous Preset (Cmd-Right / Cmd-Left) step through presets. Random Preset (Cmd-Up) picks one at random.
• Presets -> Import Presets… and Export Preset… move preset files in and out. You can also drop a .pmpreset file on the app.
• On the desktop app, Presets -> Open Presets Folder opens the presets folder in Finder or Explorer.
• Saving a preset also saves a thumbnail of the current look.
• Only enabled and locked effects are saved to a preset.

Batch Export PRO

Batch export applies the current effects to many images or videos at once.

• Use File -> Batch Export… and pick the files to export.
• Check Use current export settings to export every file at the current size, frame rate, length and format. Uncheck it to export each file at its own size, frame rate, length and format.
• On the web app, with no export folder picked, each file is a download. Your browser asks once to allow multiple downloads.

Pop Out Preview PRO

Pop Out Preview moves the output to its own window. Use it to show the output on a second screen or projector, or to record it with OBS.

• Use View -> Pop Out Preview (Cmd-P). The window matches the export size, and can be resized or made full screen.
• On the desktop app, check Settings -> General -> Preview -> Always On Top to keep it above other windows.

Spout / Syphon Output DESKTOP APP

The desktop app can send live video with zero latency through Spout (Windows) or Syphon (macOS). Use Mosh-Pro as a live source in Resolume, VDMX, MadMapper, TouchDesigner and OBS (with its Spout or Syphon plugin). The web app can’t send Spout or Syphon; use OBS window capture instead.

Spout (Windows)

• Check Settings -> General -> Live Output -> Send to Spout.
• The output matches the current export size and frame rate.
• Receiving apps see Mosh-Pro as a Spout source.
• Export width is rounded down to a multiple of 32 px.

Syphon (macOS)

• Check Settings -> General -> Live Output -> Send to Syphon.
• The output matches the current export size and frame rate.
• Receiving apps see Mosh-Pro as a Syphon server.
• Start the Syphon client before Mosh-Pro.

Keyboard Shortcuts

Shortcuts are the same on the web app and the desktop app, and are shown in the main menu. On Mac use the Cmd key, on Windows use Ctrl.

• Cmd-O - Load Media
• Cmd-I - Use Webcam
• Cmd-S - Export
• Cmd-G - Mosh Effects
• Cmd-Z - Undo Mosh
• Cmd-D - Disable All Effects
• Cmd-J - Randomize Order
• Cmd-Right - Next Preset
• Cmd-Left - Previous Preset
• Cmd-Up - Random Preset
• Cmd-U - Update Preset
• Cmd-K - Show Keyframes
• Cmd-B - Show Effects
• Cmd-Y - Open Projects
• Cmd-P - Pop Out Preview
• Cmd-, - Settings
• Spacebar - Play / pause

Right-Click Features

• Right-click a slider to reset it to its default value.
• Right-click a modulator or keyframe button to copy and paste its settings.
• Right-click the keyframe graph to Copy All, Paste All or Delete All keyframes.
• Right-click a keyframe to delete it.