Skip to content
Pixelate since 1961
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config
lib
static
test
.formatter.exs
.gitignore
.tool-versions
LICENSE
README.md
img196.jpg
mix.exs
mix.lock
release.sh

README.md

since 1961

🖼 Vostok

Vostok converts an image to a pixelated SVG.

Восток (Vostok in English) was the Russian spacecraft that in 1961 allowed the first human spaceflight. 🚀

Requirements

Vostok requires imagemagick to work.

Install it with:

MacOSX: brew install imagemagick

Linux: search your distribution repositories for imagemagick package;
eg: sudo apt install imagemagick

Windows: Chocolatey has an imagemagick package, but no tests have been done :)

Build

Vostok has been successfully built using elixir 1.7.4 and erlang 20.3.8.14. Has not been tested on different versions.

To build from command line:

$ # clone using HTTPS URL
$ git clone https://github.com/spawnfest/vostok.git && cd vostok
$ # clone using SSH URL
$ git clone git@github.com:spawnfest/vostok.git && cd vostok

Then install dependencies and build the CLI application:

$ mix deps.get
$ mix escript.build

Usage

Vostok takes the path of the image to convert:

$ vostok path/to/the/image.jpg

Execute vostok --help to see usage and help.

Has been tested with jpg and png image formats, works probably with other formats supported by ImageMagick.

Once Vostok finishes processing the image, it tries to open you browser at static/index.html to display it's work.
In case this does not happen, manually open the index.html file in the static folder of this repository with a recent browser.

Testing

You can run the supplied test suite with:

$ mix test
You can’t perform that action at this time.