8000 GitHub - hyprlab/hylki at v1.6.1 · GitHub
[go: up one dir, main page]

Skip to content
hyprlabPublic

About

Hylki (formerly Vireo): a fast, GNOME-native email client built with Rust and libadwaita.

Topics

Resources

Stars

341 stars

Watchers

0 watching

Forks

Repository files navigation

Vireo logo

Vireo

A clean, fast, GNOME-native email client — built with Rust and libadwaita, privacy-first.

Website · Release notes · Releases
License: AGPL-3.0

Vireo showing a unified inbox in light mode


Note

Veem is now Vireo. As of v1.6.0 the app formerly known as Veem has a new name and icon — the old name was too easily confused with similarly named products. Same app, same code. Native installs migrate your data automatically; Flatpak users should install Vireo fresh and remove the old Veem app. getveem.com now redirects here.

Vireo is a desktop email client for Wayland that feels at home in GNOME. It talks IMAP/SMTP directly, keeps your mail and credentials on your machine, and blocks trackers by default — no telemetry, no analytics.

Features

  • Multiple accounts — IMAP and POP3, each on its own background worker, with a unified All Inboxes view.
  • OAuth 2.0 sign-in — Google, Microsoft and custom providers over XOAUTH2, plus import from GNOME Online Accounts.
  • Whole-mailbox sync & search — no message-count cap; a fast first page loads instantly, the rest indexes in the background with infinite scroll.
  • Two-way sync — deletions and moves from your phone or another client sync back automatically (IMAP IDLE + reconciliation).
  • Conversation threading, compose/reply/forward with HTML signatures, editable drafts, and full folder management.
  • Privacy-first reading — remote content blocked by default, per-sender allow/block lists, and a per-message light/dark content theme.
  • GNOME-native — adaptive three-pane layout, per-account colours and emoji avatars, light/dark following the system, optional GNOME Contacts.

See RELEASE_NOTES.md for the full list.

Installing

Flatpak (recommended) — works on any distribution; see vireo.hyprlab.co for the signed Flatpak repo.

Fedora — download the .rpm from the latest release and:

sudo dnf install ./vireo-*.x86_64.rpm

Arch Linux — download the .pkg.tar.zst from the latest release and:

sudo pacman -U ./vireo-*-x86_64.pkg.tar.zst

You can also build the Arch package yourself with makepkg from packaging/arch/PKGBUILD.

The native packages target current distro releases (Fedora 44+, up-to-date Arch). On anything older, use the Flatpak or build from source. A Secret Service provider (e.g. gnome-keyring, preinstalled on GNOME) is needed at runtime for password storage.

Building from source

Vireo needs the Rust toolchain and the GTK 4 / libadwaita / WebKitGTK 6 development libraries, plus a Secret Service provider (e.g. gnome-keyring) at runtime.

Fedora

sudo dnf install gtk4-devel libadwaita-devel webkitgtk6.0-devel

Debian / Ubuntu

sudo apt install libgtk-4-dev libadwaita-1-dev libwebkitgtk-6.0-dev

Build & install

git clone https://github.com/hyprlab/vireo.git
cd vireo
cargo build --release
./install.sh          # installs the binary, icon and .desktop file into ~/.local

Configuration

Add accounts from Settings → Accounts in the app. For a plain IMAP/SMTP account you only need the server and an app-specific password. See accounts.toml.example for the on-disk format — passwords you enter there are migrated into the system keyring on first run and removed from the file.

OAuth (Google / Microsoft)

Microsoft works out of the box — pick Microsoft in the account editor and sign in.

Google signs in through GNOME Online Accounts — add your Google account in GNOME Settings → Online Accounts, then import it in Vireo. Official builds don't bundle a Google OAuth client (Google's secret can't live in a public repo), so GNOME Online Accounts is the standard path. You can also use your own OAuth client (see below).

To use your own OAuth client (a fork, a self-hosted build, or to replace the bundled ones), put it in ~/.config/vireo/oauth.toml:

[google]
client_id = "your-client-id.apps.googleusercontent.com"
client_secret = "your-client-secret"

[microsoft]
client_id = "your-azure-application-client-id"  # public client, no secret

or via the VIREO_GOOGLE_CLIENT_ID / VIREO_GOOGLE_CLIENT_SECRET and VIREO_MICROSOFT_CLIENT_ID / VIREO_MICROSOFT_CLIENT_SECRET environment variables.

Bundling a Google client at build time (for maintainers) — set the env vars during the build and they're compiled in via option_env!:

VIREO_GOOGLE_CLIENT_ID=... VIREO_GOOGLE_CLIENT_SECRET=... cargo build --release

Privacy

Vireo collects no telemetry and sends no analytics. Remote content in messages is blocked by default to defeat tracking pixels. Passwords and OAuth refresh tokens live in the system keyring (secret-service), never in plain files.

Contact & support

License

Vireo is free software licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).

© 2026 Hyprlab

About

Hylki (formerly Vireo): a fast, GNOME-native email client built with Rust and libadwaita.

Topics

Resources

Stars

341 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

0