Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JuanPotato/Legofy
Make images look as if they are made out of 1x1 LEGO blocks
https://github.com/JuanPotato/Legofy
Last synced: 13 days ago
JSON representation
Make images look as if they are made out of 1x1 LEGO blocks
- Host: GitHub
- URL: https://github.com/JuanPotato/Legofy
- Owner: JuanPotato
- License: mit
- Created: 2015-10-15T02:18:53.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-02-28T02:13:55.000Z (8 months ago)
- Last Synced: 2024-04-24T11:08:59.929Z (7 months ago)
- Language: Python
- Homepage:
- Size: 6.3 MB
- Stars: 3,139
- Watchers: 76
- Forks: 183
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome-github-stars - JuanPotato/Legofy - Make images look as if they are made out of 1x1 LEGO blocks (Python)
- starred - JuanPotato/Legofy - Make images look as if they are made out of 1x1 LEGO blocks (Python)
README
# Legofy [](https://travis-ci.org/JuanPotato/Legofy) [](https://pypi.python.org/pypi/legofy) [](https://pypi.python.org/pypi/legofy) [](https://pypi.python.org/pypi/legofy) [](https://coveralls.io/github/JuanPotato/Legofy?branch=master) [](https://landscape.io/github/JuanPotato/Legofy/master) [](https://gitter.im/JuanPotato/Legofy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
### What is it?
Legofy is a python program that takes a static image or gif and makes it so that it looks as if it was built out of LEGO.
### Requirements
* Python
* Python modules: Pillow, click # pip will install these automatically if using `pip install legofy`
* imagemagick # not needed but recommended
### Bugs
If you find a bug:
1. Check in the [open issues](https://github.com/JuanPotato/Legofy/issues) if the bug already exists.
2. If the bug is not there, create a [new issue](https://github.com/JuanPotato/Legofy/issues/new) with clear steps on how to reproduce it.
### Quickstart
```shell
$ pip install legofy
```
or install from source
```shell
$ git clone https://github.com/JuanPotato/Legofy.git
$ cd Legofy
$ python setup.py install
```
Wait! I don't know what any of this means? Use pip then, or if you really want to install from source [have some help.](#installation)
### Usage
```
Usage: legofy [OPTIONS] IMAGE [OUTPUT]
Legofy an image!
Options:
--size INTEGER Number of bricks the longest side of the legofied image should have.
--dither / --no-dither Use dither algorithm to spread the color approximation error.
--palette [all|effects|mono|solid|transparent]
Palette to use based on real Lego colors.
--help Show this message and exit.
```
#### Palette
There are 3 palettes: solid (33 colors), transparent (14 colors) and effects (4 colors).
You can use one of them or all the 3.
```shell
$ legofy --palette solid image.jpg
$ legofy --palette transparent image.jpg
$ legofy --palette effects image.jpg
$ legofy --palette all image.jpg
```
There is another one palette, mono, with only 2 colors (black and white...). It's just for test and fun...
### Troubleshooting
* [Mac](http://pillow.readthedocs.org/en/3.0.x/installation.html#os-x-installation)
* [Linux](http://pillow.readthedocs.org/en/3.0.x/installation.html#linux-installation)
* [Windows](http://pillow.readthedocs.org/en/3.0.x/installation.html#windows-installation)
### Installation
1. Download and install all requirements
* python from the [official python website](https://www.python.org/)
* imagemagick from the [official imagemagick website](https://imagemagick.org/)
2. Download this project by using the download zip button on this page, or running `git clone https://github.com/JuanPotato/Legofy`
* If you downloaded a zip file, please unzip it
3. Open a command line and navigate to the project folder
4. Run `python setup.py install` while in the project folder
5. You can now use Legofy anywhere, see [usage](#usage) for more help
### Forks
* JavaScript: [Legofy](https://github.com/Wildhoney/Legofy)
