{"_id":"@arc2898/termimg","name":"@arc2898/termimg","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@arc2898/termimg","version":"1.0.0","description":"Display images in any terminal — ASCII art, ANSI color, or sixel graphics","type":"module","bin":{"termimg":"dist/cli.js"},"scripts":{"build":"tsc","dev":"tsc --watch","test":"vitest run","prepublishOnly":"npm run build"},"keywords":["terminal","image","ascii","sixel","display","console","picture","img2txt","catimg"],"author":{"name":"arc2898"},"license":"MIT","dependencies":{"commander":"^14.0.0","jimp":"^1.6.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0","vitest":"^3.0.0"},"engines":{"node":">=18.0.0"},"gitHead":"2b5f1720cc96cf73af5acaf5e8460a56d8d64aea","_id":"@arc2898/termimg@1.0.0","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-3c5sidyAefcf9vDU3alQGMlkQpD3HcsLU3n2QOAdq5QEETEnDSGvj2jfyRyyQb/3fGf2htYM9B+6WExTEglquA==","shasum":"5aea22acccc8556bacf7d70e741626eea41ea5ae","tarball":"https://registry.npmjs.org/@arc2898/termimg/-/termimg-1.0.0.tgz","fileCount":8,"unpackedSize":12501,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAymqwEKpzr0pOvaQTpPlnbROU/DEScn/RweGWlACYrCAiEAse70pWDr2c2gq08jIAwmaBtDq+7/1+Y3Ub+3foMLK5Q="}]},"_npmUser":{"name":"arc2898","email":"rc002894@gmail.com"},"directories":{},"maintainers":[{"name":"arc2898","email":"rc002894@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/termimg_1.0.0_1775830452845_0.6580407580005612"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-10T14:14:12.781Z","1.0.0":"2026-04-10T14:14:13.062Z","modified":"2026-04-10T14:14:13.351Z"},"maintainers":[{"name":"arc2898","email":"rc002894@gmail.com"}],"description":"Display images in any terminal — ASCII art, ANSI color, or sixel graphics","keywords":["terminal","image","ascii","sixel","display","console","picture","img2txt","catimg"],"author":{"name":"arc2898"},"license":"MIT","readme":"# @arc2898/termimg\n\n> Display images in any terminal — ASCII art, ANSI color, or sixel graphics\n\n![Demo](https://raw.githubusercontent.com/arc2898/termimg/main/demo.gif)\n\n## Features\n\n- **ASCII Art** — Classic character-based rendering with customizable charset\n- **Truecolor ANSI** — Photo-realistic output using 24-bit ANSI colors (most modern terminals)\n- **Sixel Graphics** — Native graphics protocol for compatible terminals (iTerm2, mlterm)\n- **Batch Mode** — Display multiple images in sequence\n- **Smart Resize** — Auto-fit to terminal dimensions or specify exact size\n- ** Formats** — PNG, JPEG, GIF, BMP, TIFF, WebP\n\n## Installation\n\n```bash\nnpm install -g @arc2898/termimg\n```\n\n## Usage\n\n```bash\n# Display an image (auto-detects best method)\ntermimg photo.jpg\n\n# Force ASCII art mode\ntermimg photo.jpg --mode ascii\n\n# Force ANSI truecolor mode\ntermimg photo.jpg --mode ansi\n\n# Force sixel mode\ntermimg photo.jpg --mode sixel\n\n# Resize to specific dimensions\ntermimg photo.jpg --width 120 --height 40\n\n# Batch display from directory\ntermimg ./screenshots/*.png --batch\n\n# Output to file instead of stdout\ntermimg photo.jpg --output ascii.txt\n\n# Show image info without displaying\ntermimg photo.jpg --info\n```\n\n## Options\n\n| Option | Short | Description | Default |\n|--------|-------|-------------|---------|\n| `--mode` | `-m` | Rendering mode: `auto`, `ascii`, `ansi`, `sixel` | `auto` |\n| `--width` | `-w` | Output width in characters/columns | Terminal width |\n| `--height` | `-H` | Output height in rows | Auto |\n| `--charset` | `-c` | ASCII charset: `simple`, `detailed`, `blocks` | `detailed` |\n| `--color` | | Color mode: `truecolor`, `256`, `mono` | `truecolor` |\n| `--invert` | | Invert light/dark for ASCII mode | `false` |\n| `--batch` | `-b` | Batch mode for multiple files | `false` |\n| `--output` | `-o` | Write to file instead of stdout | stdout |\n| `--info` | `-i` | Show image metadata only | `false` |\n\n## Supported Terminals\n\n| Terminal | ANSI Truecolor | Sixel |\n|----------|---------------|-------|\n| iTerm2 | ✅ | ✅ |\n| Windows Terminal | ✅ | ❌ |\n| macOS Terminal | ✅ | ❌ |\n| Konsole | ✅ | ✅ |\n| mlterm | ✅ | ✅ |\n| Foot | ✅ | ✅ |\n| Kitty | ✅ | ❌ (uses its own protocol) |\n\n## Demo\n\n```bash\n# See it in action\ntermimg --demo\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-d2f17b623de3062c57e401f2e4ec6915"}