From 9f6a31e8ef28d05e64037de1a780c90980b63c3a Mon Sep 17 00:00:00 2001 From: JMARyA Date: Wed, 21 May 2025 13:10:23 +0200 Subject: [PATCH] add artem --- technology/applications/media/artem.md | 30 ++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 technology/applications/media/artem.md diff --git a/technology/applications/media/artem.md b/technology/applications/media/artem.md new file mode 100644 index 0000000..f258c38 --- /dev/null +++ b/technology/applications/media/artem.md @@ -0,0 +1,30 @@ +--- +obj: application +repo: https://github.com/FineFindus/artem +--- + +# artem +Artem is a small cli program, written in rust, to easily convert images to ascii art, named after the latin word for art. By default it tries to use truecolor, if the terminal does not support truecolor, it falls back to 16 Color ANSI. When the ascii image is written to a file, the image will not use colors. It supports .jpeg, .png, .gif, .webp and many more. + +## Usage +Usage: `artem [options] [image]` + +| `Option` | `Description` | +| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `-c, --characters ` | Change the characters used to display the image. The first character should have the highest 'darkness' and the last should have the least (recommended to be a space ' '). A lower detail map is recommended for smaller images. | +| `-s, --size ` | Change the size of the output image. The minimum size is 20. Lower values will be ignored and changed to 20. Conflicts with `--width` and `--height`. \[default: 80] | +| `--height` | Use the terminal maximum height to display the image. Conflicts with `--size` and `--width`. | +| `-w, --width` | Use the terminal maximum width to display the image. Conflicts with `--size` and `--height`. | +| `--ratio ` | Change the ratio between height and width. The value must be between 0.1 and 1.0. It is not recommended to change this setting. \[default: 0.42] | +| `--flipX` | Flip the image along the X-Axis/horizontally. | +| `--flipY` | Flip the image along the Y-Axis/vertically. | +| `--centerX` | Center the image along the X-Axis/horizontally in the terminal. | +| `--centerY` | Center the image along the Y-Axis/vertically in the terminal. | +| `-o, --output ` | Output file for non-colored ASCII. For color, use a file with .ansi, .svg, or .html extension. .ansi files will consider environment variables when creating colored output. | +| `--invert` | Inverts the characters used for the image, so light characters will be dark. Useful if the image has a dark background. | +| `--background` | Sets the background of the ASCII as the color. Ignored if the terminal does not support truecolor. Mutually exclusive with `--no-color`. | +| `--border` | Adds a decorative border surrounding the ASCII image, making the image slightly smaller as it respects the given size. | +| `--no-color` | Do not use color when printing the image to the terminal. | +| `--outline` | Only create an outline of the image. Uses filters and may take more resources/time, especially on larger images. Best used on images with clear foreground/background distinction. | +| `--hysteresis` | When creating the outline, use the hysteresis method to remove imperfections, but might not look as good in ASCII form. Requires `--outline` to be present. | +| `--verbose ` | Choose the verbosity of the logging level. \[default: warn] Possible values: off, error, warn, info, debug, trace. |