<h1 align=center>PyPalEx</h1>
<h3 align=center>Python Palette Extractor</h3>
<p align=center>
<a href="https://github.com/AlTimofeyev/pypalex/releases"><img src="https://img.shields.io/github/v/release/AlTimofeyev/pypalex.svg?colorA=151515&colorB=8C977D&style=for-the-badge"></a>
<a href="https://github.com/AlTimofeyev/pypalex/stargazers"><img src="https://img.shields.io/github/stars/AlTimofeyev/pypalex?colorA=151515&colorB=D9BC8C&style=for-the-badge"></a>
<a href="https://github.com/AlTimofeyev/pypalex/network/members"><img src="https://img.shields.io/github/forks/AlTimofeyev/pypalex?colorA=151515&colorB=8DA3B9&style=for-the-badge"></a>
<a href="https://github.com/AlTimofeyev/pypalex/blob/main/LICENSE"><img src="https://img.shields.io/static/v1?label=license&message=MIT&color=B66467&labelColor=151515&style=for-the-badge"></a>
</p>
<img src="https://github.com/AlTimofeyev/pypalex/blob/main/Assets/README_EXAMPLE-tsujin_bohboh-Holiday.PNG" alt="Package Example with Background Image by tsujin_bohboh on Twitter" title="Package Example with Background Image by tsujin_bohboh on Twitter" align="center">
<p align="justify">
PyPalEx is a tool for extracting color palettes from images and generating a JSON format file with light and dark color themes. This tool is intended to be OS independent, for use by the tech community for developing their own custom theme managers or by artists who want to extract color palettes for their art from images, pictures or wallpapers they adore.
</p>
<br>
<br>
<h2 align=center>TABLE OF CONTENTS</h2>
- [**PyPalEx Archives**](#pypalex-archives)
- [Wiki Homepage](#wiki-homepage)
- [Palette Examples Archive](#wiki-palette-examples-archive)
- [Code Documentation](#code-documentation)
- [**Dependencies**](#dependencies)
- [Environment Variables](#environment-variables)
- [**Installation**](#installation)
- [PIP Install](#pip-install)
- [Manual/Git Install](#manualgit-install)
- [**User Guide**](#user-guide)
- [Disclosure](#disclosure)
- [Options List](#options-list)
- [Notes](#notes)
- [Example Usage](#example-usage)
- [**Feedback**](#feedback)
<br>
<br>
<h2 align=center id="pypalex-archives">PYPALEX ARCHIVES</h2>
<h3 align=center>
[<a href="https://github.com/AlTimofeyev/pypalex/wiki">Wiki Homepage</a>]
[<a href="https://github.com/AlTimofeyev/pypalex/wiki/Archive-of-Palette-Examples">Palette Examples Archive</a>]
[<a href="https://github.com/AlTimofeyev/pypalex/blob/main/pypalex_code_documentation.pdf">Codebase Documentation</a>]
</h3>
<br>
<h2 align=center id="dependencies">DEPENDENCIES</h2>
Aside from Python, the rest are Python packages that are installable with pip.
- `Python 3.6+`
- `Pillow (PIL) 9.0+`
- For performing operations on images.
- `NumPy 1.21+`
- To manage large amounts of image data.
- `filetype 1.0+`
- To confirm filetypes are images file types.
### ENVIRONMENT VARIABLES
There are two optional environement variables that can be set by the user:
- `PYPALEX_CACHE_DIR`
- `PYPALEX_CONFIG_DIR`
By default, PyPalEx will try to store extracted color palettes into one of three locations:
- `PYPALEX_CONFIG_DIR`
- `XDG_CONFIG_HOME/palex`
- `$HOME/.config/palex`
By default, PyPalEx will try to save extracted color palettes wherever `PYPALEX_CONFIG_DIR` points to in the user's system. If the user does not set the `PYPALEX_CONFIG_DIR` environment variable, then PyPalEx will default to saving extracted color palettes wherever `XDG_CONFIG_HOME/palex` points to in the user's system. And if the `XDG_CONFIG_HOME` environment variable is not set, then PyPalEx will default to saving extracted color palettes into `$HOME/.config/palex`.
_This default output location is, of course, overriden if PyPalEx is used with the `-o --output` option._
<h2 align=center id="installation">INSTALLATION</h2>
### PIP INSTALL
#### **System-wide install (*`sudo`*)**
```sh
pip3 install pypalex
```
#### **User install (*No `sudo`*)**
```sh
pip3 install --user pypalex
# Add local 'pip' to PATH:
# (In your .bashrc, .zshrc etc)
export PATH="${PATH}:${HOME}/.local/bin/"
```
### MANUAL/GIT INSTALL
```sh
git clone https://github.com/AlTimofeyev/pypalex
cd pypalex
pip3 install --user .
# Add local 'pip' to PATH:
# (In your .bashrc, .zshrc etc)
export PATH="${PATH}:${HOME}/.local/bin/"
```
<h2 align=center id="user-guide">USER GUIDE</h2>
### DISCLOSURE
- PyPalEx can only work on images that are in the RBG color space, so any images that you supply to PyPalEx that are not already in RGB will automatically be converted into RGB color space before the extraction process begins.
- PyPalEx takes about ~5 seconds on average to process an image and extract color palettes.
- When using PyPalEx on a directory of images, you can calculate the time it takes to process all the images by multiplying the number of images by 5 seconds.
- Example: You have a directory of 20 images. So the time it will take to process all the images is
20 x 5 = ~100 seconds
<p align=justify>
Some images may take 2-3 seconds to be processed while other images may take 4-5 seconds to be processed. But the average wait time for an image to be processed and for color palettes to be extracted is about ~5 seconds.
</p>
### OPTIONS LIST
- `-f --files`
- Specify the absolute file path(s).
- If used with `-p --path` option, you only need to specify the relative file path(s).
- `-p --path`
- Specify the path from where to use images.
- Absolute path is preferred, but relative path can also be used.
- `-o --output`
- Specify the output path where to store the JSON color palette.
- `--save-check`
- Asks if the user wants to save the extracted color palettes.
- `--preview`
- Shows a preview of the extracted color palettes before saving.
- `--preview-check`
- Shows a preview of, and asks if the user wants to save, the extracted color palettes.
- `--pastel`
- Converts all color palettes into pastel.
- `--pastel-light`
- Converts light color palette into pastel.
- `--pastel-normal`
- Converts normal color palette into pastel.
- `--pastel-dark`
- Converts dark color palette into pastel.
- `--sat_pref`
- Gives preference to more saturated colors of all color palettes.
- `--sat_pref-light`
- Gives preference to more saturated colors of the light color palette.
- `--sat_pref-normal`
- Gives preference to more saturated colors of the normal color palette.
- `--sat_pref-dark`
- Gives preference to more saturated colors of the dark color palette.
- `-v --version`
- Prints the PyPalEx version.
### NOTES
- When using PyPalEx, the use of either `-f --files` and/or `-p --path` is a **MUST**. Without either, or both of, these two options being specified, PyPalEx will not work.
- PyPalEx will skip over any files that are not images.
- Please note that all the `--pastel` and `--sat_pref` options only affect the 6 base colors (red, green, yellow, blue, magenta, cyan) and do **NOT** affect the background, foreground, black, and white colors.
- Please note that the user can individually select which palette to convert to pastel (do not mistake palette for "color scheme/color theme"). For more details, please refer to the PyPalEx wiki homepage to identify which "color scheme/color theme" contains the palette you wish to convert to pastel.
### EXAMPLE USAGE
#### **`-f --files` Option**
```sh
palex -f path/to/image/dir/image.jpeg
```
```sh
palex -f path/to/image/dir/image.jpeg path/to/image/dir/image2.PNG
```
The `-f --files` option can be used with a singular image file or with multiple image files. The user must specify the absolute file path to the image they want to use with PyPalEx. However, if the user is already within the directory where the images are located, then a relative file path is also acceptable.
```sh
~ > cd path/to
~/path/to >
~/path/to > palex -f image/dir/image.jpeg image/dir/image2.PNG
```
```sh
~ > cd path/to
~/path/to >
~/path/to > palex -f image/dir/image.jpeg
```
```sh
~/path/to > cd image/dir
~/path/to/image/dir >
~/path/to/image/dir > palex -f image.JPEG image2.png
```
The above examples are meant to show how a user can navigate to a direcotry with images, or at least relatively close to a directory with images, and then use PyPalEx with the `-f --files` option and relative file path(s).
<br>
#### **`-p --path` Option**
```sh
palex -p path/to/image/dir/
```
```sh
palex -p path/to/ -f image/dir/image.png
```
```sh
palex -p path/to/image/dir/ -f image.png
```
```sh
palex -f image1.png image2.jpg image3.jpeg -p path/to/image/dir/
```
The `-p --path` option can be used with a whole directory of images and files or it can be used as a reference point for the `-f --files` option. When the `-f --files` option is used with `-p --path`, the user does not have to specify the absolute path to the images, just the relative image names/filepath(s). The directory that was provided with `-p --path` will be searched for the image names/filepath(s) specified.
<br>
#### **`-o --output` Option**
```sh
palex -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
```sh
palex -o path/to/output/dir/ -p path/to/image/dir/
```
```sh
palex -p path/to/image/dir/ -f image.png -o path/to/output/dir/
```
```sh
palex -f image1.png image2.jpg image3.jpeg -o path/to/output/dir/ -p path/to/image/dir/
```
The `-o --output` option can be used with both the `-f --files` and `-p --path` options. The sole purpose of the `-o --output` option is to let the user override the default output directory. Please refer to [Environment Variables](#environment-variables) for details about the default output directory.
<br>
#### **`--save-check` Option**
```sh
palex -f path/to/image/dir/image.jpeg -o path/to/output/dir/ --save-check
```
Asks if the user wants to save the extracted color palettes after the extraction process is completed.
<br>
#### **`--preview` Option**
```sh
palex -f path/to/image/dir/image.jpeg -o path/to/output/dir/ --preview
```
Shows a preview of the extracted color palettes before saving. This option requires that the user's terminal has the capability to show ASCII characters and ANSI colors. A future update may include a GUI variation of this preview option to avoid this issue.
<br>
#### **`--preview-check` Option**
```sh
palex -f path/to/image/dir/image.jpeg -o path/to/output/dir/ --preview-check
```
Shows a preview of, and asks if the user wants to save, the extracted color palettes. This option is a combination of the `--preview` and `--save-check` options. This option requires that the user's terminal has the capability to show ASCII characters and ANSI colors. A future update may include a GUI variation of this preview option to avoid this issue.
<br>
#### **`--pastel` Option**
```sh
palex --pastel -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
Converts all the extracted color palettes into pastel.
<br>
#### **`--pastel-light` Option**
```sh
palex --pastel-light -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
Converts light color palette into pastel.
<br>
#### **`--pastel-normal` Option**
```sh
palex --pastel-normal -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
Converts normal color palette into pastel.
<br>
#### **`--pastel-dark` Option**
```sh
palex --pastel-dark -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
Converts dark color palette into pastel.
<br>
#### **`--sat_pref` Option**
```sh
palex --sat_pref -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
Gives preference to more saturated colors of all color palettes during the extraction process.
<br>
#### **`--sat_pref-light` Option**
```sh
palex --sat_pref-light -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
Gives preference to more saturated colors of the light color palette during the extraction process.
<br>
#### **`--sat_pref-normal` Option**
```sh
palex --sat_pref-normal -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
Gives preference to more saturated colors of the normal color palette during the extraction process.
<br>
#### **`--sat_pref-dark` Option**
```sh
palex --sat_pref-dark -f path/to/image/dir/image.jpeg -o path/to/output/dir/
```
Gives preference to more saturated colors of the dark color palette during the extraction process.
<br>
#### **`-v --version` Option**
```sh
palex -v
```
```sh
palex --version
```
The `-v --version` option is used to print the PyPalEx version number.
<h2 align=center id="feedback">FEEDBACK</h2>
<p align=justify>
Any and all feedback is greatly appreciated and welcomed. On the PyPalEx GitHub repository, there is a <b><a href="https://github.com/AlTimofeyev/pypalex/discussions">Discussion</a></b> post that is available for each Release version of PyPalEx and open to everyone for any comments or feedback on the version of PyPalEx you are using.
</p>
[//]: # (Include Contributions Section Later)
Raw data
{
"_id": null,
"home_page": "https://github.com/AlTimofeyev/pypalex",
"name": "pypalex",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "python,pypalex,palex,color-palette,colorscheme,extract-colorscheme,extract-palette,extractor",
"author": "Al Timofeyev",
"author_email": "al.timofeyev@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/18/21/240a5b62f24515bb99c5d06cb895f7a9df17466a838c42f306dcac1ec8fd/pypalex-1.3.3.tar.gz",
"platform": null,
"description": "<h1 align=center>PyPalEx</h1>\n\n<h3 align=center>Python Palette Extractor</h3>\n\n<p align=center>\n <a href=\"https://github.com/AlTimofeyev/pypalex/releases\"><img src=\"https://img.shields.io/github/v/release/AlTimofeyev/pypalex.svg?colorA=151515&colorB=8C977D&style=for-the-badge\"></a>\n <a href=\"https://github.com/AlTimofeyev/pypalex/stargazers\"><img src=\"https://img.shields.io/github/stars/AlTimofeyev/pypalex?colorA=151515&colorB=D9BC8C&style=for-the-badge\"></a>\n <a href=\"https://github.com/AlTimofeyev/pypalex/network/members\"><img src=\"https://img.shields.io/github/forks/AlTimofeyev/pypalex?colorA=151515&colorB=8DA3B9&style=for-the-badge\"></a>\n <a href=\"https://github.com/AlTimofeyev/pypalex/blob/main/LICENSE\"><img src=\"https://img.shields.io/static/v1?label=license&message=MIT&color=B66467&labelColor=151515&style=for-the-badge\"></a>\n</p>\n\n<img src=\"https://github.com/AlTimofeyev/pypalex/blob/main/Assets/README_EXAMPLE-tsujin_bohboh-Holiday.PNG\" alt=\"Package Example with Background Image by tsujin_bohboh on Twitter\" title=\"Package Example with Background Image by tsujin_bohboh on Twitter\" align=\"center\">\n\n<p align=\"justify\">\nPyPalEx is a tool for extracting color palettes from images and generating a JSON format file with light and dark color themes. This tool is intended to be OS independent, for use by the tech community for developing their own custom theme managers or by artists who want to extract color palettes for their art from images, pictures or wallpapers they adore.\n</p>\n\n<br>\n<br>\n\n<h2 align=center>TABLE OF CONTENTS</h2>\n\n- [**PyPalEx Archives**](#pypalex-archives)\n - [Wiki Homepage](#wiki-homepage)\n - [Palette Examples Archive](#wiki-palette-examples-archive)\n - [Code Documentation](#code-documentation)\n- [**Dependencies**](#dependencies)\n - [Environment Variables](#environment-variables)\n- [**Installation**](#installation)\n - [PIP Install](#pip-install)\n - [Manual/Git Install](#manualgit-install)\n- [**User Guide**](#user-guide)\n - [Disclosure](#disclosure)\n - [Options List](#options-list)\n - [Notes](#notes)\n - [Example Usage](#example-usage)\n- [**Feedback**](#feedback)\n\n<br>\n<br>\n\n<h2 align=center id=\"pypalex-archives\">PYPALEX ARCHIVES</h2>\n\n<h3 align=center>\n [<a href=\"https://github.com/AlTimofeyev/pypalex/wiki\">Wiki Homepage</a>]\n [<a href=\"https://github.com/AlTimofeyev/pypalex/wiki/Archive-of-Palette-Examples\">Palette Examples Archive</a>]\n [<a href=\"https://github.com/AlTimofeyev/pypalex/blob/main/pypalex_code_documentation.pdf\">Codebase Documentation</a>]\n</h3>\n\n<br>\n\n<h2 align=center id=\"dependencies\">DEPENDENCIES</h2>\n\nAside from Python, the rest are Python packages that are installable with pip.\n- `Python 3.6+`\n- `Pillow (PIL) 9.0+`\n - For performing operations on images.\n- `NumPy 1.21+`\n - To manage large amounts of image data.\n- `filetype 1.0+`\n - To confirm filetypes are images file types.\n\n### ENVIRONMENT VARIABLES\nThere are two optional environement variables that can be set by the user:\n- `PYPALEX_CACHE_DIR`\n- `PYPALEX_CONFIG_DIR`\n\nBy default, PyPalEx will try to store extracted color palettes into one of three locations:\n- `PYPALEX_CONFIG_DIR` \n- `XDG_CONFIG_HOME/palex` \n- `$HOME/.config/palex`\n\nBy default, PyPalEx will try to save extracted color palettes wherever `PYPALEX_CONFIG_DIR` points to in the user's system. If the user does not set the `PYPALEX_CONFIG_DIR` environment variable, then PyPalEx will default to saving extracted color palettes wherever `XDG_CONFIG_HOME/palex` points to in the user's system. And if the `XDG_CONFIG_HOME` environment variable is not set, then PyPalEx will default to saving extracted color palettes into `$HOME/.config/palex`. \n_This default output location is, of course, overriden if PyPalEx is used with the `-o --output` option._\n\n<h2 align=center id=\"installation\">INSTALLATION</h2>\n\n### PIP INSTALL\n#### **System-wide install (*`sudo`*)**\n```sh\npip3 install pypalex\n```\n\n#### **User install (*No `sudo`*)**\n```sh\npip3 install --user pypalex\n\n# Add local 'pip' to PATH:\n# (In your .bashrc, .zshrc etc)\nexport PATH=\"${PATH}:${HOME}/.local/bin/\"\n```\n\n### MANUAL/GIT INSTALL\n```sh\ngit clone https://github.com/AlTimofeyev/pypalex\ncd pypalex\npip3 install --user .\n\n# Add local 'pip' to PATH:\n# (In your .bashrc, .zshrc etc)\nexport PATH=\"${PATH}:${HOME}/.local/bin/\"\n```\n\n<h2 align=center id=\"user-guide\">USER GUIDE</h2> \n\n### DISCLOSURE\n- PyPalEx can only work on images that are in the RBG color space, so any images that you supply to PyPalEx that are not already in RGB will automatically be converted into RGB color space before the extraction process begins.\n- PyPalEx takes about ~5 seconds on average to process an image and extract color palettes.\n- When using PyPalEx on a directory of images, you can calculate the time it takes to process all the images by multiplying the number of images by 5 seconds.\n - Example: You have a directory of 20 images. So the time it will take to process all the images is \n 20 x 5 = ~100 seconds\n\n<p align=justify>\nSome images may take 2-3 seconds to be processed while other images may take 4-5 seconds to be processed. But the average wait time for an image to be processed and for color palettes to be extracted is about ~5 seconds.\n</p>\n\n### OPTIONS LIST\n- `-f --files`\n - Specify the absolute file path(s).\n - If used with `-p --path` option, you only need to specify the relative file path(s).\n- `-p --path`\n - Specify the path from where to use images.\n - Absolute path is preferred, but relative path can also be used.\n- `-o --output`\n - Specify the output path where to store the JSON color palette.\n- `--save-check`\n - Asks if the user wants to save the extracted color palettes.\n- `--preview`\n - Shows a preview of the extracted color palettes before saving.\n- `--preview-check`\n - Shows a preview of, and asks if the user wants to save, the extracted color palettes.\n- `--pastel`\n - Converts all color palettes into pastel.\n- `--pastel-light`\n - Converts light color palette into pastel.\n- `--pastel-normal`\n - Converts normal color palette into pastel.\n- `--pastel-dark`\n - Converts dark color palette into pastel.\n- `--sat_pref`\n - Gives preference to more saturated colors of all color palettes.\n- `--sat_pref-light`\n - Gives preference to more saturated colors of the light color palette.\n- `--sat_pref-normal`\n - Gives preference to more saturated colors of the normal color palette.\n- `--sat_pref-dark`\n - Gives preference to more saturated colors of the dark color palette.\n- `-v --version`\n - Prints the PyPalEx version.\n\n### NOTES\n- When using PyPalEx, the use of either `-f --files` and/or `-p --path` is a **MUST**. Without either, or both of, these two options being specified, PyPalEx will not work.\n- PyPalEx will skip over any files that are not images.\n- Please note that all the `--pastel` and `--sat_pref` options only affect the 6 base colors (red, green, yellow, blue, magenta, cyan) and do **NOT** affect the background, foreground, black, and white colors.\n- Please note that the user can individually select which palette to convert to pastel (do not mistake palette for \"color scheme/color theme\"). For more details, please refer to the PyPalEx wiki homepage to identify which \"color scheme/color theme\" contains the palette you wish to convert to pastel.\n\n### EXAMPLE USAGE\n#### **`-f --files` Option**\n```sh\npalex -f path/to/image/dir/image.jpeg\n```\n```sh\npalex -f path/to/image/dir/image.jpeg path/to/image/dir/image2.PNG\n```\nThe `-f --files` option can be used with a singular image file or with multiple image files. The user must specify the absolute file path to the image they want to use with PyPalEx. However, if the user is already within the directory where the images are located, then a relative file path is also acceptable.\n```sh\n~ > cd path/to\n~/path/to >\n~/path/to > palex -f image/dir/image.jpeg image/dir/image2.PNG\n```\n```sh\n~ > cd path/to\n~/path/to >\n~/path/to > palex -f image/dir/image.jpeg\n```\n```sh\n~/path/to > cd image/dir\n~/path/to/image/dir >\n~/path/to/image/dir > palex -f image.JPEG image2.png\n```\nThe above examples are meant to show how a user can navigate to a direcotry with images, or at least relatively close to a directory with images, and then use PyPalEx with the `-f --files` option and relative file path(s).\n\n<br>\n\n#### **`-p --path` Option**\n```sh\npalex -p path/to/image/dir/\n```\n```sh\npalex -p path/to/ -f image/dir/image.png\n```\n```sh\npalex -p path/to/image/dir/ -f image.png\n```\n```sh\npalex -f image1.png image2.jpg image3.jpeg -p path/to/image/dir/\n```\nThe `-p --path` option can be used with a whole directory of images and files or it can be used as a reference point for the `-f --files` option. When the `-f --files` option is used with `-p --path`, the user does not have to specify the absolute path to the images, just the relative image names/filepath(s). The directory that was provided with `-p --path` will be searched for the image names/filepath(s) specified.\n\n<br>\n\n#### **`-o --output` Option**\n```sh\npalex -f path/to/image/dir/image.jpeg -o path/to/output/dir/ \n```\n```sh\npalex -o path/to/output/dir/ -p path/to/image/dir/\n```\n```sh\npalex -p path/to/image/dir/ -f image.png -o path/to/output/dir/\n```\n```sh\npalex -f image1.png image2.jpg image3.jpeg -o path/to/output/dir/ -p path/to/image/dir/\n```\nThe `-o --output` option can be used with both the `-f --files` and `-p --path` options. The sole purpose of the `-o --output` option is to let the user override the default output directory. Please refer to [Environment Variables](#environment-variables) for details about the default output directory.\n\n<br>\n\n#### **`--save-check` Option**\n```sh\npalex -f path/to/image/dir/image.jpeg -o path/to/output/dir/ --save-check\n```\nAsks if the user wants to save the extracted color palettes after the extraction process is completed.\n\n<br>\n\n#### **`--preview` Option**\n```sh\npalex -f path/to/image/dir/image.jpeg -o path/to/output/dir/ --preview\n```\nShows a preview of the extracted color palettes before saving. This option requires that the user's terminal has the capability to show ASCII characters and ANSI colors. A future update may include a GUI variation of this preview option to avoid this issue.\n\n<br>\n\n#### **`--preview-check` Option**\n```sh\npalex -f path/to/image/dir/image.jpeg -o path/to/output/dir/ --preview-check\n```\nShows a preview of, and asks if the user wants to save, the extracted color palettes. This option is a combination of the `--preview` and `--save-check` options. This option requires that the user's terminal has the capability to show ASCII characters and ANSI colors. A future update may include a GUI variation of this preview option to avoid this issue.\n\n<br>\n\n#### **`--pastel` Option**\n```sh\npalex --pastel -f path/to/image/dir/image.jpeg -o path/to/output/dir/\n```\nConverts all the extracted color palettes into pastel.\n\n<br>\n\n#### **`--pastel-light` Option**\n```sh\npalex --pastel-light -f path/to/image/dir/image.jpeg -o path/to/output/dir/\n```\nConverts light color palette into pastel.\n\n<br>\n\n#### **`--pastel-normal` Option**\n```sh\npalex --pastel-normal -f path/to/image/dir/image.jpeg -o path/to/output/dir/\n```\nConverts normal color palette into pastel.\n\n<br>\n\n#### **`--pastel-dark` Option**\n```sh\npalex --pastel-dark -f path/to/image/dir/image.jpeg -o path/to/output/dir/\n```\nConverts dark color palette into pastel.\n\n<br>\n\n#### **`--sat_pref` Option**\n```sh\npalex --sat_pref -f path/to/image/dir/image.jpeg -o path/to/output/dir/\n```\nGives preference to more saturated colors of all color palettes during the extraction process.\n\n<br>\n\n#### **`--sat_pref-light` Option**\n```sh\npalex --sat_pref-light -f path/to/image/dir/image.jpeg -o path/to/output/dir/\n```\nGives preference to more saturated colors of the light color palette during the extraction process.\n\n<br>\n\n#### **`--sat_pref-normal` Option**\n```sh\npalex --sat_pref-normal -f path/to/image/dir/image.jpeg -o path/to/output/dir/\n```\nGives preference to more saturated colors of the normal color palette during the extraction process.\n\n<br>\n\n#### **`--sat_pref-dark` Option**\n```sh\npalex --sat_pref-dark -f path/to/image/dir/image.jpeg -o path/to/output/dir/\n```\nGives preference to more saturated colors of the dark color palette during the extraction process.\n\n<br>\n\n#### **`-v --version` Option**\n```sh\npalex -v\n```\n```sh\npalex --version\n```\nThe `-v --version` option is used to print the PyPalEx version number.\n\n\n<h2 align=center id=\"feedback\">FEEDBACK</h2>\n\n<p align=justify>\nAny and all feedback is greatly appreciated and welcomed. On the PyPalEx GitHub repository, there is a <b><a href=\"https://github.com/AlTimofeyev/pypalex/discussions\">Discussion</a></b> post that is available for each Release version of PyPalEx and open to everyone for any comments or feedback on the version of PyPalEx you are using.\n</p>\n\n[//]: # (Include Contributions Section Later)\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python Palette Extractor: extracts color palettes from images into json files.",
"version": "1.3.3",
"split_keywords": [
"python",
"pypalex",
"palex",
"color-palette",
"colorscheme",
"extract-colorscheme",
"extract-palette",
"extractor"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "185bf9e3c6ef2b3fcd06abdacc0c3ded6d4fa37df6d0264223f3059aca0c2dac",
"md5": "fe4b9c87f3fdc74990a1f5bb608ea29d",
"sha256": "53493532abb03244eb73e91a3d59f6a8ff4e7b00d8f764c10024113d2aeb20ff"
},
"downloads": -1,
"filename": "pypalex-1.3.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fe4b9c87f3fdc74990a1f5bb608ea29d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 28521,
"upload_time": "2023-04-08T02:05:07",
"upload_time_iso_8601": "2023-04-08T02:05:07.346946Z",
"url": "https://files.pythonhosted.org/packages/18/5b/f9e3c6ef2b3fcd06abdacc0c3ded6d4fa37df6d0264223f3059aca0c2dac/pypalex-1.3.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1821240a5b62f24515bb99c5d06cb895f7a9df17466a838c42f306dcac1ec8fd",
"md5": "67dea997a3e133825475156f12a0212f",
"sha256": "7ca2518cc878210db5a40f2d48c0039954c7aa98eb809d331cb9191b5e5f5e39"
},
"downloads": -1,
"filename": "pypalex-1.3.3.tar.gz",
"has_sig": false,
"md5_digest": "67dea997a3e133825475156f12a0212f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 29161,
"upload_time": "2023-04-08T02:05:08",
"upload_time_iso_8601": "2023-04-08T02:05:08.934999Z",
"url": "https://files.pythonhosted.org/packages/18/21/240a5b62f24515bb99c5d06cb895f7a9df17466a838c42f306dcac1ec8fd/pypalex-1.3.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-08 02:05:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "AlTimofeyev",
"github_project": "pypalex",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pypalex"
}
JSON
