https://github.com/abizrh/iisca.nvim

Display image as ASCII characters in Neovim 🖼️
https://github.com/abizrh/iisca.nvim

ascii image-preview images lua neovim neovim-plugin

Last synced: 6 months ago
JSON representation

Display image as ASCII characters in Neovim 🖼️

• Host: GitHub
• URL: https://github.com/abizrh/iisca.nvim
• Owner: Abizrh
• License: mit
• Created: 2024-11-07T06:08:15.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-10T11:14:26.000Z (about 1 year ago)
• Last Synced: 2025-05-07T19:09:41.112Z (9 months ago)
• Topics: ascii, image-preview, images, lua, neovim, neovim-plugin
• Language: Lua
• Homepage:
• Size: 1.68 MB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

# 🖼️ iisca.nvim

> ✨ Convert your images into ASCII characters in neovim

![hero](https://raw.githubusercontent.com/Abizrh/iisca.nvim/main/preview.png)

## ⚠️ Requirements

- [tiv](https://github.com/stefanhaustein/TerminalImageViewer) for converting images into ASCII character

```bash

git clone https://github.com/stefanhaustein/TerminalImageViewer.git

cd TerminalImageViewer/src

make

# To move the tiv binary into your PATH (hopefully), also do

sudo make install

```

- Neovim version 0.10.0 or higher.

## 📦 Installation  

### 💤 Lazy

```lua

  {

    "Abizrh/iisca.nvim",

    dependencies = {

      "nvim-telescope/telescope.nvim",

    }

  },

```

## Usage

| Command               | Description                                             |

| --------------------- | ------------------------------------------------------- |

| `:ShowIisca`      | Search image in current file                               |

## 👀 Similar projects

- **Advance:**

  - [image.nvim](https://github.com/3rd/image.nvim)

  - [image_previewer](https://github.com/adelarsq/image_preview.nvim)

  - [image.nvim](https://github.com/samodostal/image.nvim) convert to ASCII character - *archived*