Customization

Webshell Configuration Guide

Per-user web terminal preferences are stored in ~/.config/webshell/.

---

Directory Structure

~/.config/webshell/
├── config.json      # Theme, font size, and cursor settings
└── font.woff2       # (Optional) Local custom font file (.woff2, .ttf, or .otf)

---

config.json Options

Key Type Default Description fontFamily String 'JetBrains Mono', monospace Font family stack fontSize Number 15 Font size in pixels cursorStyle String "block" Cursor shape ("block", "underline", or "bar") cursorBlink Boolean true Enable or disable cursor blinking theme Object See below Color palette overrides

---

Theme Options (theme object)

Key Description background Terminal background color (e.g. "#000000") foreground Default text color (e.g. "#e0e0e0") cursor Cursor color (e.g. "#ffffff") black – white Standard 8 ANSI colors brightBlack – brightWhite High-intensity 8 ANSI colors

---

Example ~/.config/webshell/config.json

{
  "fontFamily": "'JetBrains Mono', 'Fira Code', monospace",
  "fontSize": 15,
  "cursorStyle": "block",
  "cursorBlink": true,
  "theme": {
    "background": "#000000",
    "foreground": "#e0e0e0",
    "cursor": "#00ff00",
    "green": "#00ff00",
    "cyan": "#00ffff"
  }
}

---

Using Local Font Files

Place your font file in ~/.config/webshell/ as one of the following:

font.woff2 (Recommended) font.ttf font.otf

The webshell will automatically encode and load your font file into the web browser upon login.