# ScreenGrab

version 1.0

## ScreenGrab - fast creation of screenshots

ScreenGrab is a crossplatform application designed to quickly get screenshots. ScreenGrab is based on the Qt Framework, which allows the program to be used in GNU/Linux and Microsoft Windows environments.

Main features:

- Supports Linux & Windows
- Get desktop screenshots
- Get active window screenshots
- Get screenshots of selected desktop areas
- Copy screenshots into the clipboard
- Save your image files in PNG or JPEG format
- Ability to view and edit screenshots in an external editor
- Ability to upload screenshots to MediaCrush and imgur
- Ability to set delay before getting screenshots (from 1 to 90 seconds)
- Hide the main window (with recovery) at the time of the screenshot
- Ability to minimize ScreenGrab to the system tray, and control it via a context menu
- Getting screenshots using global shortcuts
- Auto-save screenshot when captured
- Ability to insert the current date and time in the filename when saving it

## Usage To start page

It is very simple.

On the first run ScreenGrab captures the current state of your desktop. The preview screen is displayed in the main window. All management of the program can be carried out through the buttons in the main window or in the context menu of ScreenGrab, which can be accessed by a right-mouse-click on the ScreenGrab icon in the notification area of the desktop.

Buttons in main window:

- New Screen [Ctrl+N] -- Take a new screenshot
- Save Screen [Ctrl+S] -- Write a captured screenshot on your hard disk (in PNG or JPEG format).
- Copy Screen [Ctrl+C] -- Copy a screenshot to the clipboard.
- Edit in ... -- Open and edit screenshots in an image editor.
  NOTE: In the current version for Microsoft Windows only MS Paint is supported.
- Options [Ctrl+O] -- Show program options window.
- Help [Ctrl+H] -- Access help and information about ScreenGrab, its developer and license.
- Quit [Ctrl+Q] -- Exit ScreenGrab

These buttons can be accessed via right-click on the ScreenGrab icon in the system tray menu as well.

Additional controls, located in main window.

- Delay -- Delay in seconds before grabbing the screen.
- Type -- Type of grabbing [full screen or active window].

Main settings:

- Default directory -- Default directory to save screenshots
- Default filename -- Default name of the saved file
- Format -- Default saving image format (you can select other formats)
- No window decoration -- Grab a screenshot of the active window without window decorations (only for Linux version).

Advanced settings:

- Insert DateTime in filename -- Insert date and time in the filename to be saved
  These expressions may be used for the date part of the format string:

  Parameter | Output
  --- | ---
  d | Day as number without a leading zero (1 to 31)
  dd | Day as number with a leading zero (01 to 31)
  ddd | Abbreviated localized day name (e.g. 'Mon' to 'Sun').
  dddd | Long localized day name (e.g. 'Monday' to 'Sunday').
  M | Month as number without a leading zero (1-12)
  MM | Month as number with a leading zero (01-12)
  MMM | Abbreviated localized month name (e.g. 'Jan' to 'Dec').
  MMMM | Long localized month name (e.g. 'January' to 'December').
  yy | Year as two digit number (00-99)
  yyyy | Year as four digit number

  These expressions may be used for the time part of the format string:

  Parameter | Output
  --- | ---
  h | Hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display)
  hh | Hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display)
  H | Hour without a leading zero (0 to 23, even with AM/PM display)
  HH | Hour with a leading zero (00 to 23, even with AM/PM display)
  m | Minute without a leading zero (0 to 59)
  mm | Minute with a leading zero (00 to 59)
  s | Second without a leading zero (0 to 59)
  ss | Second with a leading zero (00 to 59)
  z | Milliseconds without leading zeroes (0 to 999)
  zzz | Milliseconds with leading zeroes (000 to 999)
  AP or A | Interpret as an AM/PM time. AP must be either "AM" or "PM".
  ap or a | Interpret as an AM/PM time. ap must be either "am" or "pm".

- Autosave screen -- Automatically save the screenshot in the grab process
- Save first screenshot -- enabled | disabled automatically saves the first screenshot, which is captured on program start
- Filenames to clipboard on saving -- Send the name of the saved file to the clipboard . You can select these parameters:

- No copy - The name of saved file will not be transferred to the clipboard.
- Only filename - Send only the file name to the clipboard.
- Full path to file - Send the full path to the file to the clipboard.

- Allow multiple copies -- Allow run multiple copies of ScreenGrab.
- Enable external viewer -- Enable or disable the preview of the screenshot in the default image viewer (by double click on screenshot area in the main window).

Display settings:

- Save window size on exit -- Save the current size of main window when exiting ScreenGrab (and restore it at next run)
- Zoom area around mouse in selection mode -- Display the magnified area around the mouse pointer when receiving a screenshot of a selected area.

System tray settings:

- Use tray -- Use the notification area (system tray) of the operating system (desktop environment) for displaying messages and application management.
- Tray messages -- Mode of displaying tray messages on grab|save events. Can be "none" or "if hidden" or "always"
- Time to display tray messages -- Time within a specific notification is displayed
- Close in tray -- Minimize the main window into the system tray by click on the close window button.

Shortcut Settings:

On the tab "Shortcuts" in the options window you can set the keyboard shortcuts, which allows you to access the application functions easily. There are two kinds of key combinations used in ScreenGrab - local and global.

Local duplicate actions performed by pressing the button in the main window. They will only work when the ScreenGrab main window is active.

