# ImageGoNord - RGB image and video to any kind of palette or theme
[](https://pypi.org/project/image-go-nord/)
[](https://github.com/Schrodinger-Hat/ImageGoNord-pip/blob/master/LICENSE)
[](https://spectrum.chat/image-go-nord)
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](https://ign.schrodinger-hat.it) for testing out the package.
The main repository of this whole project is [ImageGoNord](https://github.com/Schrodinger-Hat/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](https://github.com/Schrodinger-Hat/ImageGoNord-pip/tree/master/docs) 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.
<br>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**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test.jpg)
**Processed with avg algorithm**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-average.jpg)
-----
**Original**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-profile.jpg)
**Processed with avg algorithm**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-profile-average.jpg)
### ImageGoNord with AI - PaletteNet
We implemented the PaletteNet model with PyTorch based on [this implementation](https://github.com/AakritiKinra/PaletteNet-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**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-profile.jpg)
**AI processed - Aurora palette from Nordtheme**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-profile-ai-aurora.jpg)
-----
**Original**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/sh.png)
**AI processed - Nordtheme**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-sh-ai.png)
-----
**Original**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/valley.jpg)
**AI processed - Nordtheme**
[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-valley-ai.jpg)
-----
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](https://github.com/Schrodinger-Hat/ImageGoNord-pip/tree/master/docs/example) to getting started properly!
### Contributing
- Follow the contributor guidelines
- Follow the code style / requirements
- Format for commit messages
# Authors
[TheJoin95](https://github.com/TheJoin95) & [Wabri](https://github.com/Wabri)
### License
[AGPLv3 license](https://github.com/Schrodinger-Hat/ImageGoNord-pip/blob/master/LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/Schrodinger-Hat/ImageGoNord-pip",
"name": "image-go-nord",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": null,
"keywords": "nordtheme, pillow, image, conversion, rgb, color-scheme, color-palette, linux-rice, gruvbox, catpuccin",
"author": "Schrodinger Hat",
"author_email": "schrodinger.hat.show@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c1/28/56e2178a6f55dd045278b8cecd10f929f074012900448616133f36889855/image-go-nord-1.2.0.tar.gz",
"platform": null,
"description": "# ImageGoNord - RGB image and video to any kind of palette or theme\n\n\n[](https://pypi.org/project/image-go-nord/)\n[](https://github.com/Schrodinger-Hat/ImageGoNord-pip/blob/master/LICENSE)\n[](https://spectrum.chat/image-go-nord)\n\nA tool that can convert your rgb images to nordtheme, gruvbox, catpuccin and many more palettes.\nVideo included.\n\nThis repository is a python package.\n\nYou can find a demo on [the website](https://ign.schrodinger-hat.it) for testing out the package.\nThe main repository of this whole project is [ImageGoNord](https://github.com/Schrodinger-Hat/ImageGoNord).\n\nIt's including an API layer, in case you'd like to set it up also for your project.\n\n### Documentation\n\nYou can find the [documentation into this repository](https://github.com/Schrodinger-Hat/ImageGoNord-pip/tree/master/docs) and also on the website.\nIf you have any questions, please reach us at us@schrodinger-hat.it\n\n### Inspiration\n\nWe are in love with Nordtheme, that is why we created this repository.\n\nOur goal is to make a shortcut to convert anything into any kind of themes, by starting from the images and going to videos.\n<br>An example could be an awesome wallpaper converted into the Nordtheme palette.\n\nWe checked the commnunity and we did not find anything similar or any project that can accomplish this task. So, here we are.\n\nOf course, we resolved the issue for any kind of palette, theme and it's video supported.\n\n### What you can do with this package\n\nYou can convert any image into the nord palette (or others). Here are some examples:\n\n**Original**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test.jpg)\n\n\n**Processed with avg algorithm**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-average.jpg)\n\n\n-----\n\n**Original**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-profile.jpg)\n\n\n**Processed with avg algorithm**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-profile-average.jpg)\n\n\n### ImageGoNord with AI - PaletteNet\n\nWe implemented the PaletteNet model with PyTorch based on [this implementation](https://github.com/AakritiKinra/PaletteNet-Implementation).\nInside that repository you could find the paper, in case you'd like to develop and train your model.\n\nThere is a lot of room for improvement as the shape of the input is reduced to only 6 colors.\n\nHere are some results that you could compare with other. On our point of view, AI model it seems working great with wallpaper.\n\n**Original**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-profile.jpg)\n\n**AI processed - Aurora palette from Nordtheme**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-profile-ai-aurora.jpg)\n\n-----\n\n**Original**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/sh.png)\n\n**AI processed - Nordtheme**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-sh-ai.png)\n\n-----\n\n**Original**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/valley.jpg)\n\n**AI processed - Nordtheme**\n\n[](https://raw.githubusercontent.com/Schrodinger-Hat/ImageGoNord-pip/master/images/test-valley-ai.jpg)\n\n-----\n\nYou can also convert videos into the nord palette (or others). Here is an example: \n**Original** \n\nhttps://github.com/05Alston/ImageGoNord-pip/assets/89850018/76d4c4a6-9660-4a02-9f46-e5f3f6d0147a\n\n**Processed with algorithm**\n\nhttps://github.com/05Alston/ImageGoNord-pip/assets/89850018/13822280-c019-49b1-92f7-7c658b33a01d\n\n### Core Technical Concepts\n\nWe are using the PIL because it is the most simple library and it is very useful when you need to manipulate some images.\n\nOur goal is also to make this project open source and maintainable by the community. We would love to.\n\n*We believe in the open source community.*\n\n### Getting Started\n\nGetting it from PIP\n\n```\npip install image-go-nord\n```\n\nThen you can use [some example](https://github.com/Schrodinger-Hat/ImageGoNord-pip/tree/master/docs/example) to getting started properly!\n\n### Contributing\n- Follow the contributor guidelines\n- Follow the code style / requirements\n- Format for commit messages\n\n# Authors\n\n[TheJoin95](https://github.com/TheJoin95) & [Wabri](https://github.com/Wabri)\n\n### License\n\n[AGPLv3 license](https://github.com/Schrodinger-Hat/ImageGoNord-pip/blob/master/LICENSE)\n\n\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "A tool to convert any RGB image or video to any theme or color palette input by the user",
"version": "1.2.0",
"project_urls": {
"Bug Reports": "https://github.com/Schrodinger-Hat/ImageGoNord-pip/issues",
"Download": "https://github.com/Schrodinger-Hat/ImageGoNord-pip/releases",
"Homepage": "https://ign.schrodinger-hat.it",
"Source": "https://github.com/Schrodinger-Hat/ImageGoNord-pip"
},
"split_keywords": [
"nordtheme",
" pillow",
" image",
" conversion",
" rgb",
" color-scheme",
" color-palette",
" linux-rice",
" gruvbox",
" catpuccin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2e94d7ff3a8bbf565157f70ff05e7cc70bbdefe05c9a0960ab5b738b5d416199",
"md5": "d6c7aeea8c5b1aed23fcfba813054647",
"sha256": "76998131686152771faf38265eac343feb1fb897a32f878dde1fbc4c4d908cd5"
},
"downloads": -1,
"filename": "image_go_nord-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d6c7aeea8c5b1aed23fcfba813054647",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 29081,
"upload_time": "2024-10-05T17:49:50",
"upload_time_iso_8601": "2024-10-05T17:49:50.979855Z",
"url": "https://files.pythonhosted.org/packages/2e/94/d7ff3a8bbf565157f70ff05e7cc70bbdefe05c9a0960ab5b738b5d416199/image_go_nord-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c12856e2178a6f55dd045278b8cecd10f929f074012900448616133f36889855",
"md5": "11085c53695ba3ba1cc24cd785244ae7",
"sha256": "e156503d966d08b0e74d762672276cbf837698dd689424be4673e411db7c53c1"
},
"downloads": -1,
"filename": "image-go-nord-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "11085c53695ba3ba1cc24cd785244ae7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 26451,
"upload_time": "2024-10-05T17:49:52",
"upload_time_iso_8601": "2024-10-05T17:49:52.232124Z",
"url": "https://files.pythonhosted.org/packages/c1/28/56e2178a6f55dd045278b8cecd10f929f074012900448616133f36889855/image-go-nord-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-05 17:49:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Schrodinger-Hat",
"github_project": "ImageGoNord-pip",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "image-go-nord"
}
JSON
