Import a GIF as an image sequence in Toon Boom Harmony

Toon Boom Harmony does not accept GIF files directly. Instead, you convert the GIF into a sequence of individual frames, then import those frames as layers. The fastest way is to use an image converter tool — either online or desktop software — to split your GIF into numbered PNG or JPEG files. Once you have the sequence, Toon Boom imports all frames at once and stacks them as separate layers in your timeline.

The process takes about five minutes for a typical GIF. You need the original GIF file, a converter tool, and access to your Toon Boom project folder. The result is a layered composition where each frame sits on its own layer, ready to animate or edit.

Key Takeaways

  • GIF files must be converted to an image sequence (PNG or JPEG frames) before Toon Boom can read them.
  • Free online converters like ezgif.com or CloudConvert can split a GIF into numbered frames in seconds.
  • After conversion, use File > Import > Image Sequence in Toon Boom to bring all frames in at once.
  • Each frame becomes a separate layer in your timeline, preserving the original animation timing.

Convert your GIF to a frame sequence using an online tool

The easiest route for most users is an online GIF splitter. Open ezgif.com in your browser, click the "Split" tab, and upload your GIF file. The tool displays every frame and lets you download them all as a ZIP file containing numbered images (frame_001.png, frame_002.png, and so on). The whole process takes under a minute and requires no software installation.

CloudConvert and Online-Convert.com offer the same service if ezgif is slow or unavailable. All three are free and produce the same result: a folder of numbered frames ready for Toon Boom. Save the ZIP file to your computer and extract it to a folder you can find easily — your Desktop or Documents folder works fine.

Use desktop software if you need more control over frame quality

If you want to adjust the image quality, resize frames, or remove certain frames before importing, use desktop software instead. GIMP (free, open-source) opens GIF files and exports each layer as a separate image. FFmpeg (command-line tool, free) converts GIFs to frame sequences with precise control over resolution and format. ImageMagick (command-line, free) does the same and runs on Windows, Mac, and Linux.

These tools take longer to learn than online converters but give you frame-by-frame control. For a simple GIF with no edits needed, the online route is faster. For a GIF where you need to remove frames, adjust colors, or change resolution, desktop software is worth the extra steps.

Import the frame sequence into Toon Boom Harmony

Open your Toon Boom project and go to File > Import > Image Sequence. A dialog box opens asking you to select the first frame in your sequence. Navigate to the folder where you extracted your frames, click on frame_001.png (or whatever your first frame is named), and click Open. Toon Boom automatically detects that this is a sequence and imports all numbered frames in order.

A second dialog appears asking where to place the frames. Choose "New Layer" if you want each frame on its own layer (the standard choice for animation). Choose "Composite" if you want all frames stacked on a single layer. For most workflows, "New Layer" is correct. Click OK and Toon Boom imports the entire sequence into your timeline, with each frame occupying one frame cell.

Adjust timing and playback speed after import

Once imported, each frame sits on its own layer in the order it was created. If your original GIF played at 10 frames per second but you need 24 frames per second for your project, you can hold each frame for multiple cells. Right-click the layer, select "Duplicate Frames," and choose how many times to repeat each frame. This stretches the animation to fit your project's frame rate without distorting the images.

If some frames need to hold longer than others, you can manually extend individual frames by dragging the layer's end point in the timeline. This gives you frame-by-frame control over timing that the original GIF may not have had.

Troubleshoot common import problems

If Toon Boom does not recognize your sequence, check that the filenames are numbered consistently (frame_001, frame_002, not frame_1, frame_2). Toon Boom looks for sequential numbering with leading zeros. If your converter produced files named differently, rename them in your file explorer to match the pattern. You can also re-run the online converter and download the frames again — most tools default to the correct naming scheme.

If the frames import in the wrong order, the numbering in your filenames is the issue. Check that frame_001 is actually the first frame of your animation. If the converter numbered them backward, rename the sequence or re-convert with a different tool. If the import dialog hangs or crashes, your GIF may be very large or have hundreds of frames. Try splitting the GIF into smaller chunks (first 50 frames, next 50 frames) and importing them separately, then arranging them in the timeline.

Frequently Asked Questions

Can I import an animated GIF directly without converting it first?

No. Toon Boom Harmony and Toon Boom Animate do not read GIF files natively. You must convert the GIF to an image sequence first. This is a limitation of how Toon Boom handles file formats — it works with individual image files and sequences, not container formats like GIF.

What image format works best for the frame sequence?

PNG and JPEG both work. PNG preserves transparency and quality without compression loss, making it the better choice if your GIF has a transparent background. JPEG compresses the file size but loses some detail. For most animation work, PNG is the safer option.

Will the frame timing from my original GIF carry over?

No. Toon Boom imports all frames at the default rate (usually one frame per cell). If your GIF had variable timing — some frames held longer than others — you lose that information during conversion. You can recreate the timing manually by duplicating frames or extending them in the timeline after import.

Can I import a GIF that has text or effects on it?

Yes. The converter treats the GIF as a visual file and splits whatever is on screen into individual frames. Text, effects, and colors all come through. You can then edit individual frames in Toon Boom if you need to remove or change anything.

What if my GIF is very large or has hundreds of frames?

Large GIFs can slow down the import process or cause the converter to time out. If this happens, split the GIF into smaller sections using your converter tool's frame range option, convert each section separately, and import them one at a time into Toon Boom. Arrange them in the timeline in the correct order.