Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/liviu-/average-pixels

CLI tool to generete new images from old images
https://github.com/liviu-/average-pixels

Last synced: about 1 month ago
JSON representation

CLI tool to generete new images from old images

Awesome Lists containing this project

README

        

# Average Pixels [![Build Status](https://travis-ci.org/liviu-/average-pixels.svg?branch=develop)](https://travis-ci.org/liviu-/average-pixels)

Command line tool which takes a bunch of images, and outputs a JPEG combining the images using a weighted average where the weights are samples drawn from the Dirichlet distribution.

```sh
$ average-pixels download "party explosions boom" --offset 90 --count 30
```

![party_explosions_boom](images/party_explosions_boom.jpg)

## Installation

```sh
$ python3 -m pip install average-pixels
```

## Configuration
The application in `download` mode uses [Bing Search API](https://www.microsoft.com/cognitive-services/en-us/bing-image-search-api) to search for images so it requires the user to have an API key activated for Bing's search service. To obtain one:

- [Create a Microsoft account](https://signup.live.com/signup) if you don't have one
- Get an API key for the [Bing Image Search Service](https://www.microsoft.com/cognitive-services/en-us/bing-image-search-api)


Once obtained, the key may be provided through various methods:

- When prompted by the application
- By storing it in `~/.average_pixels_api`
- Or via the `AVERAGE_PIXELS_API` environment variable (e.g. `$ export AVERAGE_PIXELS_API=$key`)

## Example usage:

The application has 2 modes:

- `local`: Combines local files and outputs the combined image
- `download`: Takes keywords from the user, and combines images from Bing Image Search

```sh
$ average-pixels download "black cats"
```

![black_cats](images/black_cats.jpg)

```sh
$ average-pixels download "green field blue sky"
```

![green_field_blue_sky](images/green_field_blue_sky.jpg)

```sh
$ average-pixels download "just give me some random photo"
```

![just_give_me_some_random_photo](images/just_give_me_some_random_photo.jpg)

```sh
$ average-pixels download "no"
```

![no](images/no.jpg)

```sh
$ average-pixels download "insects" --count 30
```

![insects](images/insects.jpg)

```sh
$ average-pixels local /tmp/average_images --offset 40
```

![existing_dir](images/existing_dir.jpg)

```sh
$ average-pixels download "turner" --count 20
```

![turner](images/turner.jpg)

```sh
$ average-pixels download "jackson pollock painting" --count 10 --offset 30
```

![jackson_pollock](images/jackson_pollock_painting.jpg)

```sh
$ average-pixels download "green" --count 100
```

![green](images/green.jpg)

```sh
$ average-pixels local images/
```

![local_dir](images/output.jpg)