{"id":13502967,"url":"https://github.com/orhun/menyoki","last_synced_at":"2025-05-14T12:13:12.427Z","repository":{"id":49254259,"uuid":"255603633","full_name":"orhun/menyoki","owner":"orhun","description":"Screen{shot,cast} and perform ImageOps on the command line 🌱 🏞️","archived":false,"fork":false,"pushed_at":"2024-12-08T08:58:24.000Z","size":1598,"stargazers_count":646,"open_issues_count":18,"forks_count":13,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-12T22:17:10.566Z","etag":null,"topics":["animated-png","animation","apng","capture","command-line","command-line-tool","gif-maker","gif-recorder","hacktoberfest","image","image-analysis","image-conversion","image-manipulation","image-processing","rust","screen-capture","screen-recorder","screencast","screenshot"],"latest_commit_sha":null,"homepage":"https://menyoki.cli.rs","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/orhun.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"orhun","patreon":"orhunp"}},"created_at":"2020-04-14T12:31:06.000Z","updated_at":"2025-04-09T08:04:05.000Z","dependencies_parsed_at":"2023-10-05T05:08:51.099Z","dependency_job_id":"2bbbcf21-503d-44fd-a74f-840ba2b61fd2","html_url":"https://github.com/orhun/menyoki","commit_stats":{"total_commits":1766,"total_committers":8,"mean_commits":220.75,"dds":"0.035107587768969384","last_synced_commit":"83e322379f1128148a1d22cf09a6066c9ca9ec3a"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fmenyoki","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fmenyoki/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fmenyoki/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fmenyoki/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/orhun","download_url":"https://codeload.github.com/orhun/menyoki/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254140769,"owners_count":22021220,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animated-png","animation","apng","capture","command-line","command-line-tool","gif-maker","gif-recorder","hacktoberfest","image","image-analysis","image-conversion","image-manipulation","image-processing","rust","screen-capture","screen-recorder","screencast","screenshot"],"created_at":"2024-07-31T22:02:31.988Z","updated_at":"2025-05-14T12:13:07.405Z","avatar_url":"https://github.com/orhun.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\n        \u003cimg src=\"https://user-images.githubusercontent.com/24392180/98470768-09356680-21f9-11eb-81de-94a622b32db4.png\" width=\"500\"\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003cb\u003eScreen{shot,cast} and perform ImageOps on the command line 🌱 🏞️\u003c/b\u003e\n    \u003cbr\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/orhun/menyoki/releases\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/v/release/orhun/menyoki?style=flat\u0026labelColor=000000\u0026color=25691f\u0026logo=GitHub\u0026logoColor=white\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://crates.io/crates/menyoki/\"\u003e\n        \u003cimg src=\"https://img.shields.io/crates/v/menyoki?style=flat\u0026labelColor=000000\u0026color=25691f\u0026logo=Rust\u0026logoColor=white\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://archlinux.org/packages/extra/x86_64/menyoki/\"\u003e\n        \u003cimg src=\"https://img.shields.io/archlinux/v/extra/x86_64/menyoki?style=flat\u0026labelColor=000000\u0026color=25691f\u0026logo=Arch%20Linux\u0026logoColor=white\"\u003e\n    \u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/orhun/menyoki/actions?query=workflow%3A%22Continuous+Integration%22\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/orhun/menyoki/ci.yml?branch=master\u0026style=flat\u0026labelColor=000000\u0026color=25691f\u0026label=CI\u0026logo=GitHub%20Actions\u0026logoColor=white\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/orhun/menyoki/actions?query=workflow%3A%22Continuous+Deployment%22\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/orhun/menyoki/cd.yml?style=flat\u0026labelColor=000000\u0026color=25691f\u0026label=CD\u0026logo=GitHub%20Actions\u0026logoColor=white\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://hub.docker.com/r/orhunp/menyoki\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/orhun/menyoki/docker.yml?style=flat\u0026labelColor=000000\u0026color=25691f\u0026label=Docker\u0026logo=Docker\u0026logoColor=white\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://codecov.io/gh/orhun/menyoki\"\u003e\n        \u003cimg src=\"https://img.shields.io/codecov/c/gh/orhun/menyoki?style=flat\u0026labelColor=000000\u0026color=25691f\u0026logo=Codecov\u0026logoColor=white\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n**menyoki** is a screencast and screenshot utility that can also perform various image related operations such as making/splitting GIFs and modifying/analyzing/viewing image files. It aims to be a lightweight command line tool for either helping out on day-to-day life operations or complicated detail-centric issues. Originally it was designed to record/screenshot terminal windows but it can be tweaked easily for other purposes with command line arguments, environment variables, or a configuration file.\n\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n- [Supported Platforms](#supported-platforms)\n- [Supported Formats](#supported-formats)\n- [Installation](#installation)\n  - [Requirements](#requirements)\n  - [Cargo](#cargo)\n  - [Arch Linux](#arch-linux)\n  - [Docker](#docker)\n    - [Docker Hub](#docker-hub)\n    - [Building an image](#building-an-image)\n  - [Manual](#manual)\n    - [From source](#from-source)\n    - [Releases](#releases)\n- [Features](#features)\n- [Usage](#usage)\n  - [General](#general-)\n    - [Arguments](#arguments)\n    - [Examples](#examples)\n  - [Record](#record-)\n    - [Arguments](#arguments-1)\n    - [Examples](#examples-1)\n    - [Pro Tip](#pro-tip)\n  - [Split](#split-)\n    - [Arguments](#arguments-2)\n    - [Examples](#examples-2)\n  - [Make](#make-)\n    - [Arguments](#arguments-3)\n    - [Examples](#examples-3)\n  - [Capture](#capture-)\n    - [Arguments](#arguments-4)\n    - [Examples](#examples-4)\n  - [Edit](#edit-)\n    - [Arguments](#arguments-5)\n    - [Examples](#examples-5)\n  - [Analyze](#analyze-)\n    - [Arguments](#arguments-6)\n    - [Examples](#examples-6)\n  - [View](#view-)\n    - [Arguments](#arguments-7)\n    - [Examples](#examples-7)\n  - [Other](#other-)\n    - [GIF/APNG](#gifapng)\n    - [PNG](#png)\n    - [JPG](#jpg)\n    - [WEBP](#webp)\n    - [PNM](#pnm)\n    - [Save](#save)\n- [Key Bindings](#key-bindings)\n- [Configuration](#configuration)\n- [Environment Variables](#environment-variables)\n  - [Examples](#examples-8)\n- [Roadmap](#roadmap)\n  - [Accessibility](#accessibility)\n  - [Platforms](#platforms)\n  - [Formats](#formats)\n  - [Optimization](#optimization)\n  - [Testing](#testing)\n- [Resources](#resources)\n  - [About the project](#about-the-project)\n  - [Why \"menyoki\"?](#why-menyoki)\n  - [Social Media](#social-media)\n  - [Funding](#funding)\n- [License](#license)\n- [Copyright](#copyright)\n\n\u003c/details\u003e\n\n## Supported Platforms\n\n- [x] Linux\n    - [x] [X11](https://www.x.org/) (fully supported)\n    - [ ] [Wayland](https://wayland.freedesktop.org/) (no record/capture)\n- [ ] Windows (no record/capture)\n- [ ] macOS (no record/capture)\n\n**menyoki** requires a window system [implementation](https://github.com/orhun/menyoki/blob/master/IMPLEMENTATION.md#implementing-for-other-platforms) of the supported platform for **record** and **capture** actions. Other features are expected to work normally since they don't require a window system running (or grabbing a window to operate on). For example, despite the macOS is not listed as a supported platform, **menyoki** still can perform image operations such as **edit**, **analyze** and **view** if it's compiled on macOS.\n\n## Supported Formats\n\n- [x] [GIF](https://en.wikipedia.org/wiki/GIF)\n- [x] [APNG](https://en.wikipedia.org/wiki/APNG)\n- [x] [PNG](https://en.wikipedia.org/wiki/Portable_Network_Graphics)\n- [x] [JPEG](https://en.wikipedia.org/wiki/JPEG)\n- [x] [BMP](https://en.wikipedia.org/wiki/BMP_file_format)\n- [x] [ICO](https://en.wikipedia.org/wiki/ICO_(file_format))\n- [x] [TIFF](https://en.wikipedia.org/wiki/TIFF)\n- [x] [PNM](https://en.wikipedia.org/wiki/Netpbm)\n- [x] [TGA](https://en.wikipedia.org/wiki/Truevision_TGA)\n- [x] [farbfeld](https://tools.suckless.org/farbfeld/)\n- [x] [OpenEXR](https://en.wikipedia.org/wiki/OpenEXR)\n- [x] [WebP](https://en.wikipedia.org/wiki/WebP)\n- [ ] [AVIF](https://en.wikipedia.org/wiki/AV1)\n- [ ] [MP4](https://en.wikipedia.org/wiki/MPEG-4_Part_14)\n\n## Installation\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/menyoki.svg)](https://repology.org/project/menyoki/versions)\n\n### Requirements\n\n* Rust: `1.56.1+`\n* Dependencies\n  * Arch Linux: `libx11`, `libxrandr`\n  * Debian, Ubuntu: `libx11-dev`/`librust-x11-dev`, `libxrandr-dev`\n  * Fedora: `libX11-devel`, `libXrandr`\n\n### Cargo\n\n**menyoki** can be installed from [crates.io](https://crates.io/crates/menyoki/) using cargo if [Rust](https://www.rust-lang.org/tools/install) is installed.\n\n```sh\ncargo install menyoki\n```\n\nUse `--force` option to update.\n\n```sh\ncargo install menyoki --force\n```\n\n### Arch Linux\n\n**menyoki** can be installed from the Arch Linux [extra repository](https://archlinux.org/packages/extra/x86_64/menyoki/).\n\n```sh\npacman -S menyoki\n```\n\nOr if you prefer, you can use an available [AUR package](https://aur.archlinux.org/packages/?O=0\u0026SeB=b\u0026K=menyoki\u0026outdated=\u0026SB=n\u0026SO=a\u0026PP=50\u0026do_Search=Go) for installation.\n* Use an [AUR helper](https://wiki.archlinux.org/index.php/AUR_helpers):\n\n```sh\nparu menyoki\n```\n\n* Clone the package and compile it with [makepkg](https://wiki.archlinux.org/index.php/Makepkg):\n\n```sh\ngit clone https://aur.archlinux.org/menyoki-git.git\ncd menyoki-git\nmakepkg -si\n```\n\n### Docker\n\n#### Docker Hub\n\nDownload the [orhunp/menyoki](https://hub.docker.com/r/orhunp/menyoki) image from Docker Hub (see available [tags](https://hub.docker.com/r/orhunp/menyoki/tags)):\n\n```sh\ndocker pull orhunp/menyoki:\u003ctag\u003e\n```\n\nRun a container:\n\n```sh\ndocker run orhunp/menyoki:\u003ctag\u003e\n```\n\n#### Building an image\n\nAfter cloning the repository, you can build an image from [Dockerfile](https://github.com/orhun/menyoki/blob/master/Dockerfile):\n\n```sh\ndocker build -t menyoki .\n```\n\nThen you can either run a container:\n\n```sh\ndocker run menyoki\n```\n\nor spawn a shell inside the container with running _it_ interactively:\n\n```sh\ndocker run -it menyoki /bin/bash\n```\n\n### Manual\n\n#### From source\n\n1. Clone the repository.\n\n```sh\ngit clone https://github.com/orhun/menyoki.git \u0026\u0026 cd menyoki/\n```\n\n2. Build the project and install binary.\n\n```sh\ncargo install --path .\n```\n\n#### Releases\n\n1. Download the latest archive from [releases](https://github.com/orhun/menyoki/releases) page and extract it.\n2. Move `menyoki` binary to `/usr/local/bin/` (Linux)\n\n## Features\n\n* [Record an animation](#record-)\n* [Split an animation into frames](#split-)\n* [Make an animation from frames](#make-)\n* [Capture an image](#capture-)\n* [Edit an image](#edit-)\n* [Analyze an image](#analyze-)\n* [View an image](#view-)\n\n## Usage\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003eAction\u003c/th\u003e\n    \u003ctd\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99543947-cdeb2280-29c4-11eb-87a9-ad559f9522ad.gif\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003cth\u003eResult\u003c/th\u003e\n    \u003ctd\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99814600-3cadb480-2b5a-11eb-84ce-1a693d5ddc2c.gif\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nCommand line arguments of **menyoki** are designed to be as intuitive as possible. As a result of that, an action can be performed with a chain of subcommands along with the flags and options. The general prototype for the usage of command line arguments is the following:\n\n`menyoki (ACTION) (FORMAT) (OUTPUT)`\n\nThe subcommand that will indicate the `action` is mandatory whereas `format` and `output` subcommands might be optional (or they might not exist at all). The `format` subcommand can be one of the supported formats and `output` basically corresponds to the **save** subcommand.\n\nThe default `format` is the first listed subcommand if there is not any subcommand given for specifying a `format`. On the other hand, **save** subcommand uses the \"menyoki\" directory in the _home_ (or _images_ if it exists) as the default output directory.\n\n### General \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\nFlags and options that will generally affect the execution of **menyoki** can be set before specifying the main action to perform. Then the main subcommand (action) must be specified.\n\n`menyoki [FLAGS] [OPTIONS] \u003cSUBCOMMAND\u003e`\n\n#### Arguments\n\n```\nFLAGS:\n    -h, --help       Print help information\n    -V, --version    Print version information\n    -v, --verbose    Increase logging verbosity\n    -q, --quiet      Do not show output\n\nOPTIONS:\n    -c, --config \u003cFILE\u003e    Set the configuration file\n        --color \u003cHEX\u003e      Set the main color [default: 3AA431]\n\nSUBCOMMANDS:\n    record     Record an animation\n    split      Split an animation into frames\n    make       Make an animation from frames\n    capture    Capture an image\n    edit       Edit an image\n    analyze    Analyze an image\n    view       View an image\n```\n\n#### Examples\n\n| Command                               \t| Action                                                                  \t|\n|-------------------------------------------|---------------------------------------------------------------------------|\n| `menyoki -V`                          \t| Print the version information                                           \t|\n| `menyoki -vv --color FF00FF \u003caction\u003e` \t| Set log verbosity level to 2 (trace) and use \"FF00FF\" as the main color \t|\n| `menyoki -q -c menyoki.conf \u003caction\u003e`  \t| Run in quiet mode and read the configuration from \"menyoki.conf\"         \t|\n\n### Record \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\n**menyoki** can record an area of a window or the whole screen and encode it as a supported format. Area selection and resize is performed with the key bindings.\n\nA few scenarios that **record** action might be helpful would be:\n\n* Record a specific area of a window\n* Record for a given duration\n* Record the output of a command (especially for TUI applications)\n\nEncoding options can be changed using the arguments of the provided format. (See the output of `menyoki record gif --help`)\n\n`menyoki record [FLAGS] [OPTIONS] [COMMAND] [SUBCOMMAND]`\n\n#### Arguments\n\n```\nFLAGS:\n    -r, --root          Record the root window\n    -f, --focus         Record the focused window\n        --select        Select the window to record\n        --parent        Record the parent of the window\n        --with-alpha    Record with the alpha channel\n        --no-keys       Disable the action keys while recording\n    -m, --mouse         Select the window with mouse click\n    -h, --help          Print help information\n\nOPTIONS:\n        --action-keys \u003cKEYS\u003e    Set the action keys [default: LAlt-S,LAlt-Enter]\n        --cancel-keys \u003cKEYS\u003e    Set the cancel keys [default: LControl-D,Escape]\n    -b, --border \u003cBORDER\u003e       Set the border width [default: 1]\n    -p, --padding \u003cT:R:B:L\u003e     Set the record area padding\n    -s, --size \u003cWxH\u003e            Set the record area size\n    -d, --duration \u003cS\u003e          Set the duration for recording [default: ∞]\n    -c, --countdown \u003cS\u003e         Set the countdown before recording [default: 3]\n    -t, --timeout \u003cS\u003e           Set the timeout for window selection [default: 300]\n    -i, --interval \u003cMS\u003e         Set the refresh interval for window selection [default: 10]\n        --font \u003cFONT\u003e           Set the font to use for window selection\n        --monitor \u003cNUM\u003e         Set the monitor to record as root window\n\nARGS:\n    \u003cCOMMAND\u003e    Set the command to run\n\nSUBCOMMANDS:\n    gif     Use the GIF encoder\n    apng    Use the APNG encoder\n    save    Save the output file(s)\n```\n\n#### Examples\n\n| Command                                                                 | Action                                                                             |\n|-------------------------------------------------------------------------|------------------------------------------------------------------------------------|\n| `menyoki record`                                                        | Select a window and start recording with default settings                          |\n| `menyoki record --root --countdown 5`                                   | Record the root window after 5 seconds of countdown                                |\n| `menyoki record --focus --with-alpha`                                   | Record the focused window with the alpha channel (for transparency)                |\n| `menyoki record --size 200x300 --duration 10`                           | Record an area of size 200x300 for 10 seconds                                      |\n| `menyoki record --padding 20:10:0:10 --timeout 120`                     | Record an area with given padding and set window selection timeout to 120 seconds  |\n| `menyoki record --parent`                                               | Record the parent window of the selected window                                    |\n| `menyoki record --root --select --monitor 1`                            | Record the first monitor as root window                                            |\n| `menyoki record --border 5`                                             | Record the area selected by a border with 5 width                                  |\n| `menyoki record --action-keys LControl-Q,LAlt-W`                        | Record with the default settings using custom key bindings                         |\n| `menyoki record --cancel-keys LControl-X,E`                             | Record with the default settings using custom key bindings                         |\n| `menyoki record gif --fps 15 --quality 90`                              | Record 15 frames per second with 90% quality                                       |\n| `menyoki record gif --gifski`                                           | Record and encode using the gifski encoder                                         |\n| `menyoki record gif save \"test.gif\" --timestamp`                        | Record and save as \"test.gif\" with timestamp in the file name                      |\n| `menyoki record apng --fps 30`                                          | Record 30 frames per second and encode as APNG                                     |\n| `menyoki -q record save \"-\" \u003e test.gif`                                 | Record and redirect output to \"test.gif\"                                           |\n| `menyoki -q record save \"-\" \\| xclip -selection clipboard -t image/gif` | Record and pipes output to xclip's clipboard selection, specifying target as a gif |\n| `menyoki -q record \"kmon -t 2000\"`                                      | Execute the command and record its output in quiet mode                            |\n| `menyoki record --font \"-*-dejavu sans-*-*-*-*-17-*-*-*-*-*-*-*\"`       | Use custom font for showing the area size (see `xfontsel`)                         |\n\n#### Pro Tip\n\nUse [slop](https://github.com/naelstrof/slop) for selecting an area of the root window (fullscreen) with mouse interaction.\n\n```sh\nmenyoki record --root --size $(slop)\n```\n\n### Split \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\n**menyoki** can split an animation into frames (extract images) if the **split** subcommand is provided and it can save frames as one of the supported formats with the use of trailing _format_ subcommand.\n\n`menyoki split [OPTIONS] \u003cFILE\u003e [SUBCOMMAND]`\n\n#### Arguments\n\n```\nFLAGS:\n    -h, --help    Print help information\n\nOPTIONS:\n    -d, --dir \u003cDIRECTORY\u003e    Set the output directory\n\nARGS:\n    \u003cFILE\u003e    Set the animation file\n\nSUBCOMMANDS:\n    png     Use the PNG encoder\n    jpg     Use the JPG encoder\n    webp    Use the WebP encoder\n    bmp     Use the BMP encoder\n    ico     Use the ICO encoder\n    tiff    Use the TIFF encoder\n    tga     Use the TGA encoder\n    pnm     Use the PNM encoder\n    ff      Use the farbfeld encoder\n    exr     Use the OpenEXR encoder\n```\n\n#### Examples\n\n| Command                                   \t| Action                                                  \t|\n|-----------------------------------------------|-----------------------------------------------------------|\n| `menyoki split rec.gif`                   \t| Extract frames from the \"rec.gif\" file                  \t|\n| `menyoki split rec.gif jpg --quality 100` \t| Extract frames as JPEG in maximum quality               \t|\n| `menyoki split rec.gif --dir frames/`     \t| Extract frames and save them to the specified directory \t|\n\n### Make \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\n**make** subcommand serves the purpose of creating an animation from a set of images. For example, it can be used for making GIFs from given images either via the command line or the specified directory.\n\n`menyoki make [FLAGS] [OPTIONS] \u003cFRAMES\u003e... [SUBCOMMAND]`\n\n#### Arguments\n\n```\nFLAGS:\n        --gifski     Use the gifski encoder\n        --fast       Encode 3 times faster (gifski)\n    -n, --no-sort    Use frames in the order given\n    -h, --help       Print help information\n\nOPTIONS:\n    -f, --fps \u003cFPS\u003e            Set the FPS [default: 20]\n    -q, --quality \u003cQUALITY\u003e    Set the frame quality (1-100) [default: 75]\n    -r, --repeat \u003cREPEAT\u003e      Set the number of repetitions [default: ∞]\n    -d, --dir \u003cDIRECTORY\u003e      Set the directory to read frames\n        --format \u003cFORMAT\u003e      Set the animation format [default: gif]  [possible values: gif, apng]\n\nARGS:\n    \u003cFRAMES\u003e...    Set the animation frames\n\nSUBCOMMANDS:\n    save    Save the output file(s)\n```\n\n#### Examples\n\n| Command                                          \t| Action                                                           \t|\n|---------------------------------------------------|-------------------------------------------------------------------|\n| `menyoki make 1.png 2.png`                       \t| Make a GIF that consists of two frames as \"1.png\" and \"2.png\"    \t|\n| `menyoki make 1.png 2.png --fps 5 --quality 100` \t| Make a GIF with the specified properties from given frames       \t|\n| `menyoki make 1.png 2.png save 3.gif --date`     \t| Make a GIF and save the file (\"3.gif\") with the date information \t|\n| `menyoki make 1.png 2.png --format apng`         \t| Make an APNG from the given frames                               \t|\n| `menyoki make --dir frames/`                     \t| Make a GIF from the frames in the specified directory            \t|\n\n### Capture \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\n**menyoki** can capture (screenshot) an area of a window or the whole screen and encode it as a supported format. Formats like **png**, **jpg**, and **pnm** have their own flags and options that might be used for changing the default encoding settings. Similar to the **record** subcommand, area selection and resize is performed with the key bindings. The same flags and options might apply for both **record** and **capture** subcommands since the actions are abstractly alike.\n\n`menyoki capture [FLAGS] [OPTIONS] [COMMAND] [SUBCOMMAND]`\n\n#### Arguments\n\n```\nFLAGS:\n    -r, --root          Capture the root window\n    -f, --focus         Capture the focused window\n        --select        Select the window to capture\n        --parent        Record the parent of the window\n        --with-alpha    Capture with the alpha channel\n    -m, --mouse         Select the window with mouse click\n    -h, --help          Print help information\n\nOPTIONS:\n        --action-keys \u003cKEYS\u003e    Set the action keys [default: LAlt-S,LAlt-Enter]\n        --cancel-keys \u003cKEYS\u003e    Set the cancel keys [default: LControl-D,Escape]\n    -b, --border \u003cBORDER\u003e       Set the border width [default: 1]\n    -p, --padding \u003cT:R:B:L\u003e     Set the capture area padding\n    -s, --size \u003cWxH\u003e            Set the capture area size\n    -c, --countdown \u003cS\u003e         Set the countdown before capturing [default: 0]\n    -t, --timeout \u003cS\u003e           Set the timeout for window selection [default: 300]\n    -i, --interval \u003cMS\u003e         Set the refresh interval for window selection [default: 10]\n        --font \u003cFONT\u003e           Set the font to use for window selection\n        --monitor \u003cNUM\u003e         Set the monitor to capture as root window\n\nARGS:\n    \u003cCOMMAND\u003e    Set the command to run\n\nSUBCOMMANDS:\n    png     Use the PNG encoder\n    jpg     Use the JPG encoder\n    webp    Use the WebP encoder\n    bmp     Use the BMP encoder\n    ico     Use the ICO encoder\n    tiff    Use the TIFF encoder\n    tga     Use the TGA encoder\n    pnm     Use the PNM encoder\n    ff      Use the farbfeld encoder\n    exr     Use the OpenEXR encoder\n    save    Save the output file(s)\n```\n\n#### Examples\n\n| Command                                                                      | Action                                                                                       |\n|------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|\n| `menyoki capture`                                                            | Select a window and screenshot with default settings                                         |\n| `menyoki capture --root --countdown 5`                                       | Screenshot the root window after 5 seconds of countdown                                      |\n| `menyoki capture --focus --with-alpha`                                       | Screenshot the focused window with the alpha channel (for transparency)                      |\n| `menyoki capture --size 200x300 --duration 10`                               | Screenshot an area of size 200x300 for 10 seconds                                            |\n| `menyoki capture --padding 20:10:0:10 --timeout 120`                         | Screenshot an area with given padding and set window selection timeout to 120 seconds        |\n| `menyoki capture --mouse`                                                    | Screenshot the selected window with a mouse click                                            |\n| `menyoki capture png --filter avg --compression fast`                        | Screenshot and encode with the specified PNG options                                         |\n| `menyoki capture jpg --quality 100`                                          | Screenshot and encode with the specified JPEG options                                        |\n| `menyoki capture webp --lossless`                                            | Screenshot and encode with the specified WEBP options                                        |\n| `menyoki capture pnm --format pixmap --encoding ascii`                       | Screenshot and encode with the specified PNM options                                         |\n| `menyoki capture ff save \"test.ff\" --timestamp`                              | Screenshot and save as \"test.ff\" in farbfeld format with timestamp in the file name          |\n| `menyoki -q capture png save \"-\" \u003e test.png`                                 | Screenshot and redirect output to \"test.png\"                                                 |\n| `menyoki -q capture png save \"-\" \\| xclip -selection clipboard -t image/png` | Screenshot and pipe output to xclip's clipboard selection, specifying an image/png target    |\n| `menyoki -q capture \"kmon -t 2000\"`                                          | Execute the command and screenshot its output in quiet mode (sets countdown to 3 implicitly) |\n\nAlso, see the [pro tip](#pro-tip) about `--size` argument.\n\n### Edit \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\n**edit** subcommand can be used to [edit](https://github.com/image-rs/image#image-processing-functions) (manipulate/filter/convert) files in one of the supported formats. Apart from the flags and options that **edit** provides, other encoding options can be specified via _format_ subcommand.\n\n`menyoki edit [FLAGS] [OPTIONS] \u003cFILE\u003e [SUBCOMMAND]`\n\n#### Arguments\n\n```\nFLAGS:\n        --convert      Convert image using the given encoder\n        --grayscale    Convert image to grayscale\n        --invert       Invert the colors of the image\n    -h, --help         Print help information\n\nOPTIONS:\n        --crop \u003cT:R:B:L\u003e             Apply padding to crop the image\n        --resize \u003cWxH\u003e               Resize the image without keeping the aspect ratio\n        --ratio \u003cRATIO\u003e              Resize the image proportionally by aspect ratio [default: 1.0]\n        --rotate \u003cROTATE\u003e            Rotate the image (clockwise) [possible values: 90, 180, 270]\n        --flip \u003cFLIP\u003e                Flip the image [possible values: horizontal, vertical]\n        --blur \u003cSIGMA\u003e               Blur the image [default: 0.0]\n        --hue \u003cHUE\u003e                  Adjust the hue of the image [default: ±0]\n        --contrast \u003cCONTRAST\u003e        Adjust the contrast of the image [default: ±0.0]\n        --brightness \u003cBRIGHTNESS\u003e    Adjust the brightness of the image [default: ±0]\n        --filter \u003cFILTER\u003e            Set the sampling filter for scaling [default: lanczos3]  [possible values: nearest, triangle, catmull-rom, gaussian,\n                                     lanczos3]\n\nARGS:\n    \u003cFILE\u003e    Set the input file\n\nSUBCOMMANDS:\n    gif     Use the GIF encoder\n    apng    Use the APNG encoder\n    png     Use the PNG encoder\n    jpg     Use the JPG encoder\n    webp    Use the WebP encoder\n    bmp     Use the BMP encoder\n    ico     Use the ICO encoder\n    tiff    Use the TIFF encoder\n    tga     Use the TGA encoder\n    pnm     Use the PNM encoder\n    ff      Use the farbfeld encoder\n    exr     Use the OpenEXR encoder\n    save    Save the output file(s)\n```\n\n#### Examples\n\n| Command                                                                                                            \t| Action                                                         \t|\n|-----------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| `menyoki edit test.png`                                                                                            \t| Re-encode the \"test.png\" file without editing                  \t|\n| `menyoki edit test.png --grayscale`                                                                                \t| Convert image to grayscale                                     \t|\n| `menyoki edit test.png --invert`                                                                                   \t| Invert the colors of the image                                 \t|\n| `menyoki edit test.png --crop 20:20:20:20`                                                                         \t| Apply the given padding to image for cropping                  \t|\n| `menyoki edit test.png --resize 300x300`                                                                           \t| Resize the image to 300x300 (without keeping the aspect ratio) \t|\n| `menyoki edit test.png --ratio 0.5`                                                                                \t| Resize the image to half the size (using the aspect ratio)     \t|\n| `menyoki edit test.png --ratio 2.0 --filter gaussian`                                                              \t| Resize the image using the specified sampling filter           \t|\n| `menyoki edit test.png --rotate 90`                                                                                \t| Rotate the image 90 degrees (clockwise)                        \t|\n| `menyoki edit test.png --flip horizontal`                                                                          \t| Flip the image horizontally                                    \t|\n| `menyoki edit test.png --blur 2.0`                                                                                 \t| Blur the image                                                 \t|\n| `menyoki edit test.png --hue 100`                                                                                  \t| Adjust the hue of the image                                    \t|\n| `menyoki edit test.png --contrast -10.5`                                                                           \t| Adjust the contrast of the image                               \t|\n| `menyoki edit test.png --brightness 50`                                                                            \t| Adjust the brightness of the image                             \t|\n| `menyoki edit test.png --convert tga`                                                                              \t| Convert image to TGA format                                    \t|\n| `menyoki edit test.png --convert jpg --quality 80`                                                                 \t| Convert image to JPEG in 80% quality                           \t|\n| `menyoki edit test.gif --ratio 0.25 gif --quality 80`                                                              \t| Resize and re-encode \"test.gif\"                                \t|\n| `menyoki edit test.gif gif --speed 0.5`                                                                            \t| Slow down the GIF (half the speed)                             \t|\n| `menyoki edit test.gif gif --cut-beginning 1.0 --cut-end 0.5`                                                      \t| Cut the duration of GIF by seconds                             \t|\n| `menyoki edit test.apng --convert gif`                                                                             \t| Convert APNG to GIF                                            \t|\n| `menyoki edit test.ff --grayscale --convert pnm --format arbitrary save \"output\" --with-extension --date \"%H%M%S\"` \t| test.ff (farbfeld) -\u003e grayscale -\u003e output_020035.pam (PNM)     \t|\n\n### Analyze \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\n**analyze** subcommand serves the purpose of inspecting an image file which is in a supported format and creating a report based on the image details. The report consists of 2 to 3 sections that are file, image, and EXIF information.\n\n`menyoki analyze [FLAGS] [OPTIONS] \u003cFILE\u003e [SUBCOMMAND]`\n\n#### Arguments\n\n```\nFLAGS:\n        --timestamp    Use Unix timestamp for report dates\n    -h, --help         Print help information\n\nOPTIONS:\n    -t, --time-zone \u003cTIMEZONE\u003e    Set the time zone of the report [default: utc]  [possible values: utc, local]\n\nARGS:\n    \u003cFILE\u003e    Set the image file\n\nSUBCOMMANDS:\n    save    Save the output file(s)\n```\n\n#### Examples\n\n| Command                                                 \t| Action                                                        \t|\n|-----------------------------------------------------------|-------------------------------------------------------------------|\n| `menyoki analyze test.jpg`                              \t| Inspect \"test.jpg\" and print the report                       \t|\n| `menyoki analyze test.jpg save test_report.txt`         \t| Inspect \"test.jpg\" and save the report as \"test_report.txt\"   \t|\n| `menyoki analyze test.jpg --timestamp`                  \t| Inspect the file and create a report based on timestamps      \t|\n| `menyoki analyze test.jpg --time-zone local`            \t| Inspect the file and create a report based on local time zone \t|\n| `menyoki analyze test.jpg --timestamp save --timestamp` \t| Use timestamps for both analysis report and file name         \t|\n\n\u003cdetails\u003e\n  \u003csummary\u003eExample report\u003c/summary\u003e\n\n```\nmenyoki - image analysis report\n\nFile Information\n  File:     \"Canon_40D.jpg\" (8.0 KB)\n  Created:  2020-11-11 231334.850884475 UTC\n  Modified: 2020-11-11 231334.850884475 UTC\n  Accessed: 2020-11-11 231404.647510552 UTC\n\nImage Information\n  Format:     JPEG\n  Dimensions: 100x68px\n  Color Type: RGB8\n  Main Colors:\n   • #433D2BFF\n   • #989069FF\n   • #8B7458FF\n   • #ADA791FF\n\nEXIF Data\n  Make: \"Canon\"\n  Model: \"Canon EOS 40D\"\n  Orientation: row 0 at top and column 0 at left\n  XResolution: 72 pixels per inch\n  YResolution: 72 pixels per inch\n  ResolutionUnit: inch\n  Software: \"GIMP 2.4.5\"\n  DateTime: 2008-07-31 103811\n  YCbCrPositioning: co-sited\n  ExposureTime: 1/160 s\n  FNumber: f/7.1\n  ExposureProgram: manual\n  PhotographicSensitivity: 100\n  ExifVersion: 2.21\n  DateTimeOriginal: 2008-05-30 155601\n  DateTimeDigitized: 2008-05-30 155601\n  ComponentsConfiguration: YCbCr_\n  ShutterSpeedValue: 7.375 EV\n  ApertureValue: 5.625 EV\n  ExposureBiasValue: 0 EV\n  MeteringMode: pattern\n  Flash: fired, no return light detection function, forced\n  FocalLength: 135 mm\n  UserComment: (530 bytes binary data)\n  SubSecTime: \"00\"\n  SubSecTimeOriginal: \"00\"\n  SubSecTimeDigitized: \"00\"\n  FlashpixVersion: 1.0\n  ColorSpace: sRGB\n  PixelXDimension: 100 pixels\n  PixelYDimension: 68 pixels\n  InteroperabilityIndex: \"R98\"\n  InteroperabilityVersion: 1.00\n  FocalPlaneXResolution: 4438.356164383562 pixels per inch\n  FocalPlaneYResolution: 4445.969125214408 pixels per inch\n  FocalPlaneResolutionUnit: inch\n  CustomRendered: normal process\n  ExposureMode: manual exposure\n  WhiteBalance: auto white balance\n  SceneCaptureType: standard\n  GPSVersionID: 2.2.0.0\n  Compression: JPEG (T)\n  XResolution: 72 pixels per inch (T)\n  YResolution: 72 pixels per inch (T)\n  ResolutionUnit: inch (T)\n  JPEGInterchangeFormat: 1090 (T)\n  JPEGInterchangeFormatLength: 1378 (T)\n\ngenerated on 2020-11-11 23:14:04.652826438 UTC\n```\n\n\u003c/details\u003e\n\n### View \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\n**view** subcommand can be used to simply view an image from the terminal. It uses the core library of [viu](https://github.com/atanunq/viu).\n\n`menyoki view [FLAGS] \u003cFILE\u003e`\n\n#### Arguments\n\n```\nFLAGS:\n    -t, --transparent    Display transparent image with transparent background\n    -h, --help           Print help information\n\nARGS:\n    \u003cFILE\u003e    Set the input file\n```\n\n#### Examples\n\n| Command                               | Action                                                      |\n|---------------------------------------|-------------------------------------------------------------|\n| `menyoki view test.jpg`               | View \"test.jpg\" from the terminal                           |\n| `menyoki view test.png --transparent` | View \"test.png\" from the terminal with transparency enabled |\n\n### Other \u003ca href=\"https://github.com/orhun/menyoki\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/24392180/99184076-96c10b00-2751-11eb-99ea-ad962144df76.png\" height=\"30\"\u003e\u003c/a\u003e\n\nIt's possible to change the GIF, APNG, PNG, JPG, and PNM encoding options with specifying flags/options to the corresponding subcommands. Also, **save** subcommand can be used for changing the default output settings.\n\n#### GIF/APNG\n\n```\nFLAGS:\n        --gifski    Use the gifski encoder         \u003conly in GIF\u003e\n        --fast      Encode 3 times faster (gifski) \u003conly in GIF\u003e\n    -h, --help    Print help information\n\nOPTIONS:\n    -f, --fps \u003cFPS\u003e            Set the FPS [default: 20]\n    -q, --quality \u003cQUALITY\u003e    Set the frame quality (1-100) [default: 75] \u003conly in GIF\u003e\n    -r, --repeat \u003cREPEAT\u003e      Set the number of repetitions [default: ∞]\n    -s, --speed \u003cSPEED\u003e        Set the GIF speed [default: 1.0]\n        --cut-beginning \u003cS\u003e    Cut the beginning of the GIF [default: 0.0]\n        --cut-end \u003cS\u003e          Cut the end of the GIF [default: 0.0]\n\nSUBCOMMANDS:\n    save    Save the output file(s)\n```\n\n(Some options might be only usable with a particular action)\n\n#### PNG\n\n```\nFLAGS:\n    -h, --help    Print help information\n\nOPTIONS:\n    -c, --compression \u003cCOMPRESSION\u003e    Set the compression level [default: fast]  [possible values: default, fast, best]\n    -f, --filter \u003cFILTER\u003e              Set the filter algorithm [default: sub]  [possible values: none, sub, up, avg, paeth]\n\nSUBCOMMANDS:\n    save    Save the output file(s)\n```\n\n#### JPG\n\n```\nFLAGS:\n    -h, --help    Print help information\n\nOPTIONS:\n    -q, --quality \u003cQUALITY\u003e    Set the image quality (1-100) [default: 90]\n\nSUBCOMMANDS:\n    save    Save the output file(s)\n```\n\n#### WEBP\n\n```\nFLAGS:\n    -l, --lossless    Use lossless encoding\n    -h, --help        Print help information\n\nOPTIONS:\n    -q, --quality \u003cQUALITY\u003e    Set the lossy encoding quality (1-100) [default: 80]\n\nSUBCOMMANDS:\n    save    Save the output file(s)\n```\n\n#### PNM\n\n```\nFLAGS:\n    -h, --help    Print help information\n\nOPTIONS:\n    -f, --format \u003cFORMAT\u003e        Set the PNM format [default: pixmap]  [possible values: bitmap, graymap, pixmap, arbitrary]\n    -e, --encoding \u003cENCODING\u003e    Set the encoding for storing the samples [default: binary]  [possible values: binary, ascii]\n\nSUBCOMMANDS:\n    save    Save the output file(s)\n```\n\n#### Save\n\n```\nFLAGS:\n    -e, --with-extension    Always save the file with an extension\n    -t, --timestamp         Add Unix timestamp to the file name\n    -h, --help              Print help information\n\nOPTIONS:\n    -d, --date \u003cFORMAT\u003e    Add formatted date/time to the file name [default: %Y%m%dT%H%M%S]\n\nARGS:\n    \u003cFILE\u003e    Set the output file\n```\n\n## Key Bindings\n\nKey bindings are only used and present while **capture** or **record** actions are performed. Essentially key bindings are for selecting capture/record areas and resizing them without any mouse interaction.\n\nThere are 3 types of key bindings in terms of performed action:\n\n* Action keys (main action keys such as `LAlt-S`, can be [customized](https://docs.rs/device_query/latest/device_query/keymap/enum.Keycode.html) via `--action-keys` and `--cancel-keys` options)\n* Cancel keys (the keys that will cancel the operation, e.g. `LControl-D`)\n* Miscellaneous keys (the keys that can be used for resizing the selected area such as `LAlt-[up]`)\n\n| Key                               \t| Action                                                      \t|\n|---------------------------------------|---------------------------------------------------------------|\n| `LAlt-[S/Enter]`                  \t| Start/stop recording or screenshot the selected area        \t|\n| `LControl-D, Escape`              \t| Cancel the current operation                                \t|\n| `LControl-C`                      \t| Cancel the current operation or stop recording              \t|\n| `LAlt-[arrow keys/hjkl]`          \t| Increase the area padding (decrease the size of the area)   \t|\n| `LControl-LAlt-[arrow keys/hjkl]` \t| Decrease the area padding (increase the size of the area)   \t|\n| `LShift-LAlt-[arrow keys/hjkl]`   \t| Reposition the selected area (move around)                  \t|\n| `LAlt-[1-9]`                      \t| Set the speed factor of changing the area size (default: 3) \t|\n| `LAlt-R`                          \t| Reset the area padding to default                           \t|\n\n![key bindings](https://user-images.githubusercontent.com/24392180/99595786-5807ab00-2a06-11eb-912f-5c2765e86d41.gif)\n\n## Configuration\n\nIt'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:\n\n* `{CONFIG_DIR}/menyoki.conf`\n* `{CONFIG_DIR}/menyoki/menyoki.conf`\n* `{CONFIG_DIR}/menyoki/config`\n\n`{CONFIG_DIR}` can be one of the following depending on the platform:\n* Linux: `$XDG_CONFIG_HOME` or `$HOME/.config`\n  * e.g. `/home/orhun/.config`\n* macOS: `$HOME/Library/Application Support`\n  * e.g. `/Users/Orhun/Library/Application Support`\n* Windows: `{FOLDERID_RoamingAppData}`\n  * e.g. `C:\\Users\\Orhun\\AppData\\Roaming`\n\n\u003cdetails\u003e\n  \u003csummary\u003eDefault configuration file\u003ca href=\"https://github.com/orhun/menyoki/blob/master/config/menyoki.conf\"\u003e*\u003c/a\u003e\u003c/summary\u003e\n\n```ini\n[general]\nverbose = 0\nquiet = false\ncolor = 3AA431\n\n[record]\nroot = false\nfocus = true\nselect = true\nparent = false\nwith-alpha = false\nno-keys = false\nmouse = false\naction-keys = LAlt-S,LAlt-Enter\ncancel-keys = LControl-D,Escape\nborder = 1\n#padding = T:R:B:L\n#size = WxH\nduration = ∞\ncountdown = 3\ntimeout = 300\ninterval = 10\n#font =\n#monitor =\n#command =\n\n[split]\n#dir =\n#file =\n\n[make]\n#no-sort = false\nfps = 20\nquality = 75\nrepeat = ∞\n#dir =\nformat = gif\n\n[capture]\nroot = false\nfocus = true\nselect = true\nparent = false\nwith-alpha = false\nmouse = false\naction-keys = LAlt-S,LAlt-Enter\ncancel-keys = LControl-D,Escape\nborder = 1\n#padding = T:R:B:L\n#size = WxH\ncountdown = 0\ntimeout = 300\ninterval = 10\n#font =\n#monitor =\n#command =\n\n[edit]\nconvert = false\ngrayscale = false\ninvert = false\n#crop = T:R:B:L\n#resize = WxH\nratio = 1.0\n#rotate =\n#flip =\nblur = 0.0\nhue = ±0\ncontrast = ±0.0\nbrightness = ±0\nfilter = lanczos3\n#file =\n\n[analyze]\ntimestamp = false\ntime-zone = utc\n#file =\n\n[view]\ntransparent = false\n#file =\n\n[save]\nwith-extension = false\ntimestamp = false\ndate = %Y%m%dT%H%M%S\n#file =\n\n[gif]\ngifski = false\nfast = false\nfps = 20\nquality = 75\nrepeat = ∞\nspeed = 1.0\ncut-beginning = 0.0\ncut-end = 0.0\n\n[apng]\nfps = 20\nrepeat = ∞\nspeed = 1.0\ncut-beginning = 0.0\ncut-end = 0.0\n\n[png]\ncompression = fast\nfilter = sub\n\n[jpg]\nquality = 90\n\n[webp]\nquality = 80\nlossless = false\n\n[pnm]\nformat = pixmap\nencoding = binary\n```\n\n\u003c/details\u003e\n\n## Environment Variables\n\nCorresponding 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:\n\n`MENYOKI_{SECTION}_{ARGUMENT}=value`\n\n### Examples\n\n| Command                                                     | Environment Variables                                     |\n|-------------------------------------------------------------|-----------------------------------------------------------|\n| `menyoki --quiet`                                           | `MENYOKI_GENERAL_QUIET=true`                              |\n| `menyoki record gif --fps 10 save --timestamp`              | `MENYOKI_GIF_FPS=10 MENYOKI_SAVE_TIMESTAMP=true`          |\n| `menyoki capture --size 200x300 jpg --quality 100`          | `MENYOKI_CAPTURE_SIZE=200x300 MENYOKI_JPG_QUALITY=100`    |\n| `menyoki edit test.png --ratio 2.0 --filter triangle`       | `MENYOKI_EDIT_RATIO=2.0 MENYOKI_EDIT_FILTER=triangle`     |\n| `menyoki split test.gif --dir frames/ pnm --format graymap` | `MENYOKI_SPLIT_DIR=frames/ MENYOKI_PNM_FORMAT=graymap`    |\n| `menyoki analyze test.png --timestamp save --date %H%M%S`   | `MENYOKI_ANALYZE_TIMESTAMP=true MENYOKI_SAVE_DATE=%H%M%S` |\n| `menyoki view test.png --transparent`                       | `MENYOKI_VIEW_TRANSPARENT=true`                           |\n\n## Roadmap\n\nThe following are the ultimate goals of the **menyoki** project.\n\n### Accessibility\n\n**menyoki** should be packaged for other distributions and package managers (such as [Nixpkgs](https://github.com/NixOS/nixpkgs) and [Homebrew](https://brew.sh/)) for easy access and installation.\n\n### Platforms\n\n[Supported platforms](#supported-platforms) list should be extended by [implementing](https://github.com/orhun/menyoki/blob/master/IMPLEMENTATION.md#implementing-for-other-platforms) the core features of **menyoki** on different systems. (See [#2](https://github.com/orhun/menyoki/issues/2), [#4](https://github.com/orhun/menyoki/issues/4) and [#5](https://github.com/orhun/menyoki/issues/5))\n\n### Formats\n\nAll the image formats that [image-rs](https://github.com/image-rs/image) supports for encoding should be implemented in **menyoki**. Also, the implementation of other image and video formats should be considered for encoding the frames in **record**/**capture** action. (See [supported formats](#supported-formats))\n\n### Optimization\n\nEncoding/decoding of some formats like GIF might be optimized for speed and efficiency. Alternative ways and options should be considered depending on the benchmarks in such cases.\n\n### Testing\n\n**menyoki** should be tested against different platforms and bugs must be reported for further development and support.\n\n## Resources\n\n### About the project\n\n* [Code of Conduct](https://github.com/orhun/menyoki/blob/master/CODE_OF_CONDUCT.md)\n* [Implementation Details](https://github.com/orhun/menyoki/blob/master/IMPLEMENTATION.md)\n* [Contribution Guidelines](https://github.com/orhun/menyoki/blob/master/CONTRIBUTING.md)\n* [Release Instructions](https://github.com/orhun/menyoki/blob/master/RELEASE.md)\n* [Changelog](https://github.com/orhun/menyoki/blob/master/CHANGELOG.md)\n\n### Why \"menyoki\"?\n\nIt's a reference to the [author](https://orhun.dev)'s favorite character from the game [Patapon 2](https://en.wikipedia.org/wiki/Patapon_2).\n\n![https://patapon.fandom.com/wiki/Menyokki?file=Moriussoo_evo.jpg](https://user-images.githubusercontent.com/24392180/99723231-f48f8300-2ac2-11eb-8118-84b873f10cce.jpg)\n\n\u003e[**Menyokki**](https://patapon.fandom.com/wiki/Menyokki) (aka **Tree-Pon** due to his resembling a tree) is a type of [Rarepon](https://patapon.fandom.com/wiki/Rarepon) introduced in [Patapon 2](https://patapon.fandom.com/wiki/Patapon_2). Its evolved form is **Kisuk**, and its ultimate form is **Moriussoo**. These Rarepons are green and resemble plants in various stages of development: Menyokki is a seedling, Kisuk is a sapling and Moriussoo is a full-grown tree.\n\nThe Menyokki sprite that is used as the project's logo was originally drawn by [OwocekTV](https://twitter.com/0x757775) for the fan made game [Patafour](https://patafourgame.com). He is also the creator and lead developer of Patafour and he is working on bringing the long awaited 4th installment of the Patapon franchise to life with the rest of the team.\n\nThanks to [owodzeg](https://github.com/owodzeg) for his hard work on [Patafour](https://patafourgame.com/) and the help with the **menyoki** logo. Kudos!\n\n### Social Media\n\n* [![Follow @menyoki_cli](https://img.shields.io/twitter/follow/menyoki_cli?style=flat\u0026labelColor=000000\u0026logo=twitter\u0026logoColor=white\u0026color=25691f)](https://twitter.com/menyoki_cli)\n* [![https://orhun.dev](https://img.shields.io/badge/author-orhun-000000?style=flat\u0026labelColor=000000\u0026color=25691f\u0026logo=Rust\u0026logoColor=white)](https://orhun.dev)\n  * [![Follow @orhun](https://img.shields.io/github/followers/orhun?label=follow%20%40orhun\u0026style=flat\u0026labelColor=000000\u0026logo=GitHub\u0026logoColor=white\u0026color=25691f)](https://github.com/orhun)\n  * [![Follow @orhundev](https://img.shields.io/twitter/follow/orhundev?style=flat\u0026labelColor=000000\u0026logo=twitter\u0026logoColor=white\u0026color=25691f)](https://twitter.com/orhundev)\n\n### Funding\n\nIf you like the **menyoki** and/or other projects on my [GitHub profile](https://github.com/orhun/), consider supporting me on [GitHub Sponsors](https://github.com/sponsors/orhun) or [Patreon](https://www.patreon.com/join/orhunp)!\n\n## License\n\nGNU General Public License ([v3.0](https://www.gnu.org/licenses/gpl.txt))\n\n## Copyright\n\nCopyright © 2020-2024, [Orhun Parmaksız](mailto:orhunparmaksiz@gmail.com)\n","funding_links":["https://github.com/sponsors/orhun","https://patreon.com/orhunp","https://www.patreon.com/join/orhunp)!"],"categories":["Applications","Rust","Other"],"sub_categories":["Graphics"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forhun%2Fmenyoki","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forhun%2Fmenyoki","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forhun%2Fmenyoki/lists"}