Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
apps:xfce4-screenshooter:usage [2024/02/05 22:03] – [After capturing] andreldmapps:xfce4-screenshooter:usage [2026/11/22 16:17] (current) – Update the introduction epetriglia
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
-{{ :xfce:xfce.screenshooter.png?no link|}}+{{ :apps:xfce4-screenshooter.png?nolink|}}
 ====== xfce4-screenshooter - Usage ====== ====== xfce4-screenshooter - Usage ======
  
 +xfce4-screenshooter can be used in two ways: through its graphical user interface (GUI), or from a terminal with command-line options (CLI). The GUI is described in the sections [[#Open the user interface|Open the user interface]], [[#Taking a screenshot|Taking a screenshot]] and [[#After capturing|After capturing]]. The [[#Command-line options|Command-line options]] section explains how to use it from a terminal, in scripts, or with keyboard shortcuts.
 +
 +  * **[[#Open the user interface|Open the user interface]]**
   * **[[#Taking a screenshot|Taking a screenshot]]**   * **[[#Taking a screenshot|Taking a screenshot]]**
   * **[[#After capturing|After capturing]]**   * **[[#After capturing|After capturing]]**
-  * **[[#Host on Imgur|Host on Imgur]]**+  * **[[#Hosting on Imgur™|Hosting on Imgur™]]**
   * **[[#Command-line options|Command-line options]]**   * **[[#Command-line options|Command-line options]]**
  
Line 18: Line 21:
 ===== Taking a screenshot ===== ===== Taking a screenshot =====
  
-<figure "Take a screenshot"> +<figure "xfce4-screenshooter Main Dialog Window"> 
-{{:apps:screenshooter:xfce4-screenshooter-dialog1.png?nolink|}}+{{:apps:xfce4-screenshooter:xfce4-screenshooter-main-window.png|xfce4-screenshooter Main Dialog Window}}
 </figure> </figure>
  
Line 33: Line 36:
 ? Select a region ? Select a region
 ! Allows you to select a region to be captured by clicking and dragging a rectangle over the area of screen that you wish to capture, before releasing the mouse button. You can also press Ctrl while dragging to move the rectangle. ! Allows you to select a region to be captured by clicking and dragging a rectangle over the area of screen that you wish to capture, before releasing the mouse button. You can also press Ctrl while dragging to move the rectangle.
-? Capturing the pointer +? Capture the mouse pointer 
-! The {gui>Capture the mouse pointer} option allows you to select whether or not the screenshot will include the mouse pointer.+! This option allows you to select whether the screenshot will include the mouse pointer. 
 +? Capture the window border 
 +! This option allows you to select whether the screenshot will include the window border. Only available for the Active window region. 
 + 
 +For an explanation about {gui>Preferences}, please consult [[apps:xfce4-screenshooter:custom-actions|Custom Actions]].
  
----- 
  
 ==== Delay before capturing ==== ==== Delay before capturing ====
Line 50: Line 56:
 After pressing the {gui>OK} button a second window will be displayed:  After pressing the {gui>OK} button a second window will be displayed: 
  
-<figure "Action"> +<figure "xfce4-screenshooter Action Window"> 
-{{:apps:screenshooter:xfce4-screenshooter-dialog2.png?nolink|}}+{{:apps:xfce4-screenshooter:xfce4-screenshooter-after-screenshot.png|xfce4-screenshooter Action Window}}
 </figure> </figure>
  
Line 60: Line 66:
 ==== Action ==== ==== Action ====
  
-The {gui>Action} section allows you to choose what should be performed on the screenshot.+The {gui>Action} section allows you to choose what should be performed on the screenshot. Select one of the actions listed below, then press the {gui>OK} button to apply it.
  
 ? Save ? Save
-! The {gui>Save} option will save the screenshot to a PNG file. A save dialog will be displayed. You will be able to set the save location, and the name of the file. +! The {gui>Save} option will save the screenshot to a file. A save dialog will be displayed. You will be able to set the save location, the name of the file and its format (PNG, JPEG, BMP and, if the corresponding pixbuf loaders are installed, WebP, JPEG XL and AVIF). 
-! Xfce4 Screenshooter is also able to save the screenshot to any remote file system supported by GVfs, such as FTP, SAMBA, SFTP, remote computers accessible via SSH... You just need to connect this remote file system using gvfs-connect or Gigolo and it will be available in the left column of the save dialog.+! xfce4-screenshooter is also able to save the screenshot to any remote file system supported by GVfs, such as FTP, SAMBA, SFTP, remote computers accessible via SSH... You just need to connect this remote file system using gvfs-connect or Gigolo and it will be available in the left column of the save dialog.
 ? Copy to the clipboard ? Copy to the clipboard
 ! The {gui>Copy to the clipboard} option allows you to paste the screenshot in another application, such as a word processor. This option is only available when a clipboard manager is running. ! The {gui>Copy to the clipboard} option allows you to paste the screenshot in another application, such as a word processor. This option is only available when a clipboard manager is running.
 ? Open with ? Open with
 ! The {gui>Open with} option saves the screenshot to the system's temporary directory and opens it with the application chosen from the drop-down list. Applications which support images are automatically detected and added to the drop-down list. ! The {gui>Open with} option saves the screenshot to the system's temporary directory and opens it with the application chosen from the drop-down list. Applications which support images are automatically detected and added to the drop-down list.
-? Host on Imgur +? Custom Action 
-! The {gui>Host on Imgur} option allow you to host your screenshot on this free online hosting service, so that you can share it easily with other people. Imgur automatically generates a tiny, medium, and full-size image of your screenshot, which can be used to create thumbnails pointing to the full size screenshot.+! The {gui>Custom Action} saves the screenshot to the system's temporary directory and executes the custom action chosen from the drop-down list. Custom Actions are defined in the Preferences dialog, for more details see [[apps:xfce4-screenshooter:custom-actions|Custom Actions]].
  
-<note important>This action is deprecated and will be removed in future releases, please use a custom action if you need to upload screenshots to Imgur or any other hosting provider..</note>+[[|Back to Top]] 
 +----
  
-<note important>Hosting images in a public-facing service must be done with caution, as it is not possible to guarantee the removal of a image after publishing it. Before using this action, please review Imgur's [[https://imgur.com/tos|Terms of service]], if you do not agree with the terms please refrain from using this service.</note>+===== Hosting on Imgur™ =====
  
-! Since 1.9.9 a hidden option is available to toggle the visibility of "Host on Imgur" in the action list, useful for whoever wants to avoid accidental usages. This option is called ''enable_imgur_upload'', accepts ''true'' or ''false'' as value and can be defined in ''~/.config/xfce4/xfce4-screenshooter''. Notice that your distribution may set this option to ''false'' by default.+As of the Xfce 4.18 release this option has been removed. Alternatively, the same feature can be accomplished using a configurable [[:apps:xfce4-screenshooter:custom-actions#host_on_imgur|custom action]].
  
 [[|Back to Top]] [[|Back to Top]]
 ---- ----
  
-===== Host on Imgur =====+===== Command-line options =====
  
-After selecting {gui>Host on Imgur} and pressing the {gui>OK} button, you will be shown this dialog:+xfce4-screenshooter can also be run from a terminal, which lets you take screenshots quickly without going through the main dialog. Command-line options are also useful to bind the Print Screen key to xfce4-screenshooter: configure the keyboard shortcuts of your desktop environment (for example with xfce4-keyboard-settings) so that pressing Print Screen launches xfce4-screenshooter with one or more of the options below.
  
-<figure "Imgur image link"> +Run ''%%xfce4-screenshooter --help%%'' to see the list of options supported by your installed version.
-{{:apps:screenshooter:xfce4-screenshooter-imgur-link-dialog.png?nolink|}} +
-</figure>+
  
-The dialog below will give you the links to the full size screenshot, the large thumbnail, the small thumbnails, as well examples of HTML, Markdown and BBcode to create a thumbnail pointing to the full size screenshot: +==== Region to capture ====
  
-<figure "Imgur Embed into code dialog"> +These options select what to capture. Only one of them can be given at a time. Without any of them, the main dialog is shown and most of the other options are ignored.
-{{:apps:screenshooter:xfce4-screenshooter-imgur-embed-dialog.png?nolink|}} +
-</figure>+
  
-The dialog below will give you the links to delete the image off of the Imgur website. The link will only be shown once. Make sure to save it if you think you might be deleting this image: +? -f, --fullscreen 
 +! Takes a screenshot of the entire screen. 
 +? -w, --window 
 +! Takes a screenshot of the active window. 
 +? -r, --region 
 +! Lets you select the region to capture by clicking and dragging a rectangle over the area of the screen that you wish to capture, then releasing the mouse button. Press Ctrl while dragging to move the rectangle, or Esc to cancel.
  
-<figure "Imgur deletion dialog"> +==== Capture options ====
-{{:apps:screenshooter:xfce4-screenshooter-imgur-deletion-dialog.png?nolink|}} +
-</figure>+
  
-Linking images of Imgur accounts is not currently supported.+These options only have an effect when -f, -w or -r is given.
  
-[[|Back to Top]] +? -d, --delay SECONDS 
-----+! Waits the given number of seconds before taking the screenshot. With -r, the delay starts after the region has been selected. 
 +? -m, --mouse 
 +! Includes the mouse pointer in the screenshot. 
 +? --no-border 
 +! Removes the window border from the screenshot. Only meaningful together with -w.
  
-===== Command-line options =====+==== Actions ==== 
 + 
 +These options select what to do with the screenshot and only have an effect when -f, -w or -r is given. If no action is given, the [[#After capturing|action window]] is shown after the capture. 
 + 
 +? -s, --save PATH 
 +! Saves the screenshot without showing any dialog. PATH can be a directory, in which case a file name is generated automatically, or a full file path. The format is chosen from the file extension: png, jpg (or jpeg) and bmp are always supported, while webp, jxl and avif require the corresponding pixbuf loaders to be installed (see ''%%--supported-formats%%''). 
 +? -S 
 +! Shows the saved screenshot in the file manager. Only has an effect together with -s. 
 +? -o, --open COMMAND 
 +! Saves the screenshot to the system's temporary directory and opens it with COMMAND, for example ''-o gimp''. The path of the screenshot is appended to the command. Cannot be used together with -s. 
 +? -c, --clipboard 
 +! Copies the screenshot to the clipboard. Can be combined with -s or -o. 
 + 
 +==== Other options ====
  
-Command line options allow you to take screenshots quickly. They also allow you to configure the Print Screen key on the upper right of most keyboards so that it takes screenshots. To do so, configure the key-bindings of your desktop environment so that it launches xfce4-screenshooter with one or several of the following options when the Prt Scrn key is pressed.+? --supported-formats 
 +! Lists the supported image formats and exits. The results depend on the installed pixbuf loaders. All other options are ignored. 
 +? -V, --version 
 +! Prints the version and exits. 
 +? -h, --help 
 +! Lists all the available options and exits.
  
-==== The command line options ====+==== Notes ====
  
-? The -w option +  * Conflicting options, such as two of -f, -w and -r, or -s together with -o, make xfce4-screenshooter print an error and exit. 
-! The -w option allows you to take a screenshot of the active window. +  * Options that are ignored because -f, -w or -r is missing produce a warning on the terminal. 
-? The -f option +  * When an action is given on the command line, xfce4-screenshooter runs non-interactively: errors are printed to the terminal and the program exits with a non-zero status, which makes it suitable for scripts.
-! The -f option allows you to take a screenshot of the entire screen. +
-? The -r option +
-! The -r option allows you to select a region to be captured by clicking and dragging a rectangle over the area of screen that you wish to capture, before releasing the mouse button. +
-? The -d option +
-! The -d option followed by a positive integer allows you to set the delay before taking the screenshot when the -w, the -f or the -r option is given. +
-? The -s option +
-! The -s option followed by the path to an existing folder allows you to set where the screenshots are saved. This option only has an effect if the -w, the -f or the -r option is given. +
-? The -o option +
-! If the -o option is given, followed by an application name, the screenshot will be saved to the system's temporary directory and opened with the application whose name is to be given after -o. This option only has an effect if the -w, the -f or the -r option is given. +
-? The -u option +
-! If the -u option is given, the screenshot will be hosted on Imgur. See above for more details. This option only has an effect if the -w, the -f or the -r option is given.+
  
-===== Command-line examples =====+==== Command-line examples ====
  
-Here is a small collection of examples demonstrating what is possible to accomplish with little shell-fu and some creativity. +Here is a small collection of examples demonstrating what is possible to accomplish with a little shell-fu and some creativity. Some of the commands below come from feature requests for very specific solutions, which would bloat xfce4-screenshooter's UI but are easy to achieve from the command line.
-Some of the commands below were extracted from feature requests to add very specific solutions, which would bloat xfce4-screenshooter's UI but are easily doable with command line.+
 For increased convenience, it is also possible to assign keyboard shortcuts to commands with the help of xfce4-keyboard-settings or add launchers to xfce4-panel. For increased convenience, it is also possible to assign keyboard shortcuts to commands with the help of xfce4-keyboard-settings or add launchers to xfce4-panel.
  
Line 144: Line 160:
 [[|Back to Top]] [[|Back to Top]]
 ---- ----
-[[:apps:xfce4-screenshooter:start:|Back to xfce4-screenshooter main page]]+ 
 +[[:apps:xfce4-screenshooter:start:|Return to xfce4-screenshooter Main Documentation Page]]