Wazza OS User guide Sign in

Apps and tabs

The apps live in the VM. Home › Apps lists every app you can use, about 70 of them; one click installs an app and opens it in a tab, with a Chat beside it whose agent knows that app.

The Apps page#

Home, Apps page: search, Add app, category filters Main apps, Installed, Office, Internet, Communication, Creative, Video and audio, 3D and games, Developer, System, Your apps; the Main apps Chat, Computer Control and Wazza Pro; the Office apps with download badges 1 2 3 4 5 6
Home › Apps right after the first start.
  1. Search apps: type part of a name or of what it does (photo, pdf, 3d).

  2. Add app: add an app that is not in the list (Add your own apps).

  3. The filters: Main apps, Installed, then the categories (Office, Internet, Communication, Creative, Video & audio, 3D & games, Developer, System) and Your apps (the ones you added). Each shows how many apps it holds.

  4. An installed app: no badge. A click opens it.

  5. A not installed app: a download badge at its top right. A click installs it, then opens it.

  6. Each section says how many of its apps are installed and how many are left to install.

The main apps#

AppWhat it is
ChatAsk any agent: a tab that is all Chat (Chats, agents and models).
Computer ControlScreen control: a Chat that can use your own computer, after your consent (Computer Control).
Wazza ProAI media creation: Wazza's image, video, audio and voice tools, with a Wazza account and its credits.

What is in the catalog#

CategoryApps
OfficeONLYOFFICE Documents, Spreadsheets, Presentations and PDF editor; Calendar; Sticky Notes; the web versions of Google Docs, Sheets, Slides, Forms, Keep and Calendar, and of Microsoft Word, Excel, PowerPoint, OneNote and Outlook Calendar
InternetChromium, Chromium Incognito, Brave, Opera, Proton VPN, OpenStreetMap, Google Maps, Google Drive, OneDrive, Dropbox; tools: OSM places and routes, Search
CommunicationGmail, Outlook, Proton Mail, Google Meet, Teams, Telegram, Signal, WhatsApp, Discord, X, Facebook, Postiz (post scheduler)
CreativeGIMP, Inkscape, Glaxnimate (2D animation), Motion Studio (motion graphics), Trelby (screenwriting)
Video & audioVLC, Kdenlive, OBS Studio, Voice Studio (text to speech), YouTube, TikTok, Spotify; tool: Video Toolkit (FFmpeg video tools and yt-dlp)
3D & gamesBlender, FreeCAD, Godot, Web Game Studio, Tiled (game maps), Free Texture Packer (sprite sheets), BREP (parametric CAD), Unity Hub
DeveloperVSCodium, Zed, Wave Terminal, Postgres; tool: Git
SystemFiles, Desktop, Settings, Calculator, KeePassXC, OTPClient (2FA codes); tools: GPU for apps, Sound card drivers

The tools have no window: they give the VM and its agents a capability (Git, the graphics libraries, sound, web search, maps and routes, video processing). They install like apps; Git, GPU for apps, Sound card drivers, Search and OSM places and routes are installed on the first start.

Web apps (Gmail, Google Docs, Word, Teams…) open in the VM's browser as their own tab; their sign-ins are on Sign in › Web apps.

Install an app#

Apps page with gimp typed in the search: the Creative section shows GIMP, Photo editing, with its download badge
Searching gimp: one result, not installed yet (the badge at its top right).
  1. Find the app (filter or search).

  2. Click it (its tooltip says Install and open). A new tab opens and shows the installation:

The new GIMP tab, Starting: Installing GIMP, The app will open once installation and verification finish. You can use another tab while this runs. Elapsed time, Running, Cancel installation
  1. The tab says Installing … with the time elapsed. You can use other tabs meanwhile; Cancel installation stops it.

  2. When it is installed and checked, the app opens in the tab, with its Chat on the left. A notification says it is done.

Installing takes from under a minute (small apps) to several minutes (Blender, ONLYOFFICE), depending on your connection. Apps install inside the VM, so they never change your computer. When an installation fails, the tab says why with Retry installation and Show log; Wazza OS already retried once by itself.

An agent can install apps for you too: ask "install Inkscape and open it", or give it a job in an app that is not installed: it installs it first.

Open and use an app#

  • Click an installed app: it opens in a new tab (Tabs). Open the same app twice and you get two tabs, each with its own window and its own Chat.
  • Use it as on any computer: click, type, use its menus. Its files are in the VM (Files and sharing).
  • Ask its Chat to work in it for you: the agent knows the app (its skill) and uses its tools or Drive.
A GIMP tab after its agent's work: the Chat's answer Done, the image is open in GIMP, 800 x 600 canvas with a dark teal background, Hello from Wazza OS in white, centered; and GIMP showing the image with Hello from Wazza OS
"Create a new 800 x 600 image with a dark teal background and write Hello from Wazza OS in large white letters in the middle": the agent of a GIMP tab did it with GIMP's own tools.

The app menu#

The menu of the GIMP card: GIMP, Photo editing; Open in vm-1; Open in a new VM; Edit app; Uninstall from vm-1

Right-click an app on the Apps page:

ItemWhat it does
Open in vm-1Opens it in that VM (one item per VM where it is installed).
Open in a new VMMakes a new VM and opens the app there (several VMs).
Edit app…The app's recipe and its skill files: how it installs and starts, and what its agent knows (Edit an app's skill).
Uninstall from vm-1…Removes the app from that VM (below).
Remove from catalog…(an app you added) Takes your app out of the catalog, once it is uninstalled everywhere.

Uninstall an app#

  1. Right-click the app on the Apps page › Uninstall from vm-1….

  2. A box shows the exact plan before anything happens:

Uninstall GIMP from vm-1? Cannot uninstall yet: the app is open in tab vm-1.t2; Removes files: the GIMP AppImage and its commands and 2 more; Open in tabs: vm-1.t2; APT GIMP 2.10 was removed at install and is not restored; Plan e553f5f406e4; Show every file, package and folder; Close its open tabs first; Uninstall (grey); Cancel 1 2 3 4
Uninstalling GIMP while a GIMP tab is open.
  1. What will be removed (files, commands, packages), the tabs where the app is open, and what is not restored (here, an older GIMP that its install had replaced).

  2. Show every file, package and folder: the complete list.

  3. Close its open tabs first: needed when the app is open (otherwise the box says Cannot uninstall yet and Uninstall stays grey).

  4. Uninstall removes exactly that plan; Cancel changes nothing. The card follows it (Uninstalling…) and a notification says when it is done.

Your files made with the app (in the VM's folders) stay. Apps that Wazza OS itself needs (Files, Desktop, the default tools) cannot be uninstalled.

From the command line#

$ wazza --gui app list
$ wazza --gui app status gimp
$ wazza --gui app uninstall gimp --vm vm-1 --follow

Every app subcommand: The command line › Apps.

Wazza OS user manual · written for Wazza OS 0.2.0 (build 44c5d0ea07c1) · screenshots from a test computer running Wazza OS 0.2.0.