Gogh README

The project's README from github.com/Gogh-Co/Gogh. As one markdown file: README.md.

Gogh

Gogh
Gogh

🔹🔹🔹 gogh.website 🔹🔹🔹

Color Scheme Implementer for Terminals

Gogh is a collection of color schemes for terminal emulators across Linux and macOS (plus Cygwin/Mintty on Windows) — see the Terminal Support table below for the full list. These schemes are designed to make your terminal more visually appealing and improve readability with better contrast and color differentiation.

The inspiration for Gogh came from the clean and minimalistic design of Elementary OS, but the project has since grown to include a variety of unique and beautiful options across platforms.

Run:
bash -c "$(curl -fsSL https://gogh.website/gogh)"

This project is here for anyone to use, no expectations.
If you want to buy me a coffee voluntarily, you can use this link.

☕ Buy me a coffee

Index:

Getting Started

Themes & Data

Help & Contributing

Project


gogh-themes-showcase


⚙️ Pre-Install

In your terminal, type:

For Debian/Ubuntu:

sudo apt-get install dconf-cli uuid-runtime

For Arch Linux:

sudo pacman -S dconf util-linux

You can now install Gogh interactively (easiest), install a specific theme directly in one line, or install non-interactively (ideal for scripting).



⚙️ Install

1. Run the one-line install command:

Linux

bash -c "$(wget -qO- https://gogh.website/gogh)"

macOS

bash -c "$(curl -fsSL https://gogh.website/gogh)"

Fish or NuShell

bash -c 'bash -c "$(wget -qO- https://gogh.website/gogh)"'


2. Select your theme from the interactive list.

DEMO:

gogh-demo-profile



⚡ Install a Specific Theme

Already know which theme you want? Skip the interactive list and pass its name after --:

bash -c "$(wget -qO- https://gogh.website/gogh)" -- "Aci"


⚙️ Install (Non-Interactive Mode)

For scripting, dotfiles, provisioning tools, CI, or container images.



💻 Terminal Support

Here are some terminals that Gogh is supported with:

Terminal Web Implementation Docker test
Alacritty Web apply_alacritty() ✅
Cygwin Web apply_cygwin() ✅
Foot Web apply_foot() ✅
Ghostty Web apply_ghostty() ✅
Gnome Web apply_gtk() ✅
Guake Web apply_guake() ✅
iTerm Web apply_darwin()
Kitty Web apply_kitty() ✅
kmscon Web apply_kmscon() ✅
Konsole Web apply_konsole() ✅
linux (Linux virtual terminal) Web apply_linux_vt() ✅
Mate Web apply_gtk() ✅
Mintty Web apply_cygwin() ✅
Pantheon / Elementary Web apply_elementary()
Termux Web apply_termux() ✅
Tilix Web apply_gtk() / appy_tilixschemes() ✅
Wezterm Web apply_wezterm()
XFCE4 Web apply_xfce4-terminal() ✅
Terminator Web apply_terminator() ✅


🎨 Themes

We have lots of themes in stock!


🔌 API

Theme data is also published as plain files, for scripting or pulling into your own tools — not a dedicated API, just static content, no authentication needed:

To fetch the same files through GitHub's actual REST API instead (e.g. for conditional requests via ETag, or commit history on a file) use the Contents API:

curl -s https://api.github.com/repos/Gogh-Co/Gogh/contents/data/themes.json \
  -H "Accept: application/vnd.github.raw+json"

That path is rate-limited like the rest of GitHub's REST API: 60 requests/hour unauthenticated. Add a personal access token (no special scopes needed for a public repo) to raise that to 5,000/hour:

curl -s https://api.github.com/repos/Gogh-Co/Gogh/contents/data/themes.json \
  -H "Accept: application/vnd.github.raw+json" \
  -H "Authorization: Bearer YOUR_GITHUB_TOKEN"

The raw files above aren't rate-limited this way — no token needed for those.


🔑 Color Hash


👀 WCAG - Accessibility Contrast



❓ HELP



🖼️ Create your Own Theme!


🤖 Work with Agents

master does not track agent-context files — AGENTS.md and the memory/ folder (architecture decisions + current project status) live on a dedicated orphan branch, meta/agents-master, so the project's own history stays focused on Gogh itself.

If you want to work on this repo with an AI coding agent, bring those files into your working copy:

git restore --source meta/agents-master -- AGENTS.md
git restore --source meta/agents-master -- memory/

