Adding programs to the Applications Menu

This document is to finalize and set up the system for more convenient operation. For consistency and to avoid confusion, I put the icons for the programs that are run from the home directory in the Applications menu directories located in the home directory structure. 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.

Install lxterminal to allow scripts to launch new terminals
```
sudo apt install lxterminal
```
Creating Application menu items
The CubicSDR and WSJT-X installers make their own icon. For the others, will add a desktop file and add it to the Applications menu
- GQRX
- Copy the icon and desktop files
```
sudo cp ~/gqrx/gqrx.desktop /usr/local/share/applications
sudo cp ~/gqrx/resources/icons/gqrx.ico /usr/share/icons
```
- Edit the desktop file to add the icon
```
sudo featherpad /usr/local/share/applications/gqrx.desktop
```
- Find Icon=gqrx and change it to Icon=/usr/share/icons/gqrx.ico
- Save the file and close the editor.
- SDRangel
  This is based on a desktop file included with SDRangel.
  Open a text editor with this command:
  sudo featherpad /usr/local/share/applications/SDRangel.desktop
  Paste the code below, based on that desktop file,the 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 --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:
  featherpad ~/.local/share/applications/GridTracker.desktop
  Paste the code below, based on that desktop file,the editor and save. You may need to change the paths if your installation folder or user name is different.
```
[Desktop Entry]
Name=GridTracker
Comment=GridTracker
GenericName=GridTracker, An Amateur Radio Companion
Exec=/home/pi/GridTracker/GridTracker
Icon=/home/pi/GridTracker/gridtracker.png
Path=/home/pi/GridTracker
Type=Application
Encoding=UTF-8
Terminal=false
Categories=None;
```
- QRadioLink.
  Open a text editor with this command:
  featherpad ~/.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:
  featherpad ~/.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/SdrGlut-Windows/SdrGlut3.ico
Path=/home/pi/Desktop/SdrGlut
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 featherpad /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:
  featherpad ~/.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:
  featherpad ~/.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;
```
- TCP Server.
  Open a text editor with this command:
  featherpad ~/.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;
```
- HD Radio (nrsc5-dui).
  Open a text editor with this command:
  featherpad ~/.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=python3 nrsc5-dui.py
Icon=/home/pi/nrsc5-dui-2.1.1/res/nrsc5-gui.ico
Path=/home/pi/nrsc5-dui-2.1.1
Type=Application
Encoding=UTF-8
Terminal=false
Categories=AudioVideo;Audio;Radio;
```
- Dream, Digital Radio Mondiale (DRM).
  Open a text editor with this command:
  featherpad ~/.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.
  It is necessary to receive the DRM signal with a receiver capable of providing a 10 KHz wide signal. The setup is here: Installing utility software on a Raspberry Pi.
```
[Desktop Entry]
Name=Dream
Comment=Digital Radio Mondiale (DRM)
GenericName=Dream
Exec=/home/pi/dream/dream -I pulse -O pulse
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;
```
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:
  featherpad ~/Documents/Start_All_WSJT_apps.sh
  Paste this code into a text editor and save.
```
#! /bin/sh

pacmd load-module module-null-sink sink_name=Virtual0
pacmd update-sink-proplist Virtual0 device.description=Virtual0
pacmd update-source-proplist Virtual0.monitor device.description=Virtual0
sleep 1
wsjtx &
sleep 20
~/GridTracker/GridTracker &
```
- Add an Application menu icon.
  Open a text editor with this command:
  featherpad ~/.local/share/applications/Start_All_WSJT_apps.desktop
  Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=Start All WSJT apps
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 ~/
  featherpad "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 ~/
  featherpad ".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;
```
- 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:
  featherpad ~/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 ~/
  featherpad ".local/share/applications/Start DMR.desktop"
  Paste the code below into the text editor and save.
```
[Desktop Entry]
Version=1.0
Name=Start 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:
  featherpad ~/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 ~/
  featherpad ".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;
```
- Give yourself execute permission to each of these scripts:
```
cd ~/Documents
sudo chmod +x *.sh
```

Back to the index