# 🎨 Modding Guide: Custom Themes & Languages

## 🌍 Part 1: Super easy - add a language

This guide is for everyone who wants to change languages on their own. You do not need Python or coding skills. A normal text editor is enough. With it, you can edit existing language files or create new ones.

### ✅ All you need is a text editor

Open a language file in the `lang` folder with any normal text editor. You can edit it, copy it, or create a new file - nothing more is needed.

That means you can change an existing language or add a new one. No source code is needed.

### Step 1: Copy a file

Open the `lang` folder and copy one of the existing language files. Then rename the copy, for example to `fr_FR.json`, `es_ES.json`, `it_IT.json`, `nl_NL.json`, or `pt_BR.json`.

### Step 2: Change only the text on the right

Very important: the left side is the key, the right side is the text. Only the text after the colon is translated. The left part must stay exactly the same.

    Correct:
    "save": "Save"
    "cancel": "Cancel"
    "open": "Open"

    Wrong:
    "save": "save"
    "Save": "Cancel"

The name on the left stays the same. The translation goes on the right. That is how the program reads the file correctly.

### Step 3: You can also use AI

You can also let an AI do the translation. Paste the language file into ChatGPT or another AI tool and say: translate only the text on the right, but do not change the names on the left.

### Step 4: Save and restart

Save the file in the `lang` folder and restart the program. The new language will then appear automatically in the list.

## 🖌️ Part 2: Creating a Custom Theme

Since version 4.1.0, themes are fully managed through external JSON files inside the `themes` folder. No Python editing is required.

### Step 1: Copy an Existing Theme

Open the `themes` folder and copy an existing file such as `light.json`. Rename the copy, for example `my_theme.json`.

### Step 2: Modify the Colors

    {
        "name": "my_theme",

        "bg": "#E0E0E0",              // Main application background
        "fg": "#000000",              // Main text color
        "info_bg": "#ffffff",         // Text areas and process log
        "separator": "#808080",       // Borders and separators
        "entry_bg": "#ffffff",        // Input fields and comboboxes
        "disabled_fg": "#6d6d6d",     // Disabled text
        "error_bg": "#f2b8b5",        // Error highlighting
        "button_bg": "#d3d1ce",       // Buttons and inactive tabs
        "button_hover": "#e4e0d8",    // Hover and active state
        "text_relief": "sunken",      // flat, sunken, ridge, groove
        "accent": "#0a64ad",          // Main accent color
        "tree_selected": "#0a64ad",   // Selected file row background
        "tree_selected_fg": "#ffffff",// Selected file row text
        "tree_row_alt": "#f7f7f7"     // Alternate row color
    }

Save the file. The application will detect it automatically.

### Step 3: Select the Theme

Start the application. Every valid JSON theme inside the `themes` folder will automatically appear in the App Theme selector.