Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Windows
ChatQT is an Ollama client where you can quickly chat with all your local-LAN models downloaded with Ollama.
Saved setup from 20 h ago
Will it work on Windows?
The maintainers included install.sh. Run it from the cloned folder after reading it.
bash install.sh
Also: scripts/install-translations.sh
docs/BUILDING.mdThis is a KDE Plasma 6 plasmoid written entirely in QML and JavaScript. There is no compilation step — QML is interpreted at runtime by Plasma. The project uses simple shell scripts for installation, translation management, packaging, and testing.
For development and testing, install to your user directory:
./install.sh dev
This automatically removes any existing installation and installs the updated version. No restart is needed for most QML changes — just remove and re-add the widget, or run the command again.
For production use, install system-wide (requires root):
sudo ./install.sh system
This installs to /usr/share/plasma/plasmoids/{PLASMOID_ID}/ where {PLASMOID_ID} is read from metadata.json.
./install.sh status # Check what's installed and where
./install.sh uninstall # Remove user-level installation
Making changes:
# Edit your code, then apply changes:
./install.sh dev
This removes the old installation and installs the updated version in one step.
Running tests:
./scripts/run-tests.sh
When you add new i18n() calls to QML files:
Extract new strings:
./scripts/translate.sh extract
Merge into existing translations:
./scripts/translate.sh update
Compile and reinstall:
./scripts/translate.sh compile
./install.sh dev
Or run all three steps at once:
./scripts/translate.sh all
The plasmoid supports internationalization using KDE's i18n framework. Translatable strings use i18n() or i18nc() in QML files.
Currently supported languages: English (source), Spanish, German, French, Italian, Portuguese (BR), Russian, Chinese (Simplified), Japanese, Korean, Arabic.
./scripts/translate.sh all
Extracts strings from QML files, merges new strings into all existing .po files, and compiles .mo binaries.
./scripts/translate.sh extract
Scans all QML files in contents/ for i18n()/i18nc() calls and writes po/K-Ollama-Plasmoid.pot.
./scripts/translate.sh create es # Spanish
./scripts/translate.sh create fr # French
This creates a new .po file pre-populated from the .pot template. Open it in a text editor or a PO editor (e.g. Lokalize, Poedit) and fill in the msgstr fields.
./scripts/translate.sh update
Merges new or changed source strings from the .pot template into all existing .po files. Strings that changed in English are marked fuzzy so translators can review them.
./scripts/translate.sh compile
Creates binary .mo files from .po files. These are what Plasma loads at runtime. Always compile before reinstalling if you've edited translations.
./scripts/translate.sh stats
Shows per-language completion percentage (translated / total strings).
Strings not translating at runtime:
i18n() in the QML source../scripts/translate.sh all to regenerate and compile../install.sh dev and restart Plasma (plasmashell --replace &).New language not appearing:
.po and a compiled .mo file exist in po/.pt_BR, not pt-BR).To build a .plasmoid file for distribution (e.g. KDE Store upload):
./scripts/package-up.sh
This reads the version from metadata.json, creates K-Ollama-{VERSION}.plasmoid in the parent directory of the project, and prints a contents summary. The package includes only end-user files (metadata.json, LICENSE, README.md, contents/, po/) — development files, tests, and scripts are excluded.
Before packaging:
"Version" in metadata.json../scripts/translate.sh all to ensure compiled .mo files are up to date../scripts/package-up.sh.├── contents/ # Plasmoid source files
│ ├── config/ # KCM configuration pages
│ │ ├── config.qml # Declares config tabs (Server, Appearance, Behavior)
│ │ └── main.xml # KConfig schema (persisted settings)
│ ├── js/ # Shared JavaScript utilities
│ │ └── utils.js # getServerUrl, extractCodeBlocks, debugLog, etc.
│ └── ui/ # Main UI components
│ ├── main.qml # Primary widget UI and Ollama API logic
│ ├── ConfigAppearance.qml # Icon theme selection
│ ├── ConfigBehavior.qml # Input, sound, markdown, timeout, debug settings
│ ├── ConfigServer.qml # Server URL, temperature, system prompt
│ ├── ConfigDefaults.qml # Default values for all cfg_ properties
│ ├── CompactRepresentation.qml # Panel icon
│ ├── ConnectionManager.qml # Polls server and exposes connected/status
│ └── assets/ # Icons and audio
├── po/ # Translation files
│ ├── *.pot # Translation template (generated by extract)
│ ├── *.po # Language-specific translations (human-edited)
│ └── *.mo # Compiled translations (generated by compile)
├── scripts/ # Utility scripts
│ ├── translate.sh # Translation management (extract/update/compile/stats)
│ ├── package-up.sh # Build .plasmoid distribution package
│ ├── run-tests.sh # QML unit test runner
│ └── install-translations.sh # Low-level helper called by install.sh
├── tests/ # QML unit tests (qmltestrunner)
├── docs/ # Project documentation
├── install.sh # Install/uninstall/status script
└── metadata.json # Plasmoid identity, version, and KDE metadata
gettext — for xgettext, msgmerge, msgfmt (translation toolchain)jq — used by package-up.sh to read metadata.jsonInstall on Debian/Ubuntu:
sudo apt install gettext jq qml6-module-qttest libqt6quicktest6
Run the full test suite:
./scripts/run-tests.sh
Options:
./scripts/run-tests.sh -v2 # Verbose output (shows individual test names)
SKIP_QML_LINT=1 ./scripts/run-tests.sh # Skip QML linting for faster iteration
QMLTEST_RUNNER=/path/to/qmltestrunner ./scripts/run-tests.sh # Custom runner path
Tests live in tests/ and use Qt's qmltestrunner. Each file covers a distinct area: utilities, UI input behavior, markdown rendering, server connection, KCM config, error handling, and performance.
plasmashell --replace & # Restart Plasma
./install.sh status # Verify installation path
kpackagetool6 --list | grep K-Ollama # Confirm KDE sees it
KDE caches plasmoid packages. After ./install.sh dev, remove and re-add the widget from the panel, or restart Plasma with plasmashell --replace &.
./install.sh dev./scripts/run-tests.sh./install.sh devi18n() strings: ./scripts/translate.sh alli18n() for all user-visible strings; i18nc() when context is needed for disambiguation.import QtQuick, not import QtQuick 2.15).Once published, install directly from KDE:
Download the latest release from GitHub Releases
.plasmoid package fileInstall the package:
kpackagetool6 --type Plasma/Applet --install K-Ollama-1.1.0.plasmoid
Add to your panel:
For testing or development:
Clone the repository:
git clone https://github.com/chevybowtie/K-Ollama-Plasmoid.git .
cd K-Ollama-Plasmoid # or whatever folder name you choose
Install using the development script:
./install.sh dev
This automatically removes any existing installation and installs the updated version.
Add to your panel:
Then run powershell -ExecutionPolicy Bypass -File .\setup.ps1. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: winget install Git.Git
git clone https://github.com/chevybowtie/K-Ollama-Plasmoid.git cd K-Ollama-Plasmoid
Run these in Git Bash (installed with Git) or WSL — not PowerShell. Do the README instructions above first.
kpackagetool6 --type Plasma/Applet --install K-Ollama-1.1.0.plasmoid cd K-Ollama-Plasmoid # or whatever folder name you choose ./install.sh dev
The steps run shell scripts (.sh). Use Git Bash (winget install Git.Git) or WSL2 (wsl --install).
No reports for Windows yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for Windows. Once written, it's saved for everyone.