Skip to content

Customizing Config File

xShin edited this page Apr 2, 2022 · 25 revisions

The awesomeshot config file contains a variable which gives you total freedom over customizing how image is edited.

Table of Contents

Config File Location

The awesomeshot config file is $HOME/.config/awesomeshot/awesomeshot.conf and awesomeshot will generate default config on first run.

NOTE: Awesomeshot will not replace the config file if already exists, if you want back to default config you can regenerate with argument -c or --config, it will ask Do you want to generate default config [y/N] if config already exists.

awesomeshot -c

Screenshot Result PATH

NOTE: This variable work for argument -a or --auto. Make sure when your phone take screenshot the result file image PATH is same with this variable. Default my phone screenshot result image PATH on /sdcard/Pictures/Screenshots. If not same, edit this variable value

You can check you default screenshot PATH by:

  1. Take Screenshot
  2. Go to Gallery
  3. Select album Screenshot
  4. Select the last image
  5. Click menu detail info

doc_2022-04-02_22-45-37

Backup Screenshot File

This variable serves to function to backup original photo (screenshot result), change this value to blank or whatever for disable function and "yes" for enable function

backup="yes"

Backup PATH

This variable serves to set the original photo backup PATH

path_backup="${HOME}/.config/awesomeshot/backup"

Convert

This variable is option for imagemagick execute

Rounded Corner

This variable serves to convert rounded corner, change this value to blank or whatever for disable convert and "yes" for enable function

convert_rounded="yes"

This variable serves to set how many rounded corners

border_radius=10

2022-04-02_23-02

Border

This variable serves to convert border (background image) when editing the image, change this value to blank or whatever for disable convert and "yes" for enable function

convert_border="yes"

Border Color

This variable serves to set border color (background image), change this value to "none" for a transparent background, if you want to custom the color, you can change this value with a hex color or use the one in the array list.

border_color="${hex_color[0]}"

For example I change the Hex Color to Blue Sky by changing the index array list to ${hex_color[3]} or #A8D7FE

White Blue Sky
neofetch neofetch2

Border Size

This variable serves to set how many size of the border

border_size=50

For example I change the value to lower, it will give minimize background-size

50 15
neofetch2 neofetch2-15

Shadow

This variable serves to convert the shadow of image, change this value to blank or whatever for disable function and "yes" for enable function.

convert_shadow="yes"

Shadow Color

This variable serves to set shadow color, if you want to custom the color, you can change this value with hex color or use the one in the array list.

shadow_color="${hex_color[1]}"

For example I switch color between border-color and shadow-color

Border-Color White with Shadow-Color Black Border-Color Black with Shadow-Color White
neofetch neofetch-black
  • First Image:
border_color="${hex_color[0]}"
shadow_color="${hex_color[1]}"
  • Second Image:
border_color="${hex_color[1]}"
shadow_color="${hex_color[0]}"

Shadow Size

This variable serves to set shadow size, this variable has four values:

shadow_size="75x30+0+30"

that mean:

  • the bottom shadow is x75
  • the right shadow is +30
  • the top shadow is +0
  • the left shadow is +30

shadow-size

Footer

This variable handle watermark image

Footer Text

This value display text or watermark on the image

Default value :  Shot by Awesomeshot

image

Footer Position

This variable is to define the position value on the footer, the value contain 8 wind direction.

  • NorthWest
  • North
  • NortEast
  • West
  • Center
  • East
  • SouthWest
  • South
  • SouthEast

Default value South

Footer XY

This variable serves to set the position of X and Y

The first value to define X and the second value to define Y Default value +0+45

Footer Font

This variable is define font.

You can check list font by command magick convert -list font | grep -iE 'font:.*'

Default value is JetBrains-Mono-Medium-Nerd-Font-Complete

image

Footer Font Size

This variable set font weight

Default value is 30

Footer Foreground

This variable set foreground color font

Default value is #000000

Footer Background

This variable set background color font

Default value is none

Convert File Screenshot to PNG

ImageMagick requires a PNG file type to be able to convert, make sure if your default screenshot is not PNG you have to enable this variable

Default value is yes

Open Image After Image Edited

awesomeshot will open the image after convert using imagemagick with Termux:API command termux-open

Default value is yes

Clone this wiki locally