https://github.com/matttproud/hodler

hodler converts iTerm 2 color schemes into forms that X resources users (XTerm) and Suckless Simple Terminal users, Alacritty users, and Linux Virtual Terminal users can use.
https://github.com/matttproud/hodler

alacritty go iterm2 linux suckless-terminal terminal xterm

Last synced: 2 months ago
JSON representation

hodler converts iTerm 2 color schemes into forms that X resources users (XTerm) and Suckless Simple Terminal users, Alacritty users, and Linux Virtual Terminal users can use.

• Host: GitHub
• URL: https://github.com/matttproud/hodler
• Owner: matttproud
• License: apache-2.0
• Created: 2016-01-30T22:05:02.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2021-12-03T23:11:27.000Z (almost 4 years ago)
• Last Synced: 2025-04-10T01:44:54.210Z (6 months ago)
• Topics: alacritty, go, iterm2, linux, suckless-terminal, terminal, xterm
• Language: Go
• Homepage:
• Size: 471 KB
• Stars: 35
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Hodler

[Hodler](https://en.wikipedia.org/wiki/Ferdinand_Hodler) converts

[iTerm 2](https://www.iterm2.com) color scheme [Property

Lists](https://en.wikipedia.org/wiki/Property_list) into forms that

the [Suckless Simple Terminal "st"](http://st.suckless.org) and

[X resources](https://en.wikipedia.org/wiki/X_resources)-based terminal

emulaters (e.g., [XTerm](http://invisible-island.net/xterm/)) and

[Alacritty](https://github.com/jwilm/alacritty) and

Linux virtual terminal (virtual console) can consume.

The name comes from the Swiss painter Ferdinand Hodler:

https://www.artfritz.ch/MUSE/ZH_KH_hodlersaal_2020/index.html.

## Installation

Hodler is built using the [Go Programming Language](https://golang.org).  Go

is required to build and modify the tool.

    $ go install -v github.com/matttproud/hodler/cmd/hodler@latest

Go generates staticly linked binaries, so users of Hodler needn't have Go

installed for casual use.

## Usage

Users of st can generate a fragment to embed into their local `config.h`.

    $ hodler -in adio.itermcolors \

          -out config.h -output_format Suckless

Users of XTerm and other X resources systems will fancy this:

    $ hodler -in adio.itermcolors \

          -out Xresources -output_format Xresources

Users of Alacritty can generate a YAML fragment to embed into their local

`alacritty.yml`:

    $ hodler -in adio.itermcolors \

          -out alacritty.yml -output_format Alacritty

Users of Linux virtual terminal can generate a command line fragment to pass to

the kernel on boot:

    $ hodler -in adio.itermcolors \

          -out kernel.txt -output_format Kernel

## Examples

Borland theme in ST:

![Demo of ST with Borland Theme](Demo_ST_Borland.png)

Borland theme in XTerm:

![Demo of XTerm with Borland Theme](Demo_XTerm_Borland.png)

Borland theme in Alacritty:

![Demo of Alacritty with Borland Theme](Demo_Alacritty_Borland.png)

Solarized Light on Linux Virtual Terminal:

![Demo of Virtual Terminal with Solarized Light](Demo_Linux_Virtual_Terminal.png)

Reference case of Borland theme in iTerm 2:

![Demo of iTerm 2 with Borland Theme](Demo_iTerm2_Borland.png)

## Caveats

Not every output format is as expressive as iTerm 2's native capabilities.

Where Hodler knows fidelity will be lost, it remarks it as such in the output.

## Roadmap

I'd eventually like Hodler to be able to convert between various theme

formats universally and not be bound to iTerm 2 as input.  This is trickier

than it sounds due to some of the input formats not having a strong file format

to be relied upon, or at least a file format without considerable amounts of

extraneous fields to be filtered.

## Build Status

[![Build Status](https://travis-ci.org/matttproud/hodler.svg)](https://travis-ci.org/matttproud/hodler)