Global shortcuts can be used the get a new screenshot when you have opened other application windows.

Command line parameters:

- --fullscreen -- Set the fullscreen mode [default].
- --active -- Set the active window mode.
- --region -- Set the screen region select mode.
- --minimized -- Open ScreenGrab minimized in the tray (or taskbar, if tray is disabled).
- --upload -- Automatically upload a screenshot to the selected image hosting service and display the direct link to the image after completion.
- --version -- Display version information [Linux only].
- --help -- Display command line parameters information [Linux only].

## License To start page

Copyright:

Artem 'DOOMer' Galichkin doomer3d@gmail.com

License:

ScreenGrab is a freeware licensed by GNU General Public License version 2

Thanks to:

Translators:

- Marcio Moraes -- Brazilian Portuguese translation
- Gennadi Motsyo -- Ukrainian translation

Beta-testers:

- Alexantia
- iNight

And all those who use ScreenGrab :)

## Version history To start page

Version 1.2:

- Added ability for autosaving type of the last created screenshot.
- Some small fixes.

Version 1.1.1:

- Fixed wrong 'imgur' uploading result string for bb-code with preview.
- Fixed segfault when exist configuration file contains "showTrayIcon=false".

Version 1.1:

- Added ability to upload to MediaCrush (http://mediacru.sh).
- Option "Always save the window size" replaced by "autosave window size on exit ScreenGrab".
- Reworked main window UI (the order of the buttons).
- Reworked the configuration dialog (some UI elements moved between sections, and increment count of the sections).

Version 1.0:

- Fixed dual monitor support
- Added XDG_CONFIG_HOME support, by a build option SG_XDG_CONFIG_SUPPORT
- Added ability to upload to some image hosting services (imgur.com and imgshack.us)
- Added build option for compiling without the upload feature (SG_EXT_UPLOADS build option)
- Added "Previous selection" mode
- Added ability to edit a screenshot in an external editor
- Added option for preview screenshot in default image viewer by double click on screenshot area
- Fixed non-minimize main window on "Exit" shortcut, when using "Minimize to tray" option
- Fixed bug with cutting button text on main window
- Fixed regression with not capture screenshot when a second instance of ScreenGrab is running
- Fixed bug with not creating the path to autosave screenshots (when it is typed in manually in configuration dialog)
- Added build option SG_GLOBALSHORTCUTS for turning on/off build with global shortcuts support
- Autoincrement filenames when saving screenshots in manual mode (in one running session)
- Added the ability to customise shortcuts to close the application
- Added ability to run ScreenGrab minimized to tray (or taskbar, if tray is disabled) with "--minimized" command line option
- Added ability to automatically upload the screenshot via the command line "--upload" parameter

Version 0.9.1:

- Fixed non-switching combo-box "Type of Screeen" when grab screenshot from signal by another instance
- Fixed incorect grab active window screens in GNOME (when disabled "Allow multiple copies" option and run another instance)

Version 0.9:

- added global shortcuts
- added option for enable|disable system tray
- added switch to the already running instance of an application when you start a second instance (non-operating mode to allow multiple instances)
- added autosave first screenshot which has been taken on application start (enabled | disabled optional)
- redesign config dialog UI

Version 0.8.1:

- [Linux] fixed incorrect selection of the default saving format in the KDE 4.4.x save file dialog
- added de_DE translation

Version 0.8:

- added command line parameters for grab modes (fullscren, active window, selection area)
- added BMP support
- added Brazilian Portuguese translation
- added automatically hiding main window on grab process
- [Linux] fixed grab active window screenshot without decorations
- [Linux] add option "no window decoration"
- added shortcuts for main window buttons

Version 0.6.2 [Linux only]:

- fixed non-translated tray menu (closed issue #7)

Version 0.6.1 [Linux only]:

- fixed incorrect detection of the system language in some Linux distributions

Version 0.6:

- default value of hiding main window changed to true
- added input template for inserting date-time into the saved filename
- added zoom around mouse cursor in area selection mode
- small modifications of the configuration dialog
- added html help info (English & Russian)

Version 0.5:

- added inserting date|time in saving filename [optional]
- added auto saving screenshots in grabbing process [option]
- added option to change the time of displaying tray messages [1 - 10 sec]
- added help info
- added tool tips for the UI elements
- small fixes config file syntax

Version 0.4:

- added grabbing selection screen area
- added ability to copy image files into the clipboard
- added saving size of main window on exit [default is turned off]
- halve the memory size occupied by ScreenGrab at startup
- [win32] fixed bug with storing the screengrab.ini file
- change structure of some source code (work with config data)
- change buttons tab order of main window
- new application icon
- some fixes

Version 0.3.1:

- fixed bug with non-displayed main window icon

Version 0.3:

- main window is now based on ui-file (remaked UI)
- added grabbing active window
- added option to allow running multiple instances of ScreenGrab
- added option to select between minimizing to tray and closing (by close window button).

Version 0.2:

- added JPEG support
- added options dialog
- added option to select a default directory for saving the files
- added option to select a default filename
- added option to select a default image format
- added saving options into INI-file
- added i18n support and Russian localisation
- some fixes and changes in code
- now available as installer (Windows) and deb packages (Ubuntu 9.04)

Version 0.1:

- first public version
- added system tray icon and menu
- added option to hide ScreenGrab in systray
- added option to block running a second instance of ScreenGrab

Version 0.0.3:

- first working build with minimal features.