==============================================================================================
GENERAL INSTALLATION OF THE RASPBERRY PI SOFTWARE
==============================================================================================	
Download from https://www.raspberrypi.org/ the NOOBS package. Follow the instructions to format your card and to install the operating system.
Installation is done with the NOOBS package.

Insert the SD card into the Raspberry, connect it to the internet with an UTP cable and 5 volt power supply.

After startup of the Raspberry Pi 2B, select at the bottom the language and keyboard.

Select for the installation the first choice "Raspbian [RECOMMENDED]" and press install.

After a while, the file system will be extracted and a message will be displayed that the Operating System is installed successfully.
Press OK and the Raspberry Pi will be booted.

Open the Terminal window ("Monitor" on the Taskbar or "Menu" --> "Accesories" or "File Manager" --> "Tools") and give the following command (+ Enter of course):
 
sudo raspi-config

Select 2 if you really want to change the default password "raspberry" to one that you do not forget!
Select 3 to choose the boot option B4 to Desktop GUI automatically logged in as 'pi' user.
Select 5 to choose Internationalisation Options
  Leave I1 for what it is
  I2 Change Time Zone to your time zone and nearest city
  I3 Change Keyboard Layout to "Microsoft Natural" and "English (US with euro on 5)" etc. for your preferred settings
Select 9 Advanced Options and then A1 Overscan and "Disable" the overscan so that you will have the maximum screen size on your flat screen monitor

Press "Finish" and "Reboot"

Press with your right mouse button on the taskbar at the top and select "Panel Settings" and "Position at Bottom" if you want to have the Taskbar at the bottom as with older versions of the software.

Press with your right mouse button on the taskbar and select "Add / Remove Panel Items" press "Add" and add the "CPUFreq frontend" and also "Temperature Monitor"

Make an update of the system. Open the Terminal window ("Monitor" on the Taskbar) and give the following command (+ Enter of course):

sudo apt-get update

There is a difference with previous versions of the software, as in the File Manager, the option "Tools" and then "Open Current Folder as Root" was removed.
But there is a simple solution, you can open the File Manager at the Taskbar and select "Tools" --> "Run a Command in Current Folder" and type the following command to have Root Access with the file manager: "sudo pcmanfm". Or "sudo leafpad" to have Root Acces when you want to edit a script or configuration file.

And change the Default view of the file manager. Otherwise you will have to wait ages till a directory with many files is displayed.
Open the file manager and select "Edit" --> "Preferences" and set the "Default view" to "Detailed list view"

==============================================================================================
MAKE THE RASPBERRY PI READY FOR USE WITH AUDIO, PYTHON AND LOPORA
==============================================================================================
Now we have to do the installation and configuration for use with Audio, Python and Lopora.

/usr/lib/pythonX/dist-packages  is the location for external modules like numpy and pyaudio, X is the Python version number.

(The command "sudo" will give you the required rights to install the software as administrator,
"apt-get install" is the command to download and install the software.)

Open the Terminal window ("Monitor" on the Taskbar) and type the next commands (if asked, press "Y" uppercase!):

Installation of Numpy, type the following commands:

sudo apt-get install python3-numpy

(Was not necessary for my Raspberry Pi, a message was displayed that it was already installed)

Installation of the PIL library has been changed, type the following commands:

sudo apt-get install python3-pil
sudo apt-get install python3-pil.imagetk

Installation of pyaudio type the following commands:

sudo apt-get install python3-pyaudio

It is not necessary anymore to install pulseaudio and pavucontrol for the downsampling of the audio stream from 48000 samples/s to 6000 samples/s. However, you can only use the sample rates that are supported by the hardware, usually 44100 samples/s and 48000 samples/s. The Raspberry Pi version 2B and the latest versions of Lopora can work with these high sample rates. The advantage: Lopora uses the unmodified original input signal.
If you have installed PulseAudio, you can remove it by typing the following commands in a terminal screen:
 sudo apt remove pulseaudio
 sudo apt remove pavucontrol

========================================================================================================================
RUNNING LOPORA ON THE RASPBERRY PI (LOPORAv04a.py is the first version for Python V3, older versions are for Python V2!)
========================================================================================================================
DO NOT COPY ANY OF THE SCRIPTFILES FROM THIS ZIP FILE, TYPE THEM OVER!!!

Make a new folder "/home/pi/QRSS" and save all the (unzipped) files in this ZIP file into this directory. Use an USB memory stick to transfer the files.

On your Menu at the Taskbar under Programming  you will find the "Python 3 (IDLE)" and you can open and modify the Lopora program with it. The first lines of Lopora do also contain some specific Raspberry Pi settings. You have to modify the first lines 29 to 50 for FTP settings and other options if you want to save the pictures, if you want a synchronized reception and which markers you want etc.

