Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| apps:xfce4-screenshooter:usage [2021/02/08 19:38] – update icon kevinbowen | apps:xfce4-screenshooter:usage [2026/11/22 16:17] (current) – Update the introduction epetriglia | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ~~NOTOC~~ | ~~NOTOC~~ | ||
| - | {{ :xfce:xfce.screenshooter.png? | + | {{ :apps:xfce4-screenshooter.png? |
| - | ====== | + | ====== |
| + | 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]], | ||
| + | |||
| + | * **[[#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 |
| - | * **[[#Via command-line|Via command-line]]** | + | * **[[#Command-line options|Command-line options]]** |
| ---- | ---- | ||
| - | ===== Via the user interface ===== | + | ===== Open the user interface ===== |
| To launch the application, | To launch the application, | ||
| Line 18: | Line 21: | ||
| ===== Taking a screenshot ===== | ===== Taking a screenshot ===== | ||
| - | <figure "Take a screenshot"> | + | <figure "xfce4-screenshooter Main Dialog Window"> |
| - | {{: | + | {{:apps:xfce4-screenshooter: |
| </ | </ | ||
| 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 | + | ? Capture |
| - | ! The {gui> | + | ! This option allows you to select whether the screenshot will include |
| + | ? 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> | ||
| - | ---- | ||
| ==== 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 " | + | <figure "xfce4-screenshooter |
| - | {{: | + | {{:apps:xfce4-screenshooter: |
| </ | </ | ||
| Line 60: | Line 66: | ||
| ==== Action ==== | ==== Action ==== | ||
| - | The {gui> | + | The {gui> |
| ? Save | ? Save | ||
| - | ! The {gui> | + | ! The {gui> |
| - | ! Xfce4 Screenshooter | + | ! xfce4-screenshooter |
| ? Copy to the clipboard | ? Copy to the clipboard | ||
| ! The {gui> | ! The {gui> | ||
| ? Open with | ? Open with | ||
| ! The {gui> | ! The {gui> | ||
| - | ? 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 |
| [[|Back to Top]] | [[|Back to Top]] | ||
| ---- | ---- | ||
| - | ===== Host on Imgur ===== | + | ===== Hosting |
| - | After selecting {gui> | + | As of the Xfce 4.18 release this option has been removed. Alternatively, the same feature can be accomplished using a configurable [[: |
| - | <figure "Imgur image link"> | + | [[|Back to Top]] |
| - | {{: | + | ---- |
| - | </ | + | |
| - | 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: | + | ===== Command-line options ===== |
| - | <figure "Imgur Embed into code 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: |
| - | {{:apps:screenshooter: | + | |
| - | </ | + | |
| - | The dialog below will give you the links to delete | + | Run '' |
| - | <figure "Imgur deletion dialog"> | + | ==== Region to capture ==== |
| - | {{: | + | |
| - | </ | + | |
| - | Linking images | + | These options select what to capture. Only one of them can be given at a time. Without any of them, the main dialog |
| - | [[|Back to Top]] | + | ? -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. | ||
| - | ===== Via command-line ===== | + | ==== Capture options |
| - | Command line options | + | These options |
| - | ==== The command line options ==== | + | ? -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. | ||
| - | ? The -w option | + | ==== Actions ==== |
| - | ! The -w option allows you to take a screenshot | + | |
| - | ? The -f option | + | These options select what to do with the screenshot |
| - | ! The -f option allows you to take a screenshot | + | |
| - | ? The -r option | + | ? -s, --save PATH |
| - | ! 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 | + | ! Saves the screenshot without showing any dialog. PATH can be a directory, in which case a file name is generated automatically, |
| - | ? The -d option | + | ? -S |
| - | ! The -d option followed by a positive integer allows you to set the delay before taking | + | ! Shows the saved screenshot |
| - | ? The -s option | + | ? -o, --open COMMAND |
| - | ! The -s option followed by the path to an existing folder allows you to set where the screenshots | + | ! Saves the screenshot |
| - | ? The -o option | + | ? -c, --clipboard |
| - | ! If the -o option is given, followed by an application name, the screenshot will be saved to the system' | + | ! Copies |
| - | ? The -u option | + | |
| - | ! If the -u option | + | ==== Other options ==== |
| + | |||
| + | ? --supported-formats | ||
| + | ! Lists the supported image formats and exits. | ||
| + | ? -V, --version | ||
| + | ! Prints the version and exits. | ||
| + | ? -h, --help | ||
| + | ! Lists all the available options and exits. | ||
| + | |||
| + | ==== Notes ==== | ||
| + | |||
| + | * Conflicting options, such as two of -f, -w and -r, or -s together with -o, make xfce4-screenshooter print an error and exit. | ||
| + | * Options that are ignored because -f, -w or -r is missing produce a warning on the terminal. | ||
| + | * When an action is given on the command line, xfce4-screenshooter runs non-interactively: | ||
| + | |||
| + | ==== Command-line examples ==== | ||
| + | |||
| + | Here is a small collection of examples demonstrating what is possible | ||
| + | For increased convenience, it is also possible to assign keyboard shortcuts to commands with the help of xfce4-keyboard-settings | ||
| + | |||
| + | < | ||
| + | # Take fullscreen screenshot and save to desktop without asking | ||
| + | xfce4-screenshooter -f -s " | ||
| + | |||
| + | # Take screenshots at regular intervals and stop after 8 captures | ||
| + | # repeat | ||
| + | repeat 8 sh -c ' | ||
| + | </ | ||
| [[|Back to Top]] | [[|Back to Top]] | ||
| ---- | ---- | ||
| - | [[: | + | |
| + | [[: | ||