https://github.com/daniel-seiler/ImageTheming

Match a wallpaper to your color scheme
https://github.com/daniel-seiler/ImageTheming

Last synced: 3 months ago
JSON representation

Match a wallpaper to your color scheme

• Host: GitHub
• URL: https://github.com/daniel-seiler/ImageTheming
• Owner: daniel-seiler
• License: agpl-3.0
• Created: 2021-09-04T09:32:41.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2024-01-30T22:01:20.000Z (9 months ago)
• Last Synced: 2024-05-29T04:09:41.331Z (6 months ago)
• Language: Kotlin
• Homepage:
• Size: 1.8 MB
• Stars: 242
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ImageTheming

Change the color palette of an image to match your theme.

## Getting Started

Use `java -jar path/to/ImageTheming.jar -h` to get all available options that can/need to be set, to generate an image.

There must always be exactly one path and one theme for the program to work. An error message will appear if some 

options are set incorrect. Simple example:  

```shell

java -jar ImageTheming.jar https://avatars.githubusercontent.com/u/73987329\?v\=4 --theme=omni

```

This will select the image from the [link](https://avatars.githubusercontent.com/u/73987329\?v\=4) (a path instead of a 

link is also possible) and select the color scheme to be 

[Omni](https://raw.githubusercontent.com/Mayccoll/Gogh/master/themes/omni.sh). 

Original | New image with Omni theme

--- | ---

![](resources/avatars.githubusercontent.com-original.png) | ![](resources/avatars.githubusercontent.com-omni.png)

## Selecting a theme

You can either use a config file or a premade theme to select the colors.  

If a file is selected, all hex numbers with the length of 6 are used as colors.  

If you want to use a premade theme, choose a color scheme from 

[these](https://github.com/Mayccoll/Gogh/tree/master/themes) files (without the .sh extension). Example: `OneDark -> one-dark.sh -> ... -t=one-dark` or `-t=.config/colors`

## Why

Ever wanted to use a wallpaper, but it didn't match your color theme?

## What to expect

This program will take an image and a theme from [Gogh](https://mayccoll.github.io/Gogh/) as minimal input. It then 

tries to match each pixel with a color from the given theme. The output is color-wise a downscaled version of the 

original image. Because of this, the best results can be achieved with images that have little to no blur, high 

resolution and clear defined lines. If you're going to watch all day at a generated image (wallpaper), you may want to 

edit the generated images afterwards in GIMP/similar software.  

To compare quality, here you have some examples. Keep in mind these are fairly zoomed in:

original | nord | solarized-dark | maia

--- | --- | --- | ---

![](resources/astronaut-with-jellyfish.png) | ![](resources/astronaut-with-jellyfish-nord.png) | ![](resources/astronaut-with-jellyfish-solarized-dark.png) | ![](resources/astronaut-with-jellyfish-maia.png)

## How to build

* [Install gradle](https://gradle.org/install/)

* Run `gradle jar`  

This will create the executable JAR file in build/libs/ImageTheming.jar