﻿# Volade Toolbar

**Volade Toolbar** is a universal search and launcher bar, part of the
VOLADE ecosystem â€” built with **Tauri 2 (Rust + WebView2)**, styled with the purple
VOLADE identity and fully multilingual.

![Volade](assets/logo.png)

---

## Version

**1.0.0** â€” September 2026

*1.0.0 is the final release:* the bar drags and snaps to the nearest screen edge
(its position is saved and restored), the picker / settings / premium panels open
**centered, borderless and frameless**, real **transparency** affects the bar
only, the weather has a fallback provider, and minimizing sends the app to the
**system tray**. The Settings and Premium panels are wider.

## Features

- **Universal search** â€” search the web, social networks, media, AI platforms,
  marketplaces and more from a single bar; the query (`{q}`) is injected into the
  target site's search URL.
- **Quick-launch buttons** â€” clock, power shortcuts and your most-used apps with
  their **real program icons**, displayed right on the bar.
- **17 languages** â€” the entire interface (bar, settings, premium panel) is
  translated: French, English, Spanish, German, Italian, Portuguese, Dutch,
  Polish, Russian, Indonesian, Arabic, Hindi, Chinese, Japanese, Korean, Turkish,
  Vietnamese. Switching takes effect **immediately**.
- **Movable bar** â€” drag it with the grip handle; its on-screen position is
  **saved** and restored at launch, always **aligned to the edges** of the screen
  without overflowing.
- **Snap to edge** â€” the bar automatically snaps to the nearest screen edge (top,
  bottom, left or right) when dragged close, adapting to any resolution and
  multi-monitor setup.
- **Centered modals** â€” the site picker, settings and premium panels open as
  centered borderless windows with **no frame, no border and no background**.
- **System tray** â€” minimizing the app hides it in the notification area (tray);
  click the tray icon (or use its menu) to bring the bar back.
- **Adjustable transparency** â€” configure the bar's transparency from 0 % (opaque)
  to 40 % in the Settings.
- **Volade Premium** â€” the exact same plans as the website (Free â‚¬0 / Premium
  â‚¬9.90 per month or â‚¬8.49 per year / Lifetime â‚¬299, crossed out from â‚¬399; promo
  code `WELCOME` for -10%). Checkout is handled on `https://api.volade.com`.
  Premium unlocks:
  - search history
  - custom app shortcuts (add, rename, enable/disable)
  - custom search engines
  - voice search
- **Windows autostart** â€” enabled by default, toggleable in Settings.
- **System stats & weather** â€” optional CPU/RAM and weather display in the bar.

## Downloads

| File | Platform | Format |
| --- | --- | --- |
| `Volade_Toolbar_1.0.0.zip` | **Windows** (10/11, x64) | MSI installer inside ZIP |
| `Volade_Toolbar_1.0.0-linux.zip` | **Linux** (Debian/Ubuntu, x64) | DEB package inside ZIP |
| `Volade_Toolbar_1.0.0-macos.zip` | **macOS** (12+, Universal) | DMG inside ZIP |

> Windows est packagÃ© localement ; Linux et macOS sont reconstruits via le
> workflow GitHub (`release.yml`) en version 1.0.0, fonctionnellement identiques.

### Windows

1. Extract `Volade_Toolbar_1.0.0.zip`.
2. Run the MSI installer: `Volade Toolbar_1.0.0_x64_en-US.msi`.
3. The WebView2 runtime is installed automatically if missing.

### Linux

See `INSTALL-LINUX.md` for detailed instructions.

```bash
unzip Volade_Toolbar_1.0.0-linux.zip
sudo dpkg -i "Volade Toolbar_1.0.0_amd64.deb"
```

### macOS

See `INSTALL-MACOS.md` for detailed instructions.

```bash
unzip Volade_Toolbar_1.0.0-macos.zip
open Volade\ Toolbar_1.0.0_aarch64.dmg
```

## First launch

1. Launch **Volade Toolbar**.
2. A splash screen appears for a moment, then the bar settles on screen.
3. Type a query and press **Enter** to search on the current site or engine.
4. Click the site icon (next to the search field) to open the **site picker**: a
   centered window opens with all available sites.
5. Click the **gear** button to open **Settings** (language, theme, transparency,
   autostart, shortcuts, engines, info).
6. Click the **premium button** to view the plans and checkout.

## Using the toolbar

- **Search a site** â€” select a site, type your query, press Enter. If the URL
  contains `{q}`, the query replaces it.
- **Change site / engine** â€” open the picker, pick a site (custom engines are
  highlighted with their icon).
- **Move the bar** â€” hold the grip (three dots) and drag; your position is saved.
  The bar snaps to the nearest screen edge for perfect alignment.
- **Pro tip** â€” enable search history (Premium) and click any past query to
  re-run it.

## Settings

- **Language** â€” 17 languages available, applied instantly.
- **Theme** â€” Dark / Light.
- **Transparency** â€” 0 % to 40 %, adjustable in increments of 10 %.
- **Weather** â€” show the weather in the bar (city configurable).
- **Autostart** â€” launch with Windows at logon (default: on).
- **Custom shortcuts** (Premium) â€” add app shortcuts with the app's real icon,
  rename them, enable/disable them.
- **Custom engines** (Premium) â€” add your own search engine with an icon.
- **Voice search** (Premium) â€” speak to search; uses your system speech
  recognition and the current interface language.
- **Info** â€” version and about.

## Premium

The premium modal reproduces the official prices:

- **Free** â€” â‚¬0, forever.
- **Premium** â€” â‚¬9.90/month or â‚¬8.49/year (billing toggle).
- **Lifetime** â€” â‚¬299 (~~â‚¬399~~).

Use promo code **`WELCOME`** at checkout for -10%. Checkout opens
`https://api.volade.com/api/checkout` in your browser.

## Shortcut

- `Enter` â€” run the search for the current site/engine.

## Build from source

Requirements: Node.js, Rust toolchain (`cargo`), and a stable WebView2 (Windows),
WebKitGTK (Linux) or WebKit (macOS).

```bash
npm install
npm run tauri -- build
```

Artifacts:
- `src-tauri/target/release/bundle/msi/Volade Toolbar_1.0.0_x64_en-US.msi` (Windows)
- `src-tauri/target/release/bundle/nsis/Volade Toolbar_1.0.0_x64-setup.exe` (Windows, NSIS)
- `src-tauri/target/release/bundle/deb/Volade Toolbar_1.0.0_amd64.deb` (Linux, via CI)
- `src-tauri/target/release/bundle/dmg/Volade Toolbar_1.0.0_aarch64.dmg` (macOS, via CI)

## Uninstall

- **Windows**: use *Programs and Features*.
- **Linux**: `sudo dpkg -r volade-toolbar`
- **macOS**: drag the app from Applications to Trash.

---

Â© Volade. See [volade.com](https://volade.com). [Terms & conditions](https://volade.com) Â· [Privacy](https://volade.com)
