Adding programs to the Applications Menu

This document is to finalize and set up the system for more convenient operation. The items for op25 are examples only, as this configuration will likely need to be changed to work for you.
If your user name is not "pi", change "/home/pi" below.

Creating Application menu items
The CubicSDR, gqrx, SigDigger and WSJT-X installers make their own Applications Menu icon. For the others, we will add a desktop file and add it to the Applications menu
- SDRangel
  This is based on a desktop file included with SDRangel.
  Open a text editor with this command:
  sudo mousepad /usr/local/share/applications/SDRangel.desktop
  Paste the code below into the text editor and save.
```
[Desktop Entry]
Name=SDRangel
GenericName=SDR/Analyzer frontend
Comment=SDR/Analyzer frontend for Airspy, Airspy HF+, BladeRF, HackRF, LimeSDR, PlutoSDR, RTL-SDR, SDRplay RSP1 and FunCube
Exec=sh -c "/opt/install/sdrangel/bin/sdrangel --soapy --fftwf-wisdom ~/.config/f4exb/fftw-wisdom"
Icon=/opt/install/sdrangel/share/icons/hicolor/scalable/apps/sdrangel_icon.svg
StartupNotify=true
Terminal=false
Type=Application
Categories=Network;HamRadio;
```
- GridTracker has an example .desktop file in its installation folder.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/GridTracker2.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=GridTracker2
Comment=GridTracker
GenericName=GridTracker: An Amateur Radio Companion
Exec=/home/pi/GridTracker2/gridtracker2
Icon=/home/pi/GridTracker2/gridtracker.png
Path=/home/pi/GridTracker2
Type=Application
Encoding=UTF-8
Terminal=false
Categories=None;
```
- QRadioLink.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/QRadioLink.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=QRadioLink
Comment=SDR Software
GenericName=QRadioLink
Exec=/home/pi/qradiolink/build/qradiolink
Icon=/home/pi/qradiolink/src/res/logo.png
Path=/home/pi/qradiolink/build/
Type=Application
Terminal=false
Categories=None;
```
- SdrGlut.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/SdrGlut.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=SdrGlut
Comment=SDR Software
GenericName=SdrGlut
Exec=/home/pi/Desktop/SdrGlut/sdrglut.x
Icon=/home/pi/Desktop/SdrGlut/misc/icon/SdrGlut3.ico
Path=/home/pi/Desktop/SdrGlut
Type=Application
Encoding=UTF-8
Terminal=false
Categories=None;
```
- iqSDR.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/iqSDR.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=iqSDR
Comment=SDR Software
GenericName=iqSDR
Exec=/home/pi/Desktop/SdrGlut/iqSDR/iqSDR.x
Icon=/home/pi/Desktop/SdrGlut/misc/icon/SdrGlut3.ico
Path=/home/pi/Desktop/SdrGlut/iqSDR
Type=Application
Encoding=UTF-8
Terminal=false
Categories=None;
```
- Start Hamlib service with an Application menu icon.
  Open a text editor with this command:
  sudo mousepad /usr/local/share/applications/rigctld.desktop
  Paste the code below into the text editor and save. Press CTRL-C to stop the Rig Control server.
```
[Desktop Entry]
Comment=Rig Control server
Terminal=true
Name=rigctld
Exec=rigctld -v -m 1 -T 127.0.0.1 -t 7356 &
Type=Application
Icon=utilities-terminal
```
- ADS-B dump1090.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/dump1090.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=ADS-B dump1090
Comment=Start dump1090
Terminal=true
Name=dump1090
Exec=/home/pi/dump1090/dump1090 --dev-sdrplay --interactive --net
Path=/home/pi/dump1090
Type=Application
Icon=utilities-terminal
```
- Virtual Radar Server.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/VirtualRadar.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=VirtualRadar
Comment=Virtual Radar Server
GenericName=VirtualRadar
Exec=mono /home/pi/VirtualRadar/VirtualRadar.exe
Icon=/home/pi/VirtualRadar/Web/favicon.ico
Path=/home/pi/VirtualRadar
Type=Application
Encoding=UTF-8
Terminal=false
Categories=None;
```
- RSP TCP Server for SDRplay.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/RSPTCPServer.desktop
  Paste the code below into the text editor and save. You can stream your SDR over the Internet if you set up port forwarding in your router.