That gives you:

Note: tool-specific folders such as .agents/ and .claude/ (agent skills) are intentionally left out of this — there isn't an established, tool-agnostic standard yet for how skills should be structured or shared, so for now they stay local/ untracked rather than committed to either branch.


🌱 First commit:

Nov 18, 2013 - aa9871e


:heart: Credits:


:heart: Contributors:

Many thanks to all who have participated in this project.

@contributors



🧠 Author (contributor)

I cannot claim to be the only author of this project. Without the help of the people who have contributed, this would not have been possible. Therefore, that's why all contributors are listed first in this document. While I am listed as the author, the true authors are all those who are mentioned in the document. I would like to express my gratitude to all of them, as well as to future contributors.

X GitHub

This project is here for anyone to use, no expectations.
If you want to buy me a coffee voluntarily, you can use this link.

☕ Buy me a coffee



🖌️ Why Gogh?

There is no blue without yellow and without orange.

-- Vincent Van Gogh --



📣 Mentions


📜 License

Gogh is dual-licensed under either the MIT license or the Apache License, Version 2.0, at your option.


🌟 Star History

Star History Chart

Star History Rank

Gogh (Gogh-Co/Gogh)

Searching Database…

10.3K ·GitHub
Gogh
Что это такое?Gogh — это набор цветовых схем для терминалов в Linux и macOS (а также Cygwin/Mintty на Windows). Он создан, чтобы сделать терминал красивее и удобнее для чтения за счёт лучшего контраста и различия цветов.
Так это просто галерея тем или она реально меняет мой терминал?Она реально меняет терминал: Gogh — это инструмент на основе shell-скриптов: вы запускаете его скрипт, выбираете схему, и цвета записываются прямо в настройки самого терминала.
Как применить тему?Запустите однострочную команду установки в bash, затем выберите тему из интерактивного списка. Если вы уже знаете название темы, список можно пропустить, передав её имя после --.
Нужно ли что-то установить перед запуском?Да, есть небольшой подготовительный шаг: в Debian/Ubuntu и Arch Linux сначала нужно добавить нужные зависимости через пакетный менеджер, и только потом запускать установщик Gogh.
Работает ли это на Windows?Только через Cygwin/Mintty — нативной поддержки Windows нет, а основными платформами являются Linux и macOS.
Какие эмуляторы терминала он умеет оформлять?Около двадцати, включая Alacritty, Ghostty, Kitty, GNOME Terminal, Tilix, Konsole, XFCE4, Terminator, Guake, WezTerm и виртуальный терминал Linux, а также iTerm на macOS и Termux на Android.
Могу ли я автоматизировать установку тем в своих dotfiles или CI?Да. Неинтерактивный режим создан как раз для скриптов, dotfiles, инструментов подготовки окружения, CI и образов контейнеров: темы выбираются по имени или slug как аргументы командной строки, а поведение управляется переменными окружения вроде TERMINAL и GOGHNONINTERACTIVE.
Могу ли я использовать данные тем Gogh в своих инструментах?Да — данные тем опубликованы в виде обычных файлов JSON и CSV, без какой-либо аутентификации, и на эти файлы нет ограничений по частоте запросов. А вот маршрут через GitHub Contents API ограничен: 60 запросов в час без аутентификации или 5 000 запросов в час с персональным токеном доступа.
Могу ли я добавить свою цветовую схему?Да. Гайд для контрибьюторов — единственный достоверный источник: в нём есть шаблон .yml, описание каждого поля по отдельности и правила, которым должен соответствовать PR с темой. Свою тему можно проверить локально командой task validate перед тем, как открывать PR.
Есть ли что-то для доступности?Да. Gogh публикует отчёт о контрастности тем по стандарту WCAG, а сами схемы разработаны так, чтобы улучшать читаемость за счёт более высокого контраста и лучшего различия цветов.
What are similar projects?iTerm2-Color-Schemes, oh-my-posh, awesome-zsh-plugins, navi, bashka, ohmyzsh, dracula-theme, powerlevel9k
Which topics is it in?iterm2, terminal-themes, color-scheme, terminal-emulators, scripting, dotfiles, bash, installer, theme, accessibility, shell, customization
Creator
Gogh-Co
Size
53.5 MB
Stars
10.3K
Updated
CommitOct 10Releasev1250Oct 01
Age
12y
Commits · 90 Days