You can start Lopora when opened with IDLE by selecting "run module". 
But it is also possible to have the scriptfile with the name "startlopora.sh" on your Desktop, you can find it in the ZIP file.

Make it executable (click the file with the right mouse button, select "Properties" --> "Permissions" --> "Execute" and set it to "Anyone"). And of course you have to modify the script file a little depending on your Directory and program names.

Select the audio device to "NAME OF USB audio device" when starting Lopora or press just enter without any name if it is the default audio device.
Select the example configuration file "30MeterBeaconband.cfg" but change the setting "Tuning frequency of the receiver in Hz" to the tuned frequency of your receiver. And also the setting "Start frequency, reception frequency at bottom of screen in Hz". And other settings if you want!

Lopora does also work in Terminal mode. But it does not have any advantages, so my advice is "do not use it!". Many ALSA messages will be displayed, just ignore them. I start Lopora with the script file. Go in the Terminal mode to the directory of the script file and type: ./startlopora.sh (with ./).

We will use the Raspberry Pi 2B in "normal" mode without Overclock and a sample rate of the audio stream of 44100 or 48000 samples/sec.

Open a terminal screen and type "alsamixer" to activate the audio mixer
Move around with left and right arrow keys of the keyboard.
Press F6 and select the desired soundcard
Auto Gain Control has to be set to MM (press "m" on the keyboard), OO means unmuted
Press F5 (all) and change the L - R CAPTURE (mic) volume to the desired value (20% in my setup)

==============================================================================================
AUTOSTART LOPORA ON THE RASPBERRY PI
==============================================================================================
Autostart can be a little problematic in Terminal mode, because you have to set the command in the file "/etc/rc.local". 
This file is executed while Linux is booting up and before any users have logged in. And if there is an error in your program, it might be that the Raspberry Pi does not boot anymore! But of course, we do not use the Terminal mode, but the Desktop mode as you do not have the display in the Terminal window.

So I did the Autostart in Desktop mode. Lopora starts now automatically, even after a sudden power failure!

Open with the File Manager the /home/pi directory .
Open the directory /home/pi/.config (Activate in the File Manager: View: Show Hidden!)
Make a new directory (folder) "autostart" and make a desktop file in this directory /home/pi/.config/autostart
The name of the Desktop file is "lopora.desktop" and you can find it in the ZIP file.
But it takes approximately 3 minutes to start Lopora with this script file due to the following reasons:
My Raspberry Pi starts much faster than my Internet modem. As the modem was not rebooted, it could not get the right time via the time server and did start to run with a wrong time. So in the script file, there is a pause of 90 seconds to give the Internet modem enough time to reboot. Then the NTP Network Time Protocol service is restarted, so that it can get the correct time from the Internet via the rebooted modem. Then there is another pause of 60 seconds to give the NTP application time to get the correct time and Lopora is started.

In my case, the scriptfile "startlopora.sh" is located on the Desktop and is called. Of course you have to modify the Exec=.. so that it runs your scriptfile.
Make the Desktopfile "lopora.desktop" executable (click the file with the right mouse button, select "Properties" --> "Permissions" --> "Execute" and set it to "Anyone") and when the Raspberry Pi reboots, Lopora will start after the mentioned 3 minutes. Just wait, it looks as if nothing happens.

If you do have more than 1 audio device, you have to modify in line 43 of the program the AUDIOdevin from "None" to the number of the audio input device. you can find a list with the numbers of the audio devices by pressing "Audio device".

==============================================================================================
SOME MORE
==============================================================================================
And always that screen that goes blank after 30 minutes... We do not want that, we have our monitor as a painting on the wall in the shack! There is a solution. The only one that works is also the most simple solution! Open a Terminal window and type the following command to install a screensaver application:

sudo apt-get install xscreensaver

At the Taskbar, press "Menu" --> "Preferences" and you will find the Screensaver application. Select the Mode "Disable Screen Saver" if you do not want to have the screensaver active, or a short time to activate it if you want to have it active to reduce for example radio interference.

And I did something that everybody does once and could not change the desktop background anymore. 
When right-clicking the desktop, I selected under Desktop Preferences - Advanced the "Show menus provided by window managers when desktop is clicked". From that moment, I had a strange menu when right clicking the desktop and could not change the Desktop Appearance anymore... Is a problem when you want to have a black desktop background. Was solved as follows:

Launch a terminal and enter "pcmanfm --desktop-pref". 
When the desktop preferences window pops up, click on the "Advanced" tab and deselect "Show menus provided by window managers when desktop is clicked".

Copying the grabber pictures can be done with an USB stick. Enough USB ports on the Raspberry Pi 2B. 

Only with special software it is possible to read the SD card in a Windows PC. More can be found on the internet. Also about how to make an image of your SD card.
