The HamBone

I'm delighted to draw attention to the new release of Andy's KB1OIQ Linux, Version 25a, and now also for RasPi.
Please find it at https://sourceforge.net/projects/kb1oiq-andysham/

Version 21 - last version to support 32-bit
Version 25a: 05-May-2023 (xfce4) 64-bit, Xubuntu 22.04.0

This is a remastered version of Xubuntu Linux.

PLEASE read this very fine document:
https://sourceforge.net/projects/kb1oiq ... NG_STARTED

This version contains a lot of amateur radio software including Fldigi, NBEMS, Gpredict, xcwcp and qrq, XLog and cqrlog, flrig and grig, xnec2c, fl_moxgen, aa-analyzer, owx, VOACAP, glfer, Xastir, gqrx, SDRangel, GNU Radio Companion, quisk, direwolf, FreeDV, wsjt-x, js8call, Micro-Fox 15 Config, TinyTrak3, sdrangel, M17 programs, and more!

This software collection uses the Xfce4 desktop environment with menus customized for Amateur Radio use.

Recommended minimums: 2GHz CPU, 4GB memory, and 15 GB of disk space (after the installation is complete).

Find the new Raspberry Pi version here:
https://sourceforge.net/projects/kb1oiq ... /0.1alpha/


Features

Live medium which can be installed to the hard drive or USB thumb drive
Xfce4 desktop environment
Contains a large number of amateur radio programs
Amateur Radio menu customized for ease of use
Nothing proprietary (as far as I know)
Software came from the Ubuntu repositories, PPAs, and source tar files
Software defined radio receiver with RTL2832 USB dongle
Micro-Fox Config GPL and TinyTrak3 Config GPL
GNU Radio Companion and gqrx
FreeDV (free digital voice)
Packet radio software linpac and AX25
pskmail client and server
digital radio mondiale
Learn CW via the Wordsworth method
FT8 via wsjt-x
js8call
Arduino IDE and libraries, plus Fritzing
nanoVNA and tinySA software
Don't forget to install GridTracker! See HOWTO_GridTracker document.
SDRangel
M17 mvoice, droidstar, and more!

Andy's own Release notes, but still from 2020:

RELEASE_NOTES
=============

If this file looks improperly spaced, choose a fixed width font.

My goal in creating this software collection was to allow the user
to have an easier way to get started with a Linux computer and an
amateur radio.  There is still a lot for the user to do!  However,
I have complete confidence in your ability to learn what you may
not yet know how to do.  After all, you're a licensed amateur
radio operator!

If you are the type of person who can install a tube into your
rig with no further direction, or perhaps a circuit board in your
computer, then this software collection may be for you.  However,
if you need to be told to get the screwdriver and remove the screws
first, with pictures and text, you may be disappointed.

This software collection is based on Ubuntu 18.04 LTS and is a remix.
This means that the selection of software packages is not the same
as the standard Ubuntu 18.04.  The vast majority of the programs
came directly from the Ubuntu repository.  A few programs were
installed either directly from source, or installed as a precompiled
binary.  Still others were downloaded from PPAs (Personal Package
Archives).  To the best of my knowledge, there is no proprietary
software on this software collection.  If you find any proprietary
software, please send me email.

Assumptions:
   - computer must contain a x86_64 type of processor
   - there is no 32-bit support - none
   - computer has a bootable USB thumb drive
   - 2GB of memory minimum (more for SDR applications)
   - 2GHz processor minimum (more for SDR applications)
   - computer has a working network connection
   - 15 GB hard disk - absolute minimum (more is definitely better)
   - this software collection does the hard work of geting you started,
     and you can continue on your own.  It is a starting point, not an
     end point.
   - one version cannot be used to upgrade a previous version

Goals:
   - works as a Live DVD or Live USB thumb drive
   - thoroughly tested in VirtualBox
   - contains installation programs for the hard drive and a USB thumb drive
   - a reasonable selection of amateur radio software is present, but users
     are expected to configure each program as is required for their unique
     situation
   - to help both the Linux and amateur radio communities by creating this
     software collection

