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 23:04] – [The command line options] Updates 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 53: | 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 63: | 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> | ||
| Line 73: | Line 76: | ||
| ! The {gui> | ! The {gui> | ||
| ? Custom Action | ? Custom Action | ||
| - | ! The {gui> | + | ! The {gui> |
| - | ? Host on Imgur | + | |
| - | <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 |
| - | {{: | + | |
| - | </ | + | |
| - | + | ||
| - | Linking images of Imgur accounts is not currently supported. | + | |
| - | + | ||
| - | [[|Back to Top]] | + | |
| - | ---- | + | |
| - | + | ||
| - | ===== Command-line 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. | + | |
| - | + | ||
| - | ==== The command line options ==== | + | |
| - | + | ||
| - | ? The -w option | + | |
| - | ! The -w or --window option allows you to take a screenshot of the active window. | + | |
| - | ? The -f option | + | These options only have an effect when -f, -w or -r is given. |
| - | ! The -f or --fullscreen option allows you to take a screenshot of the entire screen. | + | |
| - | ? The -r option | + | ? -d, --delay SECONDS |
| - | ! The -r or --region 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 | + | ! Waits the given number of seconds before taking the screenshot. With -r, the delay starts after the region has been selected. |
| + | ? -m, --mouse | ||
| + | ! Includes | ||
| + | ? --no-border | ||
| + | ! Removes the window border from the screenshot. Only meaningful together with -w. | ||
| - | ? The -d option | + | ==== Actions ==== |
| - | ! The -d or --delay option followed by a positive integer allows you to set the delay before taking the screenshot when the -w, -f or -r option is given. | + | |
| - | ? The -s option | + | These options select what to do with the screenshot |
| - | ! The -s or --save option followed by the path to an existing folder allows you to set where the screenshots are saved. The filename | + | |
| - | ? The -S option | + | ? -s, --save PATH |
| - | ! If the -S or --save option | + | ! 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. | ||
| + | ? -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 -o option | + | ==== Other options ==== |
| - | ! If the -o or --open option is given, followed by an application name, the screenshot will be saved to the system' | + | |
| - | ? The -i option | + | ? --supported-formats |
| - | ! If the -i or --imgur option is given, | + | ! Lists the supported image formats and exits. The results depend on the installed pixbuf loaders. All other options are ignored. |
| + | ? -V, --version | ||
| + | ! Prints | ||
| + | ? -h, --help | ||
| + | ! Lists all the available options and exits. | ||
| - | ? The -c option | + | ==== Notes ==== |
| - | ! If the -c or --clipboard option is given, the screenshot will be copied to the system clipboard. This option only has an effect if the -w, -f or -r option is given. | + | |
| - | ? The --no-border option | + | * Conflicting options, such as two of -f, -w and -r, or -s together with -o, make xfce4-screenshooter print an error and exit. |
| - | ! If the --no-border option | + | * Options that are ignored because |
| + | * When an action | ||
| - | ? The --supported-formats option | + | ==== Command-line examples ==== |
| - | ! If the --supported-formats option is given, all the supported image formats will be listed, results can vary depending on installed pixbuf loaders. This option cancels out the other options, prints the list and the program exits. | + | |
| - | ===== 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 |
| - | Some of the commands below were extracted | + | |
| For increased convenience, | For increased convenience, | ||
| Line 168: | Line 160: | ||
| [[|Back to Top]] | [[|Back to Top]] | ||
| ---- | ---- | ||
| - | [[: | + | |
| + | [[: | ||