EchoNanny provides remote access to your PC microphone stream with a clean Web UI, recording history, and automatic audio labeling.

• Live monitoring over a WebSocket audio stream
• Recording history with timeline and playback tools
• Automatic labels for speech and loud-noise events. You can easily find parts of audio with voices or another noise!
• Web UI access to PC audio from anywhere*
• Low CPU-usage, so can be easily run in background
• Auto-cut recording policy that automatically stops recording after {M} minutes if no voice activity is detected during the last {N} minutes:
  • AUTO_CUT_MIN_RECORDING_MINUTES={M}
  • AUTO_CUT_INACTIVE_WINDOW_MINUTES={N}
• Cross-platform distribution options: wheel, PyInstaller, and Inno Setup for Windows

* If you are using your own PC behind NAT, a private network, or a similar setup, you will need to use a tunneling app such as zrok or Cloudflare Tunnel, or configure port forwarding if your Wi-Fi router supports it.

Prerequisites:

• Python 3.11+ in PATH
• Only for Linux+(Install script OR Wheel Installation): PortAudio runtime/dev packages may be required for pyaudio:

  apt-get install -y --no-install-recommends build-essential portaudio19-dev

1. PyInstaller executable(Portable Program packed in archive)

   Download the prebuilt PyInstaller artifact from Releases, unpack it, and run echonanny executable.

2. Install script

Use the standalone installer script:

• Linux / macOS (Bash)

  curl -fsSL https://raw.githubusercontent.com/s0d3s/EchoNanny/main/scripts/install.sh | bash

• Windows (PowerShell)

  irm https://raw.githubusercontent.com/s0d3s/EchoNanny/main/scripts/install.ps1 | iex

The installer script will:

• Check prerequisites (python + venv; and on Linux, PortAudio dev presence)
• Ask for install destination directory (must exist and be empty)
• Create and activate virtual environment
• Install echonanny from PyPI
• Create .env via echonanny init-env
• Print colored next steps for credentials, server start, and Web UI access

3. Python wheel (global/virtual env)

   Install a wheel from PyPI or from GitHub Release assets:

   python -m pip install echonanny

   Setup:

   • Create data folder for application and cd to it(in that folder will be saved Recording Audio files and .env configuration file)
   • Run: echonanny init-env to create default .env file
   • Modify .env(if needed) as in a section below
   • Run app from this dir via command: echonanny serve

4. Inno Setup installer (Windows only)

   Download EchoNanny-Setup*.exe from Releases, run installer, then launch EchoNanny from Start Menu.

• Run the app as described in your chosen installation method
• From the same PC, open: http://127.0.0.1:8000 (or the address printed in the app console)
• Use credentials written in .env file(CHANGE THEM on first startup):
  • INSTANCE_USER_EMAIL
  • INSTANCE_USER_PASSWORD

EchoNanny uses instance credentials and runtime options from .env.

To edit it, open this file in any text editor and modify the required lines.

• PyInstaller / Inno install: use generated config under user-local EchoNanny folder (created via init-env)
• Wheel/manual: keep .env in your run directory, or pass explicit file path to CLI(echonanny serve --env-file ./config.env)

After installation, echonanny command is available:

echonanny init-env
echonanny serve --env-file ./config.env

• init-env — creates .env from packaged template if missing
• serve — starts backend server with selected env configuration

Each GitHub Release can include:

• PyInstaller build for Windows / Linux / macOS
• Inno Setup installer for Windows
• Universal Python wheel (py3-none-any)