APRSNotifyisapythonbasedbotscriptdesignedtosendparsedAPRSpacketdatatovariousSocialMediaorCommunicationsnetworks.
ThissoftwareisforusebyAmateurRadioOperatorsonly.
ThisbotwasdesignedtobeusedbyonepersonwithmultipleAPRSTrackerstotrackpacketsforthatoneperson.
PleaseseetheWikiformoreinformationandinstallationandconfigurationsteps.
WorkingExamples:Twitter:@n8acl_aprsMastodon:Youwillneedtofollown8acl_aprs@botsin.space.CurrentlySupportedNetworksTwitterTelegramMastodonDiscordFeaturesPullsmostpacketdatafromAPRS.fiAPIforthefollowingtypesofpackets:PositionDataWeatherStationDataReverseGeocodewithOpenStreetMapsAPI.GetWeatherConditionsfromOpenWeatherMapsAPIforthelocationofthepositionpacketFindMaidenheadGridSquareofpacketlocation.SendStatustoSocialMediaNetworks(SeeaboveforsupportedNetworks)GetnotificationofanAPRSmessagesenttoyourstation(requiresTelegramtowork).IfsomeonesendsamessageviaAPRStooneofthecallsignsbeingtracked,thescriptwillnotifyyouandshowyouthemessageonTelegram.UseCasesSendinganAPRSpackettoTwitter/Mastodonforyourfollowerstosee.SendingWeatherdatafromAPRStoSocialMedia.SendingAPRSdatatoyourselftoconfirmthatitismakingittotheinternet(viaTelegramforexample).SendingyourpositioninformationtoaTelegram/DiscordChannelthatyouhaveyournon-hamradiofamilyandfriendsonsotheycantrackyouwhenyouaretravelingbycarforalongdistance.SendingyourAPRSdatatoaclubMastodonInstancefeedfortheclubtosee.SendingpositiondatatoaradioclubTelegram/DiscordChannelsothateveryonecanseeyourdataposted.Otherusesthatyourimaginationcomesupwith.UPGRADETOVERSION5.0Toupgradetoversion5.0ofthescript,pleaseruntheupdate.pyscript.Itwillupdateyourdatabasetothemostcurrentversion.
Ifyouareinstallingthewholescriptforthefirsttime(i.e.haveneverusedAPRSNotifybefore),donotrunthisscript,butpleaserunan_util.py.OnlyrunthisupgradeifyouhaveusedAPRSNotifybeforeandhavepreviouslyupgradedtoversion4.
UpgradingaversionolderthanVersion4tocurrentVersion5Pleasenotethatanyversionpriorto4hashadtobedepreciatedandisnolongersupported.Withallthechanges,itisdifficulttosupportthoseolderversionswiththenewversion.
TheeasiestwaytoupgradeaversionofAPRSNotifythatisolderthanVersion4istomakesuretobackuptheconfig.pyfiletoanotherlocationandthendeletingtheoldAPRSnotifyscriptfolder.Thenclonetherepotogetthelatestscriptfiles.Thisallowsyoutosetupthescriptasbasicallyabrandnewsetup,justfollowthedirectionsinthewikiforanewsetupandusingthean_util.pyfile.Youcanuseyouroldconfig.pyfileasreferencetocopyandpasteyourkeysandthingsinasneeded.
CreditsTheOriginalTelegramNotifybotfunctionalitywasbasedoffagistbyGithubuserLucaspg96.ClickHere.
AddingGridSquaretoStatusmessagewassuggestedbyAlex,N7AGF.
TheGridSquareFunctionwasdevelopedbyWalterUnderwood,K6WRUandpostedonham.stackexchange.com.ClickHere
ThemapimagefunctionalityfortheTelegramBotandsuggestionstoincludeornotincludeWeatherdataamongothersuggestionswerecontributedbyChanyeolYoo,Ph.D.,VK2FAED
APRS.FIAPILimitationsissuesfoundandtroubleshotbyAlexBowman,KN4KNG.
InstallationoftheVerison4scriptstroubleshotbyDiego,EA3ICN.
APRSandtheAPRSSystemandassociatedcopyrightweredevelopedbyBobBruninga,WB4APRhttps://www.aprs.org.
ContactIfyouhavequestions,pleasefeelfreetoreachouttome.Youcanreachmeinoneofthefollowingways:
Twitter:@n8aclTelegram:@ravendosMastodon:@n8acl@mastodon.radioE-mail:n8acl@qsl.netOropenanissueonGithub.Iwillrespondtoit,andofcourseyou,whenIcan.Remember,thisisahobbyandthereareotherdailydistractorsthatcomefirst,likework,schoolandfamily.
Ifyoureachouttomeandhaveanerror,pleaseincludewhaterroryouaregettingandwhatyouweredoing.Imayalsoaskyoutosendmecertainfilestolookat.Otherwisejustreachouttome:).
ChangeLog05/30/2021
MinorupdatestoREADMEandthewiki.05/19/2021-Version5.0Release
UpdateofAPRSNotifyDatabasetoconsolidatecallsignliststoonetableRedesignofan_util.pyintoaFlaskapptoallowforwebbrowserbasedGUItoconfigurethescript.AdditionofDiscordtosupportednetworks.AutomaticallydoesnotsendamapimagewithWXStationDataormessagenotificationtoTelegramUpdatedWikiwithnewinformation.01/15/2021-Version4.0Release
RemovalofAPRSBottoadifferentprojectMovedfromtextfilesfordatastoragetoSQLlite3DatabaseVarioussmallbugfixesandreworkofthecode.Added:abilitytosendstatustoMastodonAdded:an_util.pyconfigurationutilityforinteractingwiththedatabaseAdded:Newwikiuserguide.Added:ParsingofWeatherDatapacketfromAPRS.12/11/2020-Release3.1-FixesaroundAPRS.FIAPIlimitations
APRSnotifyUpdatedaprsnotify.pytosplitpositiontrackingandmessgemonitoringlistsoutto2seperatelistsduetoAPRS.fiAPIrestrictionsAPRSbotUpdatedaprsbottofixAPRS-ISTimeoutsforsendinglocationsandmessagesREADME.mdAddedlimitationstotheAPItotheAPRS.fiAPIkeysection.OtherupdatesandclearificationstoREADME.mdConfiguration.mdSplitcallsignlistsouttopositiontrackinglistandmessagelist.ThisisduetolimitationsontheAPRS.fiAPI12/09/2020-Minorupdate
FixedBug:fixederrorinsetup.py.Namedtheconfigfilewronginvariable.(FoundbyAlexBowman,KN4KNG)11/15/2020-Version3.0Release
Added/NewFeatures:Addedarequirements.txtfiletomakeinstallinglibrarieseasierforendusersAddedcheckstomakesureallpythonlibrariesneededareinstalledalreadyandnotifytheuserifnotandhowtoinstallCreatedandaddednewinteractivebotfunctionality,APRSBotUpdates/Changes:Changedfromurllibtorequestslibrarytoparsejson.ThismakesiteasiertousethesameurlfordifferentpurposesRemovedtheaprsandmsgurlvariablesandcombinedintoaprsfi_urlvariableforusewithnewlibraryFixedbug:addedsrccallvariableinstantiation.ThisfixesabugwhereifthesrccallisnotpulledproperlythescriptbombsRemovedusingGoogleGeocoderforReversegeocoding.OnlyusingOpenStreetMapsnowUpdatedREADME.mdandConfiguration.mdfiles08/20/2020
UpdatestotheReadMefile07/06/2020-Version2.0Release
Added/NewFeatures:AbilitytochoosebetweenMetricandImperialunitsAbilitytoturnoffWXInformationandnotincludeitinthestatusmessage.NowsendsnotificationifsomeonesendstheuseramessageonAPRS(requiresTelegrambotforthistowork).SendsmapimageofthepacketlocationtoTelegram(requiresTelegrambotforthistowork).Updates:Fixed:IfthereisnotaspeedentryintheJSONpayloadfromAPRS.FI,thescriptassumesit'safixedstationanddoesnotincludespeedinthestatusmessage.InVer.1.0thiswasabugthatwouldcausethescripttofailiftherewasnotaspeedentryintheJSONpayload.Updatedtheconfigfiletoincludeswitchesfornewfeatures.Updatedtheconfigurationwalkthroughinthisrepo.UpdatedSetup.pytoincludeswitchesfornewfeatures.Willalsoupdateanexistingconfig.pyfiletothenewversion.NOTE:Ifyouarerunningversion1,whenupdatingtoVersion2ofthescript,makesuretorunsetup.pytoupdateyourexistingconfig.pyfiletothecorrectconfigversion.Reworkedandtightenupcodeinthemainscript02/29/2020-InitialRelease1.0
CombinedfunctionalityofAPRSTweetandAPRSTelegramAdded:AbilitytochoosetosendtoTwitter,TelegramorAllAdded:AbilitytochoosebetweenOpenStreetMapsandGoogleGeocodingAPIforreversegeocodingofpacketlocationAdded:Addedthehashtag#APRStotheendofthestatusmessageforTwitterAdded:FindstheMaidenheadGridSquarebasedonpacketlocationandincludesitinthestatusmessageAdded:Createdsetuputilitytohelpinconfigfilecreation.Update:FixedURLforaprs.fiinthestatusmessagefromhttps://tohttps://
评论