`dmenu_shot` provides a menu with set of custom commands to perform some simple automated image manipulation on screenshots taken using Flameshot, and then putting them into clipboard.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Mehrad Mahmoudian 2abc147b49 [update] contribution guidelines was updated 2 months ago
assets [add] the scale functionality was added 2 months ago
docs [update] contribution guidelines was updated 2 months ago
.editorconfig [add] the EditorConfig file (.editorconfig) was added 5 months ago
LICENSE Initial commit 5 months ago
Makefile [add] aliases were add to Makefile targets to make them more user-friendly 4 months ago
README.md [style] added some HTML tags to the README for aesthetics 5 months ago
dmenu_shot.sh [add] the scale functionality was added 2 months ago

README.md

dmenu_shot

dmenu_shot screenshot

The idea is to have a clean and easy to use dmenu menu to do some basic image manupulation using ImageMagic on the output of Flameshot.

The actions it can do:

  • Trim the extra white space from around the screenshot
  • Remove_white background and make it transparent
  • Negative the colors
  • Bordered the screenshot with 3 pixel-wide read line

To see what it does, check out the actions.


Table of Content


How to use

After installation (which is basically copying a shell file to your PATH), you can either use the dmenu_shot command in terminal or bind this command to a keyboard shortcut. If you don't know how, click on your Desktop Environment:


Dependencies

This script expects the user to have the following softwares installed:

  • Flameshot
  • dmenu (it can be custom built but should be available in the PATH)
  • ImageMagic (specifically the convert command
  • xclip
  • make (This is only a dependency for automatic installation)

If you have the make installed, you can check what dependencies are installed and which ones are missing using:

make check

Installation

Automatic Installation

When you have installed all the dependencies, simply do:

  1. Clone this repo or download and extract the zip file
# To clone the repo
git clone https://codeberg.org/mehrad/dmenu_shot.git 

OR

# To download the ZIP file
wget https://codeberg.org/mehrad/dmenu_shot/archive/master.tar.gz
gunzip --keep dmenu_shot-master.tar.gz
  1. Install using the Makefile:
cd dmenu_shot
make install

This will install the dmenu_shot to ~/.local/bin (so it will NOT install it system-wise and will be only installed for the current user). This makes the command dmenu_shot be usable in your terminal. All you need to do is to close your terminal and open it again and run dmenu_shot.

Manual Installation

  1. Clone this repo or download and extract the zip file
# To clone the repo
git clone https://codeberg.org/mehrad/dmenu_shot.git 

OR

# To download the ZIP file
wget https://codeberg.org/mehrad/dmenu_shot/archive/master.tar.gz
gunzip --keep dmenu_shot-master.tar.gz
  1. Copy the file to the location you want. I suggest ~/.local/bin:
cd dmenu_shot
cp dmenu_shot.sh ~/.local/bin/dmenu_shot

Uninstall

If you have automatically installed dmenu_shot, you can easily remove/uninstall it automatically as well:

make remove

Commands

This is a dmenu script and user does not need to insteract with it using the command line, but just in case, a very short help is available using --help or -h.


Contribution

To prevent this page to get lengthy, I moved the content of this part to contribute page.