Skip to content
BranchesTags

Repository files navigation

WD Wireless Tools

WD Wireless Tools

A suite of Ekahau workflow tools.

Five focused utilities for organizing projects, managing Ekahau Cloud, editing walls, converting scale, and building installer-ready reports.

Latest Release Tests License

Local First No Telemetry Python Platforms

→ Launch the browser tools

Read the User Manual · Download the Full Suite · Report an Issue

Cloud Manager
Cloud Manager
v4.16.1 · Desktop		 Quick Walls
Quick Walls
v7.38 · Desktop + Web		 Squirrel
Squirrel
v1.26.0 · Desktop		 Scale
Scale
v1.5 · Desktop + Web		 Report
Report
v2.22 · Desktop + Web

Table of Contents

What WD Wireless Tools Does

WD Wireless Tools removes the repetitive work around an Ekahau project. It gives wireless engineers a fast local workspace for cloud and file organization, wall remapping, scale conversion, and field-ready reporting—without turning those jobs into another subscription or another place to upload client data.

The full suite runs from a tiny local Flask server and opens in your normal browser. Quick Walls, Scale, and Report are also available as hosted, client-side tools for jobs that do not need desktop file-system or Ekahau Cloud access.

The important distinction: the interface is browser-based, but your working data stays local. The hosted tools process files in your browser; Cloud Manager contacts Ekahau Cloud only when you direct it to operate on your own tenant.

Five Tools, One Workflow

Cloud Manager

Compare Ekahau Cloud projects with local .esx files, find duplicates, and manage project movement from a single table view.

  • Side-by-side cloud and local inventory with character-level name differences
  • Duplicate clustering with newest/largest indicators and focused cleanup
  • Bulk upload, download, rename, move, and delete operations with previews
  • Direct access to local files in Explorer or Finder
  • Encrypted local Cloud-session cache backed by the operating-system credential vault

Cloud Manager's EkahauAPI client implements the reverse-engineered upload/download flows required to reproduce the web application's presigned upload and client-side .esx assembly behavior.

Quick Walls

Open an .esx, visually remap every wall type, apply reusable templates, and save the updated project.

  • Local, client-side .esx parsing with JSZip
  • Color-coded wall types and attenuation values
  • Ekahau factory presets plus custom JSON templates
  • Default-template auto-apply and [1]–[9] keyboard shortcuts
  • Runs directly in the browser

Squirrel

Turn loose project files into a predictable folder structure after reviewing the proposed result.

  • Recursive .esx discovery and project classification
  • Configurable naming and folder rules
  • Image, floor-plan, and report organization
  • Duplicate detection and supported-operation undo

Scale

Convert architectural measurements between feet-and-inches, decimal feet, inches, meters, and millimeters.

  • Bidirectional conversion with synchronized results
  • Architectural fractions such as 4' 6-1/2", 4' 6 1/2", and 1/2"
  • One-click copying for every output
  • Pure client-side operation, including the hosted version

Report

Transform an .esx project into print-ready, installer-facing documents. Seven report formats are available today:

  • Directional Antenna Installation / AP Placement
  • Predictive Design / AP Placement
  • Site Summary Sheet
  • Interference / Rogue Devices
  • Bill of Materials
  • Antenna Aim Sheet
  • Coverage Cell Boundary

The Change / Audit Report (coming soon) is visible in the gallery but is not selectable yet. Every available report supports its own options and print-optimized renderer through the shared report registry. Try it in the hosted Report tool.

Quick Start

Try the browser tools

Open the hosted tool suite to use Quick Walls, Scale, or Report immediately. There is no installation or login. Cloud Manager and Squirrel remain desktop-only because they need Ekahau Cloud or local file-system access.

Install the complete desktop suite

  1. Install Python 3.10 or newer. On Windows, enable Add Python to PATH during installation.
  2. Open the latest release and download the versioned WD-Wireless-Tools-vX.X.X.zip asset—not GitHub's automatic “Source code” archive.
  3. Extract the ZIP to a permanent folder.
  4. Double-click run.bat on Windows or run.command on macOS.

The launcher installs missing dependencies, starts the local service, and opens http://localhost:8675. Keep its terminal window open while using the suite.

For detailed, task-by-task instructions, see the WD Wireless Tools User Manual.

