← All documentation

Start here

The desktop and its design

One desktop, one package manager, one way to do things. Here is how ade is laid out, and the keys that make it fast.

The idea

AOS has one desktop, ade, and no other can be installed. It has one package manager, apm, and one set of apps built to feel like one thing. That is a choice, not a limit: when there is only one way to do something, it can be made to work every time, and an app that runs on one AOS machine runs on all of them.

Two more principles shape the design:

  • Two tiers of software, and the line is visible. Official apps are built and tested with each release. Third-party apps, such as Steam, Firefox and VS Code, are there so the things you expect to run do run. They are labelled third-party everywhere, and they live in a sandbox.
  • The system can’t break. The core is sealed and read-only, and an update that fails undoes itself. See How AOS keeps you safe.

How the desktop is built

ade is written from scratch in Rust and has three parts:

  • The compositor draws windows and their title bars, so every window has the same controls.
  • The shell draws everything else: the bar, the dock, the overview, the launcher, the quick panel, notifications and the wallpaper. It runs on its own, so if it ever crashes your windows stay open and it comes back.
  • The lock screen is a separate program. If it fails, the screen stays locked.

The bar

The bar sits at the top of every display. You can move it to the bottom in Settings → Appearance → Bar.

  • Left: the home button opens the overview.
  • Right: weather (once Weather has a place), network, battery, volume, and the date and time.
  • Middle: a red SSH open while remote login is on, so you always know.

Click the status area to open the quick panel. It has volume and brightness sliders, tiles for Wi-Fi, Bluetooth, power mode and wired network, buttons for Calendar, Clock, Settings, Lock and Power, and your recent notifications. The arrow on a tile opens more: Bluetooth devices, power profiles, or the Power page with Suspend, Hibernate, Restart, Power off and Log out.

The dock

The dock is a glass strip with your pinned and running apps. A dot marks an app that has a window open.

  • Click starts the app. On an app with windows, a click hides them all, and the next click brings them all back.
  • Right-click gives New window, Hide/Show, Reset, Pin to dock / Unpin and Close all, and a row for each of the app’s windows with its own Show, Reset, Minimize and Close.
  • Hover an icon to light up all of its windows, or a window’s row to light up just that one.

The dock in Home (Super) works the same way.

In Settings → Appearance → Dock you can move it into the bar, change its size, hide it automatically, or turn it off.

Finding and starting apps

  • Tap Super (the Windows key) or click the home button for the overview: all your apps in pages, with a search field that already has the keyboard. Start typing and press Enter. Your running apps are along the bottom.
  • Super+A opens the quick launcher: a small list that filters as you type.

Windows

New windows open in the middle of your main display. To arrange them:

  • Drag a window to the left or right edge for half the screen, to a corner for a quarter, or to the top to fill it.
  • Or use Super+Left / Right for halves and Super+Up to maximize. From a half, Super+Up gives the top quarter. Super+Down steps back.

ade has no workspaces or automatic tiling yet.

Several displays

Settings → Display handles each display on its own: resolution, refresh rate, scale (automatic by default), variable refresh rate, HDR where the display supports it, and which one is the main display, where new windows open. Displays can extend or mirror, arranged left to right. Every display gets its own bar, dock and wallpaper.

Look and feel

Settings → Appearance:

Setting Choices
Scheme Dark (smoked glass) or Light (white glass)
Glass Everywhere, only on the bar and panels, or Lightweight (no blur, for slower graphics)
Accent colour Blue, Teal, Green, Orange, Rose, Purple, or any colour you pick
Animations On or off
Desktop Show files and shortcuts from ~/Desktop, in three sizes

High contrast is in Settings → Accessibility, along with the screen reader, the magnifier, text size and reduced motion. To set a wallpaper, open a picture in Images, right-click it and choose Set as wallpaper.

Notifications

One notification shows at a time, top right, and stays for about 5 seconds; important ones stay longer. Click it to act on it, for example to open Software when updates are waiting. Missed ones are in the quick panel.

Keyboard shortcuts

Keys What it does
Super (tap) Overview and app search
Super+A Quick launcher
Super+T or Super+Enter Terminal
Super+E Files
Super+N Notepad
Super+Q Close the window
Super+L Lock the screen
Alt+Tab or Super+Tab Switch windows
Super+Arrows Snap, maximize, restore
Ctrl+Super+Left / Right Move the window to the other display
Print or Super+Shift+S Screenshot of an area you drag; a click takes the whole display
Shift+Print Screenshot of the active window
Super+Alt+K Quick panel, from the keyboard
Super+Alt+= / - / 0 Magnifier in / out / reset
Super+Alt+S Screen reader on or off
Super+Esc Take the shortcuts back from an app that grabbed them
Ctrl+Alt+Backspace Sign out, even if the desktop has stopped answering

Screenshots are saved in ~/Pictures/Screenshots.

Signing in and locking

The login screen lists the accounts on the machine. Your password also unlocks your encrypted home. The lock screen (Super+L) shows the clock and a password field. While the screen is locked, only the volume and brightness keys, the magnifier and the screen reader work.