Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
swappy(1)		    General Commands Manual		     swappy(1)

NAME
       swappy -	grab and edit on the fly snapshots of a	Wayland	compositor

SYNOPSIS
       swappy [options...]

DESCRIPTION
       swappy is a command-line	utility	to take	and edit screenshots of	Way-
       land desktops. Works great with grim, slurp and sway. But can easily
       work with other screen copy tools that can output a final PNG image to
       stdout.

       swappy will save	the annotated images to	the config save_dir, see be-
       low.

       If absent, then if it will try to default to a Desktop folder following
       this pattern: $XDG_DESKTOP_DIR. If this variable	is not set, it will
       revert to: $XDG_CONFIG_HOME/Desktop. If $XDG_CONFIG_HOME	is not set, it
       will revert to: $HOME/Desktop.

OPTIONS
       -h, --help
	   Show	help message and quit.

       -v, --version
	   Show	version	and quit.

       -f, --file <file>
	   A PNG file to load for editing.

	   If set to -,	read the file from standard input instead. This	is
	   grim	friendly.

       -o, --output-file <file>
	   Print the final surface to <file> when exiting the application.

	   If set to -,	prints the final surface to stdout.

	   Note	that the Save button will save the image to the	config
	   save_dir parameter, as described in the DESCRIPTION section.

CONFIG FILE
       The config file is located at $XDG_CONFIG_HOME/swappy/config or at
       $HOME/.config/swappy/config. The	file follows the GLib conf format.

		[Section]
		key=value

       The following lines can be used as swappy's default:

		[Default]
		save_dir=$HOME/Desktop
		show_panel=false
		line_size=5
		text_size=20
		text_font=sans-serif

       o   save_dir is where swappshots	will be	saved, can contain env vari-
	   ables and must exist	in your	filesystem
       o   show_panel is used to toggle	the paint panel	on or off upon startup
       o   line_size is	the default line size (must be between 1 and 50)
       o   text_size is	the default text size (must be between 10 and 50)
       o   text_font is	the font used to render	text, its format is pango
	   friendly

KEY BINDINGS
   LAYOUT
       o   Ctrl+b: Toggle Paint	Panel

   PAINT MODE
       o   b: Switch to	Brush
       o   t: Switch to	Text
       o   r: Switch to	Rectangle
       o   o: Switch to	Ellipse
       o   a: Switch to	Arrow
       o   d: Switch to	Blur (d	stands for droplet)

       o   R: Use Red Color
       o   G: Use Green	Color
       o   B: Use Blue Color
       o   C: Use Custom Color
       o   Minus: Reduce Stroke	Size
       o   Plus: Increase Stroke Size
       o   Equal: Reset	Stroke Size
       o   k: Clear Paints (cannot be undone)

   HEADER BAR
       o   Ctrl+z: Undo
       o   Ctrl+Shift+z	or Ctrl+y: Redo
       o   Ctrl+s: Save	to file	(see man page)
       o   Ctrl+c: Copy	to clipboard
       o   Escape or q or Ctrl+w: Quit swappy

AUTHORS
       Written and maintained by jtheoof <contact@jtheoof.me>. See
       https://github.com/jtheoof/swappy.

				  2020-08-31			     swappy(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | CONFIG FILE | KEY BINDINGS | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=swappy&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help