Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
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 macOS?
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 bash setup.sh. 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: xcode-select --install
git clone https://github.com/chevybowtie/K-Ollama-Plasmoid.git cd K-Ollama-Plasmoid
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
kpackagetool6 --type Plasma/Applet --install K-Ollama-1.1.0.plasmoid cd K-Ollama-Plasmoid # or whatever folder name you choose ./install.sh dev
No reports for macOS yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.