```
[Desktop Entry]
Name=RSP TCP Server
Comment=RSP TCP Server
Terminal=true
Name=RSP TCP Server
Exec=rsp_tcp -a 0.0.0.0 -s 960000
Type=Application
Icon=utilities-terminal
Categories=Network;Radio;
```
- RTL-SDR TCP Server.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/RTLTCPServer.desktop
  Paste the code below into the text editor and save. You can stream your SDR over the Internet if you set up port forwarding in your router.
```
[Desktop Entry]
Name=RTL-SDR TCP Server
Comment=RTL-SDR TCP Server
Terminal=true
Name=RTL-SDR TCP Server
Exec=rtl_tcp -a 0.0.0.0 -s 960000
Type=Application
Icon=utilities-terminal
Categories=Network;Radio;
```
- Soapy Remote server.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/SoapyRemote.desktop
  Paste the code below into the text editor and save. Configure the SDR application to use the Soapy Remote server on the Raspberry Pi's IP address and port 55132.
```
[Desktop Entry]
Comment=Soapy Remote server
Terminal=true
Name=Soapy Remote port 55132
Exec=SoapySDRServer --bind="0.0.0.0:55132"
Type=Application
Icon=utilities-terminal
```
- HD Radio for SDRplay (nrsc5-dui).
  Open a text editor with this command:
  mousepad ~/.local/share/applications/nrsc5-dui-sdrplay.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
  It is necessary to start the RSP TCP Server before running nrsc5-dui.
```
[Desktop Entry]
Name=HD Radio for SDRplay
Comment=nrsc5-dui
GenericName=nrsc5-dui
Exec=sudo sh -c 'echo performance > /sys/devices/system/cpu/cpufreq/policy0/scaling_governor; python3 nrsc5-dui.py /home/pi/nrsc5-sdrplay/build/src/'
Icon=/home/pi/nrsc5-dui/res/nrsc5-gui.ico
Path=/home/pi/nrsc5-dui
Type=Application
Encoding=UTF-8
Terminal=false
Categories=AudioVideo;Audio;Radio;
```
- HD Radio standard version (nrsc5-dui).
  Open a text editor with this command:
  mousepad ~/.local/share/applications/nrsc5-dui.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
  It is necessary to start the RSP TCP Server before running nrsc5-dui.
```
[Desktop Entry]
Name=HD Radio
Comment=nrsc5-dui
GenericName=nrsc5-dui
Exec=sudo sh -c 'echo performance > /sys/devices/system/cpu/cpufreq/policy0/scaling_governor; python3 nrsc5-dui.py /home/pi/nrsc5/build/src/'
Icon=/home/pi/nrsc5-dui/res/nrsc5-gui.ico
Path=/home/pi/nrsc5-dui
Type=Application
Encoding=UTF-8
Terminal=false
Categories=AudioVideo;Audio;Radio;
```
- Dream, Digital Radio Mondiale (DRM).
  Open a text editor with this command:
  mousepad ~/.local/share/applications/Dream.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
  This Applications menu icon will start Dream using its current setup (Using an SDRplay device directly or receiving the DRM signal with an SDR application and virtual audio cable). See Installing utility software on a Raspberry Pi.
```
[Desktop Entry]
Name=Dream
Comment=Digital Radio Mondiale (DRM)
GenericName=Dream
Exec=/home/pi/dream/dream
Icon=/home/pi/dream/src/GUI-QT/res/MainIcon.ico
Path=/home/pi/dream
Type=Application
Encoding=UTF-8
Terminal=false
Categories=AudioVideo;Audio;Radio;
```
- Dire Wolf
  Edit the start menu item to enable the map.
  Open a text editor with this command:
  sudo mousepad /usr/local/share/applications/direwolf.desktop
  Add -p to the Exec command as shown below.
