Odoo Client

Product positioning

Odoo multi-platform client for Windows for store / office desktops: embed Odoo in a local Edge WebView2 shell, with bridges for print, customer display, scale, and other local capabilities—no need to keep a separate browser window open.

Capabilities in this release

• Embedded Odoo: Microsoft Edge WebView2 renders backend and PoS pages; session cookie injection keeps login state inside the shell.
• Local service bridge: Pages can call host capabilities through the client bridge (e.g. printFile, customer display, scale reads) for cashier and front-desk workflows.
• PDF print backend: The installer bundles portable SumatraPDF and Ghostscript runtimes; print flows prefer components under the install directory.
• Accounts and local config: Multi-account management; account DB and runtime logs live in the user data directory and are not shipped in the installer; uninstall does not delete user data by default.
• System tray: Closing the window can minimize to the tray (depending on the host environment) for always-on use.
• Devices / local services: Configure and manage local devices and services in the client (e.g. serial scales, depending on site hardware).
• In-app info: More in the address bar shows WebView engine / kernel version; WebView DevTools are available on desktop.
• Update check: Can use the company release channel to detect new versions (depends on on-site Odoo / release service).

Runtime requirements

Install and notes

1. Run Setup.exe and complete the wizard (UI defaults to Simplified Chinese; English / Español available).
2. If WebView2 is missing, follow the wizard to the official Evergreen installer, then start the client.
3. This package is desktop-only; handheld scan broadcast, Gecko WebView, and related capabilities are covered in the same-day Android release notes and are not included in this Windows installer.
4. On first use, configure the Odoo server URL in the client and sign in.

Known limitations

• Installer size is larger than a “browser bookmark only” approach because of the desktop shell, WebView2 plugins, and SumatraPDF / Ghostscript print components.
• Customer display and some peripherals depend on local hardware and drivers; without them, normal browser-style access to Odoo still works.

Product positioning

Odoo multi-platform client for Linux for store / office desktops: embed Odoo in a local WebKitGTK shell, with bridges for print, customer display, scale, and other local capabilities—no need to keep a separate browser window open. Feature set aligns with the same-day Windows desktop build; the engine and packaging follow Linux desktop conventions.

Capabilities in this release

• Embedded Odoo: WebKitGTK 4.1 (this repo’s flet-webview-linux) renders backend and PoS pages; session cookie injection keeps login state inside the shell.
• Local service bridge: Pages can call host capabilities through the client bridge (e.g. printFile, customer display, scale reads) for cashier and front-desk workflows. On HTTPS sites, the bridge script is injected in chunks so WebKit does not block in-page cleartext HTTP requests.
• PDF / receipt printing: Uses system CUPS (cups-client is a dependency; installing the cups service is recommended). Device discovery can enumerate local print queues. Unlike the Windows package, this build does not ship SumatraPDF / Ghostscript.
• Accounts and local config: Multi-account management; account DB and runtime logs live in the user data directory and are not shipped in the .deb; uninstall does not delete user data by default.
• System tray: Closing the window can minimize to the tray (requires AppIndicator / StatusNotifier). If the GIR is missing or there is no StatusNotifierWatcher, close falls back to minimize.
• Devices / local services: Configure and manage local devices and services in the client (e.g. serial scales, depending on site hardware).
• In-app info: More in the address bar shows WebView engine / kernel version; WebView DevTools are available on desktop.
• Update check: Can use the company release channel to detect new versions (depends on on-site Odoo / release service).

Runtime requirements

Install and notes

1. Install the .deb (if home-directory permissions are too strict for apt, copy to /tmp first, then use apt / dpkg):

   sudo dpkg -i Odoo-Client-*.deb
   sudo apt-get install -f
   # or:
   cp Odoo-Client-*.deb /tmp/
   sudo apt install /tmp/Odoo-Client-*.deb
   
   

2. On first use, configure the Odoo server URL in the client and sign in.

3. Under Wayland, the client runs via XWayland (GDK_BACKEND=x11) so window size and the device toolbar work; COSMIC / GNOME docks resolve the icon by APPLICATION_ID (cn.com.eist.odoo-client).

