docsreference

Settings

Every setting ttheme reads, the values it takes and its default. This page is made from the same source as the comments in your config.zsh.

ttheme config

on this page

Settings live in ~/.config/ttheme/config.zsh. ttheme config opens it in $EDITOR, and alt+c in ttheme edits the common ones in place. Each default sits on a commented line, so a default a later version changes reaches you; a line you uncomment keeps your value. A variable exported before ttheme loads wins over the file.

Palettes and screens

`TTHEME_MODE`

default dark

The mode every palette shows in: auto, which follows the appearance of the system where a wired Ghostty, iTerm2, kitty or WezTerm reports it, or light or dark, which each palette carries both of — changing it repaints every open tab.

`TTHEME_TAB_PALETTE`

default off

New tabs: off keeps the configured terminal theme, seq rotates through the palettes.

`TTHEME_ANNOUNCE`

default 1

The palette notice under "Last login:": 1 shows it, 0 silences it.

`TTHEME_FX`

default typewriter

Search hint animation: typewriter, decode or glitch.

`TTHEME_SORT`

default abc

Catalogs and palettes in ttheme and preview: abc sorts them by name, catalog keeps the order they were added.

`TTHEME_MOUSE`

default on

Clicks, the wheel and drags in preview, browse, the palette editor and find: on, or off to leave the mouse to the terminal, so a drag selects text again without a modifier.

`TTHEME_KEYS`

default auto

Key symbols in ttheme's screens: auto draws ⌃ ⌥ ⇧ ↩ ⎋ ⇥ on a Mac and ctrl+r, esc and the like elsewhere and over ssh, where the keyboard may not be a Mac's; mac or text picks one.

Pictures

`TTHEME_BG_BLUR`

default 0

Soften the background pictures behind the text: a blur radius in screen pixels, 0 keeps them sharp — changing it draws every picture again.

`TTHEME_BG_COLORS`

default original

The colors new background pictures are drawn in: original keeps its own, tone tints a picture in one color of its palette — preview switches each picture later.

Downloads and updates

`TTHEME_NAMES`

default on

Character names in every language for searching palettes and find's search box, from aninames' weekly release: on downloads them (about 7 MB) and checks once a day in the background; off leaves them as they are.

`TTHEME_AUTO_UPDATE`

default on

Checks in the background: on refreshes the marketplaces you set to update on their own once a day and says when a newer ttheme is out; off leaves both to ttheme update.

`TTHEME_MARKETPLACE_LOOKUP`

default on

GitHub lookups in browse: on downloads the list of marketplaces carrying the ttheme-marketplace topic when Search marketplace opens; off waits for space.

find

`TTHEME_FIND_RATING`

default safe

The ratings find lists, any of safe, questionable and explicit, each booru read in its own rating vocabulary.

`TTHEME_FIND_BLOCK`

default "nudity underwear"

The posts find drops by tag: nudity, underwear, both, or none to keep them all.

`TTHEME_FIND_POSTS`

default all

What find lists first: all is every post of the character, cutouts are the transparent ones.

`TTHEME_FIND_SOLO`

default on

On keeps the posts tagged solo, the character alone, by danbooru or zerochan; off lists every post.

`TTHEME_FIND_CUTOUTS`

default the built-in tags

The tags find calls a transparent cutout, per site as key=tag,tag pairs — e.g. "konachan=transparent,vector yande=transparent_png".

`TTHEME_FIND_ORDER`

default fit

The order find lists posts in: fit ranks each page by how well it makes a backdrop, newest or score.

`TTHEME_FIND_SETS`

default fold

Runs of the same picture at the same size from one uploader: fold shows them as one tile, show lists each.

`TTHEME_FIND_REMOVE_BG`

default on

An opaque picture tried on in find: on cuts the character out with macOS Vision, off leaves it as it is.

`TTHEME_FIND_MIN_SCORE`

default off

The lowest score find lists: off, or a number such as 5, 10, 25, 50 or 100 — danbooru, konachan and yande.re filter by it, zerochan keeps no score.

`TTHEME_FIND_MIN_SIZE`

default off

The shortest side a picture find lists must reach, in pixels: off, or a number such as 720, 1080, 1440, 1800 or 2560.

`TTHEME_FIND_SITES`

default all four

The sites find mixes in its all tab: any of danbooru, konachan, yande.re and zerochan.

`TTHEME_FIND_HIDE`

default none

The kinds of picture find leaves out by tag: comic, monochrome, sketch, chibi, or none to keep them all.

`TTHEME_FIND_HIDE_TAGS`

default none

More tags find leaves out, spaced — e.g. "cosplay multiple_girls".

`TTHEME_FIND_PNG`

default off

On lists PNG originals only — a zerochan post counts only where danbooru holds the same file.

`TTHEME_FIND_HOSTS`

default none

Send a find site somewhere else, as key=https://host pairs — e.g. "danbooru=https://danbooru.donmai.us".