Skip to content

sebashwa/vixl44

Repository files navigation

Logo

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

Keys Action
h,j,k,l Move cursor left, down, up, right
w Move cursor 5 columns right
b Move cursor 5 columns left
Ctrl-d Move cursor 5 rows down
Ctrl-u Move cursor 5 rows up

Normal Mode

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

Visual Block Mode

Keys Action
Space, Return Paint color
x, d Cut area
y Copy area
Esc Switch to normal mode
c Switch to palette mode

Palette Mode

Keys Action
Space, Return Select color
Esc Switch to normal mode
Ctrl-v 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.

Releases

No releases published

Packages

No packages published