```
[Desktop Entry]
Name=Dire Wolf
Comment=APRS Soundcard TNC
Exec=/usr/bin/lxterminal -e direwolf -p
Icon=direwolf_icon.png
StartupNotify=true
Terminal=false
Type=Application
Categories=HamRadio
Keywords=Ham Radio;APRS;Soundcard TNC;KISS;AGWPE;AX.25
```
- pyspectrum for SDRplay. This has been updated to run in a virtual environment.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/pyspectrum.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=pyspectrum for SDRplay
Comment=Python based spectrum analyzer
Terminal=true
Name=pyspectrum for SDRplay
Exec=sh -c 'pipenv shell "python3 /home/pi/pyspectrum/src/pyspectrum.py -isoapy:sdrplay -s2e6 -c433.92e6"'
Path=/home/pi
Type=Application
Icon=utilities-terminal
```
- pyspectrum for HackRF. This has been updated to run in a virtual environment.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/pyspectrum1.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=pyspectrum for HackRF
Comment=Python based spectrum analyzer
Terminal=true
Name=pyspectrum for HackRF
Exec=sh -c 'pipenv shell "python3 /home/pi/pyspectrum/src/pyspectrum.py -isoapy:hackrf -s10e6 -c433.92e6"'
Path=/home/pi
Type=Application
Icon=utilities-terminal
```
- pyspectrum for RTL-SDR. This has been updated to run in a virtual environment.
  Open a text editor with this command:
  mousepad ~/.local/share/applications/pyspectrum2.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=pyspectrum for RTL-SDR
Comment=Python based spectrum analyzer
Terminal=true
Name=pyspectrum for RTL-SDR
Exec=sh -c 'pipenv shell "python3 /home/pi/pyspectrum/src/pyspectrum.py -irtlsdr:0 -c433.92e6 -s1e6"'
Path=/home/pi
Type=Application
Icon=utilities-terminal
```
- sdrtrunk
  Open a text editor with this command:
  mousepad ~/.local/share/applications/sdrtrunk.desktop
  Paste the code below into the text editor and save. You may need to change the paths if your installation folder/version or user name is different.
```
[Desktop Entry]
Version=1.0
Name=sdrtrunk P25 scanner
Comment=sdrtrunk
Exec=/home/pi/sdr-trunk-linux-aarch64-v0.6.0/bin/sdr-trunk
Path=/home/pi/sdr-trunk-linux-aarch64-v0.6.0
Icon=utilities-terminal
Terminal=false
Type=Application
Categories=None;
```
- PulseAudio Equalizer if you installed it...
  Open a text editor with this command:
  sudo mousepad /usr/local/share/applications/qpaeq.desktop
  Paste the code below into the text editor and save.
```
[Desktop Entry]
Name=PulseAudio Equalizer
GenericName=Sound Equalizer
Type=Application
Terminal=false
Exec=qpaeq
TryExec=qpaeq
StartupWMClass=qpaeq
Icon=audio-headphones
Categories=Qt;AudioVideo;
```
- Grig for Hamlib NET rigctl
  Copy the icon and open a text editor with these commands:
  sudo cp /home/pi/grig/win32/icons/grig.ico /usr/local/share/applications
  sudo mousepad /usr/local/share/applications/grig-net.desktop
  Paste the code below into the text editor and save.
```
[Desktop Entry]
Name=grig for Hamlib NET rigctl
Comment=Graphical user interface for Hamlib
Terminal=false
Name=grig for Hamlib NET rigctl
Exec=grig -m 2 -r 127.0.0.1:7356
Type=Application
Icon=/usr/local/share/applications/grig.ico
```
- Grig for Yaesu FT-890
  You don't need to copy the icon if you did it in the section above.
  Copy the icon and open a text editor with these commands:
  sudo cp /home/pi/grig/win32/icons/grig.ico /usr/local/share/applications
  sudo mousepad /usr/local/share/applications/grig.desktop
  Paste the code below into the text editor and save.
```
[Desktop Entry]
Name=grig for Yaesu FT-890
Comment=Graphical user interface for Hamlib
Terminal=false
Name=grig for Yaesu FT-890
Exec=grig -m 1015 -r /dev/ttyUSB0 -s 4800 --set-conf=stop_bits='"2"'
Type=Application
Icon=/usr/local/share/applications/grig.ico
```
- Rdio Scanner
  Open a text editor with this command:
  mousepad ~/.local/share/applications/rdio-scanner.desktop
  Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=Rdio Scanner - P25
Comment=Start Rdio Scanner - P25
Exec=/home/pi/rdio-scanner-linux-arm64-v6.6.3/rdio-scanner
Path=/home/pi/rdio-scanner-linux-arm64-v6.6.3
Icon=utilities-terminal
Terminal=true
Type=Application
Categories=None;
```
Scripts
You will need execute permission to each of these scripts. See the command at the end of this section.
- Here is a handy script that will start the virtual audio cable, WSJT-X and GridTracker. If you have Hamlib enabled in WSJT-X and are using Cubic SDR, Hamlib rigctld must be running before executing this script.
  - Open a text editor with this command:
    mousepad ~/Documents/Start_All_WSJT_apps.sh
    Paste this code into a text editor, uncommenting the line for your Virtual Sink verson, and save.
