> For the complete documentation index, see [llms.txt](https://docs.libreoffice.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.libreoffice.id/libreoffice-theme-changer/lotc/libreoffice-theme-changer-gui.md).

# Build & Install

### Build Extension

To build LO-TC, just follow this steps:

```bash
# clone repository
git clone https://github.com/libreofficeid/LO-TC-GUI.git

# enter to clone directory 
cd LO-TC-GUI

# build extension
make zip
```

we have special command `make all` to everyone who wanna help us to develop this extension. This command used if you have make some update to python code, and wanna to show the update directly on your LibreOffice without re-install extension via Extension Manager. Just run `make all` then restart the LibreOffice.

{% hint style="info" %}
Some operating system doesn't provide **python3-uno** package/library which is needed to run LOTC. Please make sure that this library already installed on your system before running LOTC.
{% endhint %}

### Extension Installation

Just like other extension, you only need to import this extension via menu: Tools -> Extension Manager, then add extension. LibreOffice should restart after new extension installation.

For your information, at the first run, LO-TC will ask you for root permission to setup local environment.

Here is special note for Slatpak, Snap, and Windows user.

**Only for flatpak user**, \
please run [**lotc-flatpak-first-run.sh**](https://raw.githubusercontent.com/libreofficeid/LO-TC-GUI/master/lotc-flatpak-first-run.sh) first. LibreOffice will opened, then open menu: Tools -> Extension Manager -> add extension.

**Only for Windows user**\
After installing the extension and running it at the first time, you will be asked for many times User Account Control (UAC) for Administrator Privileges to do some modifications in LibreOffice Installation Directory. UAC will be prompted again when activating your desired theme.

**Only for Snap user**\
After installing the extension and running it at the first time, you will be noticed that you have to run additional step to make this extension works. While running desired script, it will ask for sudo password to perform some modifications of your LibreOffice's Snap installation. After that, you should reboot your PC to apply this modifications. Then, you can normally run LibreOffice Snap version.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.libreoffice.id/libreoffice-theme-changer/lotc/libreoffice-theme-changer-gui.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.