Changelog
Unreleased
Nothing yet.
0.4.0 (2026-11-19)
The editor after a full audit: it fits a small screen, says what it does and why it cannot, and keys follow what you work in. New: an Export menu by kind, a right-click menu, colour sliders, zoom keys, text you can select, a starter palette for pixel art and klad apply --steps.
Drawings are saved in format klad/8, as in 0.3.0; older drawings open unchanged.
- cmd V after clicking a frame pastes the strokes or pixels you copied last; it pastes frames only when frames were what you copied last.
- An adjustment layer's own settings come first in Layer settings, and a new adjustment layer makes room for them.
- An export into a folder that cannot be made says why in plain words ("part of that path is a file, not a folder"), without the system's error number.
- V, S and A say when the layer in hand is locked or hidden, instead of doing nothing; V no longer moves a stroke of a hidden layer unseen.
- Redo in-betweens without selected frames says to select them first.
- A paste on a frame that shows a drawing held from an earlier frame gives that frame its own copy of the drawing first, so the frames before it stay as they were; the message says so, and one cmd Z takes back both. klad copy --frame does the same.
- The timeline's bar names new clip, and its buttons no longer share one icon: duplicate to the next frame shows a stack of cards, fill like the first drawing a paint bucket, copy the selected cells the copy icon.
- File > Import picture… opens the system's file chooser, showing PNG and JPEG files.
- The pixel eraser keeps its own size, as the brush eraser does.
- While a text is open, cmd Z takes back what was typed since the last move of the caret in one step, and Edit > Undo, Select all and Copy act on the text; once there is no typing left to take back, they act on the drawing again.
- The colour picker of the bar over a selection stays open while shift is held, so a # can be typed in its hex field; a hex without its # is taken too. The bar hides while shift is held only when none of its pickers is in use, and it no longer comes back when the pointer passes over its place, so a shift click reaches the stroke under it.
- S drags a box around strokes, as its icon shows; loop in the bar over the canvas draws a loop as before. A box or loop cuts strokes at its edge is off by default for strokes, so a box takes the strokes wholly inside it, and a box that holds no whole stroke says so; on a pixel layer it stays on, so a box takes the pixels inside.
- Text typed on a pixel layer becomes pixels in the current colour, hard edged, when it is finished; the editor says so when the text starts and when it is laid down. klad pixel --text does the same from the command line (with --font, --text-size and --at).
- The colour picker of the bar over a glow or another gradient starts from the gradient's colour, and after a hex is typed and Return pressed it shows that colour, not the colour you paint with.
- A turned layer (cmd T) or turned strokes keep a turned box, so the next drag scales or turns what you see.
- The editor fits a small screen. A drawing of one frame opens with the timeline folded to its toolbar, and it opens by itself when the drawing gets a second frame; open, it is no taller than its rows. The panels on the right share the height of the window and never run past it: each scrolls inside, Layers always shows at least three rows with its buttons, and when the window is too short for all of them Brush folds first. A panel you open with its arrow or from the Window menu gets its room and the others give way, and the Window menu ticks a panel only when it shows, so one choice brings up a folded panel. At an interface size above 100% the timeline keeps its size on the screen, so the canvas keeps its room. On a 1440 by 900 window the canvas went from about a third of the window to more than half.
- In a pixel drawing the Colour panel shows the palette and its buttons first, above the colour wheel.
- Menus, windows and the tool bar fit a small screen too. On Windows and Linux a menu longer than the window scrolls, so its last items can be reached. A window is never taller than the room above the status line: its title and its close button stay in sight, the brush window's list shrinks to fit, and on a very short screen the whole window scrolls. Windows open at their full size at once, and a second window opens a little below and to the right of the first instead of over it. In the bar above the canvas a slider that does not fit moves to the next row whole, and a tool's hint stays on one line (cut off at the end, with all of it when you point at it).
- Window > Hide panels (Tab) leaves a show the panels (Tab) button in the status line, so the way back is on screen; on Windows and Linux the menu bar hides with the panels.
- The command finder's list uses the room it has: after a search with one result or none, Help > Keyboard shortcuts shows a full list again.
- The tool strip and the rows of the start window show a scroll handle when they hold more than fits.
- "making the light maps" and "preparing the planes" show in the status line while they work, not over the picture.
- The brush and the fill work on any layer: on a vector layer, a group, an adjustment or bones layer, a reference picture, or with no layer picked, they paint on a new paint layer above it, as the pen and the shape tool make a vector layer. The eraser says it works on paint and pixel layers.
- A locked or hidden layer says so when you paint, fill, select or reshape on it, in the same words as the line in the bar above the canvas. Before, the brush said to pick a paint layer, and on a hidden layer the strokes went in unseen.
- An eraser stroke over nothing is not kept: it said nothing and took a step of the history.
- The pen, the shape tool and the text tool never draw into a reference picture, which exports leave out: they make a vector layer above it. The text tool says where the text went.
- Messages say what happened in words, without the drawing's internal ids or timings: "added a paint layer", "moved the drawing to frame 12", "undid: delete a mark of the drawing at frame 0 on lines". Stopping playback says nothing unless frames were skipped. A finished job says "done" without its timing.
- Commands say why they cannot run instead of answering with an error: New drawing (K) on a frame that has one, Next drawing and Previous drawing with no other drawing, Show gaps and Refill on a mask, a pixel layer or a frame without a drawing, Clip to layer below on a mask, Fill like with no flood fills to carry, Thinner and Thicker on pixels, and redo the in-betweens with none selected.
- Make this pose a drawing on the frame that holds the drawing the bones are rigged to puts the pose on the next frame (it adds the frame if needed) instead of refusing with ids; with no layer following the bones, posing says so and where to attach one.
- Opening a damaged drawing says that its doc.json is damaged and what can still be done; opening a picture says to bring it in with File > Import picture….
- The fill's list of layers names them without ids. A mask's hint says the red marks what is hidden and how to see the layer without it. Settings that cannot be saved from the start window say so.
- In the timeline a drag over frames selects them, also when every frame has a drawing of its own (pixel art on ones) and also from the middle of a frame. To move a drawing, select its frame and drag its dot, or hold alt; the end of a drawing changes its hold only from the inside edge of its last frame. Shift and drag always selects.
- New frames in a pixel drawing are one frame long (on ones); paintings stay on twos.
- A new layer shows on every frame: its first drawing starts at frame 0, whatever frame you are on.
- Show a drawing here on a frame with an empty drawing replaces it with the link, and on a frame with a drawing of its own says so before you pick, instead of refusing with ids.
- cmd + and cmd - zoom the canvas in and out (a pixel drawing by whole pixels) and cmd 0 fits it; View > Zoom in and Zoom out are new.
- The eraser keeps its own size: E and B each come back at the size they had.
- Text typed at a large zoom stays drawn: its picture is made at a size the graphics card takes and drawn enlarged. Text on a small drawing starts at a quarter of its height (6 px on a 32 by 24 sprite) instead of 48 px.
- A text you are typing can be selected: cmd A selects all of it, shift with the arrows a part, a double click a word, a drag from inside it a stretch; typing, Backspace and Delete replace what is selected, cmd C and cmd X copy and cut it, and cmd Z takes back the typing. Other command keys (cmd S, cmd K, cmd W, cmd E, cmd ,, F5) work while a text is open: the text is kept first.
- When the agent changes the drawing a line says so ("the agent changed the drawing: stroke on lines"), and an undo that takes back the agent's step says whose it was.
- A hex colour typed in a picker is one step of the history: the field answered twice, the second time with the colour you paint with. A colour picked for a shape with a gradient keeps the gradient, in the new colour.
- In a layer transform (cmd T) a drag outside the box turns it, as the bar says; a click outside still ends it.
- A layer row drags from its name too.
- The bar of a selection sits above the turn knob when it goes above the selection, and its colour picker then opens upwards, away from the strokes; holding shift hides the bar, so a stroke under it can be added.
- A clipped layer moved into a group without the layer it was clipped to says that it now shows something else or nothing.
- With V, a press on a stroke of another layer switches to that layer and drags at once (it could be dropped with "still loading"); a loop that goes to another layer says which.
- A drawing whose last change came from the agent opens with V (select and move) in hand, so a first click picks instead of painting; your own drawings keep the brush. A drawing of shape layers only opens with its top layer picked.
- A click on a shape with V makes its layer the one in hand, as a click on a stroke does. cmd A with V keeps V in hand.
- Esc with a colour picker open closes the picker only; a second Esc drops the selection.
- New shape and text layers get names of their own: shapes, shapes 2, text 2.
- ctrl Y (cmd Y on the Mac) redoes too.
- The fill stops at the lines of every visible layer by default, so a first fill on a colour layer under the ink fills the shape, not the page.
- A new pixel drawing starts with a palette of eight colour ramps (grey, red, orange, yellow, green, blue, purple, skin), four shades each, so the darker and lighter pencil work at once. From the command line:
klad new --pixel 64x64 --palette. - = then - on the last drawing of a layer gives the timeline back its length.
- A new clip opens its settings with the name selected, to type its name at once. Clip names above the frames are no longer cut at the top and bottom.
- cmd ← and cmd → go to the first and the last frame (Home and End still do; a Mac laptop has neither).
- In the start window a drawing with a transparent background shows its thumbnail on a checkerboard, as the canvas does.
- The Pencil answers to the pen's tilt: it grows and lightens as the pen leans. Settings > Pen shows the tilt the pen sends.
klad apply --stepsmakes every line of a script an edit of its own, in order: each is a step in the history and shows in the open editor as it lands, so a drawing made by a script can be watched appearing mark by mark.--delay 120waits that many ms after each step,{"pause":600}on a line waits between two parts, and a line that is a list of ops is one step. A line that fails stops the run with the lines before it kept;--from <line>goes on from there.- The brush no longer tapers a stroke you draw by hand unless you ask for it: a click paints a dot at once and a line ends where you lift the pen or the mouse. For tapered ends set taper in px and taper out px under more in the brush bar. Brushes saved in a drawing and strokes painted from the command line keep their taper.
- Keys follow what you are working in. Click a frame in the timeline and cmd C, cmd V, cmd D, Delete and cmd A copy, paste, repeat, delete and select frames (a blue line around the frames shows the timeline has the keys); press on the canvas and they act on strokes and shapes again. The keys that change timing (=, -, I, shift I, alt left, alt right) run only while the timeline has the keys and say so otherwise; the Frame menu runs them from anywhere.
- Repeating frames. With frames selected in the timeline, cmd D and the duplicate button repeat all of them after themselves as copies; before, only the drawing under the playhead was copied. - now takes back exactly what = did, also on a drawing that runs to the end of the timeline.
- File > Export is a menu with an entry for each kind of export (image, frames, sprite sheet, GIF, Aseprite file, Godot), and each window shows only what that export uses. Pick the folder with Choose…, type a name under save as, and the window says where the file will go. When it is written the message says where it is, and Show the folder opens it.
- Windows open in the middle of the window, each time they open.
- A right click on the canvas opens a menu: copy, paste, duplicate, delete, select all, and Move to new layer, which puts the selected strokes or shapes on a layer of their own right above.
- Shapes copy and paste: cmd C and cmd V work on vector shapes as on strokes. With nothing to copy or paste, the keys say what to do instead of doing nothing.
- The pen and the shape tool work on any layer: on a paint layer the path or shape goes on a new vector layer above it. On a pixel layer U still draws pixels.
- The colour button in the bar at a selection opens a colour picker with the drawing's palette and the colours used lately, for strokes and for a shape's fill and outline. use the current colour in it gives the colour you paint with, as the button did before.
- The Colour panel mixes with sliders in HSV, HSL, RGB or Lab next to the wheel, and remembers which.
- A turned view shows its angle on the canvas with an upright button (alt R). Hold shift while twisting two fingers to turn in steps of 15 degrees; R and shift R go to the next step.
- Double click a layer's name and type: the name is selected, so typing replaces it. Return in a text field no longer starts playback.
- While alt is held over the canvas the pointer is an eyedropper. On a pixel layer the pointer is the pixel's outline alone, without the brush's ring.
- cmd S says the drawing is saved as you go, and where it is. A
.kladdrawing dropped on the window opens. - Fixed a text that vanished. A text opened again with T could be saved hidden when a menu command changed the drawing while it was open (a new layer, an undo, a paste), and was gone from the picture after the drawing was opened again. What is shown while a text is open never reaches the file now, and the same goes for a layer's look while its slider is dragged.
- A drawing renamed in Finder or the file browser while it is open stays one drawing: klad goes on in the renamed folder and says so, and the window's title and the recent drawings follow. Before, klad kept writing to the old name, which made a second, partial folder and emptied the other layers at the next undo. A drawing whose folder is moved somewhere else or deleted is closed, and the start window says what happened. No command, in the editor or from the command line, writes into a drawing's folder once it is no longer where it was opened.
- Copy, delete, paste keeps the strokes. cmd C now takes the strokes themselves, so cmd V pastes them as they were copied, whatever happened to the originals since: deleted, moved or recoloured. Parts cut out by a loop paste as those parts (they came back as empty marks on their old layers). Strokes copied from several layers land on the layer in hand when it is another layer, so copy, New paint layer, paste moves them there; while one of their own layers is in hand they go back to the layers they came from, and the message says which.
- The editor no longer writes over what an agent changed a moment before. It used to learn of a change in the drawing's folder only when the system reported it, a moment later; a stroke, a command or an undo made in that moment was worked out on the drawing as klad last read it, so the agent's change was dropped, and an undo could put a layer into the drawing twice, after which it opened only after a repair. Every change now reads the folder first when it has changed, and nothing is written over a change klad has not read.
- Fixed the canvas after undoing Make it a map layer on a layer that was no longer selected: the layer's paint stayed off the canvas until another layer was picked. Make it a map layer and the map button are one undo step each, with the light maps they turn on.
- Fixed links that did nothing: Help > Guides, What's new, the links in About klad and in the start window, and the report and support emails now open with the system.
0.3.0 (2026-11-16)
Light maps for 2D lighting: normal, height, specular, emission, depth and occlusion maps made from what is drawn, shaped by hand, written beside every export and lit in Godot. Drawings are saved in format klad/8; older drawings open unchanged.
- Fixed opening a drawing on the Mac: Choose a .klad file... in the start window (it said folder) and File > Open… could not pick a
.kladdrawing, which Finder shows as one file. The open panel now takes a.kladdrawing; other files are greyed out. - Fixed shade and rim on posed layers. The shade and rim fills that
klad lightmakes keep the part of the shape outside a cut, and a pose turned the fill with its bone but left that cut where it was in the rest drawing, so in posed frames and their in-betweens the rim grew into a wide crescent and the shade slid away. Posing now moves the cut with the fill, inklad applyposes, in-betweens and the editor alike; a frame posed before this comes right when you pose it again. - Fixed cuts in in-betweens. A fill or stroke cut by a lasso kept its cut where it was in the first key when an in-between moved it: flood fills between keys, and marks that ride a line (marks drawn by hand between keys and marks found in one key only). The cut now moves with the mark.
- Fixed hard edges on posed fills. A pose sampled each fill at the nearest pixel, so a turned fill got a stepped edge and thin bands along it broke into dots; it now blends between pixels as
klad transformdoes, and a pose and a transform of the same turn give the same picture. Frames posed before this keep their old edge until they are posed again. - Colour squares open the colour picker. A colour square outside the Colour panel (an effect's colour, a fill or gradient stop, the shine and glow colours, the preview lights, the fog, the grey around the canvas, a new drawing's paper) opens the colour wheel with a hex field and use the current colour, instead of taking the current colour on a click; dragging on the wheel is one undo step. A glow colour is removed with remove in its picker.
- Light maps for 2D lighting: a normal map (OpenGL style, green up, as Godot expects), a height map, a specular map and an emission map, made from what is drawn. The drawing's surface rounds in from its outline by a bevel (round, chamfer, pillow or flat; fit beside it, or
bevel=fit, makes it as deep as the shape so the whole silhouette rounds like a ball), rises where paint with body is thick, and follows height layers you paint (white raises, black lowers); a top layer can have a surface of its own, and layers can paint the normal, specular and emission maps directly. Map layers are a layer type of their own: map in Layers adds one, Layer > Make it a map layer and Make it a colour layer convert, the list shows each with an icon for what it draws, and its Layer settings hold only what applies (what it draws, the range for height); from the command lineklad add art.klad layer map height, andklad lslists them as map layers with what they draw (draws height). Map layers never show in the picture, so while one is selected the canvas shows its own map (height, normal, specular or emission) and goes back to the picture on another layer. Window > Light maps turns them on and holds the settings (opening it in a full dock folds other panels to make room, and says which), and turning them off and on there brings back the surface and the lights they had; View > Next light map (M) shows each map over the canvas, View > Lit shows the drawing lit by its preview lights, and holding L lights it with the pointer. From the command line:klad maps art.klad --on,klad set art.klad l7 map=height,klad set art.klad g2 surface.bevel=12,klad lights art.klad --add point --at 120,80,klad render art.klad --map normaland--lit,klad hash art.klad --map normal. Drawings are saved in formatklad/8; older drawings open unchanged. - Shaping the light maps by hand. On a height layer any brush paints height, white raising and black lowering: while it is selected the canvas shows the height map with the stroke under way drawn over it, the Colour panel shows a grey ramp and five steps from lower to raise with how many px the colour moves the surface, choosing the role picks white, and white raises beside it sets the range; from the command line a stroke or fill in a colour on a height layer prints what its lightness does. On a normal layer the brush paints a direction: pick it on the sphere in the Colour panel (the middle faces out, flatten goes back to it, the row under it holds the eight leans), or turn on direction from pen tilt and lean the pen the way the surface faces. From the command line:
klad stroke art.klad l9 --normal nw(or--normal 0.5,-0.3), and{"normal":"nw"}in a stroke op. - Shine and glow. A layer's shine (0 matte to 1) and the colour of its shine make the specular map, and emissive makes it glow at full brightness whatever the light (windows, eyes, fire); for parts of a layer, + the current colour beside it makes only the parts in that colour glow, on every frame, with no layer of their own; shading blended over a glowing part (multiply and the like) lets its glow through, a normal layer over it covers it; all of it is in a colour layer's Layer settings under Light, with a surface of its own, and the light preview shows the highlights and the glow. From the command line:
klad set art.klad l3 shine=0.6 specular=#ffd0a0,klad set art.klad l5 emissive=true,klad set art.klad l5 glows=#bff2ff,#ffd040. - Depth and occlusion maps. The depth map is near white: each plane's depth, a layer's z (px nearer within its plane) and the height; it is written as 16-bit grey,
--invertfor far white. The occlusion map darkens creases and the foot of raised forms. M now shows them too. From the command line:klad render art.klad --map depth,--map occlusion,klad set art.klad l3 z=12. - Light maps in every export.
klad export art.klad --maps normal,specular(orall) writes each map beside the PNG, the frames or the sheet pages, with the same size, trim and layout, named like the picture with_n,_h,_s,_e,_dor_o; normal maps are written as plain data with no colour profile. The export window has a tick for each map. - A sample for light maps, lit-creature: the walking creature and a basketball on one drawing, lit for a game's 2D lights, with the creature's parts raised and recessed on a height layer that follows every frame, eyes that glow by colour and a ball rounded by a fitted bevel.
- Lit sprites in Godot. With the maps on,
klad export --godot(and the editor's export to Godot) writes the normal and specular maps and makes every sheet page aCanvasTexture, soPointLight2DandDirectionalLight2Dlight the sprite; what glows plays on a child sprite that ignores the light;art_lit.tscnholds the sprite in front of a plain backdrop that catches the light and the shadows (a light inside the sprite, like a lantern's own, is not shadowed by it: the mouse light checks as it moves), the drawing's preview lights (one follows the mouse) and its ambient. Parallax scenes, rigs and tilesets get the maps too. - Shadows from the silhouette.
--occluderstraces the outline of every distinct picture into an occluder that switches with the frame, so the sprite casts a shadow; rigs get one per part, parallax scenes one per plane. shadows in the export window, View > Overlays > Occluders andklad render --overlay occludersshow the shapes. The lights in<name>_lit.tscncast soft shadows that start right at the outline (filter PCF5, smoothing 1: Godot blurs 2D shadows by angle from the light, so more smoothing spreads them past the sprite's edge). - Shader samples.
--shaders fog,rim,occlusionadds a short shader that reads the maps (fog towards a colour by depth, a rim light from the height, darker creases) to the sprite or the parallax planes, a start for your own. - Light maps for pixel art. A pixel drawing's maps step by whole pixels and stay sharp at any export scale, with the normals taken from a normal palette of 9 directions (or 17:
klad surface sprite.klad --directions 17); the Colour panel shows the palette on a normal layer, andklad pixel sprite.klad l2 --normal nwpaints one.klad surfacesets a layer's own surface or the drawing's. - Checking the light maps.
klad check art.klad --maps --alland View > Check the light maps report normals pointing into the surface, layers that read flat under light, map paint where nothing is drawn, glow past the drawing and maps that jump between frames while the picture holds still; the Light maps panel lists them and a click goes to the place. A new sample,samples/lit-lantern, builds the lantern with its maps, lights and a Godot export.
0.2.0 (2026-11-12)
Pixel art: pixel layers in the colours of a palette, tools that draw whole pixels, animation, tiles, checks and exports that stay sharp. Drawings are saved in format klad/7; older drawings open unchanged.
- Pixel layers, the start of pixel art in klad. A pixel drawing (Pixel art in the start window, or
klad new sprite.klad --pixel 64x64) is a small drawing of whole pixels with no soft edges; Layer > New pixel layer orklad add art.klad layer pixeladds a pixel layer to any drawing.klad pixel sprite.klad l1 --color skin --cells '4-11,5-9'puts pixels on it as one mark bound to a palette colour (a colour the palette lacks is added), and--eraseclears them. Each mark stays editable: recolour it withklad set, move it withklad transform, remove it withklad rm;klad strokeslists them. Exports above full size keep the pixels square. Brush strokes and fills stay off pixel layers. The format is nowklad/7(stroke files version 3); older drawings open unchanged. - A sharp view for pixel drawings. In the editor the zoom steps in whole pixels, so every pixel is the same size; a grid shows between the pixels once you are zoomed in (View > Pixel grid), the pixel under the pointer is outlined and its position shows in the status line, and the Real size panel shows the drawing as the player sees it, at 1x, 2x or 4x.
klad renderenlarges a pixel drawing to about 512 px, and--overlay gridnumbers its pixels along the top and the left. - The palette of a pixel drawing. Changing a palette colour changes every pixel painted with it: click the colour in the palette, change it, and press update (or
klad palette art.klad --recolour skin --to '#e8b796'). palettes adds the colours of a palette that comes with klad (PICO-8, Resurrect 64, four greens, 1-bit;klad paletteslists them) or of a palette file, a list of hex colours or a GIMP palette (klad palette art.klad --load pico-8). ramp adds five steps of the current colour, from dark and cool to light and warm (klad palette art.klad --ramp wood --base '#8b5a2b'), and--ramp skin --of skin-dark,skin,skin-lightgroups colours the palette has. - The pixel pencil and eraser. On a pixel layer the brush tool (B) draws whole pixels in the current colour, which joins the palette, and the eraser (E, or the pen's eraser end) clears them; each drag of the pencil is one mark, and the eraser takes its pixels out of the marks under it and leaves none of its own, so pixels you move there later stay whole. A one-pixel line is pixel perfect (no doubled corners), the size is a square of whole pixels ([ and ]), and shift click draws a straight line from the last pixel. From the command line,
klad pixeltakes--path(SVG path data as a line of pixels) and--size. - Sprites as text, for agents.
klad pixel sprite.klad l1 --grid sprite.txtdraws a sprite from a legend (i = ink) and rows of characters, one per pixel, each character becoming one mark bound to its palette colour;klad pixels sprite.klad l1reads a pixel layer back the same way, with its legend and numbered rows and columns (--plainin the form--gridreads,--json). - Shapes and fill on the grid. On a pixel layer the fill tool (G) fills every pixel joined to the one you click that has exactly its colour (across corners, read all pixel layers), and the shape tool (U) drags a rectangle, an ellipse or a line of whole pixels, outlined or filled. From the command line:
klad pixelwith--line,--rect,--ellipse(--filled) and--fill x,y(--diagonal,--ref). - Selecting and editing pixels. On a pixel layer the stroke tool (S) drags a box, or a loop, around pixels and takes them, cutting marks between whole pixels; drag them to move by whole pixels, scale by whole numbers or turn by quarters, and the bar under them flips, turns, recolours (exactly the current colour), copies and deletes. Select same colour takes every mark in the selected colours. From the command line:
klad lassotakes--box x,y,w,h,klad strokes --entry skinlists one colour's marks, andklad recolourgives pixel marks the exact palette colour. - Shading pixels. The pixel pencil, the shape tool and the fill tool have three inks: colour, lighter and darker; the last two step the pixels you go over along their colour's ramp. dither draws a share of the pixels in an even pattern, with the second colour for the rest. Layer > Outline the pixels adds a one-pixel outline in the current colour, and Lighter and Darker in the bar under selected marks step them along their ramp. From the command line:
klad pixel --shade,--ditherwith--second,--outline(--inside),klad recolour --step, andklad recolour --from skin --to skin-darkto replace a colour. - Mirror and tiles for pixel art. The pixel pencil, shape and fill tools draw each pixel's twin across the mirror line. View > Tile: wrap at the edges makes the drawing a tile: what you draw past an edge comes back in on the other side, fills go round the edges, and the canvas shows its repeats around it. From the command line:
klad pixel --mirror-x 16(and--mirror-y),klad new tile.klad --pixel 16 --wrap,klad canvas tile.klad --wrap on, andklad render --repeat 3to see a tile repeated. - Animating pixel layers. Frames, holds, links, clips and onion skins work on pixel layers as on paint layers. A keyed pixel layer moves by whole pixels and stays sharp. In-betweens, poses, weights and bones refuse pixel layers and say why: they move points and bend strokes, so draw the frames or key the layer's position.
- Exports that stay sharp, and GIFs. A pixel drawing exports at whole-number sizes only, up to 64 times (
klad export sprite.klad --scale 8), enlarged pixel for pixel; the export window shows times real size and the size in pixels. Sheets, numbered frames and Godot exports follow the same rule, and the Godot scenes of a pixel drawing turn texture filtering off. New for every drawing:klad export art.klad --gifand GIF in the export window write an animated GIF for each clip, or one of the whole timeline, with each frame's own duration. A GIF holds 255 colours:--dither(the dither box) mixes them in a fine pattern so the soft gradients of a painting do not band. - Palette variants. A drawing can hold other colours for the same sprite, like a blue team beside a red one. In the Colour panel new variant makes one and shows it; colours you change while it is shown are its own, and the palette itself keeps its colours. Pick base or a variant under the palette to show it. The export window exports what is shown, one variant, or every variant in one go. From the command line:
klad palette --new-variant blue,--variant base,--rename-variant,--rm-variant, andklad export --variant blueor--variants. - Aseprite files in and out.
klad import hero.asepriteopens an Aseprite file as a klad drawing: its layers and groups, every frame's drawing, linked cels, the palette and its tags as clips. In the editor, Choose an Aseprite file... in the start window (or its path pasted there) does the same and opens the drawing it made.klad export hero.klad --aseprite, or Aseprite in the export window, writes a drawing's pixel layers back to an Aseprite file. klad says what it leaves out each way. - Pictures to pixels. File > Pixels of a picture… turns a PNG or JPEG into pixels on the pixel layer you are on, in the palette's colours, or makes a pixel drawing of the layer you are on or of the whole picture at a size you choose. From the command line:
klad pixelize sprite.klad --image ref.png --to l1,klad pixelize hero.klad --size 64, andklad import ref.pngfor a new pixel drawing from a picture. Each pixel becomes part of a mark bound to a palette colour, so the result is edited like any pixel drawing. - Tilesets. View > Tileset: cut into tiles… cuts a drawing into tiles of one size; the canvas shows the tile lines, and as a tile set in the export window writes a Godot TileSet with a tile for every cell that is not empty. From the command line:
klad new ground.klad --pixel 64x48 --tile 16,klad canvas --tile 16,klad pixels --tile 2,0andklad pixel --grid --tile 2,0to read and draw one tile at a time, andklad export --tileset <folder>. - Pixel checks.
klad check sprite.kladlists the usual slips of pixel art with their places: single stray pixels, doubled corners in one-pixel lines, jagged lines, banding, and colours that are not in the palette. In the editor Check the pixels marks them on the canvas and follows your edits until you turn it off. They are places to look at, not errors. - A third agent skill,
klad skill pixel: the craft of pixel art (size and palette, silhouette, clusters, clean lines, outlines, ramps with hue shift, shading without pillow shading or banding, anti-aliasing by hand, tiles, and a checklist at real size), and animating a sprite frame by frame: the four poses of a walk, heights and holds, what moves with the body and what trails it, the idle, and how to judge it. Under the MIT licence, like the other two. - Two pixel art samples,
sprout(a 32 px character with an idle and a walk) andground(a tileset of 16 px tiles), in the start window andklad samples, and a guide, Drawing pixel art: starting a drawing, drawing and mirroring, moving pixels, ramps, a second colouring, animating a sprite, turning a picture into pixels, the checks, tiles and exports. klad checkis quiet enough to read: it lists what stands out (a single pixel outside the shape or in a flat area, an L in a drawn line) and counts single pixels among other colours and corners in shading in one line as left out. A 64 px sprite that gave 77 findings gives 15. The editor's Check the pixels marks the same ones.klad export -otakes a folder that exists for every kind of export and puts the export in it under its usual name; a sheet used to land next to the folder.
0.1.17 (2026-11-11)
The first builds, and klad's licences.
- A new icon, painted in klad: a K in two brush strokes.
- Align and distribute shapes. With V, shift click adds a shape to the selection and a loop dragged on a vector layer takes the shapes inside; several shapes move, scale, turn, flip, duplicate and delete together. The bar under them lines up their left, right, top or bottom edges or their centres and spaces three or more evenly; one shape lines up on the canvas (Edit > Align). From the command line:
klad align art.klad n3 n4 n7 --y middle --spread x, with--to canvasor--to <shape>and--gap. - Fixed exports of a clip moved by keys (a layer, group or shape keyed between frames, with no drawing per frame):
klad export --sheet,--framesand--godotwrote the first pose for every frame, andklad render --sheetshowed them as held. Each pose is now its own picture. - A second agent skill,
klad skill drawing: the craft of drawing and painting (planning a picture, light on form, values, edges, colour, materials, line, a painting method and a critique checklist), under the MIT licence like the first. - Drawings are
.kladfolders in a fresh format,klad/6(drawings from the first builds open as they are, except their bones, which are dropped). Drawings from before (.drawfolders) do not open and are not converted. - Drawings live well in git: an edit changes only the files of what it edits (
doc.jsonkeeps no revision or id counter), and copies of a drawing edited apart, in a clone or a worktree, never make the same id, so edits to different layers merge. New ids end in the copy's two-letter tag (l48qa,c12:s349qa);klad infoshows it. The editor follows agit checkoutof an open drawing, and klad never renders an old picture from its cache after one. Recolouring several strokes or fills at once (the selection bar in the editor, orklad recolour) moves them to the new colour together and keeps each one's own shade, so a painted-over area stays painted. If a merge still leaves an id used twice,klad repair(or Repair and open when the drawing won't open) gives every later one a new id and moves its stroke files along. - Erasers, smudges and blends stay with the strokes they were drawn over: move, copy or delete the strokes and they come along (or split, when only some of the strokes move), and an eraser erases only its own strokes, so moving them never bites into the paint they land on. The selection bar shows what is attached, "attached only" moves it on its own (it attaches to what it lands on), and detach frees it (
klad detach); a stroke its erasers wipe out completely is skipped by clicks and the lasso.klad strokes --jsonlistson,attachedandhidden. Stroke files move to version 2 (formatklad/6); older drawings open with nothing attached. - Bending a stroke with the point tool bends what is attached to it. The eraser has a feather slider in the brush bar, for the pen's eraser end too: its edge fades out like an airbrush. Brushes take
featherandfringe(an edge frayed into streaks along the stroke, like a dry brush), in the brush window and inklad brushes --set. - klad is source-available, not open source: the app is under the PolyForm Internal Use License 1.0.0, with permission for personal use (building from source is free for it), to propose contributions and to share the drawings you make (
LICENSE). Companies with 500,000 euros or more in revenue a year buy a licence for each person who uses klad; a bought build is that licence, under the same terms. The file format (docs/format.md), the command reference (docs/cli.md), the agent skill and the newklad-clientcrate are MIT (LICENSE-MIT), so any program or agent can read, write and make klad drawings. Contributions come in under a contributor licence agreement (CLA.md). klad-client: run klad from Rust, apply edits as JSON ops, read drawings back as JSON, render them.- Builds for macOS (an app, Apple silicon and Intel in one) and Windows, sold on itch.io; Linux from source. Each has the
kladcommand line, the editor, the fonts, the licences and the agent skill. - The editor runs on Windows and Linux (
klad open, orklad-editor), with the platform's open dialog; pens that report pressure through the system (Windows) draw with it. - On a Mac,
.kladdrawings show in Finder as one item and open in klad with a double click. klad install(and "install the klad command" in the editor's document menu) putskladon the terminal's path, for you and for agents.klad skillprints the agent skill.- The editor checks once a day whether a newer version is out and says so, with a link to what changed (off in the settings window); About's "check now" and
klad updatescheck on demand and say why a check failed. klad --version, About and the start window show the version and the commit a build was made from;just buildcounts the version up for every build.- In-betweens blend colours evenly (in OKLab), so light can follow a turning limb when the second key is coloured for it.
klad arcsfollows the part of a foot on the ground: a heel-to-toe roll is no longer reported as a slide.- Help > Report a problem shows the report before it is copied (version, system, the last messages and lines of klad's log, with your home folder hidden) and can zip the drawing to attach;
klad reportprints the same. Errors and crashes are kept in a small log for it. - Nothing in the editor names klad's internal ids: the status line, layer settings, selections, the in-between window, undo and the history say layers by name and drawings by frame, the timeline numbers each layer's drawings 1, 2, 3, and a new layer is called "paint 1" instead of by its id. The numbers window (timings) moves behind Settings > Layout > developer tools, off by default.
- The format promise: from 1.0, a drawing saved by any release opens in every later one with nothing lost. Each release keeps copies of the samples it saved, and the tests open them all with each new build.
- Help > Guides and Help > What's new open klad's guides and this changelog on klad.studio; the welcome on the start window links the guides too.
- Support by email: Help > Contact support opens an email to hello@klad.studio with the version and your system filled in; Report a problem can email its report there too, and About links klad.studio and the address. Crash messages name the address as well as the issues page.
- Messages say what happened and what to do next; when klad itself goes wrong it says so, and that your work is saved.
- Bones: a bones layer holds a skeleton (
klad bone, the bone tool J), weights from the bones or painted (klad weights), and poses that bend the drawing (klad pose, pose mode); in-betweens of two poses turn the bones. The bone tool lists the skeleton, picks a bone in every mode, and moves ends, joints and whole bones with their children (klad bone --movewith--by). - Transform a whole layer or group: cmd T puts handles round it, and a drag moves, turns or scales every drawing on it, its shapes, and its bones and poses (
klad transform --layer). - Bones live on a bones layer (Layer > New bones layer, or the first bone you draw makes one;
klad add <file> layer bones). Any paint layer in the drawing joins it: attached to a bone it moves with that bone alone, as a cut-out, so a character drawn in pieces needs no weights; or it bends with the skeleton by the weights (klad attach, the picked bone's layers menu, or the bone button on a layer's row). Pose mode shows the drawing posed as you drag; "make this pose a drawing" keeps it. - Bones are a preview: the bone tool, Layer > New bones layer, the bones guide and the help of
klad bone,attach,poseandiksay so. Posing may still change; drawings keep their rigs when it does. - Bones are drawn as chains: letting go of a bone starts the next one from its end, each click adds one, shift fans them from one joint, Esc ends the chain (
klad bone --chain). - IK: a bone and its parent become a limb (or a bone alone an aim) that reaches for a target, bending the way it is drawn, with softness so knees do not snap straight (
klad ik, the bone tool's options). In pose mode, drag a limb's end and the limb follows; move the whole by a root bone's head and planted feet stay where they are (klad pose --target,--mix); in-betweens keep them planted. Exports to Godot carry the solved turns. - A first start: the start window welcomes, offers first steps (draw a shape, fill it, hand the drawing to an agent, ticked off as you go; Help > First steps opens them again) and six sample drawings that open as copies (
klad sampleslists and copies them). - Picking strokes takes what you see: the topmost layer that shows paint under the pen and the mark covering the point, on all layers or this layer only (the S and V options).
- A selected shape takes the colour as its fill or its outline (the shape's bar, Edit > Shape).
- Alt click on a layer's eye shows only that layer, and again the rest as it was (
klad solo). - Menus: a menu bar (the Mac's own, an in-window one on Windows and Linux) holds every command in File, Edit, Tools, Layer, Frame, Animation, View, Window and Help, with short labels, its keys, ticks for what is on and greyed items for what cannot run now; File has close (cmd W) and recent drawings.
- Keys: layers, groups and shapes move, turn, scale and fade between frames with eases (
klad key, the keys section of layer settings). - Godot:
--godot-rigexports a Skeleton2D with Polygon2D parts and the poses as animations;--godot-scenea parallax scene with a Parallax2D per depth plane. klad paintover(and "paint over" in the layers panel): brushwork from any picture, strokes that follow its forms and stop at its colour edges, big to small, detail where the picture has it;--likeand--framescarry it through an animation without boiling.klad compare(and "compare with the reference" in the editor): a drawing against a reference picture in numbers and words, with a heat map.- Large stills render several times faster: strokes land only where they painted, and the CLI replays a drawing's tiles on every core (same pixels).
- Dragging in a large drawing: shapes and strokes move under the pointer from the first move, wherever they are (in groups with effects, clipped, masked, under any blend), drawn in the background tile by tile; the layers above and the rest of the dragged layer stay in place (dragging a shape on the topmost layer no longer hid the shapes above it), and letting go redraws only the tiles the move touched.
- Edits on vector layers redraw only the tiles their shapes covered before and after, not the whole layer.
- Noise and haze no longer make every edit redraw the tiles around it.
- Drawings with many clipped layers and groups redraw several times faster: each tile skips the stacks that have nothing in it.
- A tap that wobbles selects a shape or strokes without nudging them: a drag starts once the pointer has moved 3 points on screen.
- The numbers panel shows how long the canvas takes each frame, next to the rest of the interface.
- Switching layers no longer redraws the whole canvas when nothing on it changes.
- Fixed tiles that could stay blank or out of date when a panel or popup was laid out for the first time while the canvas was being redrawn.
0.1.0 (2026-11-04)
The first public version: the klad command line on macOS and Linux and the editor on macOS, built from source.
From CHANGELOG.md in Klad at v0.4.0 (971a89b).