Manual launch

pip install -r requirements.txt
python server.py

The startup banner identifies the installed suite version:

WIRELESS TOOLS  v2.1.2
A suite of Ekahau workflow tools.

Local suite: http://localhost:8675/
Press CTRL+C in this window to stop WD Wireless Tools.

Privacy and Local-First Design

  • Quick Walls and Report parse .esx archives locally in your browser with JSZip.
  • Scale performs every calculation in the browser.
  • Squirrel accesses only the local folder you select.
  • Cloud Manager connects only to the Ekahau Cloud account and local folder you select.
  • Saved Cloud-session data is encrypted; its key lives separately in Windows Credential Manager or macOS Keychain.
  • There is no telemetry.

No hosted WD Wireless Tools service receives your survey files. As with any production workflow, keep backups and review previews before bulk file or Cloud operations.

First Run

Cloud Manager

Sign into Ekahau Cloud in a normal Chrome, Edge, or Firefox window, then choose the parent folder containing your local Ekahau projects. Safari, Private, and Incognito sessions are not supported for session discovery. Your selections are remembered locally.

Quick Walls, Scale, and Report

No setup is required. Drop an .esx into Quick Walls or Report, or type a measurement in Scale.

Squirrel

Choose a folder containing loose project files. Squirrel shows the proposed organization before moving anything.

Local data locations

  • Custom desktop wall templates: templates/
  • Cloud Manager settings: ~/.wd_wireless_tools/
  • Hosted Quick Walls templates: the browser's local storage

Troubleshooting

Python is not recognized

Install Python 3.10 or newer and enable Add Python to PATH on Windows. Reopen the terminal afterward.

macOS blocks run.command

Right-click run.command, choose Open, then confirm Open. This is normally required only once.

Cloud Manager cannot find a session

Confirm that you are signed into https://cloud.ekahau.com in a normal Chrome, Edge, or Firefox window. Close and reopen the browser if its cookie database is locked.

Port 8675 is already in use

Close the other running instance, or choose another port:

set PORT=8676 && run.bat
PORT=8676 bash run.command

Browser does not open automatically

Open http://localhost:8675 manually while the launcher terminal remains open.

Project Structure

WD-Wireless-Tools/
├── server.py                 # Local Flask/Waitress service and API routes
├── run.bat                   # Windows launcher
├── run.command               # macOS launcher
├── requirements.txt          # Python dependencies
├── BACKLOG.md                # Unfinished product work only
├── tools/
│   ├── cloud_manager.py      # Cloud client and reverse-engineered upload/download flows
│   ├── template_store.py     # Wall-template persistence
│   └── folder_organizer.py   # Squirrel scanning and organization
├── web/                      # Application source and hosted page templates
│   ├── assets/
│   │   ├── versions.json     # Suite and component versions
│   │   ├── lib/              # Vendored browser libraries
│   │   └── js/
│   │       ├── wd-shared.js  # Shared UI utilities
│   │       ├── walls-swap.js # Wall-remapping workflow
│   │       └── ...           # Tool-specific application code
│   └── pages/                # GitHub Pages landing/stub templates
├── templates/                # Bundled wall-type templates
├── docs/
│   └── USER_MANUAL.md        # Complete user documentation
├── scripts/
│   ├── build_release.py      # Allowlisted release ZIP builder
│   └── make_test_projects.py # Fictional ESX fixture generator
├── tests/                    # Python, server, asset, and JavaScript safety tests
└── .github/workflows/        # Tests, releases, and Pages deployment

The local .claude/ directory is development-tool configuration, not application code. It is intentionally excluded because it may contain machine-specific paths and permissions.

Help and Support

  • Start with the User Manual or the guide built into each tool.
  • Search existing GitHub issues.
  • For a reproducible bug or focused feature request, open an issue with the tool version, operating system, expected result, and actual result.
  • Never attach client .esx files, credentials, session data, or other confidential material to a public issue.

Contributions are welcome when they keep the tools focused, understandable, and safe for real wireless work.

License

Released under the MIT License. © R David Paine III.

Built for wireless engineers, by a wireless engineer.

Made with signal strength and caffeine by WeirDave.

About

A suite of Ekahau workflow tools

Resources

Readme
MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages