Differences

This shows you the differences between two versions of the page.

--- mwtchahrd [2026/02/11 02:55] – created w1cdn
+++ mwtchahrd [2026/02/28 19:14] (current) – add links and update formatting w1cdn
@@ Line 1: / Line 1: @@
+====== mwtchahrd ======
+mwtchahrd is an application that works with or without a wrapper script, to send spots to an instance of [[https://git.ianrenton.com/ian/spothole|Spothole]] running on the FARPN [[mesh#yggdrasil|yggdrasil]] mesh. Or you can send spots to a spothole instance hosted elsewhere.
-"rigctl and gps stuff are optional These are not. curl jq awk grep tr tail date timeout"
+If you're on the FARPN mesh, you can find it here:
+http://[300:6f6a:b087:4dda::8]/
+{{:spotholemap.png?400|Screenshot of a map of the lower 48 US states, which some markers and lines connecting them.}}
+To have your node report spots to this fun tool, you need to do several things:
+  - Make sure you're on the FARPN yggdrasil mesh (refer to the yggdrasil setup in the [[tutorial-packet-on-pi|tutorial]])
+  - Install a couple required programs
+  - Get a copy of the executable mwtchahrd
+  - Get a copy of the wrapper script mwtchahrd_spot.sh and make some tweaks to it
+  - Create the systemd service file to run everything
+  - enjoy!
+===== 1. Prerequisites =====
+The script uses these applications; ''curl jq awk grep tr tail date timeout''.
+If you followed the FARPN tutorial, you likely only need to install ''jq''
+<code>
+sudo apt install jq
+</code>
+===== 2. Get mwtchahrd executeable =====
+there are a couple versions of this available since a couple different FARPN members have been playing with it. You can follow the steps at these links to create your executable, or you can ask in the FARPN chat for a copy of the newest, since its been very recently getting tinkered with.
+[[https://gitea.farpn.net/n6cta/mwtchahrd]]
+[[https://gitea.farpn.net/w1cdn/mwtchahrd]]
+If you are installing on a Pi as per the tutorial, you'll want the executable from the generated ''aarch64-unknown-linux-gnu'' folder.
+Once you have the mwtchahrd executable in hand, put it in your ''~/.local/bin/'' folder
+===== 2. Get the N6CTA mwtchahrd_spot.sh wrapper script =====
+You'll likely just want to ping one of the FARPN members for a copy of this script. At some point it'll get properly published and we'll put a link to it here.
+Once you have ''mwtchahrd_spot.sh'' in hand, you'll want to put it in ''~/.local/bin''.
+open it up, so that you can make some edits to it:
+<code>
+nano ~/.local/bin/mwtchahrd_spot.sh
+</code>
+You'll want to locate the lines below, and tweak them up a bit so they look like these modified versions:
+<code>
+API_BASE="http://[300:6f6a:b087:4dda::8]/api/v1"
+DE_CALL="YOURCALLSIGN"
+MWTCH_CMD=""/home/YOURUSER/.local/bin/mwtchahrd -i 127.0.0.1 -p 8000 -u"
+</code>
+after you've made those changes, make the script executeable:
+<code>
+chmod +x ~/.local/bin/mwtchahrd_spot.sh
+</code>
+===== 3. Create the Systemd Service File =====
+<code>
+sudo nano /etc/systemd/system/mwtchahrd-hf-spot.service
+</code>
+paste from below into the newly created file, and then change USER to your user, callsign, etc.
-Example systemd service:
 <code>
-user@server:~ $ cat /etc/systemd/system/mwtchahrd-hf-spot.service
 [Unit]
 Description=MWTCHAHRD Spot Forwarder
@@ Line 15: / Line 82: @@
 Group=USER
 ExecStart=/home/USER/.local/bin/mwtchahrd_spot.sh \
-    --api http://spot.n6cta.ygg/api/v1 \
+    --api http://[300:6f6a:b087:4dda::8]/api/v1 \
     --call USER-7 \
     --lat 34.103 \
     --lon -117.793 \
-    --rigctl "rigctl -m 2 -r 192.168.1.178:4532 f" \
+    --rigctl "rigctl -m 2 -r 127.0.0.1:4532 f" \
-    --mwtch "/home/USER/.local/bin/mwtchahrd -i 192.168.1.178 -p 8000 -u" \
+    --mwtch "/home/USER/.local/bin/mwtchahrd -i 127.0.0.1 -p 8000 -u" \
     --dx-loc-overrides "/home/USER/.config/spothole/overrides.txt" \
     --ignore-destinations "MAIL,MBX,CQ,APWW11,BPQWX,DX,FLOCK" \
@@ Line 30: / Line 97: @@
 WantedBy=multi-user.target
 </code>
+and then lastly, enable the service, then start it
+<code>
+sudo systemctl enable mwtchahrd-hf-spot.service
+sudo systemctl start mwtchahrd-hf-spot.service
+</code>
+===== 4. Enjoy! =====
+You should now be able to visit the link at the start of this article (if you're on the [[mesh#yggdrasil|yggdrasil]] mesh) and see your spots listed along with the other FARPN generated spots!