{"id":27201678,"url":"https://github.com/markmac99/ukmon-pitools","last_synced_at":"2025-06-14T11:33:37.044Z","repository":{"id":41207273,"uuid":"347215877","full_name":"markmac99/ukmon-pitools","owner":"markmac99","description":"ukmeteornetwork toolset for RMS pi meteor cameras","archived":false,"fork":false,"pushed_at":"2025-06-11T22:37:31.000Z","size":59221,"stargazers_count":22,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-11T23:36:44.004Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/markmac99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-12T22:38:23.000Z","updated_at":"2025-06-11T22:37:36.000Z","dependencies_parsed_at":"2023-10-11T14:25:24.898Z","dependency_job_id":"5f0e3657-b09d-4a0d-9297-5c13ae193e89","html_url":"https://github.com/markmac99/ukmon-pitools","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/markmac99/ukmon-pitools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmac99%2Fukmon-pitools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmac99%2Fukmon-pitools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmac99%2Fukmon-pitools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmac99%2Fukmon-pitools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/markmac99","download_url":"https://codeload.github.com/markmac99/ukmon-pitools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markmac99%2Fukmon-pitools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259809199,"owners_count":22914788,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-09T21:57:20.740Z","updated_at":"2025-06-14T11:33:37.026Z","avatar_url":"https://github.com/markmac99.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Toolset for RMS pi meteor cameras\nVersion 2023.11.0\n\nThese tools manage uploads of RMS data to the UK Meteor Data Archive and to the livestream. There are two parts:  \n* The post-processing job that runs after RMS to send data to the archive.  \n* The realtime job that uploads detections to the livestream..  \n\nThere is more information about RMS and the toolset in the wiki [here](https://github.com/markmac99/ukmon-pitools/wiki \"UKMON Wiki\")\n\n## INSTALLATION\n\n### Single Station / Pi installation\nThese instructions are for single-station setups such as on a Raspberry Pi.\n\n* Login to your pi using VNC or AnyDesk or TeamViewer, open a Terminal window from the Accessories menu, then type the following\n``` bash\ncd $HOME/source  \ngit clone https://github.com/markmac99/ukmon-pitools.git  \n```\n\n#### Configuration \nOpen a terminal window and type the following\n``` bash\ncd ukmon-pitools  \n./refreshTools.sh  \n```\n* When prompted, copy the SSH public key. \n* If you don't get prompted for the key, then find the hidden file /home/pi/.ssh/ukmon.pub.\n\n* Email the key to markmcintyre99@googlemail.com along with your location (eg the name of your town or village), your GMN camera ID eg UK12345 and the rough direction your camera points in eg SW, S, NE. \n\n* We will add your key to our server and send you instructions for how to complete the setup. \n\n### Multistation Installation\nThese instructions are for multi station linux builds where multiple cameras are managed from a single\nuserid. \nNB: If you're setting up such a configuration you MUST let me know the affected camera IDs so i can make some server-side adjustments. \n\nTo explain the process, lets assume you have cameras US0001 and US0002\n* Login as the managing user and run the following to set up US0001\n``` bash\ncd $HOME/source\ngit clone https://github.com/markmac99/ukmon-pitools.git  ukmon-pitools-US0001  \ncd ukmon-pitools-US0001  \n./refreshTools.sh  \n```\n* This will create a default ukmon.ini file. Edit this file and make the following changes:\n``` bash\nexport UKMONKEY=~/.ssh/ukmon-US0001  \nexport RMSCFG=~/source/Stations/US0001/.config  \n```\n* Now rerun ./refreshTools.sh. This time it will create an SSH key called ~/.ssh/ukmon-US0001. \n \n* If you're setting up from scratch then email the public key to markmcintyre99@googlemail.com. We'll email back instructions in how to complete the process. \n  \n* If you're migrating an existing installation from a pi, then you can copy over the existing keys as follows (replace 'yourpiname' with your Pi's network name or ip address):\n``` bash\nscp yourpiname:.ssh/ukmon \\~/.ssh/ukmon-US0001  \nscp yourpiname:.ssh/ukmon.pub \\~/.ssh/ukmon-US0001.pub  \n```\n* Now edit the ini file again and set the LOCATION to the correct value. \n* Then rerun ./refreshTools.sh. \n* This time, it should complete successfully. \n\n* If you have more than one camera, repeat these instructions for each camera\n\nHOW THE TOOLS WORK\n==================\n\nukmonPostProc.py\n================\nThis uses the RMS post-processing hook to creates JPGs and other data, then upload to the UK Meteor Network archive. The script has three optional capabilities: \n\n\nMP4s\n------------------\nThe script can create MP4s of each detection.\nTo enable these, edit ukmon.ini and set DOMP4S to 1\n``` bash\nDOMP4S=1\n```\nRunning an Additional Script of your own\n----------------------------------------\nIf you want to run an additional Python script after this one finishes, create a file named \"extrascript\"  in the same folder, containing a single line with the full path to the script. For example to enable the feed to istrastream, you could open a Terminal window and type the following:  \n``` bash\necho \"$HOME/source/mystuff/myscript.py\" \u003e $HOME/source/ukmon-pitools/extrascript  \n```\nThis should create file called 'extrascript' in the ukmon-pitools folder, containing one line \"$HOME/source/mystuff/myscript.py\"\n\nThe script must contain a function rmsExternal with the following definition\n``` python\ndef rmsExternal(cap_dir, arch_dir, config):\n    # do stuff here\n```\nThis will be passed the capture_dir, archive_dir and RMS config object in the same way as RMS passes these to any external script. \n\nuploadToArchive.py\n==================\nThis does the actual uploading to the UK meteor network archive. Can be called standalone if you want to reupload data:\neg  \n``` bash\npython uploadToArchive.py UK0006_20210312_183741_206154  \n```\nthis will upload from $HOME/RMS_data/ArchivedFiles/UK0006_20210312_183741_206154\n\nliveMonitor.sh\n==============\nThis script monitors in realtime for detections, then uploads them to the livestream. The script calls a \npython script liveMonitor.py.  \n\nThere are two configuration parameters that you can set in ukmon.ini to control how this works: \n* UKMFBINTERVAL: how frequently the process checks whether there's a request for fireball data. Default 1800 seconds. Set to zero to disable the fireball upload feature completely.  \n* UKMMAXAGE: How far back to look for events to upload. Default 1800 seconds. Each time the software is restarted, it will look for events in the log. This parameter avoids too much reuploading of old events.  \n\nYou shouldn't really need to set these but if you do, then for example edit ukmon.ini and add  \n``` bash\nexport UMFBINTERVAL=900\n``` \nto set the check interval to 900 seconds. Note there must be no spaces around the equals sign, and that\nexport must be in lowercase.  \n\nsendToLive.py\n-------------\nPart of liveMonitor, this python script does the actual uploading. You can use it manually as follows:  \n``` bash\npython sendToLive.py capture-dir ff-file-name \n```\nrefreshTools.sh\n===============\nUpdates the UKMON RMS Toolset to the latest version. After first run, this will run automatically\nevery time your Pi reboots. You can also run it manually. \n\nrefreshTools reads from a configuration file that is specific to your camera. We will send\nyou this file when you onboard to the network. The file contains your location ID and the\ndetails of our sftp server used to distribute security keys. \n\nQuestions\n=========\nAny questions, concerns or suggestions:\n* Check the wiki here https://github.com/markmac99/ukmon-pitools/wiki\n* Join our group on Groups.io https://groups.io/g/ukmeteornetwork/topics\n* As a last resort, email me via markmcintyre99@googlemail.com  \n\nCopyright\n=========\nAll code Copyright (C) 2018-2023 Mark McIntyre\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkmac99%2Fukmon-pitools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarkmac99%2Fukmon-pitools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkmac99%2Fukmon-pitools/lists"}