[{"_1":2,"_159":-5,"_160":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_137":138},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_130":-5,"_131":11,"_132":17,"_133":11,"_134":-5,"_135":136},"canonicalUrl","https://hub.docker.com/r/n8acl/hammy_bot/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","n8acl","reponame","hammy_bot","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2022-06-22T00:05:24.009382Z","description","","is_private","last_updated","2023-03-16T20:20:58.26507Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.distribution.manifest.list.v2+json","name","pull_count",942,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Hammy, a Ham Radio Discord Bot\nPython based Ham Radio Callsign/APRS Discord lookup bot.\n\n---\n\n# Description\n\nThis is a Python based, self-hosted, Ham Radio Discord bot that can be added to Ham Radio Discord Servers to add some functionality for various Amatuer Radio Callsign related searches. \n\n### Searches\n- Search for callsign and get callbook info.\n- Search for callsign+ssid on the APRS network to see the last beaconed packet by a station.\n\nNote that this software is intended for use by Amateur Radio Operators only.\n\n## API's Used\n\nThis bot pulls data from the following locations:\n\n| Service | Description | Website |\n|---------|---------|---------|\n|Callook.info|Used for Call Book data lookup|[https://callook.info/](https://callook.info/)|\n|HamQTH.com|Used for Call book data lookup for callsigns not found at callook.info|[https://www.hamqth.com](https://www.hamqth.com)\n|APRS.FI|Used for APRS Data lookup|[https://aprs.fi](https://aprs.fi)|\n|Radioid.net|Used for DMR/NXDN ID Lookups|[https://radioid.net](https://radioid.net)|\n\n---\n\n# Installation/Setup\n\n### Installation Steps\n1) Obtain API Keys/Logins\n2) Install needed packages, clone Repo and install library dependencies\n3) Configure the script\n\nRemember that all the commands shared here are for Linux. So if you want you can run this on a Linux Server or even a Raspberry Pi. (Mine is running on a Raspberry Pi 4 2 GB model with many other bots and scripts running with no issues.)\n\nIf you want to run this on a Windows or Mac machine, you will need to install Python3 and be familiar installing from a requirements.txt.\n\n### Obtaining API Keys/Logins\n\nThe first step in this process will be obtaining the API keys that you need. \n\n##### APRS.fi API Key\n* First and foremost, you will need an [APRS.fi](https://aprs.fi) account. On your account page is the API key you will need.\n \n##### HamQTH.com Login\n* To be able to use HamQTH.com for searching (especially International Callsigns), you will need to obtain a username and password for HamQTH.com. [Click here to register.](https://www.hamqth.com/register.php)\n\n##### Discord\n\n* Go to: [https://discord.com/developers/applications](https://discord.com/developers/applications)\n* Click ```New Application```\n* Give it a name (I called it Hammy)\n* On the next screen, you can upload an avatar for the bot.\n* Click the ```bot``` selection under settings\n* Click ```Add Bot```\n* Give it a Name (I used the same name )\n* Then Copy the Bot Token (you will need this for the config.py part of the script along with the APRS.fi keys)\n* Turn off ```Public Bot```\n* Make sure to turn on the ```Message Intents``` Setting under ```Privileged Gateway Intents```.\n* Save Settings\n* Click ```OAuth2``` and then ```URL Generator```\n* For Scope Choose ```bot``` and ```appplications.commands```\n* For Permissions, choose the following:\n - Under General Permissions:\n - Read Messages/View Channels\n - Under Text Permissions:\n - Send messages\n - Send Messages in threads\n - Embed Links\n - Attach Files\n - Read message History\n - Use Slash Commands\n* Copy the generated URL\n* Paste it into a browser window Address bar\n* Choose the Server you want to authorize it to and then click authorize.\n* It should pop into the server.\n* Next you will need to get your server id.\n * To get this, you will need to, on Discord, go into ```User Settings```->```Advanced``` and turn on ```Developer Mode``` (if it is not already on.)\n * Then just right click on your server's icon and click ```Copy ID```. Then go back into your ```config.py``` and paste that ID in the ```discord_server_id``` field.\n\nOnce you have the keys you need and the bot authorized into your server, you will eventually copy them into the appropriate places in the config.py file, but now we need to get the files and get things installed.\n\n---\n\n### Installing the Script\n\nThe next step is installing the needed packages, cloning the repo to get the script and then installing the needed libraries for the script to work properly.\n\nThis is probably the easiest step to accomplish.\n\nPlease run the following commands:\n\n```bash\nsudo apt-get update && sudo apt-get -y upgrade && sudo apt-get -y dist-upgrade\n\nsudo apt-get install python3 python3-pip git screen\n\ngit clone https://github.com/n8acl/hammy-discord-bot.git\n\ncd hammy-discord-bot\n\npip3 install -r requirements.txt\n```\n\nNow you have everything installed and are ready to configure the script.\n\n## Configure the Script\nOnce you have your API Keys, have cloned the repo and installed everything, you can now start configuring the bot. Open the config.py file in your editor of choice and copy in the keys you obtained from APRS.fi and Discord into the appropriate spots.\n\n## Running the Script\n\nOnce you have the config file edited, start the bot by typing the following:\n\n```bash\nscreen -R hammy-discord-bot\n```\n\nThen in the new window:\n```bash\ncd hammy-discord-bot\n\npython3 hammy_bot.py\n```\n\nOnce that is done, hit CTRL-A-D to disconnect from the screen session. If something ever happens, you can reconnect to the session by typing:\n\n```bash\nscreen -R hammy-discord-bot\n```\n\nAnd see why it errored or quit and restart. This is useful if you need to contact me for support.\n\n---\n\n# Bot Commands\n\nAll Commands can be issued from any text channel and the message will be returned in a message that only you can see. While callbook data is available online publicly, this helps to keep it at least a little private on the server.\n\n| Command | Description | Example |\n|---------|-------------|---------|\n|/callsign < callsign >|Returns callbook data for the callsign queried,
including DMR ID and NXDNID, in a DM.|/callsign W1AW|\n|/dmr < dmrid > | Returns callbook data for the DMR ID queried,
including DMR ID and NXDNID, in a DM.
This is useful to determine who is talking if you see a DMR ID
on your Radio that is not loaded into the radio contact list.|/dmr 1234567|\n|/nxdn < nxdnid > | Returns callbook data for the NXDN ID queried,
including DMR ID and NXDNID, in a DM.
This is useful to determine who is talking if you see a NXDN ID
on your Radio that is not loaded into the radio contact list.|/nxdn 1234567|\n|/aprs |Returns last postion beaconed for the station queried.
Note that SSID is optional, but it will not do a
wildcard or fuzzy search.| /aprs W1AW
/aprs W1AW-9|\n|/hammy|Brings up help text with the above command list.|/hammy|\n\n---\n\n## Contact\nIf you have questions, please feel free to reach out to me. You can reach me in one of the following ways:\n\n- Twitter: @n8acl\n- Discord: Ravendos#7364\n- Mastodon: @n8acl@mastodon.radio\n- E-mail: n8acl@qsl.net\n\nOr open an issue on Github. I will respond to it, and of course you, when I can. Remember, this is a hobby and there are other daily distractors that come first, like work, school and family.\n\nIf you reach out to me and have an error, please include what error you are getting and what you were doing. I may also ask you to send me certain files to look at. Otherwise just reach out to me :).\n\n---\n\n## Change Log\n\n* 05/30/2022 - Removed returning data in a DM to returning it as an ephemeral message using slash commands.\n\n* 05/25/2022 - Version 4.0 Release\n * Migrated to ```pycord``` discord library for slash command support. This replaces the ```interactions.py``` library and the ```discord.py``` library.\n\n* 03/14/2022 - Version 3.0 Release\n * Migrated to ```interactions.py``` for slash command support\n * Removed Repeater lookup for now. ```interactions.py``` does not support file sending at this point and the returns are too large to send via a message.\n\n* 02/19/2022 - Version 2.0 Release\n * Added ability to look up North American Repeaters via RepeaterBook.com\n\n* 01/18/2022 - Minor Release\n * Added HamQTH.com for international callsign lookups. If a callsign is not found at callook.info, it will then try to retreive information on that callsign from HamQTH.com.\n\n* 01/15/2022 - Initial Release 1.0","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",1135668319,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":119,"_120":90,"_121":29,"_122":52,"_53":123,"_124":125,"_126":105,"_127":119,"_128":62,"_129":17},"content_type","creator",10750098,"digest","sha256:e17bf77e92dca0b7a52a152344606617a4479b343368d2b8eaeb269fbf622512","full_size",367429103,"id",239212928,"images",[99,114],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},"architecture","amd64","sha256:2586f55621217b371765f9f82aacfdb7809477e6f3c3d83f6a466d615cbb4ce9","features","last_pulled","2026-09-17T12:43:54.166781724Z","last_pushed","2023-03-16T20:20:58Z","os","linux","os_features","os_version","size","variant",{"_100":115,"_91":116,"_103":44,"_104":117,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":118,"_59":62,"_113":-5},"arm64","sha256:55bd9cafa73c8879351c72f57a9a472394739623c85f2f8cd3a3274acf3eb849","2026-09-17T12:43:54.147699698Z",359082954,"2023-03-16T20:20:58.006762Z","last_updater","last_updater_username","media_type","latest","repository",17418320,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":139,"_146":147,"_135":157,"_158":11},{"_36":140,"_38":141,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":142,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":143,"_75":11,"_76":145,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":144},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_148":60,"_149":-5,"_150":-5,"_151":152},"count","next","previous","results",[153],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":154,"_46":119,"_120":90,"_121":29,"_122":52,"_53":123,"_124":125,"_126":105,"_127":119,"_128":62,"_129":17},[155,156],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},{"_100":115,"_91":116,"_103":44,"_104":117,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":118,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
2586f5562121	linux/amd64	350.41 MB
55bd9cafa73c	linux/arm64	342.45 MB

n8acl/hammy_bot

Tags for n8acl/hammy_bot