Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| apps:xfce4-screenshooter:usage [2024/02/05 22:25] – [Action] Sort andreldm | 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 - 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]], | ||
| + | |||
| + | * **[[#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 |
| * **[[# | * **[[# | ||
| Line 18: | Line 21: | ||
| ===== Taking a screenshot ===== | ===== Taking a screenshot ===== | ||
| - | <figure "Take a screenshot"> | + | <figure "xfce4-screenshooter Main Dialog Window"> |
| - | {{: | + | {{:apps:xfce4-screenshooter: |
| </ | </ | ||
| Line 40: | Line 43: | ||
| For an explanation about {gui> | For an explanation about {gui> | ||
| - | ---- | ||
| ==== Delay before capturing ==== | ==== Delay before capturing ==== | ||
| Line 54: | 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 64: | 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> | ||
| - | <note important> | + | [[|Back |
| + | ---- | ||
| - | ! The {gui> | + | ===== Hosting |
| - | + | As of the Xfce 4.18 release | |
| - | <note important> | + | |
| - | + | ||
| - | ! 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 '' | + | |
| [[|Back to Top]] | [[|Back to Top]] | ||
| ---- | ---- | ||
| - | ===== Host on Imgur ===== | + | ===== Command-line options |
| - | After selecting {gui> | + | 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 '' |
| - | {{: | + | |
| - | </ | + | |
| - | 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 |
| - | <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 |
| - | {{: | + | |
| - | </ | + | |
| - | The dialog below will give you the links to delete | + | ? -f, --fullscreen |
| + | ! Takes a screenshot of the entire screen. | ||
| + | ? -w, --window | ||
| + | ! Takes a screenshot of the active window. | ||
| + | ? -r, --region | ||
| + | ! Lets you select | ||
| - | <figure "Imgur deletion dialog"> | + | ==== Capture options ==== |
| - | {{: | + | |
| - | </ | + | |
| - | Linking images of Imgur accounts | + | 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 |
| - | Command line options | + | These options |
| - | ==== The command | + | ? -s, --save PATH |
| + | ! Saves the screenshot without showing any dialog. PATH can be a directory, in which case a file name is generated automatically, | ||
| + | ? -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' | ||
| + | ? -c, --clipboard | ||
| + | ! Copies the screenshot to the clipboard. Can be combined with -s or -o. | ||
| - | ? The -w option | + | ==== Other options ==== |
| - | ! The -w option allows you to take a screenshot of the active window. | + | |
| - | ? The -f option | + | |
| - | ! 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' | + | |
| - | ? 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 ===== | + | ? --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. | ||
| - | Here is a small collection of examples demonstrating what is possible to accomplish with little shell-fu and some creativity. | + | ==== Notes ==== |
| - | Some of the commands below were extracted | + | |
| + | * 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 to accomplish with a little shell-fu and some creativity. Some of the commands below come from feature requests | ||
| For increased convenience, | For increased convenience, | ||
| Line 150: | Line 160: | ||
| [[|Back to Top]] | [[|Back to Top]] | ||
| ---- | ---- | ||
| - | [[: | + | |
| + | [[: | ||