In short, the software collection was built by starting first with the
debootstrap package.  The X Window System was installed along with 
a desktop environment.  A variety of amateur radio applications were
then installed.  The menu was customized for amateur radio use.  The login
screen, boot splash screen, and the slideshow for the hard disk installation
program were also customized.

This link was extremely helpful in the creation of this software collection:
  https://help.ubuntu.com/community/LiveC ... romScratch

Based on the assumptions above, software was selected for its usefulness
to amateur radio.  The included amateur radio software is shown (if this section
does not look properly lined up, pick a fixed width font):

AlarmeJT       - companion program to wsjt-x
aa-analyzer.pl - command line program used with RigExpert AA-xxx analyzers
chirp          - used to program frequencies into HTs (chirpw)
cqrlog         - a full featured QSO logging program
cwwav          - command line program to convert text files to CW wav or mp3
direwolf       - soundcard TNC for APRS
dream          - digital radio mondiale receiver
dump1090       - ADSB reception
earthtrack     - used with predict and xplanet to display satellites
ebook2cwgui    - convert Ebook files to CW (get free ones at 
                 http://www.gutenberg.org/ebooks/)
flamp          - NBEMS program for Amateur Multicast Protocol (AMP)
flcluster      - access DX cluster nodes
fldigi         - digital modes such as PSK31 (NBEMS)
flmsg          - companion to fldigi, a simple forms management editor 
                 for standard message formats (NBEMS)
fllog          - to provide a common log across networked computers
flnet          - a net control logging program by W1HKJ
flrig          - rig control
flwkey         - modem program for the K1EL Winkeyer series
flwrap         - companion to fldigi, file encapsulation / compression
Fl_Moxgen      - Moxon Rectangle antenna design program
foxtelem       - Fox-1A (AO-85) Satellite Telemetry decoder
freedv         - SSB low bit rate digital voice
gerbv          - view Gerber files
glfer          - QRSS (slow CW) or DFCW (Dual Frequency CW) modes
GNU Radio      - GNU software defined radio
gpredict       - satellite tracking
gqrx           - software defined radio receiver
grig           - rig control software
gsmc           - Smith Chart calculator for impedance matching
gspiceui       - GUI interface for spice
gwave          - analog waveform viewer (e.g. spice output) (broken)
hamlib         - radio control library
ibp            - HF beacons
kicad          - electronic design automation and schematic capture
klog           - logging program
linpac         - packet radio ax.25 software
mfc_gpl        - Byonics Micro-Fox 15 configuration GUI 
MSHV           - FT8 and other digital modes, similar to wsjt-x
owx            - Open Wouxun, command line programs for Wouxun HTs
PotaPutter     - an ADIF converter for POTA QSOs
PyLogJam       - a simple logger for POTA QSOs
pcb-gtk        - interactive printed circuit board editor
predict        - predict orbits of satellites (used with earthtrack)
pskmail        - ARQ communication system optimized for HF
qgrid          - Maidenhead grid squares calculator
quisk          - software defined radio receiver
qrq            - CW callsign practice
qsstv          - SSTV (analog AND digital)
qtel           - Echolink client
soundmodem     - user mode driver for packet radio (useful with xastir)
splat          - command line HF propagation prediction
sunclock       - track day/night line on Earth
svxlink        - Echolink server
TQSL           - used with ARRL Logbook of the World
tt3_gpl        - Byonics TinyTrak3 Configuration GUI
voacapl        - VOACAP - propagation prediction - link to online data
wfview         - IC-7300 waterfall viewer
wordsworth     - learn CW a "wordsworth" at a time
wsjt-x         - weak signal communication - JT9,JT65,FT8
wwl            - compute distance between Maidenhead grids
xastir         - APRS mapping
xcwcp          - CW code practice
xdx            - DX cluster TCP/IP client
xlog           - logging program for casual operators
xnec2c         - antenna modeling software
xplanet        - used by earthtrack and predict to track satellites
xwefax         - display Wefax and Radiofax images
xwxapt         - display APT images from weather satellites

Other included software (not an exhaustive list):

evince          - PDF file reader
firefox         - web browser
imagemagick     - image manipulation programs (for use with scrot and display)
leafpad         - very simple text editor
locate		- locate and updatedb to create a database of filenames
lxkeymap        - configure keyboard
lxrandr         - modify screen resolution
minicom         - serial communcation program
nano		- text editor
ntp		- sync time with time server
pavucontrol	- sound volume controls
pmount          - user mount for removable devices
ristretto       - image viewer
scrot           - command line screen capture tool
smartpm		- the Smart package manager for software management
ssh		- SSH client and server
sylpheed        - email tool (for use with flarq)
ubiquity        - program to install software to the hard drive
usbmount        - automounting of USB devices
wicd		- GUI tool for configuring network(s)
wireless-tools	- command line tools for wireless networking
xcalc		- calculator
xclock		- a simple clock 
xfce		- lightweight window manager
xfe		- graphical file manager
xfimage		- image viewer
xfwrite		- text editor
xosview		- system monitor

Other tidbits of information (in no particular order):

- Ubiquity hard drive installer
  The Ubiquity installer is a pain in the neck to get working!
  It is a pain in the neck to keep it working!

  The ubuntu-artwork package is required (and I've included it for you).

  During a hard drive installation, the Ubiquity slideshow entertains you.
  This slideshow was customized for "Andy's Ham Radio Linux" starting with 
  version 15.1.  I hope you enjoy it!

- icewm was removed starting with version v23a, and replaced with Xfce.
  However, I have not removed the icewm menu files, which are still in
  /etc/X11/icewm.  I shall not support the icewm environment moving forward.

- To setup the system to use UTC:
    - sudo dpkg-reconfigure tzdata
    - Scroll down and choose "None of the above"
    - Scroll down and choose "UTC"
    - Once the ncurses GUI exits, the UTC settings should be working.
    - Try the "date" command to be sure.

- Files installed from source or binary are locate in:
  - /usr/local/bin
  - A few development packages are distributed which were used
    when compiling these programs from source.
  - See /usr/local/share/doc/Andy_Ham_Radio_Linux/00_SOURCES

- The MySQL password is "kb1oiq".

- If the user boots a live medium and creates files in the $HOME
  directory, they aren't copied to the hard drive
  when ubiquity does its installation.

- An example configuration files for xwxapt can be found here:
  /usr/local/share/xwxapt/xwxaptrc
  Copy this file to your ~/xwxapt directory.

- Wireless configuration:
  - Click the WiCD icon, which is found by default at the top right
    of the screen in the panel.  The icon looks a bit like a computer
    monitor.
  - Be sure to go into the WiCD->Preferences menu and set the 
    Wireless Interface
  - Generally, this will be "wlan0" or "eth1" (try ifconfig to
    see the interfaces), or these new "enps0*" names.
  - WiCD is accessed via the icon on the taskbar near the clock
  - One might have to remove the network-manager package if the
    wireless connection attempt fails with the error:
    "Bad Password".
  - Try it first to see if this is necessary
  - Some wireless hardware is painful to get working with Linux.
    It may be necessary to search Google to find out the procedure
    for your specific hardware.

- In order to install to the hard drive, boot a live medium
  and login.  There will be an icon on the desktop which 
  is labeled "Install Ubuntu remix".  Click (or double click)
  that icon to start the installation.

- This might be broken:
  - Satellites can be seen over the planet Earth on your root window!
  - The very first time, type "predict" in an xterm and set it up.
  - In the Amateur_Radio->Satellite menu, start the Predict server
    - There probably won't be any visible output.  That's OK.
  - In the Amateur_Radio->Satellite menu, start Earthtrack
    - One should see a picture of the Earth on the root window, with 
      satellites drawn on it, centered at the location of W1AW.
  - Customize the home QTH by editing ~/.predict/predict.qth.
  - Clean it up by the Earthtrack (cleanup) menu.
  - Restore your background by Menu->Settings->Themes->Default.
  - If this fails (and it fails the very first time), 
    select the Earthtrack (cleanup) menu, which kills all of the
    predict and earthtrack processes, and start again.

- Look at the HACKS file for specific hacks and customizations.
  The list may not be complete.

- VirtualBox:
  - A very recent version of VirtualBox is needed, at least version 6.1.
  - Sound: I have it working with PulseAudio on the host and ICH AC97 as the
    sound device.
  - Be sure to setup at least 2GB of memory, 4GB is better if you want to do 
    a lot of things while in VirtualBox.
 
- First boot after hard drive installation
  - add your user to the group netdev (adduser <user> netdev)
  - add your user to the group audio (adduser <user> audio)
  - add your user to the group dialout (adduser <user> dialout)
  - Have fun!!!

- VOACAP
  - I have substituted VOACAP Online, which brings up the browser on the
    appropriate web page.

- Debugging boot related issues
  - When the boot screen appears, it hides all mesages from the startup scripts
  - Press the Esc key to see those messages
  - Debug as appropriate based on these messages
  - Pressing shift many times during boot should bringup the GRUB boot screen

- Dire Wolf
  - KB1OIQ prefers:  direwolf -t 0
    (to disable all colors and blinking text)
  - Prior to running for the first time:
    cp /usr/local/share/doc/direwolf/examples/direwolf.conf ~

- pskmail_server (first included in version 17)
  - I suspect that the user will need to do the following:
    - sudo -i
    - cd /usr/local/src/pskmail_server
    - ./libinstall.sh
    - ./install.sh
    - further tweaks may be needed - send me email if you find the right recipe

- USB memory sticks and SYNC/NOSYNC
  - often, the write access to a USB memory stick seems to be very SLOOOOOWWWWWWW......
  - to speed it up, I modified /etc/usbmount/usbmount.conf to mount the device "nosync"
  - BE SURE to properly umount the device:
    - sync
    - pumount
  - NEVER just pull out the USB memory stick!

- foxtelem
  - Create a directory where you'd like to store the program data.
  - Start the foxtelem program.
  - Be sure to select "Custom" when run the first time.
  - Don't pick "Simple".  Just don't.
  - Point foxtelem at the directory where you'd like to store the program data.
  - Then, foxtelem will work OK.
  - If this isn't done correctly, there will be all sorts of error boxes
    and the program will not run.  You may have to kill it.  To recover
    from that case:  rm -fr ~/.FoxTelem
    and start over.

- xdx
  - The menus do not appear as expected in the 2.7.0 version.  This is a know issue.
  - Move the mouse and click it in the empty space where the menus should be.
  - The drop down menus will appear when you click in the magic place.

- After installing to the hard drive, one might wish to delete the 
  "ubuntu" account.  As root:  userdel ubuntu

- I cannot possibly support all of the programs in this software
  collection.  If you require assistance, please search the internet,
  and I'm sure you'll find the answer.

I hope you have a lot of fun with this software collection!

73 de Andy KB1OIQ
April 2020

KX4QC's humble opinion: Great to see this new release of a project a long time in the works. It contains a wealth of software and utilities for Amateur Radio and is well worth a good look. Linux is easy to "multi-boot", so consider trying this alongside your other favorite distro.

For a long time now, Andy's has not been included with the hundreds of mainstream distros available from Distrowatch https://distrowatch.com/ (Why??) And as of this writing, even this latest version is still not there. Go figure...

While I usually recommend Mint for a starter distro for ham radio, because it is stable, and comes with lot of ham software, take a good look at Andy's too. It comes on a "live" bootable medium so you can try it without installing anything -until you decide it's a keeper.

I've just received notice that Andy's Linux is now updated. The recent alpha version has been withdrawn and the the bug-fixed current version (v26} is available at:

https://sourceforge.net/projects/kb1oiq ... files/v26/

Please let KB1OIQ know if you find bugs or something that needs attention.

I know that it is not at present available at https://distrowatch.org like most other flavors of Linux -including good ham radio ones, but i don't know why.