LIbrary for Amateur Radio Equipment Control Applications.
Go to file
Michael Black 3967e41fcf
Merge pull request #1513 from GeoBaltz/rp5
Convert amplifiers/ and rotators/ to use pointers
2024-02-22 08:00:15 -06:00
.github Update actions in c-cpp.yml 2023-11-14 23:54:56 -06:00
amplifiers Convert all port references in amplifiers/ to pointers. 2024-02-19 13:06:53 -05:00
android astyle files for 4.5 release 2022-07-27 17:16:17 -05:00
bindings Fix a dependency check for bindings 2024-02-08 09:59:52 -06:00
c++ Change token_t to hamlib_token_t to avoid collsions with libbsm and others 2024-01-21 23:11:55 -06:00
doc Update rigctl.1 2024-02-02 15:54:29 -06:00
docker-build Fix spelling errors 2022-07-07 23:56:22 +02:00
extra Fix some more hamlib_token_t 2024-01-22 10:50:30 -06:00
include Update comment in rig.h 2024-02-03 12:44:48 -06:00
lib astyle files 2023-12-16 11:37:58 -06:00
macros bindings: Fix tcl build with slibtool 2022-05-06 22:12:18 -07:00
perl Trying to fix github build for change 2022-06-17 15:30:08 -05:00
rigs Fix ID read for Xiegu rigs and add x25x26 possible 2024-02-18 22:25:19 -06:00
rotators Finish rotators/ 2024-02-19 13:06:53 -05:00
scripts Fix more cppcheck items 2023-10-14 12:01:41 -05:00
security astyle files 2023-12-16 11:37:58 -06:00
simulators Add simxeigux6100.c 2024-02-20 12:07:30 -06:00
src Another attempt to fix 32-bit mingw build for 2038 2024-02-21 17:24:15 -06:00
tests Remove some debug from rigctlcom.c 2024-02-20 12:05:51 -06:00
.editorconfig Add new levels: RFPOWER_METER, COMP_METER, VD_METER and ID_METER, supported at least by most of recent Icom rigs. Add level NOTCHF_RAW for manual notch frequency without specified unit for Icom rigs. Add level MONITOR_GAIN. Add functions DUAL_WATCH and DIVERSITY, supported now by K3/K3S. Fix VOXDELAY level commands for many Icom rigs. Add MONITOR_GAIN level for Icom rigs. Fix and add many K3 commands and add specific rig models for K3S, KX2 and KX3 -- they are very similar to K3, but have slight differences. Extend dump_caps output for rigctl: add complete details of ext levels and frequency ranges. Tests have been performed on IC-7000, IC-756ProIII, IC-7300, IC-7600 and K3. 2019-05-30 09:37:49 +03:00
.gitignore .gitignore: Ignore some macOS housekeeping files. 2023-09-27 20:27:58 +02:00
AUTHORS Add INDI rotator backend 2020-11-15 12:46:35 +01:00 add new rotator grbltrk 2022-05-17 13:23:44 +08:00
COPYING Updated GPL 2/LGPL 2.1 licenses 2011-08-22 21:38:34 -05:00
COPYING.LIB Updated GPL 2/LGPL 2.1 licenses 2011-08-22 21:38:34 -05:00
ChangeLog Update ChangeLog 2020-10-17 11:40:26 -05:00
INSTALL Fix typos 2023-03-26 11:01:51 +02:00
LICENSE Update LICENSE 2022-08-26 22:32:25 -05:00 Fix TIME_BITS_64 2024-02-03 23:35:56 -06:00
NEWS Update NEWS with pointer conversion macros. 2024-01-26 14:23:30 -05:00
PLAN Fix spelling errors 2020-07-24 09:02:48 +02:00
README Add README back 2022-06-17 15:56:42 -05:00
README.betatester Update README.betatester 2022-06-03 22:34:26 -05:00
README.coding_style Add some tips on shell scripts 2020-05-31 17:29:29 -05:00
README.developer Add github reference to README.developer 2023-09-14 22:11:21 -05:00
README.freqranges Format to break lines before 80 characters 2021-05-16 21:11:10 -05:00 Improve by adding github and sourceforge info 2022-11-10 08:03:43 -06:00
README.multicast Change modelist to modes array 2023-10-22 13:18:51 -05:00
README.osx Add Macports to README.osx 2020-06-04 18:35:47 +01:00
README.release Fix spelling errors 2020-07-24 09:02:48 +02:00
README.win32 Add MSVC projects to scripts/MSVC for 32 and 64-bit builds in C++ 2022-09-03 13:09:50 -05:00 Fix 2020-05-09 07:17:19 -05:00
Segfault-award Fix segfault using python Hamlib.rig_parse_mode(None) 2023-01-29 15:50:27 -06:00
THANKS minor changes 2008-07-14 01:31:55 +00:00
VFOs.txt Update VFOs.txt 2021-04-04 08:07:55 -05:00 Add to format all .c files 2022-11-16 16:54:49 -06:00
bootstrap Remove bashisms from shell scripts 2020-05-27 10:54:35 -05:00 Try adding _TIME_BITS=64 to see if 32-bit build works with it 2024-02-11 15:57:10 -06:00 Fix more cppcheck items 2023-10-13 17:36:29 -05:00
hamlib.m4 Add LIBUSB flags to hamlib.m4 2021-08-17 09:17:20 -05:00 Fix hardcoded pcconfig libdir 2017-09-03 12:33:00 -05:00

