MENYOKI.CONF(5) menyoki manual MENYOKI.CONF(5) NAME menyoki.conf - menyoki configuration file SYNOPSIS $MENYOKI_CONFIG, $HOME/.config/menyoki.conf, $HOME/.config/menyoki/menyoki.conf, $HOME/.config/menyoki/config DESCRIPTION It's possible to override the default command line arguments with a configuration file. It can be specified via --config option or $MENYOKI_CONFIG environment variable. Also, it can be placed to a location where menyoki looks for as default. GENERAL Options that belong to the [general] section. verbose Increase logging verbosity quiet Do not show output color Set the main color [default: 3AA431] RECORD Options that belong to the [record] section. root Record the root window focus Record the focused window select Select the window to record parent Record the parent of the window with-alpha Record with the alpha channel no-keys Disable the action keys while recording mouse Select the window with mouse click action-keys Set the action keys [default: LAlt-S,LAlt-Enter] cancel-keys Set the cancel keys [default: LControl-D,Escape] border Set the border width [default: 1] padding Set the record area padding size Set the record area size duration Set the duration for recording [default: ] countdown Set the countdown before recording [default: 3] timeout Set the timeout for window selection [default: 300] interval Set the refresh interval for window selection [default: 10] font Set the font to use for window selection monitor Set the monitor to record as root window command Set the command to run SPLIT Options that belong to the [split] section. dir Set the output directory file Set the animation file MAKE Options that belong to the [make] section. no-sort Use frames in the order given fps Set the FPS [default: 20] quality Set the frame quality (1-100) [default: 75] repeat Set the number of repetitions [default: ] dir Set the directory to read frames format Set the animation format [default: gif] [possible values: gif, apng] CAPTURE Options that belong to the [capture] section. root Capture the root window focus Capture the focused window select Select the window to capture parent Capture the parent of the window with-alpha Capture with the alpha channel mouse Select the window with mouse click action-keys Set the action keys [default: LAlt-S,LAlt-Enter] cancel-keys Set the cancel keys [default: LControl-D,Escape] border Set the border width [default: 1] padding Set the capture area padding size Set the capture area size countdown Set the countdown before capturing [default: 0] timeout Set the timeout for window selection [default: 300] interval Set the refresh interval for window selection [default: 10] font Set the font to use for window selection monitor Set the monitor to capture as root window command Set the command to run EDIT Options that belong to the [edit] section. convert Convert image using the given encoder grayscale Convert image to grayscale invert Invert the colors of the image crop Apply padding to crop the image resize Resize the image without keeping the aspect ratio ratio Resize the image proportionally by aspect ratio [default: 1.0] rotate Rotate the image (clockwise) [possible values: 90, 180, 270] flip Flip the image [possible values: horizontal, vertical] blur Blur the image [default: 0.0] hue Adjust the hue of the image [default: +-0] contrast Adjust the contrast of the image [default: +-0.0] brightness Adjust the brightness of the image [default: +-0] filter Set the sampling filter for scaling [default: lanczos3] [possible values: nearest, triangle, catmull-rom, gaussian, lanczos3] file Set the input file ANALYZE Options that belong to the [analyze] section. timestamp Use Unix timestamp for report dates time-zone Set the time zone of the report [default: utc] [possible values: utc, local] file Set the image file VIEW Options that belong to the [view] section. transparent Display transparent image with transparent background file Set the image file SAVE Options that belong to the [save] section. with-extension Always save the file with an extension timestamp Add Unix timestamp to the file name date Add formatted date/time to the file name [default: %Y%m%dT%H%M%S] file Set the output file GIF Options that belong to the [gif] section. gifski Use the gifski encoder fast Encode 3 times faster (gifski) fps Set the FPS [default: 20] quality Set the frame quality (1-100) [default: 75] repeat Set the number of repetitions [default: ] speed Set the animation speed [default: 1.0] cut-beginning Cut the beginning of the animation [default: 0.0] cut-end Cut the end of the anim [default: 0.0] APNG Options that belong to the [apng] section. fps Set the FPS [default: 20] repeat Set the number of repetitions [default: ] speed Set the animation speed [default: 1.0] cut-beginning Cut the beginning of the animation [default: 0.0] cut-end Cut the end of the anim [default: 0.0] PNG Options that belong to the [png] section. compression Set the compression level [default: fast] [possible values: default, fast, best] filter Set the filter algorithm [default: sub] [possible values: none, sub, up, avg, paeth] JPG Options that belong to the [jpg] section. quality Set the image quality (1-100) [default: 90] WEBP Options that belong to the [webp] section. quality Set the lossy encoding quality (1-100) [default: 80] lossless Use lossless encoding PNM Options that belong to the [pnm] section. format Set the PNM format [default: pixmap] [possible values: bitmap, graymap, pixmap, arbitrary] encoding Set the encoding for storing the samples [default: binary] [possible values: binary, ascii] ENVIRONMENT Corresponding environment variables can be set for overriding the command line flags and options. The general prototype of the variables that menyoki checks are the following: MENYOKI_{SECTION}_{ARGUMENT}=value Examples Command Environment Variables -------------------------------------------------------------------------- menyoki --quiet MENYOKI_GENERAL_QUIET=true menyoki record gif --fps 10 save MENYOKI_GIF_FPS=10 --timestamp MENYOKI_SAVE_TIMESTAMP=true menyoki capture --size 200x300 jpg MENYOKI_CAPTURE_SIZE=200x300 --quality 100 MENYOKI_JPG_QUALITY=100 menyoki edit test.png --ratio 2.0 MENYOKI_EDIT_RATIO=2.0 --filter triangle MENYOKI_EDIT_FILTER=triangle menyoki split test.gif --dir frames/ MENYOKI_SPLIT_DIR=frames/ pnm --format graymap MENYOKI_PNM_FORMAT=graymap menyoki analyze test.png --timestamp MENYOKI_ANALYZE_TIMESTAMP=true save --date %H%M%S MENYOKI_SAVE_DATE=%H%M%S menyoki view test.png --transparent MENYOKI_VIEW_TRANSPARENT=true AUTHOR Written by Orhun Parmaksiz REPORTING BUGS Contact the author via email or use GitHub Issues for reporting bugs: COPYRIGHT Copyright (C) 2020-2023 Orhun Parmaksiz Licensed under GPLv3: SEE ALSO menyoki(1) See the project homepage at for full documentation. menyoki 1.7.0 March 2023 MENYOKI.CONF(5)