CHIRP

# About CHIRP-next

{{>toc}}

This page explains the chirp-next build, why it is necessary, what to expect, and how you can help.

## Why is this necessary?

When CHIRP started in 2008, it was based on two core pieces of modern-at-the-time software, Python 2.x (the language) and PyGTK (the GUI toolkit). Since then, the Python development team defined Python 3.0, which is an evolution of the language, but with many incompatible changes, specifically in the areas that affect CHIRP. Further, the developers of PyGTK decided to mothball the project and **not ever** move to support Python 3. This left CHIRP in a tough spot, as moving to Python 3 not only required significant changes to almost every radio driver (of which there are about 350) *and* basically a complete re-write of the GUI at the same time. There are various shims and hacks for temporary compatibility that we could have (and in some cases, did) explore, but the end result was the same: something had to change.

Mac and Linux users are likely painfully aware of the increasing difficulty in running CHIRP that has been creeping up for the last few years. Python 2.7 was officially End-of-Lifed in 2020, and many Linux distros dropped support around then. Apple held on a little longer, but has removed Python 2.7 from MacOS now. Windows' users have been largely unaffected directly by the deprecation issue, but developers have an increasingly shrinking set of platforms they can use to continue CHIRP development.

## How you can help

Perhaps the biggest hurdle to this transition has been the radio drivers. CHIRP supports hundreds of unique radio models, and in many cases, those were developed with borrowed radios, or radios that a developer owned at the time, but no longer has. Rewriting those drivers and testing them with real hardware is an enormous task for an all-volunteer project like this. To get to where we are today, we had to find and test as many real radios as possible. Developers borrowed, bought on eBay (yes, really), and dug out of the woodwork as many as possible, but there is (and likely will be) a long tail of models that we're looking for.

Re-writing the GUI also brings many challenges, as this is largely maintained by one person in the development team. A re-write gives us an opportunity simplify, eliminate complex features that are rarely used, and also make CHIRP behave a little better on each of the platforms. Instead of being "A Linux program that runs on Windows," we have also used this opportunity to try to make it feel more like a native app on each of the platforms we support.

We now need to engage the larger community of users, power-users, and enthusiasts to try to close the gap on radio testing, GUI testing, etc.

### 1. Test obscure radio models

If you have one of the radios on the list of un-tested models, please consider giving it a try and filing a bug. Even if it works fine, please let us know so we can mark it down. If it doesn't, it would be great if you would be willing to test some changes to help us get it fixed. If it's an older radio, consider donating it to a developer (this is the most helpful thing you can do).

**When filing a bug, please consider:**

1. Please search or consult the [list of bugs](https://chirp.danplanet.com/projects/chirp/issues?utf8=%E2%9C%93&set_filter=1&sort=id%3Adesc&f%5B%5D=status_id&op%5Bstatus_id%5D=*&f%5B%5D=tracker_id&op%5Btracker_id%5D=%3D&v%5Btracker_id%5D%5B%5D=1&f%5B%5D=cf_1&op%5Bcf_1%5D=%3D&v%5Bcf_1%5D%5B%5D=next+%28py3%29&f%5B%5D=&c%5B%5D=tracker&c%5B%5D=status&c%5B%5D=priority&c%5B%5D=subject&c%5B%5D=updated_on&group_by=status&t%5B%5D=) to see if your issue is already reported

1. Be sure to choose "next" in the Chirp Version field so we know this is related to the new build

1. Make sure to tell us which radio you're reporting. Both in the subject of the bug, but also in the "Model Affected" box

1. Make sure to update the "Platform" field so we know which system you are using

1. If you are able to download and save an image of the radio, please attach it

1. If the problem occurs while changing memories or settings, please include *detailed* steps to reproduce it.

### 2. Further test well-supported models

We attempted to "smoke test" converted drivers for the new platform, but it's possible that bugs still lurk in strange configurations. Even if you only have radios that have already been tested, we welcome more comprehensive tests. **Note:** if you find a bug, it would be helpful if you can test the same issue on the legacy build and include in your bug report whether or not it's broken there, or only in the new build.

**When filing a bug, please consider:**

1. Please search or consult the [list of bugs](https://chirp.danplanet.com/projects/chirp/issues?utf8=%E2%9C%93&set_filter=1&sort=id%3Adesc&f%5B%5D=status_id&op%5Bstatus_id%5D=*&f%5B%5D=tracker_id&op%5Btracker_id%5D=%3D&v%5Btracker_id%5D%5B%5D=1&f%5B%5D=cf_1&op%5Bcf_1%5D=%3D&v%5Bcf_1%5D%5B%5D=next+%28py3%29&f%5B%5D=&c%5B%5D=tracker&c%5B%5D=status&c%5B%5D=priority&c%5B%5D=subject&c%5B%5D=updated_on&group_by=status&t%5B%5D=) to see if your issue is already reported

1. Be sure to choose "next" in the Chirp Version field so we know this is related to the new build

1. Make sure to tell us which radio you're reporting. Both in the subject of the bug, but also in the "Model Affected" box

1. Make sure to update the "Platform" field so we know which system you are using

1. If you are able to download and save an image of the radio, please attach it

1. If the problem occurs while changing memories or settings, please include *detailed* steps to reproduce it.

### 3. Poke around with the new GUI

The GUI is all new from scratch, so it is likely to have bugs. If you find something, please report it. If there is some feature you consider to be missing from the new GUI that was present in the old one, we want to hear that too. Please understand that we will probably have to prioritize bugs over features for some time to come, but your feedback is still valuable. **Please check the [list of requested features](https://chirp.danplanet.com/projects/chirp/issues?utf8=%E2%9C%93&set_filter=1&sort=id%3Adesc&f%5B%5D=status_id&op%5Bstatus_id%5D=*&f%5B%5D=tracker_id&op%5Btracker_id%5D=%3D&v%5Btracker_id%5D%5B%5D=2&f%5B%5D=cf_1&op%5Bcf_1%5D=%3D&v%5Bcf_1%5D%5B%5D=next+%28py3%29&f%5B%5D=&c%5B%5D=tracker&c%5B%5D=status&c%5B%5D=priority&c%5B%5D=subject&c%5B%5D=updated_on&group_by=status&t%5B%5D=) before reporting one.**

Things that appear to be GUI bugs can often be specific to a radio driver, so please try to follow the same instructions for GUI bugs as well:

1. Please search or consult the [list of bugs](https://chirp.danplanet.com/projects/chirp/issues?utf8=%E2%9C%93&set_filter=1&sort=id%3Adesc&f%5B%5D=status_id&op%5Bstatus_id%5D=*&f%5B%5D=tracker_id&op%5Btracker_id%5D=%3D&v%5Btracker_id%5D%5B%5D=1&f%5B%5D=cf_1&op%5Bcf_1%5D=%3D&v%5Bcf_1%5D%5B%5D=next+%28py3%29&f%5B%5D=&c%5B%5D=tracker&c%5B%5D=status&c%5B%5D=priority&c%5B%5D=subject&c%5B%5D=updated_on&group_by=status&t%5B%5D=) to see if your issue is already reported

1. Be sure to choose "next" in the Chirp Version field so we know this is related to the new build

1. Make sure to tell us which radio you're reporting. Both in the subject of the bug, but also in the "Model Affected" box

1. Make sure to update the "Platform" field so we know which system you are using

1. If you are able to download and save an image of the radio, please attach it

1. If the problem occurs while changing memories or settings, please include *detailed* steps to reproduce it.