Violoop Docs

English

简体中文

English

简体中文

Appearance

Settings Reference ​

This page is the detailed, item-by-item companion to Settings & Preferences. It explains what every setting does, the options you'll see, and when to change it. Use the search box at the top of Settings to jump to any item by name.

Where settings live. A few settings belong to the Violoop app on this computer (they don't travel with the device). Most belong to the device — its config is the single source of truth, so those preferences follow the device to any computer. Each item below notes which it is.

Saving. Nearly everything saves automatically the moment you change it — a small saving → saved indicator confirms it. The exceptions (things that apply on a button) are called out.

The two proxies — and why there are two ​

This is the most common point of confusion, so it's worth being precise. Violoop has two independent network-proxy settings, because two separate machines make network connections:

  • Your computer, running the Violoop desktop app.
  • Your device, which has its own network (its Wi-Fi) and makes its own outbound connections — to AI providers and the Violoop cloud.

They are configured in different places and route different traffic. Setting one has no effect on the other.

Network Proxy (app)Device Network Proxy
WhereSettings → PC / GeneralSettings → Device
Whose trafficThe desktop app's own outbound connections (from this computer)All outbound HTTP/HTTPS from the device — AI provider APIs, the cloud, and processes the device runs
Lives onThis computerThe device
OptionsOff / Manual / Auto (system)Enable toggle + proxy URL

Network Proxy (the app's proxy) ​

Found under PC / General. It controls how the desktop app itself reaches the network from your computer. Three modes:

  • Off — All the app's connections go direct, with no proxy.
  • Manual — You enter a proxy URL, e.g. http://127.0.0.1:7890. Saves when you press Enter or click away (a half-typed URL is never saved).
  • Auto (system) — The app follows your operating system's configured proxy. The detected system proxy is shown so you can confirm what it will use; if none is detected, it connects directly.

Environment override. If the VIOLOOP_HTTP_PROXY environment variable is set, it overrides this setting. When that happens the app shows the currently-effective proxy with a warning, so a "why isn't my setting applying?" moment explains itself.

Use this when the desktop app needs a proxy to reach its own services (updates, sign-in, etc.) on a restricted network.

Device Network Proxy ​

Found under Device. A simple Enable toggle plus a Proxy URL field. When enabled, it routes all outbound HTTP/HTTPS traffic from the device through that proxy — including calls to AI provider APIs, the Violoop cloud, and any processes the device spawns. It accepts http:// or https:// URLs and saves automatically.

Use this when the device's internet access must go through a proxy — for example a corporate network, or when you deliberately want to route the AI traffic through a specific proxy.

Most people need neither, or only one. Reach for the device proxy when it's the AI/cloud traffic that needs routing; reach for the app proxy when it's the desktop app itself that can't get out.

This Computer ​

Settings for the Violoop app on this particular computer. These do not travel with the device.

General ​

  • Assistant language — The language the assistant replies in, and the language of the app's own interface. Leave it on Auto to follow your system, or pick a fixed language.
  • Dynamic Island display — Which monitor the floating status island appears on, if you have more than one screen.
  • Network Proxy — The app's outbound proxy. See The two proxies above.
  • Restart onboarding — Re-runs the first-time setup wizard. This resets the local setup on this computer (with a confirmation prompt); it doesn't erase your device's data.

Runtime ​

Status of the small bundled components the app uses to run certain tasks. Each shows ready / initializing / failed / idle, its install location, and any error. Normally there's nothing to do here; if one fails you can Reinitialize it, or Refresh to re-check. The panel polls its status automatically.

System Permissions (macOS only) ​

The macOS privacy permissions Violoop needs to operate your computer — Accessibility, Automation, Screen Recording, and optionally Full Disk Access. Each row shows granted/denied status with a required-or-optional tag, and a button to grant it or open the correct system settings pane. See Operating Your Computer for what each is for. On Windows and Linux this panel simply notes that no equivalent permissions are needed.

Version & Update ​

Two sub-sections — PC app and Device firmware — each showing the current and latest versions, an update-status pill, download progress, and a release-notes link. You can Check for updates, Install / Update now, or Ignore this version. Updating the device requires it to be connected. See Connecting & Troubleshooting for the firmware-update flow.

Assistant Intelligence ​

How your assistant thinks and what it can reach. These live on the device.

Models ​

Choose where the AI runs and which model:

  • Violoop Cloud — The simplest option. Shows your account balance and lets you pick a model and the reasoning effort (how hard it thinks; higher is more thorough but slower).
  • Custom — Bring your own: add API keys for providers, add custom models, or use local models (it auto-detects a local Ollama running on your machine).

A pending model choice is only committed when you click Apply, so you can line up a change without switching mid-thought.

Tools ​

The list of built-in tools the assistant can use, each with an on/off toggle. You can filter to only-enabled or only those that require confirmation, and each tool shows whether it will, may, never, or is blocked from asking you before it runs. Turn a tool off to remove that capability entirely.

Skills ​

The reusable skills your assistant has picked up, shown as cards. Enable, disable, or delete each one, search the list, and Open folder to see where they're stored. Skills are the assistant's "how-to" knowledge for recurring tasks.

Voice & Language ​

  • Speech recognition language — The language used when you talk to Violoop (Auto, or a fixed language).
  • Text-to-speech — Marked coming soon; not yet active.

MCP Servers ​

Connect external tool servers that speak the Model Context Protocol to extend what the assistant can do. Add, edit, enable, or remove a server; choose its transport (a local command or a URL); see its connection state and the tools it exposes. A Recommended catalog lets you search and install common servers in a click.

Plugins ​

Install and manage plugins that add new capabilities and surfaces. Per plugin you can launch or stop it, toggle it on, open its own settings, review the permissions it requests, and see its status (running / installed / not installed).

Proactive ​

Controls whether Violoop offers help on its own:

  • Enable — Turn proactive suggestions on or off.
  • Sampling interval — How often it checks in on what's happening (seconds).
  • Fire threshold — How confident it must be before it speaks up, from loose (more suggestions) to strict (only high-confidence ones).
  • Privacy controls — Pause/resume the engine, opt in to (or out of) uploading diagnostic data, upload now, or purge collected data. Status readouts show whether the engine is running and how much it has processed.

Permissions ​

Under Device settings → Permissions — the controls for what the assistant may do on your computer. This is the most security-relevant panel. It lives on the device.

  • Access presets — One-click profiles that set a sensible baseline: Safe, Recommended, or Trusted.
  • File access — Whether the assistant may read and write files at all (read and write are separate).
  • Command execution — Whether running terminal commands is denied, always asks first, or allowed.
  • Path sandbox — An on/off toggle and a mode (deny or ask) governing file access outside the allowlist, plus the Allowed Directories list itself. Add a folder to let the file tools work in it; anything not listed stays off-limits to file editing. This is the whitelist described in Operating Your Computer.

Tightening these keeps Violoop on a short leash; loosening them lets it act with fewer interruptions.

Your Device ​

Settings for the hardware itself. These live on the device.

  • Wi-Fi — Connect the device to a wireless network so it can reach the cloud: scan, pick a network, see signal strength, and enter the password (or type a hidden SSID manually).
  • Timezone — The device's timezone, from a searchable list; applies on Apply.
  • Volume — The device speaker volume (0–100%); applies when you release the slider.
  • Proxy (Device Network Proxy) — The device's outbound proxy. See The two proxies.
  • Security — Read-only trust information: the device's own public key (its trust anchor) and the list of client devices enrolled with it. You can copy these; there's nothing to edit.

Account & Backup ​

Account ​

Your profile card (name, email), with Edit profile (nickname, bio), Change password, and Logout.

Backup & restore ​

Safeguard and move your assistant's data and memory:

  • Back up to cloud — Save everything to the cloud; shows the last backup's time.
  • Restore from cloud — Pick a previous backup to restore. Restoring replaces the device's current data.
  • Export / Import — Save a backup to a local file, or load one back in.

Budget ​

  • Unlimited toggle, or a daily spending limit in dollars.
  • A gauge of today's spend versus the limit, a per-provider breakdown, and a 7-day history.

Stats ​

Read-only usage and performance analytics — request and session counts, input/output token usage (including cache), latency trends, and a per-model breakdown. Nothing to configure; it's for insight.

Advanced ​

  • Compaction — For long conversations, the assistant condenses older context to stay within limits. Here you can see each session's context usage against its threshold, force a compaction manually, and export a session transcript (Markdown or JSONL).
  • Icon Models — Manage the small per-app vision models cached to help the assistant recognize what's on screen: view the cache, download or re-fetch per app, and clear items.
  • Edge Status — A diagnostics dashboard for the device link — connection/signaling status, the device's network details, and a reconnect button.

Developer mode. Clicking the version string at the bottom of Settings seven times unlocks developer mode, revealing extra panels (such as a system-prompt editor). It's not needed for normal use — leave it off unless you know you need it.

See Also ​