How to Script Brushes for Procreate
StyleFrame Team7 min read
Procreate has no scripting language for brushes. You build a script brush in Brush Studio by pairing a shape source (the stamp that defines the nib) with a grain source (the texture), then tuning stroke, pressure, and stabilization settings. For calligraphy-style brushes, draw a nib shape in white on a black square, import it as the Shape Source, adjust spacing, and map Apple Pencil pressure to size.
What "Scripting" a Brush Means in Procreate
If you come from After Effects expressions or Blender Python, the word "script" suggests code. Procreate's brush engine is parameter-based instead. Every brush comes from two ingredients:
- Shape: the stamp that is repeated along your stroke. It determines the nib's silhouette.
- Grain: the texture seen inside that stroke. For clean lettering, leave it as plain white so it adds nothing.
Everything else is a setting that changes how those two ingredients respond to your hand: spacing, pressure curves, stabilization, rendering mode, and size limits. "Script brush" can also mean a brush for brush-script lettering, the flowing, pen-like calligraphy style. Both readings lead to the same workflow, so this guide covers the build process and then how to tune it for script styles.
Before You Open Brush Studio: Prepare the Shape
Most brush problems start with the source image, not the settings.
- Use a square canvas. Brush shapes are square, so designing in a square avoids distortion.
- Work white on black. The brush engine reads white as opaque and black as transparent. A black background with a white shape gives you a stamp that paints.
- Watch your file format. A PNG with a transparent background and a black design imports as an empty square, because black reads as transparent. Save as a JPG with a solid background, or draw the design in white.
- Invert if needed. If the result is a negative of what you wanted, tap the source preview with two fingers to invert it.
For a brush-pen feel, think about the mark a real brush pen leaves when you press it flat on paper. It is closer to a teardrop than a circle. You can sketch that teardrop with a basic technical pen on the black square, then use it as your shape. Pointed-pen scripts like copperplate tend to work well with an oval shape source. Ink-like lettering brushes often use a round shape with a bit of grain. Broad-edge scripts such as blackletter need a flat-edged shape, which is why one "calligraphy brush" never covers every style.
Build the Brush Step by Step
1. Create a new brush
Open the brush panel, create a brush set to keep your experiments organized, and tap the plus icon inside it to open Brush Studio. Alternatively, duplicate a stock brush and modify the copy. Duplicating is a safer starting point because the original stays intact.
2. Import the shape source
In the Shape section, choose Edit, then Import, and bring in your JPG from Photos or the clipboard. Pasting from the clipboard is a useful fallback when a file import behaves oddly.
3. Set the grain
For lettering, pick a plain white grain source so nothing interferes with the stroke edge. If you want a textured ink look, use your own scanned texture. Crop it to a 1:1 ratio and turn on auto-repeat so tile edges do not show while you paint.
4. Adjust the stroke path
A stamp brush needs spacing set correctly. At low spacing, the stamps overlap into a continuous line. At high spacing, you see individual dots. For script, keep spacing low so the line reads as one smooth stroke. Also check the General settings: if your shape is directional, turn on the option that orients it to the iPad screen so the nib keeps a fixed angle instead of rotating with your stroke. That is essential for broad-edge styles.
5. Map Apple Pencil pressure
Script lettering depends on thick downstrokes and thin upstrokes, so pressure should drive size:
- Set pressure to control size at its maximum.
- Open the pressure curve and drag the control point so zero pressure produces the thinnest stroke. This gives you real size dynamics as you press harder.
- Set pressure to control opacity to none if you want solid ink rather than see-through light strokes.
- In the properties, raise the maximum size if the brush feels too small at full pressure. One tutorial pushes it to 150%.
6. Add stabilization and streamline
Streamline smooths wobbly lines and is a popular setting among calligraphers. More is not always better. One calligrapher keeps it around 88% with pressure at 100%, because pushing it to the maximum reduces control over the letterform. Treat that as a starting point rather than a rule, since the ideal values depend on your grip and pressure habits. Lettering brushes are often tuned around their maker's habits, so expect to adjust any brush you download.
7. Test and save
Open a new canvas and write a few strokes: a baseline row of loops, a few capitals, and some fast and slow connecting strokes. Tap Done, name the brush, and it saves into your set. You can reopen it later to refine it.
Match Settings to Script Style
Building three separate brushes beats forcing one to do everything. A brush tuned for expressive modern script will fight you on rigid blackletter angles.
Advanced: Combining Two Brushes
Procreate can combine two brushes into a dual brush, which is how you get effects like a stippled script stroke. The workflow from one tutorial runs like this:
- Build the first brush with stabilization, a light glaze rendering mode, and burnt edges at maximum. Set pressure to size and tune the curve.
- Duplicate it, then swap in a soft shape source and a textured grain source, and change the rendering mode to heavy glaze.
- Select the first brush, swipe right on the second, and choose Combine.
- Open the combined brush, select the top brush, and set the combine mode to Difference.
This approach gives you texture variation that a single stamp would not.
Troubleshooting Common Problems
- The shape or grain looks blank. Usually a black design on a transparent PNG. Convert to a JPG on white or redraw in white.
- The brush paints a negative. Invert the source with a two-finger tap.
- Strokes look dotted. Reduce spacing.
- The nib rotates unpredictably. Enable orientation to the iPad screen for fixed-angle nibs.
- A downloaded brush feels wrong. Duplicate it and adjust pressure and streamline on the copy.
- Installing a pack is slow. Procreate lacks a native multi-brush import, so brush bundles often need a workaround.
For deeper parameter reference, Procreate's own Artists' Handbook and the Brush Studio documentation explain each panel.
Where Script Brushes Fit in a Motion Pipeline
Hand-drawn lettering is a common ingredient in motion work: title cards, animated signatures, handwritten lower thirds, and styleframes for pitches. Procreate is a convenient place to draw that lettering, but the result is a static image. Getting it moving usually means tracing strokes in After Effects, building a reveal with masks or trim paths, or redrawing frame by frame.
AI video and motion tools such as Styleframe can also sit beside your existing tools. Check the tool's current feature set and export options before building a pipeline around it. As with any generative step, judge the output against your drawn references and iterate until it matches your intent.
Quick Checklist
- Draw the nib shape in white on a black square, and save it as a JPG.
- Import it as the Shape Source, and invert if needed.
- Use a plain white grain unless you want texture.
- Lower spacing, and fix orientation for broad-edge nibs.
- Map pressure to size and shape the curve so light pressure gives thin lines.
- Add moderate streamline, and avoid pushing it to the maximum.
- Duplicate before experimenting, and test with real lettering.
- Build separate brushes for separate script styles.
Once the process is familiar, a new custom brush takes minutes, and the quickest way to improve is to duplicate, tweak one setting at a time, and write the same test word each round so you can see exactly what changed.