GCIN-TOOLS(1)

📦 version 2.9.4, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 NAME 🌸

gcin-tools — configuration tools of gcin. (Yes bestie, you're reading gcin-tools(1) from the gcin input method platform. Buckle up. 💖)

✨ SYNOPSIS ✨

gcin-tools

💅 DESCRIPTION 💅

gcin-tools is the default configuration tool of gcin. Iconic. Main character energy fr.

There's also another way to configure things if you're feeling feral: write conffiles into $HOME/.gcin/config. Scroll down to the CONFFILES section for the full tea. 🫖

🎀 CONFFILES 🎀

Okay so, all the conffiles listed below get created automatically by gcin-tools… with two lil exceptions that do NOT get auto-created: gcin-bell-volume and gcin-sound-play-overlap. Just so you know. 💀

If you wanna write conffiles by yourself (respect, honestly), first make sure the config directory exists:

mkdir -p $HOME/.gcin/config

After that, you may try something like:

echo zo > $HOME/.gcin/config/phonetic-keyboard

And boom — you just made a phonetic-keyboard file with the content zo, which means you selected the standard style with the 1234 selection method. Ate. ✨

All available conffiles are listed below, and default options are shown in bold.

💜 $HOME/.gcin/config/default-input-method number

Default input method when gcin is called.

  • 1 — Chanjei input method, version 3
  • 2 — Chanjei input method, version 5
  • 3 — Bopomofo input method
  • 4 — Symbols virtual keyboard
  • 5 — Pinyin input method
  • 6 — Tsin intelligent Bopomofo input method
  • 7 — Dayi input method
  • 8 — Array input method, 30 keys version
  • 9 — Boshiamy input method, aka Liu's input method
  • 10 — Direct input for UTF-32 (U+) or Big-5 characters
  • 11 — Simple Chanjei input method
  • 12 — Japanese anthy input method
  • 13 — Greek letters input method
  • 14 — Latin letters input method
  • 15 — Jyutping input method
  • 16 — NewCJ3 input method

🧚 $HOME/.gcin/config/gcb-position number

Disable or enable gcb clipboard manager.

  • 0 — Disable
  • 1 — Enable, at lower left corner
  • 2 — Enable, at upper left corner
  • 3 — Enable, at lower right corner
  • 4 — Enable, at upper right corner

🦋 $HOME/.gcin/config/gcb-position-x number

The X-axis padding of gcb clipboard manager. Default is 0.

🦋 $HOME/.gcin/config/gcb-position-y number

The Y-axis padding of gcb clipboard manager. Default is 0.

🔔 $HOME/.gcin/config/gcin-bell-volume number

Volume of bell ring, between -100 to 100. Default is -97.

🌸 $HOME/.gcin/config/gcin-capslock-lower boolean

Input lower-case letters when Caps Lock key is ON.

  • 1 — ON
  • 0 — OFF

🌸 $HOME/.gcin/config/gcin-eng-phrase-enabled boolean

Enable Alt-Shift phrases in alphabet-numeric mode.

  • 1 — ON
  • 0 — OFF

👑 $HOME/.gcin/config/gcin-flags-im-enabled number

Available input methods to be cyclic selected by Control-Shift.

  • 2147483647 — All input methods are enabled.
  • 2 — Ctrl-Alt-1 Chanjei input method, version 3
  • 4 — Ctrl-Alt-2 Chanjei input method, version 5
  • 8 — Ctrl-Alt-3 Bopomofo input method
  • 16 — Ctrl-Alt-4 Symbols virtual keyboard
  • 32 — Ctrl-Alt-5 Pinyin input method
  • 64 — Ctrl-Alt-6 Tsin intelligent Bopomofo input method
  • 128 — Ctrl-Alt-7 Dayi input method
  • 256 — Ctrl-Alt-8 Array input method, 30 keys version
  • 512 — Ctrl-Alt-9 Boshiamy input method, aka Liu's input method
  • 1024 — Ctrl-Alt-0 Direct input for UTF-32 (U+) or Big-5 characters
  • 2048 — Ctrl-Alt-- Simple Chanjei input method
  • 4096 — Ctrl-Alt-= Japanese anthy input method
  • 8192 — Ctrl-Alt-` Greek letters input method
  • 16384 — Ctrl-Alt-[ Latin letters input method
  • 32768 — Ctrl-Alt-] Jyutping input method
  • 65536 — Ctrl-Alt-\ NewCJ3 input method

Take 2147483647 minus the numbers of the input methods, and you get the configuration number. For example, to disable Greek and Latin letters, calculate 2147483647 - 8192 - 16384 = 2147459071.

echo 2147459071 > $HOME/.gcin/config/gcin-flags-im-enabled

Then you get it. Math ate, no cap. 🧮✨

⭐ $HOME/.gcin/config/gcin-font-name string

Default font.

  • sans — Sans-serif
  • serif — Serif

💖 $HOME/.gcin/config/gcin-font-size number

Font size of character-selection area. Default is 16.

💖 $HOME/.gcin/config/gcin-font-size-gtab-in number

Font size of key codes input area in gtab input methods (Chanjei IM, Array IM, etc.). Default is 10.

💖 $HOME/.gcin/config/gcin-font-size-pho-near number

Font size of similar-phonetic character selection in Tsin IM. Default is 14.

💖 $HOME/.gcin/config/gcin-font-size-symbol number

Font size of symbol-selection window. Default is 12.

💖 $HOME/.gcin/config/gcin-font-size-tsin-pho-in number

Font size of phonetic input area in Bopomofo and Tsin IM. Default is 10.

💖 $HOME/.gcin/config/gcin-font-size-tsin-presel number

Font size of phrase pre-selection window in Tsin IM. Default is 16.

🎀 $HOME/.gcin/config/gcin-im-toggle-keys number

Toggle Key for IM window ON/OFF.

  • 0 — Control-Space
  • 1 — Shift-Space
  • 2 — Alt-Space
  • 3 — Windows-Space

🌈 $HOME/.gcin/config/gcin-init-im-enabled boolean

Enable input method mode without pressing toggle keys.

Heads up bestie — this option is not available in XIM mode. Not a vibe, just a fact. 💀
  • 1 — ON
  • 0 — OFF

🖼️ $HOME/.gcin/config/gcin-inner-frame boolean

Show frame border in gcin window.

  • 1 — ON
  • 0 — OFF

🪟 $HOME/.gcin/config/gcin-input-style number

Window style of gcin.

  • 1 — OverTheSpot (Follow the cursor)
  • 2 — Root (Fixed index window)

🪟 $HOME/.gcin/config/gcin-pop-up-win boolean

Dynamic pop up window.

  • 1 — ON
  • 0 — OFF

🌐 $HOME/.gcin/config/gcin-remote-client boolean

Use gcin in remote applications.

  • 1 — ON
  • 0 — OFF

📍 $HOME/.gcin/config/gcin-root-x number

Window position in X-axis when window style is Root (Fixed index window). Default is 1600.

📍 $HOME/.gcin/config/gcin-root-y number

Window position in Y-axis when window style is Root (Fixed index window). Default is 1200.

🎨 $HOME/.gcin/config/gcin-sel-key-color hex

Color of selection Key.

  • #FF0000 — Red
  • #00FF00 — Green
  • #0000FF — Blue
  • #FFFF00 — Yellow
  • #FF00FF — Magenta
  • #00FFFF — Cyan

🌸 $HOME/.gcin/config/gcin-shift-space-eng-full boolean

Toggle to double-wide English character mode with Shift-Space.

  • 1 — ON
  • 0 — OFF

🔊 $HOME/.gcin/config/gcin-sound-play-overlap boolean

Play all sound when text-to-speech is enabled.

  • 1 — ON
  • 0 — OFF

🧷 $HOME/.gcin/config/gcin-status-tray boolean

Show gcin status in system tray.

  • 1 — ON
  • 0 — OFF

🎨 $HOME/.gcin/config/gcin-win-color-bg hex

Background color of gcin window. Default is #005BFF.

🎨 $HOME/.gcin/config/gcin-win-color-fg hex

Foreground color of gcin window.

  • #FF0000 — Red
  • #00FF00 — Green
  • #0000FF — Blue
  • #FFFF00 — Yellow
  • #FF00FF — Magenta
  • #FFFFFF — White

🎨 $HOME/.gcin/config/gcin-win-color-use boolean

Customized colors in gcin window.

  • 1 — ON
  • 0 — OFF

🖱️ $HOME/.gcin/config/gcin-win-sym-click-close boolean

Close symbol-selection window after choosing a symbol.

  • 1 — ON
  • 0 — OFF

🔤 $HOME/.gcin/config/gtab-auto-select-by_phrase boolean

Auto-select according to Tsin phrase database in gtab input methods.

  • 1 — ON
  • 0 — OFF

🔡 $HOME/.gcin/config/gtab-capslock-in-eng boolean

Toggle Chinese/English mode with Caps Lock key in gtab input methods.

  • 1 — ON
  • 0 — OFF

🏷️ $HOME/.gcin/config/gtab-disp-im-name boolean

Display input method name in gtab input methods.

  • 1 — ON
  • 0 — OFF

🔑 $HOME/.gcin/config/gtab-disp-key-codes boolean

Show all possible key codes of character in gtab input methods.

  • 1 — ON
  • 0 — OFF

🔍 $HOME/.gcin/config/gtab-disp-partial-match boolean

Display partial matched characters in gtab input methods.

  • 1 — ON
  • 0 — OFF

🔔 $HOME/.gcin/config/gtab-dup-select-bell boolean

Bell ring when multiple selections are available in gtab input methods.

  • 1 — ON
  • 0 — OFF

🙈 $HOME/.gcin/config/gtab-hide-row2 boolean

Hide second row of window in gtab input methods.

  • 1 — ON
  • 0 — OFF

👀 $HOME/.gcin/config/gtab-in-row1 boolean

Show key codes in first row of window in gtab input methods.

  • 1 — ON
  • 0 — OFF

🧹 $HOME/.gcin/config/gtab-invalid-key-in boolean

Clear key codes input area when invalid key and Space key are pressed.

  • 1 — ON
  • 0 — OFF

👀 $HOME/.gcin/config/gtab-pre-select boolean

Show candidate characters before pressing endkey (Space key). For gtab input methods.

  • 1 — ON
  • 0 — OFF

🚀 $HOME/.gcin/config/gtab-press-full-auto-send boolean

Auto-send character when key codes input area is filled in gtab input methods.

  • 1 — ON
  • 0 — OFF

❓ $HOME/.gcin/config/gtab-que-wild-card boolean

Use ? as wildcard.

  • 1 — ON
  • 0 — OFF

🌸 $HOME/.gcin/config/gtab-shift-phrase-key boolean

Use single Shift key to input Alt-Shift phrases in gtab input methods.

  • 1 — ON
  • 0 — OFF

␣ $HOME/.gcin/config/gtab-space-auto-first number

Function of Space Key in gtab input methods.

  • 0 — Auto-selected by definition in .gtab file.
  • 1 — Send first character in Boshiamy input method.
  • 2 — Send first character in character-selection area.
  • 4 — Does not send first character. (For Array input method.)
  • $HOME/.gcin/config/gtab-unique-auto-send boolean — bestie, when gtab input methods only give you one choice, this auto-sends that character. no extra tap, periodt. 💅
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/gtab-vertical-select boolean — vertical selection window in gtab input methods. it's giving stacked, slay. ✨
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/left-right-button-tips boolean — show button tips when your mouse cursor stays on the gcin window. default is ON, but it will be turned OFF after gcin-tools is executed. so heads up, bestie. 🫶
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/pho-hide-row2 boolean — hide the second row of the window in Bopomofo and Tsin IM. lowkey minimal. 🙈
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/pho-in-row1 boolean — show key codes in the first row of the window in Bopomofo IM. it's giving transparency. 🔥
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/phonetic-char-dynamic-sequence boolean — dynamic character sequence adjustment in Bopomofo and Tsin IM. it literally adapts, no cap. 💖
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/phonetic-huge-tab boolean — input all Traditional Chinese, Simplified Chinese, and Japanese characters provided by pho-huge.tab in Bopomofo and Tsin IM. huge tab energy, fr fr. 🌈
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/phonetic-keyboard string — key codes arrangement style in Bopomofo, Tsin, and Japanese anthy IM. pick your main character keyboard layout, bestie. 👑
    • zo — Standard style with 1234 selection method
    • zo-asdf — Standard style with asdf selection method
    • et — Eten style with 1234 selection method
    • et-asdf — Eten style with asdf selection method
    • et26 — Eten 26 keys style with 1234 selection method
    • et26-asdf — Eten 26 keys style with asdf selection method
    • hsu — Mr. Hsu's style (Kuo-Yin IM, Natural Bopomofo IM)
    • pinyin — Phonetic Pinyin style with 1234 selection method
    • pinyin-asdf — Phonetic Pinyin style with asdf selection method
    • dvorak — Dvorak style
    • ibm — IBM style
    • mitac — Mitac style
  • $HOME/.gcin/config/phonetic-speak boolean — enable text-to-speech. you have to install speech data for this feature, so don't forget, bestie. 😭
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/phonetic-speak-sel string — speech data filename for text-to-speech. the way it's giving voice. 🎀
  • $HOME/.gcin/config/tsin-buffer-editing-mode boolean — VI-like editing mode in Tsin IM. for the vim girlies, periodt. 💅
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/tsin-buffer-size number — size of buffer (editing area) in Tsin IM. default is 40. no cap, that's the default. ✨
  • $HOME/.gcin/config/tsin-chinese-english-toggle_key number — toggle key for Chinese/English mode in Tsin IM. choose your fave. 👀
    • 1 — Caps Lock key
    • 2 — Tab key
    • 4 — Shift key (Not available in XIM mode).
    • 8 — Left Shift key (Not available in XIM mode).
    • 16 — Right Shift key (Not available in XIM mode).
  • $HOME/.gcin/config/tsin-cursor-color hex — color of cursor in Tsin IM. slay that cursor. 🌈
    • #FF0000 — Red
    • #00FF00 — Green
    • #0000FF — Blue
    • #FFFF00 — Yellow
    • #FF00FF — Magenta
    • #00FFFF — Cyan
  • $HOME/.gcin/config/tsin-phrase-line-color hex — color of phrase-underline in Tsin IM. default is #0000FF. blue is the moment. 💜
  • $HOME/.gcin/config/tsin-phrase-pre-select boolean — show phrase pre-selection window in Tsin IM. it's giving preview. 🔥
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/tsin-space-opt number — function of Space key in Tsin IM. choose your space bar destiny. 💅
    • 1 — Select other same phonetic characters.
    • 2 — Send space to buffer of Tsin IM.
  • $HOME/.gcin/config/tsin-tab-phrase-end boolean — use Escape key or Tab key to stop phrase-auto-selection in Tsin IM. so you can exit that phrase selection. 🙈
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/tsin-tail-select-key boolean — show selection keys follows choices in Tsin IM. the keys literally follow the choices, bestie. ✨
    • 1 — ON
    • 0 — OFF
  • $HOME/.gcin/config/tsin-tone-char-input boolean — input tone symbols of Bopomofo in Tsin IM. iconic. 💅
    • 1 — ON
    • 0 — OFF

✨ SEE ALSO ✨

and that's the tea, bestie! this whole manual is from GCIN 1.4.4, dated 2 FEB 2009, and it's the GCIN-TOOLS(1) page. periodt. 💅✨

📦 where this page comes from