Skip to main content

A tool to convert any RGB image or video to any theme or color palette input by the user

Project description

ImageGoNord - RGB image and video to any kind of palette or theme

PyPI - Python Version PyPI license Join the community on Spectrum

A tool that can convert your rgb images to nordtheme, gruvbox, catpuccin and many more palettes. Video included.

This repository is a python package.

You can find a demo on the website for testing out the package. The main repository of this whole project is ImageGoNord.

It's including an API layer, in case you'd like to set it up also for your project.

Documentation

You can find the documentation into this repository and also on the website. If you have any questions, please reach us at us@schrodinger-hat.it

Inspiration

We are in love with Nordtheme, that is why we created this repository.

Our goal is to make a shortcut to convert anything into any kind of themes, by starting from the images and going to videos.
An example could be an awesome wallpaper converted into the Nordtheme palette.

We checked the commnunity and we did not find anything similar or any project that can accomplish this task. So, here we are.

Of course, we resolved the issue for any kind of palette, theme and it's video supported.

What you can do with this package

You can convert any image into the nord palette (or others). Here are some examples:

Original

Original

Processed with avg algorithm

Original


Original

Original

Processed with avg algorithm

Original

ImageGoNord with AI - PaletteNet

We implemented the PaletteNet model with PyTorch based on this implementation. Inside that repository you could find the paper, in case you'd like to develop and train your model.

There is a lot of room for improvement as the shape of the input is reduced to only 6 colors.

Here are some results that you could compare with other. On our point of view, AI model it seems working great with wallpaper.

Original

Original

AI processed - Aurora palette from Nordtheme

Converted


Original

Original

AI processed - Nordtheme

Converted


Original

Original

AI processed - Nordtheme

Converted


You can also convert videos into the nord palette (or others). Here is an example:
Original

https://github.com/05Alston/ImageGoNord-pip/assets/89850018/76d4c4a6-9660-4a02-9f46-e5f3f6d0147a

Processed with algorithm

https://github.com/05Alston/ImageGoNord-pip/assets/89850018/13822280-c019-49b1-92f7-7c658b33a01d

Core Technical Concepts

We are using the PIL because it is the most simple library and it is very useful when you need to manipulate some images.

Our goal is also to make this project open source and maintainable by the community. We would love to.

We believe in the open source community.

Getting Started

Getting it from PIP

pip install image-go-nord

Then you can use some example to getting started properly!

Contributing

  • Follow the contributor guidelines
  • Follow the code style / requirements
  • Format for commit messages

Authors

TheJoin95 & Wabri

License

AGPLv3 license

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

image-go-nord-1.2.0.tar.gz (26.5 kB view details)

Uploaded Source

Built Distribution

image_go_nord-1.2.0-py3-none-any.whl (29.1 kB view details)

Uploaded Python 3

File details

Details for the file image-go-nord-1.2.0.tar.gz.

File metadata

  • Download URL: image-go-nord-1.2.0.tar.gz
  • Upload date:
  • Size: 26.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for image-go-nord-1.2.0.tar.gz
Algorithm Hash digest
SHA256 e156503d966d08b0e74d762672276cbf837698dd689424be4673e411db7c53c1
MD5 11085c53695ba3ba1cc24cd785244ae7
BLAKE2b-256 c12856e2178a6f55dd045278b8cecd10f929f074012900448616133f36889855

See more details on using hashes here.

File details

Details for the file image_go_nord-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for image_go_nord-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 76998131686152771faf38265eac343feb1fb897a32f878dde1fbc4c4d908cd5
MD5 d6c7aeea8c5b1aed23fcfba813054647
BLAKE2b-256 2e94d7ff3a8bbf565157f70ff05e7cc70bbdefe05c9a0960ab5b738b5d416199

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page