Installation - icom-lan
Description: Python library for controlling Icom transceivers over LAN

Skip to content

# Installation

## Requirements

- Python 3.11+
- An Icom radio with LAN/WiFi connectivity (IC-7610, IC-705, IC-7300, IC-9700, etc.)
- Network access to the radio (same LAN/subnet)

## Install from PyPI

    pip install icom-lan

## Install from Source

    git clone https://github.com/morozsm/icom-lan.git
    cd icom-lan
    pip install -e .

## Development Install

For running tests and contributing:

    git clone https://github.com/morozsm/icom-lan.git
    cd icom-lan
    pip install -e ".[dev]"

## Optional: Audio Support

For Opus codec audio streaming:

    pip install icom-lan[audio]

This installs `opuslib` for Opus codec support. Not required for PCM/uLaw audio.

## Verify Installation

    # Check the CLI is available
    icom-lan --help

    # Or run as a module
    python -m icom_lan --help

## Radio Setup

Before connecting, ensure your radio is configured for LAN control:

### IC-7610

1. Menu → Set → Network — configure IP address (static recommended)
2. Menu → Set → Network → Remote Control — enable "Network Control"
3. Menu → Set → Network → Network User — create a username/password
4. Default port: 50001

### IC-705

1. Menu → Set → WLAN Set — connect to your WiFi network
2. Menu → Set → Network → Remote Control — enable
3. Menu → Set → Network → Network User — create credentials

### IC-7300

1. Requires the optional LAN module or use via IC-7610's second CI-V port
2. Same network settings menu structure

Static IP Recommended

Assign a static IP to your radio to avoid connection issues after DHCP lease changes.

Firewall

Ensure UDP ports 50001-50003 are open between your computer and the radio.