4. This package is desktop-only; handheld scan broadcast, Gecko WebView, and related capabilities are covered in the same-day Android release notes. Desktop print and customer display are also described in the same-day Windows notes (Windows print backend: SumatraPDF / Ghostscript).

Known limitations

• Package size is larger than a “browser bookmark only” approach because of the desktop shell and WebKitGTK runtime dependencies; printing relies on system CUPS and does not embed the Windows portable PDF stack.
• Customer display and some peripherals depend on local hardware and drivers; without them, normal browser-style access to Odoo still works.
• On some virtual GPUs the launcher disables WebKit DMA-BUF (to avoid white blocks); physical machines keep hardware compositing.
• Info-style dialogs can occasionally be covered by the WebView overlay; if that happens, switch accounts or refresh, then open About / Info again.

Product positioning

Odoo multi-platform client for Android aimed at store handhelds and tablets: open Odoo backend and PoS inside an in-app WebView, and expose device capabilities to the page through the client JavaScript bridge (same approach as official Mobile JavaScript / ; see bridge docs in the repo). Business logic stays in Odoo JS—no separate native UI for the shell.web_mobile

Highlights in this release

• Hikvision handheld scanner MV-IDP5204 (Android 11): Scan verified. The device delivers barcodes via scan broadcast; the shell queues them and PoS reads them through the bridge ( / ), then adds the matching product by barcode. HID keyboard wedge scanning can still use the web barcode path; this release focuses on broadcast + bridge. Official camera scan API () is not included; handheld use does not depend on camera preview.enableReadergetReaderDatascanBarcode
• Redmi K80 (Android 16): Verified that Odoo can be opened and used normally.
• About APK size: The System WebView on MV-IDP5204 is too old to render Odoo reliably. At startup the app probes System WebView major version: ≥ 110 uses system WebView; below 110 (or probe failure) uses embedded GeckoView. Older ROMs such as Hikvision therefore take the Gecko path, so the APK is noticeably larger—this is expected. Use More in the address bar to inspect the current engine.

Capabilities in this release

• Embedded Odoo: Backend / PoS via system WebView or GeckoView; the Gecko path supports injecting bridge scripts so the reader bridge can stay online.
• Client bridge: Same dispatch model as desktop. On Android for this release, verified or available cashier-related pieces include: in-shell account switch ( / ), PoS reader polling, Toast / SnackBar feedback; push-related methods are registered, and failure without a real FCM token does not block login.switchAccountupdateAccount
• Accounts and local config: Multi-account supported; account DB and logs live under app data and are not shipped inside the APK.
• Update check: Can use the company release channel to detect new versions (depends on on-site Odoo / release service).
• Architecture: Release packages are arm64-v8a only.

Runtime requirements

Install and notes

1. Install (unknown sources / enterprise distribution per site policy).Odoo-Client-*-arm64.apk
2. On first launch, configure the Odoo server URL and sign in.
3. Handheld scanning: confirm broadcast conventions match the Hikvision adapter; enter PoS and confirm the bridge is “online” before testing add-to-order.
4. This package is Android-only; Windows install, office printing, customer display, etc. are covered in the same-day Windows release notes.

Known limitations

• APK is larger than a “system WebView only” build because of GeckoView and related components.
• Mobile office print / PoS thermal receipt / cash drawer, system contacts, full notification shade, camera barcode, real Firebase push are not wired or are degraded in this build; use the Windows package for desktop print and customer display.
• On newer devices using system WebView, trust the on-site PoS bridge online/offline indicator; the Gecko path on older devices is the focus of scan integration in this release.

Changelog blurb

Android arm64: System WebView ≥ 110 uses the system engine; otherwise GeckoView (old ROMs such as Hikvision). MV-IDP5204 scan broadcast → JS bridge → PoS add-by-barcode verified; Redmi K80 (Android 16) can use Odoo normally. Larger APK due to Gecko is expected. Mobile print / camera scan / real FCM push not in this build.