everforest-factory 2.0.1

convert any image to the everforest palette! (fork of gruvbox-factory)

everforest-factory 🏭

A fork of gruvbox-factory by @paulopacitti, adapted to the Everforest color scheme.

"Comfortable & Pleasant Color Scheme for Vim" - sainnhe

• A simple cli to convert manufacture an everforest themed wallpaper.
• Three color palettes: dark, light and smooth mix.

Requirements

• Python 3.13.1 or higher

Installation

From PyPI

pip install everforest-factory

From source

git clone https://github.com/dorpivovar/everforest-factory.git
cd everforest-factory
pip install .

For development (editable mode):

pip install -e .

Note: if pip install reports that the script is installed in a directory not on PATH (e.g. /var/data/python/bin), add it:

export PATH="/var/data/python/bin:$PATH"

Or run directly via python -m factory.

Usage

everforest-factory [-h] [-p [{dark,light,mix}]] [-i IMAGES [IMAGES ...]]

Options

Flag	Description
-h, --help	Show help message and exit
-p, --palette	Choose palette: dark (default), light, or mix
-i, --images	Path(s) to the image(s) to process

Examples

Convert a single image with the dark palette (default):

everforest-factory -i wallpaper.png

Use the light palette:

everforest-factory -p light -i photo.jpg

Process multiple images at once:

everforest-factory -p mix -i image1.png image2.jpg image3.webp

Use a glob pattern:

everforest-factory -p dark -i ~/Pictures/*.png

Run without installing (from the project directory):

python -m factory -p dark -i wallpaper.png

Output

Processed images are saved in the same directory as the originals with the everforest_ prefix:

wallpaper.png → everforest_wallpaper.png

Palettes

Palette	Description
dark	Everforest Dark — deep green-tinted backgrounds with warm accents
light	Everforest Light — soft cream backgrounds with vivid accents
mix	Extended blend of both dark and light palettes with intermediate tones

Acknowledgements

This project is a fork of gruvbox-factory by @paulopacitti and its contributors:

• @H4ppy-04
• @Gabulhas
• @hza2002
• @jasonmishi
• @perpetualCreations
• @Kuuhhl
• @marcelofern

Built on top of ImageGoNord.

Everforest color scheme by sainnhe.