Changelog¶
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Please add link(s) to PR(s) as [#N] to the end of each entry, and add a link target at the end of the changelog of the next release.
NEXTRELEASE¶
Breaking changes¶
Please check these when upgrading, especially if you use your own config.toml or key bindings.
- The
[keybinds]section uses a new syntax"BINDING" = "TOOL-OR-COMMAND", e.g."<Control>l" = "line". The old syntaxline = "l"still works but is deprecated and logs a warning. #555 - Changed default shortcuts:
- v selects the pointer tool, p selects the new pen tool. #799
- b selects the brush, which now paints with a soft edge and is slightly transparent. The former brush is the pen tool. #799
- h selects the freehand highlighter, g the block highlighter. #761, #799
- Delete deletes the selected annotation, Shift+Delete clears all. #607
- w focuses the size input field, s selects the spotlight tool. #804
- Shift while drawing a box shaped tool (crop, rectangle, ellipse, blur, highlight, ...) snaps to the aspect ratios configured in
aspect-ratios(1:1 is one of them) instead of only drawing squares and circles. Ctrl keeps the current aspect ratio. #643, #647, #648, #697, #702 - Esc and Enter are no longer used by the tools (e.g. to abort or finish a crop) and always run the configured actions, except in the text tool. Tools finish at the end of a drag; use undo to revert. The dismiss and commit buttons were removed from the toolbar. #607, #783
- In the text tool Enter inserts a line break, Esc or Ctrl+Enter finish the text. Esc no longer discards the text, use undo instead. #823
- Without a crop, the exported image includes annotations outside of the screenshot and has a transparent background there. Crop to the screenshot to get the old behavior. #662
- Freehand and block highlighter are separate tools. Holding Ctrl at the start of a highlight no longer switches between them, and
primary-highlighter/--primary-highlighterare deprecated and ignored. The freehand highlighter is calledhighlighterin the config and--initial-tool. #761, #799 - Styles moved to the new
[style]section and can be set per tool.corner-roundness,default-fill-shapesanddefault-round-capswere removed from[general], usecorner-radius,fillandround-capsin[style]instead. The command line option--corner-roundnesswas renamed to--corner-radius, the old name is still accepted. #814 - The size in the bottom toolbar is no longer a factor but an absolute value in px, pt or percent depending on the tool.
annotation-size-factorscales the sizes once at startup. #814 - Lines, arrows and other stroked shapes have flat (butt) caps instead of round ones, so short lines are drawn correctly and handles sit on the ends of the line. #799
--disable-notificationsshows notifications as an in-app toast instead of dropping them. #711--profile-startupis deprecated in favour of--log-level debug. #711
Added¶
- Edit annotations with the pointer tool v: #607, #631, #642, #673, #700, #714, #723, #744, #748, #769, #781, #787, #795, #810
- Click to select, Alt+Click to select between overlapping annotations. Thick strokes can be grabbed anywhere on the stroke.
- Move, resize by handles, nudge with the cursor keys, delete with Delete.
- Change the style of the selected annotation with the toolbar.
- Change the layer with Alt+Scroll or Alt+PageUp/Alt+PageDown.
- Double-click a text to edit it.
- Resizing a marker changes its number or extra ring.
- All of this can be undone and redone.
- Clicking an annotation with another tool temporarily switches to the pointer tool.
- New config
auto-select-newselects newly created annotations. - Image tool o: click to insert an image from a file chooser, or drag a box to fit it in. Ctrl+V pastes an image from the clipboard and images can be dropped onto the window. #563, #766, #773, #817
- Pixelate tools:
fringe-pixelatex replaces the area with its surroundings before pixelating it, so the original content cannot be recovered.pixelateandfringeare available as well. #469, #646 - Spotlight tool s dims everything but the marked area. #804
- Lensblur tool Shift+U blurs everything but the marked area. #804
- Blackout tool Shift+X blacks out the marked area. #806
- Pen tool p, which draws like the brush did before. #799
- Grouped tools: related tools share one toolbar button. Open the menu with a long click or a click on the indicator; it also shows the shortcuts. #600, #717, #799, #813
- All toolbar buttons and commands can be bound to any key, including zoom, scale, size, fill and round caps. New defaults are e.g. Ctrl+1 fit to window, Alt+1 100 %, Ctrl+plus/Ctrl+minus zoom, f toggle fill, k toggle round caps, - cycle size. Use
"none"to unbind a key. #555, #606, #618, #624 - Shortcuts work with all keyboard layouts: they follow the active layout, also match keys typed with Shift, and fall back to a Latin layout or US QWERTY for non-Latin layouts like Cyrillic or Greek. #608, #771, #772
- All styles can be configured per tool in
[style.TOOL], i.e. color, size, small, medium, large, fill, round caps, corner radius and the new opacity. Tools without own values use the general[style]. #814 - Text style (effect and background opacity) can be configured via fill, round caps and opacity. #814
- Open a screenshot from the clipboard with
--from-clipboard [COMMAND], default commandwl-paste -t image. #679, #737 - System wide config in
$XDG_CONFIG_DIRS/satty/config.toml(usually/etc/xdg/satty/config.toml), read before the user config. #667 - The crop selection snaps to the image bounds. #659, #694, #702
- Round caps toggle rounded corners for rectangle, blur, pixelate and highlight. #661
- Pen, brush and highlighter draw a straight 15° aligned line while Shift is held. #728
- Log viewer, open it with Ctrl+Shift+L. #785
- Line, arrow, pen, brush and highlighter draw a horizontal line while Ctrl is held. #801
- The bottom toolbar shows the aspect ratio of the image or shape, and length and angle of lines and arrows. #647, #781
- Selection, crop border and center marker are drawn with two colors, so they are visible on dark and light backgrounds, and keep their size when zooming. #659
- When zoomed in, the screenshot is drawn without smoothing, so single pixels are visible. #652, #750
- Missing folders are created when saving. #743
- WebP images can be opened even if gdk-pixbuf has no WebP loader. #563
- New config
notification-grace-periodto wait for the notification daemon to read the thumbnail before exiting. #635 - New
--log-leveloption, log output has level and severity, and a dialog is shown for fatal errors. #711 - Documentation website at https://satty-org.github.io/Satty/. #668, #763
Changed¶
- Unknown config fields log a warning instead of preventing Satty from starting. #698
- Blur is drawn below all other annotations, crop above them. #607
- Blur strength no longer depends on the zoom of the canvas. #804
- The size sets the opacity of the block highlighter, the darkness of the spotlight and the strength of blur and lensblur. #804, #814
- Highlight, spotlight, blur, lensblur and marker draw a rectangle with fill or an ellipse without. #804, #808
- Switching tools updates the toolbar to the style of the tool. #814
Fixed¶
- Satty can be installed with
cargo installagain. #625 - Notification thumbnails no longer go missing when Satty exits right after saving. #635
input-scaleno longer has the inverse effect on the window size. #690- Lines, arrows and the strokes of pen, brush and highlighter are visible right at the click, not only after the mouse moved. #803
- The transparency checkerboard is no longer drawn into exported images. #754
--initial-tool cropshows the crop dimensions. #641- A simple click no longer creates tiny, invisible annotations. #660, #720
- The text effect toggle only reacts to Alt alone, so e.g. Ctrl+Shift+Alt+U for unicode input in fcitx5 works. #696
- The center marker appears and disappears right when Alt is pressed or released. #734
- Short unfilled arrows are drawn correctly and do not change direction, and toggling round caps no longer changes the arrow length. #778
- Custom colors are no longer duplicated in the color dialog. #669
--helpno longer refers to the nonexistent optionaction_on_copy. #693- Fonts that are named instances of a variable font are loaded; variable font styles are not supported and a warning is logged. #618
- The canvas has the focus at start, not the size field. #824
- Add CSS variables for compatibility with newer GTK and Adawait. #826
- The text cursor and the box of an empty text are visible again while editing. #827
Contributors¶
Thanks to everyone who contributed to this release:
- Constantine Romakhov (@Solessfir)
- Haïm Dimer (@hdimer)
- ilyusha (@rokokol)
- Jonathan (@Jab2870)
- René D. Obermüller (@RobertMueller2)
- @robertwidfen
- Sitiyou (@sitiyou)