Hamlib - (C) Frank Singleton 2000 ( (C) Stephane Fillod 2000-2011 (C) The Hamlib Group 2000-2022

The purpose of this project is to provide stable, flexible, shared libraries that enable quicker development of Amateur Radio Equipment Control Applications. The master repository is Daily snapshots are available at Development happens on the github master (often by merging feature branches) and each release has a release branch.

Many Amateur Radio Transceivers come with serial interfaces that allows software to control the radio. This project will endeavour to provide shared libraries that greatly simplify the application programmer's interaction with radio equipment and other controllable devices such as rotators, switches, etc.

Supported Radios

The Hamlib Wiki page, Supported Radios, contains a snapshot of the supported radios at the time of the last Hamlib release. Go to to reach the Wiki.

Hamlib Design

The library provides functions for both radio and rotator control, and data retrieval from the radio or rotator. A number of functions useful for calculating distance and bearing and grid square conversion are included. - library that provides generic API for all RIG types. This is what Application programmers will "see". Will have different names on other platforms, e.g. libhamlib-2.dll on MS windows. Also contains all radio and rotator "backends" (formerly in their own dlopen'ed libraries) provided by Hamlib.

Backend Examples are:

  1. yaesu will provide connectivity to Yaesu FT 747GX Transceiver, FT 847 "Earth Station", etc. via a standard API.

  2. xxxx. will provide connectivity to the Wiz-bang moon-melter 101A (yikes..)

Hamlib will also enable developers to develop professional looking GUI's towards a standard control library API, and they would not have to worry about the underlying connection towards physical hardware.

Initially serial (RS232) connectivity will be handled, but we expect that IP (and other) connectivity will follow afterwards. Connection via a USB port is accomplished via the Linux kernel support. USB to serial converters are well supported. Other such devices may be supported as long as they present a serial (RS-232) interface to Hamlib.


Most distributions have the latest Hamlib release in their testing or alpha versions of their distribution. Check your package manager for the Hamlib version included in your distribution.

Developing with Hamlib API

API documentation is at:

Take a look at tests/README for more info on simple programming examples and test programs.

C++ programming is supported and language bindings are available for Perl, Python, and TCL. A network daemon utility is also available for any programming language that supports network sockets (even netcat!).


Hamlib is entirely developed using GNU tools, under various Linux systems. The library may be recompiled by the familiar "three step":

Note: if ./configure does not exist run ./bootstrap first

    sudo make install

For debugging use this configure ./configure CFLAGS=-g -O0 -fPIC --no-create --no-recursio

See the INSTALL file for more information.


Consult the README.betatester and README.developer files in this directory if you feel like testing or helping with Hamlib development.

Contributions of rig specifications and protocol documentation are highly encouraged. Do keep in mind that in some cases the manufacturer may not provide complete control information or it is only available under a Non-Disclosure Agreement (NDA). Any documentation must be publicly available so we can legally write and distribute Free Software supporting a given device.

The Hamlib team is very interested to hear from you, how Hamlib builds and works on your system, especially on non-Linux system or non-PC systems. We try to make Hamlib as portable as possible.

Please report in case of problems at Git email formatted patches or in unified diff format are welcome!

Also, take a look at Here you will find a mail list, link to the Wiki, and the latest releases. Feedback, questions, etc. about Hamlib are very welcome at the mail list:


Hamlib Version Numbers

Like other software projects, Hamlib uses a version numbering scheme to help program authors and users understand which releases are compatible and which are not. Hamlib releases now follow the format of:



Major: Currently at 4, but can be advanced when changes to the API require client programs to be rewritten to take advantage of new features of Hamlib. This number has advanced a couple of times throughout the life of Hamlib. Advancement of the major number is only for frontend API changes that require modification of client source. ABI compatibility is presently maintained to prior releases so that a program linked to an earlier 1.2.Y.[Z] release will work with a later 3.Y[.Z] release without recompiling. It is our intention to maintain such ABI compatibility as long as practical.

Minor: This number advances when either new backend(s) or new rig model(s) to existing backend(s) are added. Advancing this number informs client program authors (and users of those programs) that new model/backend support has been added. Will also include bug fixes since the last Incremental release.

Incremental: May be undefined (e.g. Hamlib 3.0) and would advance to 1 (e.g. Hamlib 3.0.1) for any bug fixes or feature additions to existing model(s) or backend(s), then to 2, etc. New rig models or backends are not included in Incremental. When Release is advanced, Incremental will reset to undefined and will not be included as part of the version number.

Release schedule

Hamlib has in the past maintained a "ready when it's ready" philosophy. However, given that much of the Linux user base is now influenced by the Ubuntu distribution and its timed six month release schedule, Hamlib releases will be scheduled in advance of Ubuntu releases. Planned release dates for Hamlib are now 1 February and 1 August of each calendar year. Between those dates various Incremental releases will occur as development warrants.

Have Fun / Frank S / Stephane F / The Hamlib Group

73's de vk3fcs/km5ws / f8cfe