```
#! /bin/sh

pactl load-module module-null-sink sink_name=VirtualRx format=s16le channels=2 rate=48000 sink_properties=device.description="VirtualRx"
sleep 1
wsjtx &
sleep 20
~/GridTracker/GridTracker &
```
  - Add an Application menu icon.
    Open a text editor with this command:
    mousepad ~/.local/share/applications/Start_All_WSJT_apps.desktop
    Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=Virtual Audio Cable, WSJT, GridTracker
Comment=Script to Start All WSJT apps
Exec=/home/pi/Documents/Start_All_WSJT_apps.sh
Icon=utilities-terminal
Terminal=false
Type=Application
Categories=Application;
```
- Project 25 trunked radio system scanner with liquidsoap
  - This script will open 3 terminal windows with op25, liquidsoap and tail which will show messages.
    Open a text editor with this command:
    cd ~/
    mousepad "Documents/op25 with liquidsoap.sh"
    Paste the code below into the text editor and save. You may need to change the text to match your configuration.
```
#! /bin/sh

lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && ./rx.py --args 'driver=sdrplay,soapy=0' -N 'IFGR:28','RFGR:1' -S 1000000 -x 1 -f 855.2875e6 -o 1e3 -q -1 -d 700 -T michigantrunk.tsv -V -2 -w 2> stderr-stream0.2"' &
lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && ./op25.liq"' &
lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && tail -f stderr-stream0.2"' &
```
  - Add an Application menu icon.
    Open a text editor with this command:
    cd ~/
    mousepad ".local/share/applications/op25 with liquidsoap.desktop"
    Paste the code below into the text editor and save it.
```
[Desktop Entry]
Version=1.0
Name=Start P25 scanner
Comment=Start op25
Exec="/home/pi/Documents/op25 with liquidsoap.sh"
Icon=utilities-terminal
Terminal=false
Type=Application
Categories=None;
```
- Project 25 trunked radio system scanner in web browser with liquidsoap
  - This script will open Firefox and 2 terminal windows, with op25 and liquidsoap. If you use another browser, change the script as needed.
    Open a text editor with this command:
    cd ~/
    mousepad "Documents/op25 http liquidsoap.sh"
    Paste the code below into the text editor and save. You may need to change the text to match your configuration.
```
#! /bin/sh

lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && ./rx.py --args 'driver=sdrplay,soapy=0' -N 'IFGR:28,RFGR:1' -S 1000000 -x 1 -f 855.2875e6 -o 1e3 -q -1 -d 700 -T michigantrunk.tsv -V -2 -v 1 -w -l 'http:0.0.0.0:8080'"' &
lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && ./op25.liq"' &
sleep 5
firefox --new-window http://127.0.0.1:8080/ &
```
  - Add an Application menu icon.
    Open a text editor with this command:
    cd ~/
    mousepad ".local/share/applications/op25 http liquidsoap.desktop"
    Paste the code below into the text editor and save it.
```
[Desktop Entry]
Version=1.0
Name=Start P25 scanner with GUI
Comment=Start op25
Exec="/home/pi/Documents/op25 http liquidsoap.sh"
Icon=utilities-terminal
Terminal=false
Type=Application
Categories=None;
```
- Start the DMR receiver
  - This script will open 2 terminal windows with op25 and tail that will show messages. It may also open a plot window if so configured in the .json file.
    Open a text editor with this command:
    mousepad ~/Documents/start_DMR.sh
    Paste the code below into the text editor and save it.
```
#! /bin/sh

lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && ./multi_rx.py -c dmr_cfg.json -v 9 2> stderr.2"' &
lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && tail -f stderr.2"' &
```
  - Add an Application menu icon.
    Open a text editor with this command:
    cd ~/
    mousepad ".local/share/applications/Start DMR.desktop"
    Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=Start op25 DMR
Comment=Start DMR
Exec=/home/pi/Documents/start_DMR.sh
Icon=utilities-terminal
Terminal=false
Type=Application
Categories=None;
```
- Start Motorola Type II Smartnet
  - This script will open 2 terminal windows with op25 and tail which will show messages.
    Open a text editor with this command:
    mousepad ~/Documents/start_UM_Snet.sh
    Paste the code below into the text editor and save.
```
lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && ./multi_rx.py -v 4 -c smartnet_test.json 2> stderr.2"' &
# Using built-in audio
lxterminal -e 'bash -c "cd ~/op25/op25/gr-op25_repeater/apps && tail -f stderr.2"' &
```
  - Add an Application menu icon.
    Open a text editor with this command:
    cd ~/
    mousepad ".local/share/applications/Start Smartnet.desktop"
    Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=Start Smartnet
Comment=Start Smartnet
Exec=/home/pi/Documents/start_UM_Snet.sh
Icon=utilities-terminal
Terminal=false
Type=Application
Categories=None;
```
- Start OpenWebRX
  - Open a text editor with this command:
    mousepad ~/Documents/start_owrx.sh
    Paste the code below into the text editor and save.
```
#! /bin/sh

SoapySDRUtil --probe="driver=sdrplay"
sudo systemctl start codecserver
cd ~/openwebrx
./openwebrx.py
```
  - Add an Application menu icon.
    Open a text editor with this command:
    cd ~/
    mousepad ".local/share/applications/Start OpenWebRX.desktop"
    Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=OpenWebRX
Comment=Start OpenWebRX
Exec=/home/pi/Documents/start_owrx.sh
Icon=/home/pi/openwebrx/htdocs/favicon.ico
Terminal=true
Type=Application
Categories=None;
```
- Start Trunk Recorder - HackRF
  - This script will open 3 terminal windows with op25, liquidsoap and tail which will show messages.
    Open a text editor with this command:
    mousepad ~/Documents/MPSCS-HackRF.sh
    Paste the code below into the text editor and save. You may need to change the text to match your configuration.
```
#! /usr/bin/env bash

cd ~/trunk-build
./trunk-recorder --config=config-MPSCS-HackRF.json
rm -r -v MPSCS/*
```
  - Add an Application menu icon.
    Open a text editor with this command:
    mousepad ~/.local/share/applications/MPSCS-HackRF.desktop
    Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=Trunk Recorder - HackRF
Comment=Start Trunk Recorder - HackRF
Exec="/home/pi/Documents/MPSCS-HackRF.sh"
Icon=utilities-terminal
Terminal=true
Type=Application
Categories=None;
```
- Start Trunk Recorder - SDRplay
  - This script will open 3 terminal windows with op25, liquidsoap and tail which will show messages.
    Open a text editor with this command:
    mousepad ~/Documents/MPSCS-SDRplay.sh
    Paste the code below into the text editor and save. You may need to change the text to match your configuration.
```
#! /usr/bin/env bash

cd ~/trunk-build
./trunk-recorder --config=config-MPSCS-SDRplay.json
rm -r -v MPSCS/*
```
  - Add an Application menu icon.
    Open a text editor with this command:
    mousepad ~/.local/share/applications/MPSCS-SDRplay.desktop
    Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=Trunk Recorder - SDRplay
Comment=Start Trunk Recorder - SDRplay
Exec="/home/pi/Documents/MPSCS-SDRplay.sh"
Icon=utilities-terminal
Terminal=true
Type=Application
Categories=None;
```
- Give yourself execute permission to each of these scripts:
```
cd ~/Documents
sudo chmod +x *.sh
```

Back to the index