aseprite · CrashTestJava · Nov 16, 2025 · Nov 27, 2025 · Nov 27, 2025 · Nov 29, 2025
diff --git a/adjustments.md b/adjustments.md
@@ -0,0 +1,42 @@
+# Adjustments
+
+The Adjustments dropdown can be accessed with *Edit > Adjustments*, and it contains various options to adjust the colors of the sprite.
+
+## Brightness/Contrast
+
+![image of brightness/contrast menu](adjustments/brightness-contrast.png)
+
+Adjusts the brightness and contrast of the sprite or selection. A negative value will decrease the brightness/contrast while a positive value will increase the brightness/contrast.
+
+* The *R*, *G*, *B*, and *A* buttons control if a component should be affected, e.g: the *R* button is checked, so the *R* (red) component will be adjusted.
+* The bottom button controls if the adjustment should apply to the active timeline selection (*Selected*) or all of the cels in the sprite (*All*). If [a portion of a sprite is selected](selecting.md#selecting): in *Selected* mode it would only apply to the selected content of the selected timeline elements; in *All* mode it would apply to the selected content of all of the sprite's cels.
+
+    ![image of component buttons and selection button](adjustments/component-buttons.png)
+
+
+## Hue/Saturation
+
+![image of hue/saturation menu](adjustments/hue-saturation.png)
+
+
+Adjusts the hue, saturation, and value/lightness of the sprite or selection. *Shortcut:* <kbd>Ctrl+U</kbd>.
+
+* HSV / HSL: Increases a HSV/L component by a percentage of the components value
+    > e.g: a color has a Value of `20` increasing by `10%` of `20`; the resulting Value would be `20` + `2`, or `22`.
+* HSV+ / HSL+: Increases a HSV/L component by the specified amount
+    > e.g: a color has a Value of `5` increasing by `14`; the resulting Value would be `5` + `14`, or `19`.
+
+## Color Curve
+
+![image of color curve menu](adjustments/color-curve.png)
+
+Applies a color curve to the sprite or selection. *Shortcut:* <kbd>Ctrl+M</kbd>.
+
+Clicking anywhere in the box will create a new point. <kbd>Left click</kbd> and drag a point to move it; <kbd>Right click</kbd> a point to edit its properties. To delete a point, hover over a point and press <kbd>Delete</kbd>.
+
+---
+
+**SEE ALSO**
+
+[FX](fx.md#fx) |
+[Edit Menu](edit-menu.md#edit-menu)
diff --git a/adjustments/brightness-contrast.png b/adjustments/brightness-contrast.png
diff --git a/adjustments/color-curve.png b/adjustments/color-curve.png
diff --git a/adjustments/component-buttons.png b/adjustments/component-buttons.png
diff --git a/adjustments/hue-saturation.png b/adjustments/hue-saturation.png
diff --git a/cel.md b/cel.md
@@ -14,19 +14,15 @@ cels for all layers in a specific time:
 ## Move a Cel
 
 You can use the [Move tool](move-tool.md) to drag-and-drop the current
-cel in the canvas. Or you can use the [Timeline to move the cel](move-cels.md) to
-other layer/frame position.
+cel in the canvas. Or you can use the [Timeline ](move-cels.md) to move the cel to
+another layer/frame position.
 
 ## Change Opacity
 
-On [RGB](color-mode.md#rgb) images each cel has its own opacity
-level. You can use the slider at the status bar to modify its opacity:
+On [RGB](color-mode.md#rgb) images, each cel has its own opacity
+level. You can change a cel's opacity by right-clicking it and selecting *Properties* (or *Frame > Cel Properties*), and then adjusting the *Opacity* slider.
 
-![Cel Opacity](cel/cel-opacity.gif)
-
-You can do the same right-clicking a cel and selecting *Properties* option (or *Frame > Cel Properties* menu):
-
-![Cel Properties](cel/cel-properties.gif)
+![change cel opacity example](cel/cel-opacity.gif)
 
 ----
 

diff --git a/cel/cel-opacity.gif b/cel/cel-opacity.gif
diff --git a/context-bar.md b/context-bar.md
@@ -15,19 +15,19 @@ The context bar for most painting tools looks similar to this, with a few option
 
 ### Brush type, custom brushes, & brush angles
 
-See the [brushes section](brushes.md).
+See the [brushes](brushes.md) section.
 
 ### Brush size 
 
 The brush size (in pixels). To quickly change the size of the brush, you can use <kbd>Ctrl+Alt</kbd> and drag.
 
 ### Ink
 
-See the [ink section](ink.md).
+See the [ink](ink.md) section.
 
 ### Dynamics
 
-See the [dynamics section](dynamics.md).
+See the [dynamics](dynamics.md) section.
 
 ### Pixel-perfect mode
 
@@ -45,7 +45,7 @@ While it isn't an option in the pencil tool, you can find the opacity option in
 
 ![Context bar for selection tools](context-bar/selection.png)
 
-See the [selection section](selecting.md) for selecting and the [rotation section](rotate.md) for rotating and pivot.
+See the [selection](selecting.md) section for selecting and the [rotation](rotate.md) section for rotating and pivot.
 
 ### Transparent Color & Transparent Color Options
 
@@ -59,13 +59,13 @@ In the Transparent Color Options, you can change whether the transparent color i
 
 ![Context bar when moving the selection](context-bar/movingselection.png)
 
-See the [move selection section](move-selection.md).
+See the [move selection](move-selection.md) section.
 
 ## Eyedropper tool
 
 ![Context bar for eyedropper tool](context-bar/eyedropper.png)
 
-See the [eyedropper section](eyedropper.md).
+See the [eyedropper](eyedropper.md) section.
 
 ## Paint Bucket
 
@@ -123,24 +123,8 @@ Toggles between a linear and radial gradient.
 
 ![Context bar for text tool](context-bar/text.png)
 
-### Font selector
+See the [Text Tool](text-tool.md) section.
 
-Picks the font to use.
-
-### Font size
-
-Changes the font size. Depending on the font, some font sizes may have the `*` symbol next to them, indicating that the size is to pixel scale with the font.
-
-### Font formatting
-
-Changes the font formatting. Options:
-
-- Bold
-- Italic
-
-- Antialias - Toggles antialising, which smoothes out the text.
-- Hinting - Toggles hinting, which aligns the font to the pixel grid.
-- Ligatures - Toggles ligatures.
 
 ## Move tool
 
@@ -150,7 +134,7 @@ Selects layers based on which layer the clicked content is on.
 
 ## Slice tool
 
-See the [slices section](slices.md).
+See the [slices](slices.md) section.
 
 ---
 

diff --git a/dynamics.md b/dynamics.md
@@ -10,7 +10,7 @@ Once opened, the menu looks like this:
 
 ![Dynamics menu](dynamics/dynamics.png)
 
-The left column (Pressure) is for use with a pen, and the right (Velocity) is for use with a mouse. 
+The left column (Pressure) can only be used with a pen, and the right (Velocity) column can be used with a pen and mouse. 
 
 Only one of these can be selected per row. You can have multiple rows selected at once.
 

diff --git a/edit-menu.md b/edit-menu.md
@@ -0,0 +1,82 @@
+# Edit Menu
+
+The **Edit Menu** contains options/commands to modify the current sprite, as well as Aseprite settings.
+
+## Undo, Redo, & Undo History
+
+* **Undo**: Undoes the previous action. *Shortcut:* <kbd>Ctrl+Z</kbd>.
+* **Redo**: Redoes the previous action. *Shortcut:* <kbd>Ctrl+Y</kbd>.
+* **Undo History**: See the [Undo History](undo-history.md#undohistory) section.
+
+## Cut, Copy, & Paste
+
+* **Cut**: Cuts the active [selection](selecting.md#selecting) content. *Shortcut:* <kbd>Ctrl+X</kbd>.
+* **Copy**: Copies the selected content, [layer](layers.md#layers), [cel](cel.md#cel), or frame; e.g if a layer was selected, the layer would be copied. *Shortcut:* <kbd>Ctrl+C</kbd>.
+* **Copy Merged**: Copies the selected content for each visible layer, merged into one image. *Shortcut:* <kbd>Ctrl+Shift+C</kbd>.
+* **Paste**: Pastes the clipboard (can be a layer, cel, portion of the sprite, etc). *Shortcut:* <kbd>Ctrl+V</kbd>.
+* **Paste Special**: 
+    * *Paste as New Sprite*: Pastes as a new [sprite](sprite.md#spritestructure).
+    * *Paste as New Layer*: Pastes as a new layer.
+    * *Paste as New Reference Layer*: Pastes as a new [reference layer](reference-layer.md#referencelayer).
+* **Delete**: Deletes the selected content, layer, cel, or frame. *Shortcut:* <kbd>Del</kbd>.
+
+## Fill & Stroke
+
+* **Fill**: Fills the active selection with the [foreground color](color-bar.md#foreground-color). *Shortcut:* <kbd>F</kbd>.
+* **Stroke**: Outlines the inside of the active selection with the foreground color. *Shortcut:* <kbd>S</kbd>.
+
+## Rotation & Flipping
+
+* **Rotate**: See the [Rotate Canvas](rotate-canvas.md#rotate-canvas) section. 
+* **Flip Horizontal**: Flips the sprite or selection horizontally. *Shortcut:* <kbd>Shift+H</kbd>.   
+* **Flip Vertical**: Flips the sprite or selection vertically. *Shortcut:* <kbd>Shift+V</kbd>.  
+* **Transform**: Selects the cel content. *Shortcut:* <kbd>Ctrl+T</kbd>.
+* **Shift**: Shifts the pixels of a selection once in the selected direction. Pixels on the ends of the selection will wrap around when shifted.
+
+![shift example](edit-menu/shift.gif)
+
+## New Brush & New Sprite From Selection
+
+* **New Brush**: Creates a new brush. See the [Brushes](brushes.md#custom-pattern-brushes) section. *Shortcut:* <kbd>Ctrl+B</kbd>.
+* **New Sprite From Selection**: Creates a new sprite from the selection content. See the [New Sprite](new-sprite.md#new-sprite-from-selection) section. *Shortcut:* <kbd>Ctrl+Alt+N</kbd>.
+
+## Replace Color
+
+See the [Replace Color](replace-color.md#replace-color) section. 
+
+## Invert
+
+Inverts all of the colors in a selection or cel.
+
+The menu has a few important buttons at the bottom:
+
+* The *R*, *G*, *B*, and *A* buttons control if a component should be inverted, e.g: the *R* button is checked, so the *R* (red) component can be inverted.
+* The bottom button controls if the invert should apply to the active timeline selection (*Selected*) or all of the cels in the sprite (*All*). If [a portion of a sprite is selected](selecting.md#selecting): in *Selected* mode the invert would only apply to the selected content of the selected timeline elements; in *All* mode the invert would apply to the selected content of all of the sprite's cels.
+
+![image of component buttons and selection button](edit-menu/invert-buttons.png)
+
+## Adjustments
+
+See the [Adjustments](adjustments.md#adjustments) section. 
+
+## FX
+
+See the [FX](fx.md#fx) section. 
+
+## Insert Text
+
+See the [Text Tool](text-tool.md#text-tool-&amp;-insert-text) section. 
+
+## Keyboard Shortcuts
+
+See the [Keyboard Shortcuts](keyboard-shortcuts.md#keyboard-shortcuts) section. 
+
+## Preferences
+
+See the [Preferences](preferences.md#preferences) section. 
+
+---
+
+**SEE ALSO**
+
+[Menu Bar](menu-bar.md#menu-bar)
diff --git a/edit-menu/invert-buttons.png b/edit-menu/invert-buttons.png
diff --git a/edit-menu/shift.gif b/edit-menu/shift.gif
diff --git a/eyedropper.md b/eyedropper.md
@@ -21,7 +21,7 @@ You have some extra options in the [context bar](context-bar.md):
 * Pick colors from the *All Layers* (the composition of layers), the
   *Current Layer* only without composition (ignoring the layer
   blending modes), or *First Reference Layer* to pick colors from the
-  first reference layer that is found.
+  first [reference layer](reference-layer.md#reference-layer) that is found.
 
   ![Sample options](eyedropper/sample-options.png)
 
@@ -30,6 +30,10 @@ You have some extra options in the [context bar](context-bar.md):
 You can configure the `Right click` to pick colors from
 [Edit > Preferences > Editor](right-click.md).
 
+## Pick colors outside of Aseprite
+
+You can pick a color from another window by clicking on the [Foreground](color-bar.md#foreground-color) or [Background](color-bar.md#background-color) color button and dragging the cursor outside of Aseprite. Releasing the mouse will pick the color the cursor was over.
+
 ---
 
 **SEE ALSO**

diff --git a/fx.md b/fx.md
@@ -0,0 +1,45 @@
+# FX
+
+The FX (effects) dropdown can be accessed with *Edit > FX*, and it contains various effects to use on the sprite.
+
+## Outline
+
+![diagram of outline menu](fx/outline.png)
+
+The outline menu adds an outline around the sprite or the selected content. The algorithm outlines any shape that is not the *Background Color*. *Shortcut:* <kbd>Shift+O</kbd>.
+
+* **Outline Color**: Sets the color of the outline.
+* **Background Color**: Sets the background color for the outline algorithm to detect. The algorithm outlines any shape that is not the *Background Color*.
+
+   ![example of background color](fx/background-color.gif) 
+
+* **Outline Location**: Can either be *Inside* or *Outside*. *Inside* draws the outline inside the shape and *Outside* draws the outline outside the shape.
+
+   ![example of outline location](fx/location.gif) 
+
+* **Shape Controls**: Controls the outline shape. The lower button panel can be used to create custom shapes, while the upper button panel are presets.
+* **Component Controls**: 
+    * The *RGBA* buttons control which components of the outline color are used, e.g: if the *R* component is not selected the outline color will have an Red rgb value of `0`. By default, all components are selected.
+    * The bottom button controls if the outline should apply to the active timeline selection (*Selected*) or all of the cels in the sprite (*All*). If [a portion of a sprite is selected](selecting.md#selecting): in *Selected* mode it would only apply to the selected content of the selected timeline elements; in *All* mode it would apply to the selected content of all of the sprite's cels. 
+* **Tiled**: When enabled, if a shape is cut off by the edge of the canvas, the cut off outline wraps around to the opposite side.
+
+    ![example of tiled mode](fx/tiled.gif) 
+
+## Convolution Matrix
+
+![image of convolution matrix menu](fx/conv-matrix.png)
+
+A list of [convolution matrix](https://en.wikipedia.org/wiki/Kernel_(image_processing)) filters/effects to apply to the sprite or the selected content. *Shortcut:* <kbd>F9</kbd>.
+
+## Despeckle
+
+![image of despeckle menu](fx/despeckle.png)
+
+Applies a [median filter](https://en.wikipedia.org/wiki/Median_filter) to the sprite or the selected content.
+
+---
+
+**SEE ALSO**
+
+[Adjustments](adjustments.md#adjustments) |
+[Edit Menu](edit-menu.md#edit-menu)
diff --git a/fx/background-color.gif b/fx/background-color.gif
diff --git a/fx/conv-matrix.png b/fx/conv-matrix.png
diff --git a/fx/despeckle.png b/fx/despeckle.png
diff --git a/fx/location.gif b/fx/location.gif
diff --git a/fx/outline.png b/fx/outline.png
diff --git a/fx/tiled.gif b/fx/tiled.gif
diff --git a/menu-bar.md b/menu-bar.md
@@ -5,7 +5,7 @@ The Aseprite menu bar is the menu at the top of the [main window](workspace).
 ![Aseprite Menu Bar](menu-bar/aseprite-menubar.png)
 
 You can access the main functionality of Aseprite from this menu.
-Pressing <kbd>Alt+underscored letter</kbd> will open the given menu,
+Pressing <kbd>Alt+[underscored letter]</kbd> will open the given menu,
 e.g. <kbd>Alt+F</kbd> will open the *File* menu. After that you can
 press an underscored key to access submenus. E.g. <kbd>Alt+F</kbd> and
 then <kbd>N</kbd> will access *File > New* menu option.
@@ -15,10 +15,20 @@ at the top of the screen:
 
 ![macOS Menu Bar](menu-bar/macos-menubar.png)
 
-Anyway you can show the Aseprite menu bar by checking the [*Edit >
+You can show the Aseprite menu bar by checking the [*Edit >
 Preferences > General > Show Aseprite menu
 bar*](preferences.md#general) option.
 
+**Menus**:
+
+* File
+* [Edit](edit-menu.md#editmenu) 
+* Sprite
+* Layer
+* Frame
+* Select
+* View
+
 ---
 
 **SEE ALSO**

diff --git a/preferences.md b/preferences.md
@@ -63,7 +63,7 @@ The Preferences dialog is divided in several sections:
 
 ## Tablet
 
-See the [tablet](tablet.md) section.
+See the [Tablet](tablet.md) section.
 
 ## Files
 
@@ -77,7 +77,7 @@ See the [tablet](tablet.md) section.
 
   ![ranges example](preferences/ranges.png)
 
-* **Color management**: See the [color profile](color-profile.md) section.
+* **Color management**: See the [Color Profile](color-profile.md) section.
 
 ## Alerts
 
@@ -214,10 +214,21 @@ Options to change the general behavior of the [Sprite Editor](sprite-editor.md):
 
 * **Undo Limit**: The memory limit for undo information, in megabytes, for each sprite.
 * **Go to modified frame/layer**: Sets the current frame/layer to the one where the undo occurred.
-* **Allow non-linear history**: Undo history is a list of sprite states. If non-linear undo history is disabled and undo is used (which moves the current state back one entry), the next action will overwrite the undone action/state. If it is enabled and undo is used, the next action will add the new sprite state to the list, keeping the old one intact.
-  ![nonlinear undo history example](preferences/nonlinear-undohistory.gif)
+* **Allow non-linear history**: See the [Undo History](undo-history.md#non-linear-undo-history) section. 
 * **Show Undo Tooltip**: Show the undo tooltip in the bottom right corner of the window.
 
+## Theme
+
+* **Font**: Sets the program font.
+* **Mini Font**: Sets the program mini font.
+
+## Extensions
+
+* **Add Extension**: Opens a file dialog to select an extension to add (a `.zip` or `.aseprite-extension` file).
+* **Disable**: Disables the selected extension.
+* **Uninstall**: Uninstalls the selected extension.
+* **Open Folder**: Opens a native file explorer (Windows File Explorer or macOS Finder) in the folder where the selected extension is installed.
+
 ## Aseprite Format
 
 * **Cel Content Format**: Changes the cel image format. See https://github.com/aseprite/aseprite/blob/main/docs/ase-file-specs.md#cel-chunk-0x2005.

diff --git a/preferences/nonlinear-undohistory.gif b/preferences/nonlinear-undohistory.gif
diff --git a/reference-layer.md b/reference-layer.md
@@ -0,0 +1,14 @@
+# Reference Layer
+
+![reference layer example](reference-layer/reference-layer.gif)
+> Image used taken from [publicdomainpictures.net](https://www.publicdomainpictures.net/en/view-image.php?image=142181).
+
+Reference layers are a way to show reference images at higher resolutions than the canvas. Reference layers cannot be drawn on or edited.
+
+There are a few ways to create a reference layer. To create one from a file, use *Layer > New > New Reference Layer from File*. To paste one in from the clipboard, use *Edit > Paste Special > Paste as New Reference Layer*.
+
+---
+
+**SEE ALSO**
+
+[Layers](layers.md#layers])
diff --git a/reference-layer/reference-layer.gif b/reference-layer/reference-layer.gif