Skip to main content

Walkie-Talkie

Serverless peer-to-peer walkie-talkie application for LAN.

Automatic peer discovery, encrypted text chat, push-to-talk voice communication.

Installation

pip install walkie

Or for development:

git clone https://github.com/Lunixizm0/walkie.git
cd walkie
uv sync

Usage

# Generate config (creates random passwords, salt, and encryption key)
walkie gen

# Receive config from another client
walkie get

# Send config to another client
walkie give <target_ip>

# Start the application
walkie run

Or run directly:

python -m walkie run
python -m walkie gen
python -m walkie get
python -m walkie give 192.168.1.100

Configuration

The app looks for walkie_config.toml in ~/.config/walkie/. You can override the path with the WALKIE_CONFIG environment variable.

Features

  • Automatic peer discovery via UDP broadcast (no server needed)
  • AES-256-GCM encryption for voice and chat
  • Low-latency voice with Opus codec
  • Push-to-Talk (Shift+V) and Voice Activity Detection (VAD) modes
  • Seamless playback with jitter buffer
  • System tray minimization
  • TOML-based configuration
  • Config sharing over TCP (--get/--give)

Requirements

  • Python 3.11+
  • Linux, Windows, or macOS
  • Microphone and speakers

System Dependencies

Walkie requires system libraries for audio and GUI tray support. Install them before installing the Python package:

Debian / Ubuntu:

sudo apt install -y portaudio19-dev gobject-introspection \
  libgirepository1.0-dev libglib2.0-dev pkg-config python3-dev python3-tk

Arch Linux:

sudo pacman -S --needed portaudio gobject-introspection pkgconf python tk

macOS (Homebrew):

brew install portaudio gobject-introspection pkg-config tcl-tk

Windows:

No extra system dependencies needed. Wheels for sounddevice and pygobject bundle everything required.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

walkie-2.0.1.tar.gz (23.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

walkie-2.0.1-py3-none-any.whl (23.3 kB view details)

Uploaded Python 3

File details

Details for the file walkie-2.0.1.tar.gz.

File metadata

  • Download URL: walkie-2.0.1.tar.gz
  • Upload date:
  • Size: 23.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for walkie-2.0.1.tar.gz
Algorithm Hash digest
SHA256 62aac4f437bbbe19e54d9cf53bb8ef297d5d7c8e223b44443c09a6924dac2fd4
MD5 1d5a168963d13ecfcd56dd8818466f86
BLAKE2b-256 41f7b81118d41ac8ccced67b7f3955d9471a429e8397209a46759600ef8b3346

See more details on using hashes here.

Provenance

The following attestation bundles were made for walkie-2.0.1.tar.gz:

Publisher: publish.yml on Lunixizm0/Walkie

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file walkie-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: walkie-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 23.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for walkie-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5436232ab5d44f534b23f65530125da2191d7882890042276a093472202d7009
MD5 56081e7182d9940b80818e70acf72417
BLAKE2b-256 3701c97f51bbbdca25e34d5451af9696854be98d8c29acecbc70e81787dd02e1

See more details on using hashes here.

Provenance

The following attestation bundles were made for walkie-2.0.1-py3-none-any.whl:

Publisher: publish.yml on Lunixizm0/Walkie

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

3.0.0

2 files

This release

2.0.1 This release

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page