Moving from Adobe Animate
Verification record: Umoupen 0.9.62 build 666 (2026-10-22) · Verification scope
This article lists what the features you used in Adobe Animate (formerly Adobe Flash) are called in Umoupen and which article covers each one. Symbols and tweens work differently in places, so those differences come first.
Location: Help → Edit Keybinds → Presets → Flash / Animate / File → Open (FLA, XFL)
First things to set up
Section titled “First things to set up”- Choose Help → Edit Keybinds to open the Help panel, then select Presets → Flash / Animate. F5 is assigned to Lengthen Frame, F6 to Duplicate Frame, F7 to New Blank Frame, and F8 to Convert Selection to Symbol. Check the full list under Shortcuts in the same panel.
- Open your FLA and XFL files with File → Open. Opening one is a conversion, so compare the timeline, symbols, and tweens with the original file afterwards. If an old binary FLA will not open, save it as XFL in Adobe Animate first.
Pressing F6 inside an exposure splits it at the current frame into a separate drawing with the same artwork. F7 starts a blank drawing at that frame. To convert only the selected strokes with F8, use Contents in the Move tool and select the whole strokes.
Shortcuts and keybind presets covers switching presets, and Import PSD, CLIP, FLA, or XFL covers what is imported.
Name mapping
Section titled “Name mapping”| Adobe Animate | Umoupen | Article |
|---|---|---|
| Library | Gallery | Use the Gallery |
| Symbol, instance | Symbol, symbol instance | Create and reuse symbols |
| Convert to Symbol | Convert Selection to Symbol / Convert Layer to Symbol | Create and reuse symbols |
| Edit in Place | Edit in Place | Symbol instances and Edit in Place |
| Graphic Loop, Play Once, Single Frame, first frame | Loop, Once, Bounce, Stop, Start Frame | Symbol instances and Edit in Place |
| Break Apart | Break Apart | Create and reuse symbols |
| Duplicate Symbol | Duplicate in the Gallery (existing placements keep their reference) | Create and reuse symbols |
| Keyframe, Insert Frame | Drawing, Cel, exposure, Lengthen Frame | Frames, drawings, cels, and exposures, Change exposure length and position |
| Motion tween, classic tween | Tween | Animate symbols, text, and layers with Tween |
| Motion Editor | Tween Editor | Curve Editor |
| Layer parenting | Transform Parent | Transform parent |
| Layer folder | Folder | Folders and parenting |
| Mask layer | Clip to Layer Below | Masks and clipping masks |
| Camera tool | Camera layer | Camera Layer |
| Onion skin | Onion Skin | Onion Skin |
| Object drawing mode | Object Drawing (vector layers) | — |
Animate in the Move tool options is a switch that records whole-layer motion. It has nothing to do with Adobe Animate.
How symbols differ
Section titled “How symbols differ”One symbol type
Section titled “One symbol type”Adobe Animate has graphic, movie clip, and button symbols. Umoupen has one symbol type. Playback is chosen per placed instance, not by symbol type.
| Adobe Animate graphic | Umoupen instance |
|---|---|
| Loop | Loop |
| Play Once | Once |
| Single Frame | Choose Stop and set the frame to show with Start Frame |
| (none) | Bounce: plays forward and backward in turn |
| First | Start Frame |
The playback settings appear in the Move options when you select a symbol instance whose contents are two or more frames long.
One symbol can hold several animations
Section titled “One symbol can hold several animations”Add Animation creates another animation, such as a walk and a run, inside one symbol. Each instance picks which one plays in its Animation field. If you kept one symbol per motion in Adobe Animate, you can combine them into one symbol.
Symbols go on vector layers only
Section titled “Symbols go on vector layers only”Place symbol instances on vector layers. Dragging from the Gallery while a raster layer is active shows “Symbols can only be added to vector layers”. One layer can hold several instances.
Where Convert Layer to Symbol puts the result
Section titled “Where Convert Layer to Symbol puts the result”Convert Layer to Symbol replaces the layer’s contents with an instance on the same layer. This also applies to raster layers: the destination becomes a vector layer, and the raster artwork remains inside the symbol. Up to build 652 it kept the original layer and added a new layer with the instance above it. If the same picture appears twice in an older build, check the layers above and below.
How tweens differ
Section titled “How tweens differ”In Adobe Animate, a motion tween moves an object placed in a tween span on the timeline. In Umoupen, tween keys sit inside one drawing’s exposure (cel).
- Extend the exposure that holds the symbol instance to two or more frames.
- Turn Tween on.
- Move to a later frame inside the exposure, press Add Tween Keyframe, then move the instance.
They cannot go on the first frame of the exposure or outside it. Instances on the same layer each move independently.
| To do this | Use in Umoupen |
|---|---|
| Move a symbol or text | Tween (inside the exposure) |
| Shape the speed over the whole exposure with one curve | Global in the Tween Editor |
| Move a whole layer | Set the Move tool to Layer and turn Animate on. Values go into Layer Transform |
| Make a layer follow another layer’s motion | Transform Parent |
Layer Transform animation runs over the layer’s whole time, regardless of exposure boundaries. Animate symbols, text, and layers with Tween and Curve Editor describe the steps in detail.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Check first |
|---|---|
| A symbol cannot be placed on the stage | Make the destination vector layer active. |
| A tween key cannot be added | Check that the exposure is two or more frames long and that the current frame is not its first frame. |
⌘T does not add a tween | ⌘T only shows or hides the Tween Editor. Turning Tween on or off is a separate operation. |
| You want to change the contents of one placement only | For a placement containing vector strokes, use Break Apart to edit the strokes directly. Break Apart alone may revert after a normal save and reload, so reopen the saved file to check the result. |
| F5–F8 do not behave as in Adobe Animate | Check that the selected preset is Flash / Animate. |
| An old FLA will not open | Save it as XFL in Adobe Animate, then open it. |
Related articles
Section titled “Related articles”Verification
Section titled “Verification”- Hands-on verified: After Break Apart alone, both Command-S and File → Save were used, then the file was closed and reopened. The original Symbol 23 returned. Two strokes could be selected immediately after Break Apart, but the tab showed no modification indicator. In this example, a normal save did not retain Break Apart alone.
- Hands-on verified: F5–F8 were actually entered with the Flash / Animate preset. F5 extended the exposure from four to five frames. F6 split it into a separate drawing with the same artwork from frame 2. F7 started a blank drawing at frame 3. With whole strokes selected in the Move tool’s Contents mode, F8 converted those strokes to Symbol 1 and placed an instance at the same frame. Reopening the final save retained the symbol at frame 1, the dot at frame 2, and the blank drawing at frame 3.
- Verified from the current implementation: The log recorded clean save noop dirtyCount=0 for the save attempts after Break Apart alone; the saved file was byte-identical to the input. The two drawings from F6 had identical vmap data, F7 created a drawing marked blank true, and frame 1 contained a symbol reference after F8. The key preset was restored to Umoupen Default.
- Unverified: The build 666 check covers only normal saving after Break Apart alone and F5–F8 under the stated conditions. The internal cause of the save result, Save As, waiting for autosave, other symbols, repeating these tests in builds 660/662, physical keyboard Fn behavior, Windows, and iPad remain unverified. An initial F8 trial with only some points selected converted the whole layer, but the internal dispatch conditions were not analyzed. The previous five-item check, including duplication, the Stop label, and raster conversion, and the rest of the article were not repeated.
- Evidence records: F-20261022-505