Home

Awesome

Logo

vixl44

Create pixel art inside your terminal using vim movements

Installation

Get go, then:

go get github.com/sebashwa/vixl44

Usage

~/go/bin/vixl44 [OPTIONS] [FILENAME]

FILENAME

    the name of your file

OPTIONS

-c, --cols
    number of columns, default is 20, 0 means full width, ignored if name of existing file given
-r, --rows
    number of rows, default is 20, 0 means full height, ignored if name of existing file given

Keybindings

Movement

KeysAction
<kbd>h</kbd>,<kbd>j</kbd>,<kbd>k</kbd>,<kbd>l</kbd>Move cursor left, down, up, right
<kbd>w</kbd>Move cursor 5 columns right
<kbd>b</kbd>Move cursor 5 columns left
<kbd>Ctrl-d</kbd>Move cursor 5 rows down
<kbd>Ctrl-u</kbd>Move cursor 5 rows up

Normal Mode

KeysAction
<kbd>Space</kbd>, <kbd>Return</kbd>Paint color
<kbd>s</kbd>Select color under the cursor
<kbd>f</kbd>Replace color in area (Flood fill)
<kbd>u</kbd>Undo change
<kbd>Ctrl-r</kbd>Redo change
<kbd>p</kbd>Paste from buffer
<kbd>c</kbd>Switch to palette mode
<kbd>Ctrl-v</kbd>Switch to visual block mode

Visual Block Mode

KeysAction
<kbd>Space</kbd>, <kbd>Return</kbd>Paint color
<kbd>x</kbd>, <kbd>d</kbd>Cut area
<kbd>y</kbd>Copy area
<kbd>Esc</kbd>Switch to normal mode
<kbd>c</kbd>Switch to palette mode

Palette Mode

KeysAction
<kbd>Space</kbd>, <kbd>Return</kbd>Select color
<kbd>Esc</kbd>Switch to normal mode
<kbd>Ctrl-v</kbd>Switch to visual block mode

Commands

:w FILENAME<CR>         - Write to FILENAME
:wq FILENAME<CR>        - Write to FILENAME and quit
:exp FILENAME.svg<CR>   - Export to FILENAME in svg format
:exp FILENAMExN.png<CR> - Export to FILENAME in png format with an optional scale factor N
:exp FILENAME.ansi<CR>  - Export ANSI escape sequences to FILENAME (use i.e. cat FILENAME to view it)
:q<CR>                  - Quit

License

This project is free software: You can redistribute it and/or modify it under the terms of the GNU General Public License, either version 3 of the License, or (at your option) any later version.