Skip to content

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English | Русский

Text IMP v2.3.1

Text IMP is a text navigator and editor for Adobe After Effects.

It scans text layers in a project, helps you quickly find the right layer, jump to it in After Effects, edit its Source Text, and apply optional smart typography rules.

The original Text IMP workflow was JSON-oriented. Starting with v2.0, the main workflow was redesigned around direct work with text layers, while JSON tools remain available for legacy compatibility.

image

Features

  • Search text layers across the entire project or only the active composition.
  • Search by composition name, layer name, or text content.
  • Case-insensitive search.
  • Treats ё and е as equivalent in Russian search.
  • Fuzzy search tolerant of small typos.
  • Automatic EN/RU keyboard-layout fallback when normal search returns no results.
  • Flat list or grouped-by-composition view.
  • Expand / collapse composition groups.
  • Directly reveal the selected layer in After Effects.
  • Edit Source Text from the script interface.
  • Ctrl/Cmd + Enter to save.
  • English and Russian UI localization.
  • Persistent user settings between launches.
  • Optional Russian typography processing using native After Effects No Break.
  • Optional layout-specific custom rules.
  • Legacy JSON import/export kept outside the main workflow.

Search

Search works across composition names, layer names, and text content.

Case and Russian normalization

These are treated the same:

ТРЕНИРОВКА
Тренировка
тренировка

For Russian search, ё and е are also treated as equivalent.

Fuzzy search

Small spelling mistakes are tolerated, for example:

тренровка
тренирвока
тренироовка

can still match:

тренировка

Short queries stay stricter to reduce noisy results.

Wrong keyboard layout

If normal and fuzzy search return no matches, Text IMP automatically retries the query using the alternate EN/RU keyboard layout.

Examples:

ghbdtn       -> привет
nhtybhjdrf   -> тренировка
руддщ        -> hello

The text typed in the search field is not modified.

Views

Flat list

Default view.

Composition > Layer name — Layer text

This is especially useful for projects with many compositions containing only one or a few text layers.

By composition

▼ Composition 01
    headline — Title
    subtitle — Subtitle

▼ Composition 02
    price — 5 000 ₽

Use Expand all and Collapse all to control the grouped view.

The selected view is remembered between launches.

Localization

The interface supports:

lang [English]
lang [Русский]

The selected language is remembered.

If a translation is missing, English is used as the fallback language.

Editing text

Select a text layer in the list to load its Source Text into the editor.

You can then:

  • edit the text;
  • reveal the layer in After Effects;
  • save changes;
  • use Ctrl/Cmd + Enter for quick save.

After saving, Text IMP updates the selected entry without rebuilding the entire list, so selection, group state, and scroll position are preserved as much as ScriptUI allows.

Safety restrictions

Text IMP blocks editing if Source Text:

  • is controlled by an expression;
  • contains keyframes.

These layers can still be found and inspected.

Advanced Russian text processing

Enable:

Advanced Russian text processing

In Russian localization this option is enabled by default on first use.

All related checkbox states are remembered between launches.

Smart wraps

Smart Wraps use native After Effects No Break character ranges instead of replacing visible spaces with Unicode non-breaking spaces.

They protect common constructions such as:

  • short Russian prepositions, conjunctions, and particles;
  • № 12, § 5;
  • 20 %, 10 кг, 250 мл, 36,6 °C;
  • grouped numbers such as 1 000 000;
  • currencies such as 1 000 ₽, $ 100, EUR 100;
  • dates such as 1 августа 2026 года;
  • initials and surnames such as И. И. Иванов;
  • abbreviations such as и т. д., т. е., в т. ч.;
  • references such as стр. 5, рис. 2, табл. 3;
  • phone numbers;
  • list labels;
  • punctuation dashes.

Visible text and spacing are not rewritten.

After Effects requirement for Smart Wraps

The current implementation uses TextDocument.characterRange() and CharacterRange.noBreak.

For reliable advanced text processing, After Effects 24.3 or newer is recommended.

The core navigator/editor can still be used without these advanced typography features.

Optional custom layout rules

These rules are intentionally separated from the core Russian typography engine and are disabled by default.

Keep + with next token

Example:

Side bends + kettlebell

The script protects:

+ kettlebell

so a line break may happen before +, but not between + and the next token.

Keep compact UI values together

Designed for short UI / fitness labels such as:

RPM 100+ ↓
Gear 9-12

Protected fragments:

100+ ↓
9-12

Removing custom rules

The optional rules are isolated in the source code between:

// ---------------- OPTIONAL CUSTOM RULES START ----------------

// optional rules

// ----------------- OPTIONAL CUSTOM RULES END -----------------

This block can be removed entirely if these features are not needed. The core script will continue working and the related checkboxes will disappear automatically.

Persistent settings

Text IMP remembers:

  • interface language;
  • flat/grouped view;
  • expression-layer filter;
  • Advanced Russian text processing state;
  • Smart Wraps state;
  • optional custom rule states.

Legacy JSON tools

JSON is no longer part of the main workflow, but remains available through the JSON... button for compatibility.

Supported actions:

  • export project text layers to JSON;
  • import JSON and update text layers.

Example format:

[
  {
    "compName": "Composition Name",
    "layerIndex": 1,
    "layerName": "Layer Name",
    "text": "New Text Content"
  }
]

Installation

  1. Download Text_IMP_v2.3.1.jsx.
  2. Open Adobe After Effects.
  3. Go to:
File > Scripts > Run Script File...
  1. Select the .jsx file.

For regular use, the script can also be placed in the appropriate ScriptUI Panels folder and opened as a panel where supported by your After Effects setup.

Quick start

  1. Launch Text IMP.
  2. Keep All project selected or switch to the active composition.
  3. Search for a layer by name or text.
  4. Select the layer.
  5. Edit the text.
  6. Click Save or press Ctrl/Cmd + Enter.
  7. Use Show layer to reveal it in After Effects.

Known ScriptUI behavior

After Effects uses the legacy ScriptUI framework. In some AE versions, the text of an already rendered TreeView row may visually refresh only after the next interaction with the list.

The Source Text itself is already saved correctly; this is only a ScriptUI repaint limitation.

Version history

See CHANGELOG.md.

Credits

Original Text IMP author: RawFungus
GitHub: https://github.com/RawFungus

Text IMP 2.x develops the original concept into a direct text-layer navigator and editor for Adobe After Effects.

License

Keep the original project's license terms when redistributing modified versions.

The script is provided as-is. Test it on a copy of important projects before production use.

About

Text IMP is an Adobe After Effects script for searching, navigating and editing text layers. Includes fuzzy search, EN/RU localization and smart typography tools.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages