CHIRP Radio Programming: Setting Up a Handheld Without the Keypad

Anyone who has tried to enter forty repeaters into a handheld through its tiny keypad knows why CHIRP radio programming is so popular. CHIRP is an open-source programming tool that lets you edit your radio’s memory channels on a computer, as if you were working in a spreadsheet, and then send them to the radio over a cable. You can paste in frequencies, import local repeaters, copy channels from one radio to another and save a backup of everything. This guide shows how a typical session goes, from connecting the cable to uploading the finished file, and covers the mistakes that catch beginners: wrong model, missing backup, wrong tones and bad offsets.

The details of supported radios and menus change between CHIRP builds, so use this article for the workflow and the project’s own documentation for model-specific notes.

What CHIRP Is and What It Supports

According to the project’s official repository, CHIRP is a community project released under the GPL-3.0 licence, and the code and documentation are open to anyone. In practical terms it is a cross-platform programming application that works with a long list of amateur handhelds, mobiles and some scanners from many manufacturers. You select the make and model, download the radio’s current memory image, edit it in a table and upload it back.

Two things are worth knowing from the start. First, the project has been through a major rewrite known as CHIRP-Next, and the older first-generation build is no longer supported by the data services that feed it. The RepeaterBook documentation for CHIRP notes explicitly that RepeaterBook no longer supports the first edition but does support CHIRP-Next, so always download the current build from the project’s own website rather than an old copy from a forum. Second, support depends on the exact radio. Many models within a brand are similar but not identical, and CHIRP lists them separately. Before you buy a cable or a radio, check that your exact model appears in the supported-radios list.

What You Need

• A supported radio. Check the make and model against the supported list. Rebadged versions of the same radio often work, but do not guess.
• The right programming cable. Most handhelds need a USB programming cable with the correct plug for the radio’s speaker/microphone jack. Cables differ by radio family, and some cheap cables use chips that need drivers on some operating systems. A cable that is wrong for your radio can fail or, in rare cases, damage the radio.
• A computer. CHIRP runs on Windows, macOS and Linux. On Linux you may need to add your user to the group that can access serial ports. On Windows, check which COM port the cable appears as in Device Manager.
• Your licence. Programming a frequency into a radio does not authorise you to transmit on it. Program only frequencies and modes you are entitled to use.
• A fully charged battery. A radio that loses power during an upload can end up with a corrupted image, so start with a charged battery or external power.

Step 1: Connect and Download From the Radio

The first rule of CHIRP is to download before you change anything. Connect the cable firmly to the radio, turn the radio on, and set the volume to a moderate level. In CHIRP, choose the download option from the Radio menu, select the serial port, the make and the exact model, and start the download. Some radios need to be in a particular state, for example powered on with the squelch open, and CHIRP shows instructions on screen for each family.

When the download completes, the table of memory channels appears. Do two things immediately:

1. Save the image. Use the file menu to save the unmodified image to a file with a clear name, such as the radio model and the date. That file is your backup. If an upload goes wrong, or you do not like your edits, you can restore the radio to this state.
2. Look at what is already there. Browse the existing channels, noting any that you want to keep, such as the weather channels or emergency settings.

Do not skip the backup. Radios can contain calibration or settings data that are specific to the individual unit, and the saved image is the only way to restore them.

Step 2: Understand the Memory Columns

The CHIRP grid has a row for each memory channel and a column for each setting. The names are mostly self-explanatory, but several of them determine whether a repeater works, so it pays to know them.

If you are new to repeaters, offsets and tones, our guide to VHF and UHF simplex and repeater operating basics explains how access tones and offsets work in practice. A radio programmed with the right frequency but the wrong tone or offset will receive the repeater but never open it when you transmit.

Step 3: Import Local Repeaters

You do not need to type each repeater by hand. CHIRP can fetch repeater lists from online directories, and the RepeaterBook documentation describes two routes.

The first is inside CHIRP itself: from the Radio menu, choose Query data source, then RepeaterBook, select your search parameters and download. CHIRP shows the results in a list from which you choose the repeaters to bring into your radio’s image. The search options are limited, but the method is quick.

The second route is more flexible. From the RepeaterBook website, run a search with the more detailed criteria that the site offers, then use the export menu and choose CHIRP. The documentation notes that you need to be logged in to use export. Save the file, then in CHIRP open the saved file or a downloaded image and copy the channels you want into your own image. A few cautions from that documentation are worth remembering:

• If a repeater supports analogue FM and a digital mode, the export defaults to FM.
• If the exported file is open in a spreadsheet program, close it before importing, otherwise CHIRP may report that it found no memory channels.
• Check the imported entries, since the data are contributed by many people and repeaters change. A repeater listed as operational may have moved or gone off the air.

Treat imported lists as a starting point. Keep the channels you will actually use, and delete the rest, because a radio with hundreds of repeaters takes ages to scan and nobody wants to scroll through them on the air.

Step 4: Edit and Organise Your Channels

With the import done, tidy the table. A good layout makes the radio much easier to use in the field.

• Group by purpose. Put local repeaters first, then simplex calling channels, then regional repeaters for travel, and finally weather and emergency channels.
• Use clear names. A name such as the town and the band is more useful than a long callsign that the display truncates.
• Add simplex channels. Include the national calling frequency and a couple of agreed simplex channels for your club, using your regional band plan.
• Use comments. The comment column does not go to the radio, but it is useful for your own notes, such as the repeater owner, the access tone source and the date you verified it.
• Check receive-only entries. Add weather broadcasts or other listening channels as receive-only so that you cannot transmit on them by mistake.

You can edit cells directly, copy and paste rows, and import or export a spreadsheet-style file of your channels, which makes it easy to share a channel list with a club or move it to another radio. If you have a different handheld later, you can load the list in CHIRP and upload it to the new model, though some columns, such as names and power levels, may need adjustment because radios differ.

Step 5: Upload to the Radio

Before uploading, double-check the selected model. CHIRP is designed to warn you about a mismatch between an image and the radio, but you should not depend on it. Make sure the battery is charged, the cable is seated, and no other program is using the serial port. Choose the upload option from the Radio menu, confirm the port, make and model, and let it run without touching the cable. Do not interrupt it.

After the upload, turn the radio off and on and test:

1. Check that the channel list looks right on the display.
2. Listen to a known active repeater and confirm you hear traffic.
3. Transmit briefly on a repeater you are licensed to use, giving your callsign, and confirm it opens and you hear yourself.
4. Test a simplex channel with a friend.

If something is wrong, go back to your backup image or correct the entry and upload again. Keep both the original image and your edited file in a safe place, with dates in the filenames, so you can always return to a known good state.

Common Problems and Fixes

• The radio does not respond. Check that the cable is pushed fully into the jack. Many radios have a recessed socket that needs a firm push. Confirm the serial port and the model.
• Download fails halfway. A weak battery, a loose cable or a USB hub can interrupt the transfer. Try a different port and a fresh battery.
• The repeater opens only sometimes. Check the tone and offset, and consider whether the handheld is simply too weak. A handheld with a rubber antenna may struggle; an external antenna such as a J-pole or a ground-plane antenna from our 2-meter antenna guide often makes a bigger difference than any programming change.
• Digital repeaters sound like noise. A radio set to analogue FM will not decode a digital voice repeater. The comparison of DMR, D-STAR and System Fusion explains why digital modes need a radio that supports them and different programming.
• Channels disappear or names change. Radios have limits on name length and the number of memory banks. Check your model’s limits.
• The wrong image was uploaded. Restore from your backup immediately and check the model selection.

Keep Your Setup Safe and Legal

Some inexpensive handhelds can transmit well outside the amateur bands once they are programmed with the right frequencies. CHIRP makes this easy, but the responsibility is yours. Programming a radio is not a licence to use every frequency. Stay within the amateur allocations and within your own licence class, and do not program channels used by public safety, business or other services for transmit. Check that the radio’s power level and modulation comply with local rules, and that the radio meets your country’s equipment rules if they apply.

If you are still studying for your licence, the overview of licence exams and classes will help you plan which privileges you will have and which band plan details to learn first.

The Bottom Line

CHIRP turns a tedious keypad job into a simple spreadsheet task. Download and save the radio’s image first, pick the exact model, import your local repeaters from RepeaterBook, tidy the channels, check offsets and tones and upload with a charged battery. Keep your original image and your edited file as backups, and test the radio on the air before you rely on it. Programmed well, a handheld becomes a ready-to-use tool for the repeater next door or the club net on the other side of the country.

Frequently Asked Questions

Is CHIRP software open source?

Yes. The project’s official repository lists the GPL-3.0 licence, and the source is publicly available.

Which version of CHIRP should I use?

Use the current CHIRP-Next build from the project’s website. RepeaterBook’s documentation says it no longer supports the first-edition build, so older copies may not import repeater lists.

How do I get repeaters into CHIRP?

Use Radio, then Query data source, then RepeaterBook inside CHIRP, or export a search from RepeaterBook in CHIRP format while logged in and open that file in CHIRP.

Why should I save an image before editing?

The saved image is a complete copy of the radio’s original memory. If an upload goes wrong or you want to undo your changes, you can restore it.

Can CHIRP program any radio?

No. It supports a long list of specific models. Check that your exact radio and cable are supported before you start.

Does programming a frequency let me transmit on it?

No. Your licence determines what you may transmit. Program only frequencies and modes you are authorised to use.