{"id":16224723,"url":"https://github.com/mattblack85/astro_monitor","last_synced_at":"2025-03-19T12:30:48.568Z","repository":{"id":42956306,"uuid":"440458667","full_name":"MattBlack85/astro_monitor","owner":"MattBlack85","description":"A small program to help you during your astrophotography sessions","archived":false,"fork":false,"pushed_at":"2024-03-15T08:48:27.000Z","size":67,"stargazers_count":9,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-11T13:11:59.907Z","etag":null,"topics":["astrophotography","backup","ekos","indi-backup","kstars","kstars-backup","monitoring","phd2-backup","rust","telegram"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MattBlack85.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-12-21T09:22:39.000Z","updated_at":"2024-10-02T22:02:13.000Z","dependencies_parsed_at":"2024-10-27T20:43:28.311Z","dependency_job_id":null,"html_url":"https://github.com/MattBlack85/astro_monitor","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattBlack85%2Fastro_monitor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattBlack85%2Fastro_monitor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattBlack85%2Fastro_monitor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattBlack85%2Fastro_monitor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MattBlack85","download_url":"https://codeload.github.com/MattBlack85/astro_monitor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243989576,"owners_count":20379648,"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":["astrophotography","backup","ekos","indi-backup","kstars","kstars-backup","monitoring","phd2-backup","rust","telegram"],"created_at":"2024-10-10T12:25:18.463Z","updated_at":"2025-03-19T12:30:48.222Z","avatar_url":"https://github.com/MattBlack85.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Astro monitor\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/MattBlack85/astro_monitor/assets/4163222/5798898a-2569-49e3-b60c-f783b9134bf6\" alt=\"Your image title\" width=\"200\"/\u003e\n\u003c/p\u003e\n\n\nA small program that can help you with your astro session. \nThe main functionality is the watchdog; if astromonitor notices Kstars is dead il will send a request to notify you via telegram. \nThe other cool feature is the backup, astromonitor can backup:\n- your INDI configuration for your devices\n- the profile containing your equipment and setup\n- PHD2 profile\n- generic Kstars option (theme, colors, etc.)\n\n  \nyou can restore the backup on an other PC or when installing the suite again.\n\n# Have a look at how it works\nhttps://github.com/MattBlack85/astro_monitor/assets/4163222/587784c4-6a9b-4485-9444-9d0d61d9897e\n\n# Install\nyou trust me? run the following command\n\n```shell\nwget -O - https://raw.githubusercontent.com/MattBlack85/astro_monitor/main/install.sh | sh\n```\n\nsudo will be needed as last step to move `astromonitor` to `/usr/local/bin`\n\n\n# How to use astromonitor\nUsing astromonitor is easy, just follow these instruction\n\n## First step - obtain a token using telegram\nOn telegram, look for @AstroMonitorBot (the icon is the bubble nebula from hubble) and send a `/register` command, it will answer with a token, store it in a safe place, that's your key for the backups.\n\n## Make a backup\nOpen a terminal and run `astromonitor --do-backup XXXXXXXXXXXXXXXXXX` paste your key obtained in the previous step instead of XXXXXXXXXX\n\n## Retrieve a previously made backup\nOpen a terminal and run `astromonitor --retrieve-backup XXXXXXXXXXXXXXXXXX` paste your key obtained in the previous step instead of XXXXXXXXXX\n\n## Monitor Kstars during a session\nOpen a terminal and run `astromonitor --kstars XXXXXXXXXXXXXXXXXX` paste your key obtained in the previous step instead of XXXXXXXXXX\n\nThis will start monitoring Kstars and if it crashes, it will send you a notification via telegram\n\n# List of all functionalities:\nyou can obtain the same list by running `astromonitor --help`, here what we actually support:\n\n- `--kstars` monitor Kstars and send a telegram notification if it crashes during a session\n- `--do-backup` make a backup of the Kstars database and INDI devices configuration and store it remotely\n- `--retrieve-backup` restore the previously saved backup\n- `--fd-monitor` monitor file descriptors used to check if there is any leak\n- `--system-monitor` monitor system resources (CPU and RAM) usage and log it\n\nThe main folder where you'll find the logs is `~/.local/share/astromonitor/logs`\n\n# Compile it and run\nIf you want to compile it by yourself, the project is pure `Rust`, you just need the rust toolchain (see https://rustup.rs/), then clone this repo with `git clone https://github.com/MattBlack85/astro_monitor` or `git clone git@github.com:MattBlack85/astro_monitor` cd into the folder `cd astro_monitor` and then `cargo build --release`.\nYou will find the compiled program then under `target/release/astromonitor` you can move the program around (for example /usr/local/bin)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattblack85%2Fastro_monitor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattblack85%2Fastro_monitor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattblack85%2Fastro_monitor/lists"}