--- name: "menyoki.conf" section: "5" platform: "linux" package: "menyoki" version: "1.8.0-1" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/menyoki.conf" --- # menyoki.conf(5) menyoki configuration file ## 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` Additionally, `MENYOKI_WINDOW_SYSTEM` can be set to `x11` or `wayland` for overriding the window system that is otherwise detected from the presence of `WAYLAND_DISPLAY`. ### Examples | | | | --- | --- | | Command | Environment Variables | | `menyoki --quiet` | `MENYOKI_GENERAL_QUIET=true` | | `menyoki record gif --fps 10 save --timestamp` | `MENYOKI_GIF_FPS=10 MENYOKI_SAVE_TIMESTAMP=true` | | `menyoki capture --size 200x300 jpg --quality 100` | `MENYOKI_CAPTURE_SIZE=200x300 MENYOKI_JPG_QUALITY=100` | | `menyoki edit test.png --ratio 2.0 --filter triangle` | `MENYOKI_EDIT_RATIO=2.0 MENYOKI_EDIT_FILTER=triangle` | | `menyoki split test.gif --dir frames/ pnm --format graymap` | `MENYOKI_SPLIT_DIR=frames/ MENYOKI_PNM_FORMAT=graymap` | | `menyoki analyze test.png --timestamp save --date %H%M%S` | `MENYOKI_ANALYZE_TIMESTAMP=true MENYOKI_SAVE_DATE=%H%M%S` | | `menyoki view test.png --transparent` | `MENYOKI_VIEW_TRANSPARENT=true` | ## AUTHOR Written by Orhun Parmaksız \ ## REPORTING BUGS Contact the author via email or use GitHub Issues for reporting bugs: \ ## COPYRIGHT Copyright © 2020-2024 Orhun Parmaksız Licensed under GPLv3: \ ## SEE ALSO [**menyoki**(1)](/menyoki/1.md) See the project homepage at \ for full documentation.