Dump My Screen

All those screenshots, no longer lost in time like tears in rain.

Table of Contents

• Features
• Installation
  • Linux
    • Arch Linux
• Usage Guide
  • Functions
    • Take Screenshot
    • Take Screenshot with Previous Region
    • Executing application using flags
  • Options to Save or Copy File
    • Image to Clipboard
    • Save to Folder
    • Custom to Clipboard
  • Flags
    • Screenshot
• Configuration
  • Options
    • Screenshot folder
    • Custom string
    • Show in systray
    • Selected region coordinates
    • No compositor mode

Features

• Lightweight
• Possibility to copy custom command/string to clipboard, together with image path
• Remembers previously selected region, enables taking a new screenshot with same region again
• Configurable
• Can be executed with flags

Installation

Linux

Arch Linux

Link to AUR

Pacman:

sudo pacman -S dumpmyscreen

Yay:

yay -S dumpmyscreen

Usage Guide

As the application is very lightweight and simple, there is not much to be said here. But lets do a quick rundown of the main functionality at least.

Functions

Take Screenshot

This function will trigger the crosshair the you can then use to select an area to screenshot.

Take Screenshot with Previous Region

Takes a screenshot using the coordinates from the previously selected region, when the last screenshot was taken.

Executing application using flags

You can execute the application using flags, currently there is only one flag, but there is a high chance that there will be more in the future.

See the Flags section for further information and examples on how to use it.

Options to Save or Copy File

Image to Clipboard

Saves the image to clipboard, you can then simply paste it into any application that can handle images directly from clipboard.

Save to Folder

This option saves the screenshot to the directory chosen in the configuration, more info on screenshot folder can be found here Screenshot folder

Custom to Clipboard

Flags

Screenshot

The screenshot flag can be used to trigger the "Take screenshot" function directly. This can be useful if you want to take a screenshot using a script or for example bind it to a key in your Window Manager.

Usage:

dumpmyscreen --screenshot

Usage example using i3:

bindsym Print exec dumpmyscreen --screenshot

Configuration

The configuration file is located here:

~/.config/dumpmyscreen/config.conf

Options

Screenshot folder

The folder where all the screenshots will end up.

Default value:

Screenshotfolder = ~/.config/dumpmyscreen/screenshots

Custom string

Whenever "Custom to clipboard" or "CTRL + X" is pressed after taking a screenshot, the string that is saved in the config file, will be used together with the file path of the screenshot.

Example config value:

CustomString = /upload

Will yield:

/upload /home/username/.config/dumpmyscreen/screenshots/screenshot_YYYYMMDD_HHMMSS.png

Show in systray

This option defaults to true, whenever it is set to false, it will hide the icon from the system tray.

Default value:

ShowInSystray = true

Selected region coordinates

This option defaults to empty string, whenever you take a screenshot it will get populated with the coordinates of from the selected area when the user took the screenshot. These coordinates are then used for the "Take Screenshot with Previous Region" function.

This option is not something that needs to be manually configured, but simply a choice by me to use instead of having to store it in a temp file.

Default value:

SelectedRegionCoordinates = ""

No compositor mode

This option defaults to false. Whenever it is set to true, it will mimic the look of what the application would look like after taking a screenshot, on a system that actually has a compositor. So if you for example run a WM without a compositor, after taking a screenshot everything behind the floating window showing the screenshot preview would just be black. Set this to true and it will now show the desktop behind the floating window again. It is a little bit of a hack, so you can choose for yourself if this is for you or not.

If you have a compositor, just leave this at false.

Default value:

NoCompositorMode = false