Project

General

Profile

Running Under Linux » History » Version 24

Dan Smith, 01/14/2023 04:24 PM

1 24 Dan Smith
# Running CHIRP-legacy Under Linux
2
3
<big>**NOTE**: These instructions are for python2-based CHIRP-legacy. You almost certainly want to see [[ChirpOnLinux]] instead.</big>
4 1 Dan Smith
5
{{>toc}}
6
7
CHIRP's preferred platform is Linux. By far the best way to get CHIRP running is to use one of the binary package repositories provided and maintained by volunteers. If you are running an obscure or old distribution, you may need to install it manually from the source tarball.
8
9 21 Dan Smith
## Installing the flatpak
10 1 Dan Smith
11
You will need flatpak package support from your distribution. Check https://www.flatpak.org/setup/ for distribution specific instructions.
12 21 Dan Smith
CHIRP will not automatically update when installed using this method. When you are ready to update CHIRP, you should download a new flatpak and run the `flatpak install` command again.
13 1 Dan Smith
14 21 Dan Smith
```
15
sudo apt install flatpak
16 1 Dan Smith
sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
17 21 Dan Smith
```
18 1 Dan Smith
19
Next download the latest flatpak bundle from https://trac.chirp.danplanet.com/chirp_daily/LATEST/
20
It will probably be saved in your Downloads directory
21 20 Tony Fuller
22 21 Dan Smith
```
23
cd ~/Downloads
24 1 Dan Smith
sudo flatpak install chirp-daily-*.flatpak
25 21 Dan Smith
```
26 1 Dan Smith
27
You may need to log in and log out to see CHIRP in your distribution's applications menu.
28 20 Tony Fuller
If you can't wait to start CHIRP run
29 1 Dan Smith
30 21 Dan Smith
```
31
flatpak run com.danplanet.chirp
32
```
33 1 Dan Smith
34 21 Dan Smith
## Installing the snap
35 1 Dan Smith
36
You will need snap package support for your distribution. Check https://snapcraft.io/chirp-snap for distribution specific instructions.
37 20 Tony Fuller
Snaps automatically update when the device is connected to the internet. This is the biggest advantage over the flatpak.
38
39 21 Dan Smith
```
40
sudo snap install chirp-snap --edge
41 20 Tony Fuller
sudo snap connect chirp-snap:raw-usb
42 21 Dan Smith
```
43 20 Tony Fuller
44
If you do not see CHIRP under your distribution's applications menu then you can manually create using
45
46 21 Dan Smith
```
47
ln -s /var/lib/snapd/desktop/applications/chirp-snap_chirp-snap.desktop ~/.local/share/applications
48
```
49 19 Tony Fuller
50 21 Dan Smith
## Ubuntu package via PPA (20.04 and earlier)
51 1 Dan Smith
52 19 Tony Fuller
This is super quick and easy if you're running a reasonably new version of Ubuntu. Simply run the following in a terminal:
53 1 Dan Smith
54 21 Dan Smith
```
55
sudo apt-add-repository ppa:dansmith/chirp-snapshots
56 1 Dan Smith
sudo add-apt-repository ppa:nrbrtx/python2-stuff  # Older installations of Ubuntu do not need this (20.04 and earlier)
57
sudo apt-get update
58
sudo apt-get install chirp-daily python-future
59 21 Dan Smith
```
60 19 Tony Fuller
61 1 Dan Smith
Look for CHIRP under your distribution's applications menu.
62
63 21 Dan Smith
## Manual installation from source
64 19 Tony Fuller
65 1 Dan Smith
If you are here, you are probably running an old or obscure distribution, or you want to run from source for some other reason (such as testing a daily build). Before you start, make sure that the required python modules are installed on your system. Some suggestions on how to do this are:
66
67 22 Dan Smith
* Ubuntu/Debian: `apt-get install python-gtk python-serial python-libxml2 python-future`
68
* Fedora/RedHat: `yum install pyserial pygtk2 libxml2-python python2-futures`
69 2 Dan Smith
70 16 Tony Fuller
Next, grab the source tarball from the [[Download]] page and save it somewhere like your home directory and then unpack it:
71
72 21 Dan Smith
```
73
tar xzf chirp-0.1.12.tar.gz
74 2 Dan Smith
cd chirp-0.1.12
75 21 Dan Smith
```
76 1 Dan Smith
77
From here, the easiest thing is to just launch CHIRP directly without installing it onto your system. Don't worry, this works just fine and CHIRP will be fully functional. Simply run the following:
78
79 21 Dan Smith
```
80
./chirpw
81
```
82 1 Dan Smith
83
Once you've tested that it runs on your system, you may want to install it permanently. To do this, run the setup routine by doing:
84
85 21 Dan Smith
```
86
sudo python setup.py install
87
```
88 1 Dan Smith
89 4 Jeff Otterson
When finished, you should be able to run "chirpw" from anywhere on your system, and (with luck) you'll also have an item in your distribution's applications menu.
90 6 Jens Jensen
91 21 Dan Smith
## serial port permissions
92 16 Tony Fuller
93 8 Jens Jensen
Note that you may need to adjust permissions on the /dev/tty(something) device, or add your users who want to use CHIRP to the "dialout" group in order to let non-privileged users access the serial device.
94
95 9 Jens Jensen
This issue is often indicated by an "access denied" error when accessing serial port.
96 14 Pavel Milanes
97 9 Jens Jensen
On most Linux distros this is accomplished with:
98 21 Dan Smith
```
99 1 Dan Smith
sudo addgroup "$USERNAME" dialout
100 21 Dan Smith
```
101 13 Pavel Milanes
102 23 Tony Fuller
For other distributions, such as Manjaro, you may need to add your user to the `uucp` group.
103
104 1 Dan Smith
You will then need to log out and back in for it to take effect.