auge
| Crates.io | auge |
| lib.rs | auge |
| version | 0.3.1 |
| created_at | 2025-04-21 12:18:43.99077+00 |
| updated_at | 2025-11-27 14:24:49.931434+00 |
| description | a command-line apparatus for image manipulation |
| homepage | https://github.com/metdxt/auge |
| repository | https://github.com/metdxt/auge |
| max_upload_size | |
| id | 1642625 |
| size | 105,255 |
METDXT (metdxt)
documentation
README
Auge
Observe... and reshape the visual world line.
Auge is a command-line artifact forged in the fires of Rust, designed to manipulate the fabric of visual perception. It serves not merely as a tool, but as an extension of the user's will, seamlessly integrating into the data streams of Unix-style pipelines to chain alterations to reality itself.
Whether you seek to blur the edges of existence, drain the chromatic essence from an image, or reconstruct it through the lens of pointillism, Auge stands ready. It can even project the results directly into your ocular interface (terminal), detecting advanced protocols like iTerm or Kitty, or falling back to primitive block representations if necessary.
The Ritual of Summoning
To manifest this apparatus within your local environment, you may acquire pre-compiled instances for Windows (x86_64) and Linux (x86_64, aarch64) from the release zone.
Alternatively, those proficient in the ways of cargo may compile it from the source ether:
# Initiate synchronization sequence
cargo install auge
# OR forge directly from the source repository
# cargo install --git https://github.com/metdxt/auge
Invocation
Once materialized, the apparatus responds to the following incantations:
auge [OPTIONS] <COMMAND>
Consult the internal knowledge base via auge --help or auge <COMMAND> --help to uncover the deeper secrets of each operation.
The Grimoire (Capabilities)
Auge possesses a vast array of "Reality Alteration Protocols" (filters) to modify input data:
| Incantation | Effect |
|---|---|
view |
Passive Observation. Projects the image onto the terminal without alteration. |
grayscale |
Chromatic Drain. Strips the image of color, leaving only luminance. |
g-blur |
Gaussian Diffusion. Softens reality by blurring pixels (-s for strength). |
dotart |
Pointillist Reconstruction. Renders the image as a matrix of dots. Customizable colors, thresholds, and can even output raw JSON data representing the dots. |
dynthres |
Luma Severance. Dynamic thresholding to separate light from dark based on percentiles. |
resize |
Spatial Distortion. Alters the dimensional proportions of the image (target resolution or %). |
invert |
Polarity Reversal. Inverts the colors, creating a negative of the current reality. |
sepia |
Temporal Patina. Applies an antique tone, simulating the passage of time. |
edge |
Boundary Revelation. Highlights the edges where perceptions shift. |
blob-detect |
Entity Identification. Detects and colors connected blobs of pixels based on color or luminance. |
Advanced Manipulation
- Stream Chaining: Auge thrives in the flow. It reads from
stdinand writes tostdout, allowing you to chain multiple instances to perform complex rituals. - Ocular Projection: If no output file is specified and the destination is a terminal, Auge automatically attempts to render the image directly to your view.
Known Realms (Supported Formats)
The apparatus can decipher and encode a multitude of visual formats across the multiverse:
| Format | Input (Decode) | Output (Encode) |
|---|---|---|
| AVIF | ✗ (The void resists) | ✓ |
| BMP | ✓ | ✓ |
| DDS | ✓ | ✗ |
| Farbfeld | ✓ | ✓ |
| GIF | ✓ | ✓ |
| HDR | ✓ | ✓ |
| ICO | ✓ | ✓ |
| JPEG | ✓ | ✓ |
| OpenEXR | ✓ | ✓ |
| PNG | ✓ | ✓ |
| PNM | ✓ | ✓ |
| QOI | ✓ | ✓ |
| TGA | ✓ | ✓ |
| TIFF | ✓ | ✓ |
| WebP | ✓ | ✓ |
Demonstrations of Power
Scenario I: The Chromatic Shift Transform a PNG into a grayscale artifact, blur its essence, and seal it into a new vessel.
auge -i input.png grayscale | auge g-blur -s 3 > output.png
Scenario II: The Pointillist Vision Gaze upon an image directly in your terminal, reconstructed as dot art with a custom background.
auge -i input.jpg dotart --bg-color "#1a1a1a" --scale 12
Scenario III: Detecting Anomalies Identify red blobs in the visual field and visualize them as a heatmap.
auge -i input.png blob-detect --color "#FF0000" --threshold 30 --mode heatmap
The Covenant
This apparatus is distributed under the MIT License. You are free to use, modify, and distribute it across the timelines, provided the ancient texts (license headers) remain intact.