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

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

Last synced: 8 days ago
JSON representation

CLI tool to generete new images from old images

• Host: GitHub
• URL: https://github.com/liviu-/average-pixels
• Owner: liviu-
• License: mit
• Created: 2016-06-11T08:29:56.000Z (almost 9 years ago)
• Default Branch: develop
• Last Pushed: 2022-11-22T01:08:46.000Z (over 2 years ago)
• Last Synced: 2025-03-14T01:04:57.639Z (about 1 month ago)
• Language: Python
• Homepage:
• Size: 417 KB
• Stars: 8
• Watchers: 3
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• my-awesome-github-stars - liviu-/average-pixels - CLI tool to generete new images from old images (Python)

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)