# ScreenGrab

version 1.2.1

## 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 Microsoft Windows and GNU/Linux environments.

Main features:

- Works in Windows & Linux
- Get desktop screenshots
- Get active window screenshots
- Get screenshots of selected desktop areas
- Copy screenshots into the clipboard
- Save your image files in PNG, JPEG or BMP format
- Ability to view and edit screenshots in an external editor
- Ability to upload screenshots on several image hosting services (currently ScreenGrab supports mediacru.sh, imgur.com and imageshack.us, in the future, the list will be expanded)
- 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 filename and save

## 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 SreenGrab, 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 hard disk (in PNG or JPEG format).
- Copy Screen [Ctrl+C] -- copy screen to the clipboard.
- Edit in ... - the ability to 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, developer and license.
- Quit [Ctrl+Q] -- Exit program

These buttons can be accessed via right-click on the ScreenGrab icon in the systemtray 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 -- name of saved file by default.
- Format -- default saving image format (you can select other format in saving)
- No window decoration -- grab screenshot of active window without window decorations (only for linux version).

Advanced settings:

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

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

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

  Parameter | Output
  --- | ---
  h | the hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display)
  hh | the hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display)
  H | the hour without a leading zero (0 to 23, even with AM/PM display)
  HH | the hour with a leading zero (00 to 23, even with AM/PM display)
  m | the minute without a leading zero (0 to 59)
  mm | the minute with a leading zero (00 to 59)
  s | the second without a leading zero (0 to 59)
  ss | the second with a leading zero (00 to 59)
  z | the milliseconds without leading zeroes (0 to 999)
  zzz | the 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 saving screenshot in grab process
- Save first screenshot -- enabled | disabled automatically saving 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 ability for preview screenshot in default image viewer (by double click on screenshot area in the main window).

Display settings:

- Save window size on exit -- saving the current size of main window when exiting ScreenGrab (and restore it at next run)
- Zoom area around mouse in selection mode -- the ability to 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 main window in to the systemtray by click on the close window button.

shortcuts settings:

On the tab "Shortcuts" in the options window you can set keyboard shortcuts for quick accessing application functions. 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 working with another application in your operating system.

Command line parameters:

- --fullscreen -- set fullscreen mode [default].
- --active -- set active window mode.
- --region -- set screen region select mode.
- --minimized -- run minimized to 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.1:

- Added configuration option for url to mediacru.sh uploader and set "Imgur" as defalt host for uploading (backport from v2.0).
- Fixed regression with too small preview of the first screenshot.

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)

x 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.