Run 928 logged "--network and --net in the options will be ignored", so NetworkMode stayed the per-job bridge. The fix is a DOCKER-USER exception on the runner host (pizzabox), which accepts RELATED/ESTABLISHED traffic from br-f192811a98b7; verified 200 from a bridge container after adding it.
Paarrot
Paarrot is a Matrix client focusing primarily on simple, elegant and secure interface. The desktop app is built with Electron and based on Cinny.
Download
Installers for Windows and Linux can be downloaded from releases.
| Operating System | Download |
|---|---|
| Windows (x64) | Get it on Windows |
| Linux (AppImage) | Get it on Linux |
Linux Installation
For the best AppImage experience, we recommend using AppImageLauncher which automatically integrates AppImages into your system.
Local development
To setup development locally run the following commands:
git clone --recursive http://synbox.ruv.wtf:8418/litruv/cinny-desktop.gitcd cinny-desktop/cinnynpm cicd ..npm ci
To build the app locally, run:
npm run build
To start local dev server, run:
npm run dev
Testing
npm run test- unit and E2Enpm run test:unit- Vitestnpm run test:e2e- Playwright driving Electron
The E2E test drives the real Electron app against the vite dev server, so it needs the
cinny dependencies installed and an X display. On a headless machine run it under xvfb:
xvfb-run -a npm run test:e2e.
The E2E test logs in to a live homeserver over the network, so it needs network access and a working test account. It uses a dedicated account, never a personal one:
| Variable | Default |
|---|---|
E2E_HOMESERVER |
ruv.wtf |
E2E_USER |
giteaci |
E2E_PASSWORD |
required, read from the environment, never committed |
A failed E2E run attaches a screenshot and the main and renderer console logs to the
report. CI uploads test-results/ and playwright-report/ as artifacts.
Plugin System
Paarrot includes a plugin system for extending and customising the app with JavaScript modules.
Installing Plugins
- Drop a plugin folder into your plugins directory:
- Windows:
%APPDATA%\paarrot\plugins\<plugin-name>\ - Linux:
~/.config/Paarrot/plugins/<plugin-name>/for the packaged app,~/.config/paarrot/plugins/<plugin-name>/when running from source - macOS:
~/Library/Application Support/Paarrot/plugins/<plugin-name>/
- Windows:
- Enable it in Settings → Plugins → Installed
What Plugins Can Do
- Register custom slash commands
- Intercept and modify messages
- Inject buttons into 11 UI locations (nav lists, toolbars, headers, sidebar, menus)
- Register custom themes
- Hook into raw Matrix events
- Run background tasks
- Show system notifications
Plugin Locations (UI Buttons)
Plugins can inject buttons as nav list rows or icon buttons across the app:
| Location | Style | Where |
|---|---|---|
channel-list |
Nav row | Space channel list |
home-section |
Nav row | Home panel, above room list |
direct-messages |
Nav row | DMs panel, below "Create Chat" |
sidebar-actions |
Icon | Left sidebar — above Explore and above Search |
text-composer-toolbar |
Icon | Message composer toolbar |
composer-actions |
Icon | Beside the + attach button |
room-header |
Icon | Room header bar |
room-menu |
Icon | Room ⋮ dropdown |
message-actions |
Icon | Message hover bar |
user-menu |
Icon | Right-click on user avatar |
search-notification-section |
Icon | Notifications page header |