Project

General

Profile

Running Under Linux » History » Version 21

Dan Smith, 12/07/2022 06:25 PM

1 21 Dan Smith
# Running CHIRP Under Linux
2 1 Dan Smith
3
{{>toc}}
4
5
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.
6
7 21 Dan Smith
## Installing the flatpak
8 1 Dan Smith
9
You will need flatpak package support from your distribution. Check https://www.flatpak.org/setup/ for distribution specific instructions.
10 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.
11 1 Dan Smith
12 21 Dan Smith
```
13
sudo apt install flatpak
14 1 Dan Smith
sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
15 21 Dan Smith
```
16 1 Dan Smith
17
Next download the latest flatpak bundle from https://trac.chirp.danplanet.com/chirp_daily/LATEST/
18
It will probably be saved in your Downloads directory
19 20 Tony Fuller
20 21 Dan Smith
```
21
cd ~/Downloads
22 1 Dan Smith
sudo flatpak install chirp-daily-*.flatpak
23 21 Dan Smith
```
24 1 Dan Smith
25
You may need to log in and log out to see CHIRP in your distribution's applications menu.
26 20 Tony Fuller
If you can't wait to start CHIRP run
27 1 Dan Smith
28 21 Dan Smith
```
29
flatpak run com.danplanet.chirp
30
```
31 1 Dan Smith
32 21 Dan Smith
## Installing the snap
33 1 Dan Smith
34
You will need snap package support for your distribution. Check https://snapcraft.io/chirp-snap for distribution specific instructions.
35 20 Tony Fuller
Snaps automatically update when the device is connected to the internet. This is the biggest advantage over the flatpak.
36
37 21 Dan Smith
```
38
sudo snap install chirp-snap --edge
39 20 Tony Fuller
sudo snap connect chirp-snap:raw-usb
40 21 Dan Smith
```
41 20 Tony Fuller
42
If you do not see CHIRP under your distribution's applications menu then you can manually create using
43
44 21 Dan Smith
```
45
ln -s /var/lib/snapd/desktop/applications/chirp-snap_chirp-snap.desktop ~/.local/share/applications
46
```
47 19 Tony Fuller
48 21 Dan Smith
## Ubuntu package via PPA (20.04 and earlier)
49 1 Dan Smith
50 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:
51 1 Dan Smith
52 21 Dan Smith
```
53
sudo apt-add-repository ppa:dansmith/chirp-snapshots
54 1 Dan Smith
sudo add-apt-repository ppa:nrbrtx/python2-stuff  # Older installations of Ubuntu do not need this (20.04 and earlier)
55
sudo apt-get update
56
sudo apt-get install chirp-daily python-future
57 21 Dan Smith
```
58 19 Tony Fuller
59 1 Dan Smith
Look for CHIRP under your distribution's applications menu.
60
61 21 Dan Smith
## Manual installation from source
62 19 Tony Fuller
63 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:
64
65
* Ubuntu/Debian: @apt-get install python-gtk python-serial python-libxml2 python-future@
66 2 Dan Smith
* Fedora/RedHat: @yum install pyserial pygtk2 libxml2-python python2-futures@
67
68 16 Tony Fuller
Next, grab the source tarball from the [[Download]] page and save it somewhere like your home directory and then unpack it:
69
70 21 Dan Smith
```
71
tar xzf chirp-0.1.12.tar.gz
72 2 Dan Smith
cd chirp-0.1.12
73 21 Dan Smith
```
74 1 Dan Smith
75
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:
76
77 21 Dan Smith
```
78
./chirpw
79
```
80 1 Dan Smith
81
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:
82
83 21 Dan Smith
```
84
sudo python setup.py install
85
```
86 1 Dan Smith
87 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.
88 6 Jens Jensen
89 21 Dan Smith
## serial port permissions
90 16 Tony Fuller
91 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.
92
93 9 Jens Jensen
This issue is often indicated by an "access denied" error when accessing serial port.
94 14 Pavel Milanes
95 9 Jens Jensen
On most Linux distros this is accomplished with:
96 21 Dan Smith
```
97 1 Dan Smith
sudo addgroup "$USERNAME" dialout
98 21 Dan Smith
```
99 13 Pavel Milanes
100 1 Dan Smith
You will then need to log out and back in for it to take effect.