directKiwi v7.21
This piece of software is JUST a GUI written for Python 2/3 designed to fast connect audio socket to KiwiSDR servers around the world using modified versions @ https://github.com/dev-zzo/kiwiclient or related fork @ https://github.com/jks-prv/kiwiclient
Thanks to Pierre Ynard (linkfanel) for the listing of available KiwiSDR nodes used as source for the TDoA map update process (http://rx.linkfanel.net)
Stuff required to run the software:
INSTALL AND RUN (on WINDOWS)
Install python 2 or 3
If you don't have git for windows installed, just download https://github.com/llinkz/directKiwi/archive/master.zip and unzip the package somewhere
Else in 'Git Bash' type : git clone --recursive https://github.com/llinkz/directKiwi
Double-click on setup.bat (this script will install python modules)
Double-click on directKiwi.bat
INSTALL AND RUN (on LINUX) Thanks Daniel E. for the install procedure
Install python 2 or 3
Install python-pip (search for the right package for your distro)
git clone --recursive https://github.com/llinkz/directKiwi
cd directKiwi
./setup.sh (this script will install python modules, it may fail, if so, install modules manually using your package manager)
./directKiwi.py (note: check the shebang if it fails on your system. On my Archlinux it should be "#!/usr/bin/python2" for example)
INSTALL AND RUN (on MAC OS) Thanks Nicolas M. for the install procedure
Install Homebrew, in terminal : /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Install Python 2 or 3, in terminal : brew install python@#
git clone --recursive https://github.com/llinkz/directKiwi
cd directKiwi
./setup.sh (this script will install python modules, it may fail, if so, install modules manually using your package manager)
./directKiwi.py
TIP
- Zoom function is actually disabled because it has some bugs, but if you need the feature active just uncomment
line 459 for Windows or lines 460 + 461 for Linux (and MacOS ?)
LICENSE
- This python GUI code has been written and released under the "do what the f$ck you want with it" license
WARNING
- This code has been tested on Raspberry Pi B+ but there was some issues with a third-party USB sound card, so it was not working here. For testers : feedback appreciated, thanks.
TODO LIST
- enable IQ mode with direct recording to file ?
- real-time management of the KiwiSDR (freq change, demodulation change, AGC/MGC change.. work in progress)
CHANGE LOG
- v1.00 : first working version, basic, only freq/mode/bw, connect/disconnect
- v1.10 : design modification + console output
- v1.1beta : adding the smeter
- v1.20 : adding the spectrum extension
- v1.30 : adding the recorder extension
- v1.31 : dealing with processes & sub-processes + code clean-up
- v1.32 : changed LP & HP from QSlider to QScrollBar style for 100Hz steps clicks + some comments added + code clean-up
- v1.33 : AM modulation has fixed BW (10kHz) - CW has frequency offset -1kHz BW set to 200Hz centered on desired freq
- v1.40 : most "update proc" bugs has been removed (major concerns wrong user entries in their kiwisdr setup/reg)
- v1.40beta : The KiwiSDR manual server listing update has been added - note: requires pygeoip module, still some bugs
- v1.41 : adding the possibility to manually enter IP:PORT/HOSTNAME:PORT to connect to a specific KiwiSDR server
- v1.42 : adding some regexp checks to validate frequencies and IP:PORT/HOSTNAME:PORT in both top inputboxes
- v2.00 : BUG SOLVED: "QScrollbar & TextEdit refresh still not working with direct program lunch"
- v2.01 : KiwiSDRclient.py cleaned + S-meter bars removed
- v2.10 : adding the AGC control (manual or auto)
- v2.20 : spectrum & recording modules has been removed, too many issues with client-side sound card settings
- v2.30 : it's now possible to switch from node to node directly by double-clicking on the listing lines (prev forgiven)
- v3.00 : GUI based on TK now, no more PyQT stuff needed
- v3.10 : adding labels, node listing and console scrollbars, cancel connect possibility + all CRLF converted to LF
- v3.11 : some modifications in the console output log format + an update process bug has been solved
- v3.20 : update process finally re-written and still using GeoIP - node listing now redrawing itself, no more restart needed
- v3.30 : host ports are checked before filling the node listing, normally all nodes listed are reachable now
- v3.40 : adding top bar menus for colors changing and saving directKiwi.cfg configuration (colors + geometry)
- v3.50 : adding default lowpass, highpass, modulation to directKiwi.cfg configuration file
- v3.60 : adding default agc/mgc, mgc gain, hang, agc threshold, agc slope, agc decay to directKiwi.cfg configuration file
- v3.61 : agc/mgc listbox now (previously checkbox) + xxx.proxy.kiwisdr.com hosts (out of USA) locations fixed + autosorting list at start
- v3.62 : fixed a TK issue than was caused by python 2.7.15 version (code was written under 2.7.14
- v3.63 : fixed an issue with the India located remote that has few informations in kiwisdr.com/public listing page (source for updates)
- v4.00 : the GUI is now using directTDoA design, nodes are displayed on a World map instead of a table
- v5.00 : code clean up + cfg file now in json format + faster way to switch between nodes (left click only) - no more s-meter - icon size change possible
- v5.10 : no more pygame & scipy (for MacOS), sounddevice python module + libsamplerate instead -> works with 20kHz KiwiSDRs + no audio compression set by default
- v6.00 : IS0KYB microkiwi_waterfall script added (SNR measurement + waterfall display), IS0KYB SNR website source is not used anymore + code clean up
- v6.10 : adding a line to open Web Browser with pre-set TDoA extension loaded (requested by user)
- v7.00 : directKiwi now uses same GUI as directTDoA - python 3 compatibility added - bug fixed on the map update due to some format modifications on the website sources
- v7.10 : Restart GUI routine modified + directKiwi.bat & setup.bat added for Windows users + bug fix that caused the map to move suddenly far away when selecting a node (problem only noticed on Windows OS) + added functionality to manage the overlapping of icons on the map. Now when you click near a cluster of multiple nodes, a menu will appear and allow you to choose the one you really want (to listen or to display node menu) + bug fixes
- v7.20 : Bug fixes for demodulation bandpass filters + modification on microkiwi_waterfall.py, to deal with nodes that have blocked frequency ranges
- v7.21 : Bug fixes
Enjoy
linkz
October 2020 update