https://github.com/5ht2b/heartbeat

A service to keep a live heartbeat (ping) on multiple devices
https://github.com/5ht2b/heartbeat

docker fasthttp go golang webserver

Last synced: 10 months ago
JSON representation

A service to keep a live heartbeat (ping) on multiple devices

• Host: GitHub
• URL: https://github.com/5ht2b/heartbeat
• Owner: 5HT2B
• License: isc
• Created: 2021-02-08T18:41:26.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-20T00:13:56.000Z (almost 2 years ago)
• Last Synced: 2025-08-16T19:39:49.019Z (10 months ago)
• Topics: docker, fasthttp, go, golang, webserver
• Language: Go
• Homepage: https://frog.icu
• Size: 421 KB
• Stars: 51
• Watchers: 1
• Forks: 5
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# [heartbeat](https://frog.icu)

[![Last Online](https://img.shields.io/badge/dynamic/json?color=%23887ee0&label=last%20online&query=last_beat_formatted&suffix=%20ago&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAACXBIWXMAAES4AABEuAH3N9d6AAADrklEQVR42u2ZT4hVVRzHP8d5joUVg9SYf5ocmcxNSLhxUW5yaCFBGWLUokWI4FJXgQiCu2oltQlCbCVIIAiRomVYQSWZb0jCyhx1/L9wAjXL+bZ4v9v7vdt9zcwbu2eme77wOL/zvb977vl97/nzu+dBQkJCQkJCQkJCQqmQtEDSSUl1SY/H7k8MATaria2x+jErogYLnD1QRQEec/ayKgrQ18aujADznb1E0uyqCbDY2TUgyk4QRQBJPcBDObo6AgALC7goC2EsAR4t4PqrJEDRcK+UAIsKuMpPgT5JoSoC+C3wNyt7gIerIkC2Bgj4wvGlfxPEngI3gSHHl54LlC6ApbyPWPUicMpdLn0hjDECFgNdZg8Dv7prS6oggM8CR4CfXX1pFQTwW+Al4Dxwy+r/jykg6WVJr7TZ1/1ByNkQwl0TAaBX0v1lClD7D4J/CdiXVYG9ORd/+HHBytPAEzTWhn7gh9IEkLQCeG2SYowCu0II13PBzwJ2OOrFAgH8QcglK39x3ECpAgAHaM3MJop+4PUctwF4ytWfk9RlwzyDf9Y5K884brekm22eKeAEsD6EcFvSO8B6WqeygG+BDSGEO5JWAR/wz/OHu8B7SBpSZxjxc1xSTdKpAr+VLRFIZ4y/I6lm3NpJPntQUs84Ps9Y23v+xWe0BqwB1tLcm8fDFuBJGsfaAzTmLzSm0XL3FjJxBoHj1pkumlPgagjhT7OPAfXc6GmHIeDrEMINSR8B6wp8TtgPGlNwHTC3YDTtmWDMLW/wLafgG8bNlvST49929qfu3nmO/6ag7fvG+xXc0z0Bn66CtronHbw19oIL4kPjNjrupAly1eq/S3rQ/J52fvs66sA9Rid5wJfAmNnPSpoDbHPXt4cQ/gCyN98NrDbbL4AjsYPvSADb+upW7QN20tzbjwP7zf7E3TZoZdEWOLMEMBzN9AD8H5vbQwgy+xCNhQbgeSt9FniOaYBOBTjm7Gy1/wr4+G8yhGHgR6suV+MvcJ8FDscOfioCfE7z7Wbwbz/DQWevofVD6HLs4KeEXNLzWRsfn+DslfS9qz8QO4apCvCuC2Z1G5+5km6bzzVJo2Zfn+zzph0k9UraJWnTOH5HClLQ+kSfM+Mh6c0CAQ7F7leGMk6EDhZwZ2MHXqYA3wFXctyFThqakQKEEMaAwzl6WmSBpQhgyM/58x21MlMhaZGkMbcIrojdpxgi1C34MUm9sfsTQ4BX7Yzg/dh9SUhISEhISEhISIC/AB8nCh3wr1ifAAAAAElFTkSuQmCC&url=https%3A%2F%2Ffrog.icu%2Fapi%2Fstats)](https://frog.icu)

[![Total Beats](https://img.shields.io/badge/dynamic/json?color=%236495ED&label=total%20beats&query=total_beats_formatted&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAACXBIWXMAAES4AABEuAH3N9d6AAADrklEQVR42u2ZT4hVVRzHP8d5joUVg9SYf5ocmcxNSLhxUW5yaCFBGWLUokWI4FJXgQiCu2oltQlCbCVIIAiRomVYQSWZb0jCyhx1/L9wAjXL+bZ4v9v7vdt9zcwbu2eme77wOL/zvb977vl97/nzu+dBQkJCQkJCQkJCQqmQtEDSSUl1SY/H7k8MATaria2x+jErogYLnD1QRQEec/ayKgrQ18aujADznb1E0uyqCbDY2TUgyk4QRQBJPcBDObo6AgALC7goC2EsAR4t4PqrJEDRcK+UAIsKuMpPgT5JoSoC+C3wNyt7gIerIkC2Bgj4wvGlfxPEngI3gSHHl54LlC6ApbyPWPUicMpdLn0hjDECFgNdZg8Dv7prS6oggM8CR4CfXX1pFQTwW+Al4Dxwy+r/jykg6WVJr7TZ1/1ByNkQwl0TAaBX0v1lClD7D4J/CdiXVYG9ORd/+HHBytPAEzTWhn7gh9IEkLQCeG2SYowCu0II13PBzwJ2OOrFAgH8QcglK39x3ECpAgAHaM3MJop+4PUctwF4ytWfk9RlwzyDf9Y5K884brekm22eKeAEsD6EcFvSO8B6WqeygG+BDSGEO5JWAR/wz/OHu8B7SBpSZxjxc1xSTdKpAr+VLRFIZ4y/I6lm3NpJPntQUs84Ps9Y23v+xWe0BqwB1tLcm8fDFuBJGsfaAzTmLzSm0XL3FjJxBoHj1pkumlPgagjhT7OPAfXc6GmHIeDrEMINSR8B6wp8TtgPGlNwHTC3YDTtmWDMLW/wLafgG8bNlvST49929qfu3nmO/6ag7fvG+xXc0z0Bn66CtronHbw19oIL4kPjNjrupAly1eq/S3rQ/J52fvs66sA9Rid5wJfAmNnPSpoDbHPXt4cQ/gCyN98NrDbbL4AjsYPvSADb+upW7QN20tzbjwP7zf7E3TZoZdEWOLMEMBzN9AD8H5vbQwgy+xCNhQbgeSt9FniOaYBOBTjm7Gy1/wr4+G8yhGHgR6suV+MvcJ8FDscOfioCfE7z7Wbwbz/DQWevofVD6HLs4KeEXNLzWRsfn+DslfS9qz8QO4apCvCuC2Z1G5+5km6bzzVJo2Zfn+zzph0k9UraJWnTOH5HClLQ+kSfM+Mh6c0CAQ7F7leGMk6EDhZwZ2MHXqYA3wFXctyFThqakQKEEMaAwzl6WmSBpQhgyM/58x21MlMhaZGkMbcIrojdpxgi1C34MUm9sfsTQ4BX7Yzg/dh9SUhISEhISEhISIC/AB8nCh3wr1ifAAAAAElFTkSuQmCC&url=https%3A%2F%2Ffrog.icu%2Fapi%2Fstats)](https://frog.icu)

[![Docker Build](https://img.shields.io/github/actions/workflow/status/5HT2B/heartbeat/docker-build.yml?logo=docker&logoColor=white)](https://github.com/5HT2B/heartbeat/actions/workflows/docker-build.yml)

[![CodeFactor](https://img.shields.io/codefactor/grade/github/5HT2B/heartbeat?logo=codefactor&logoColor=white)](https://www.codefactor.io/repository/github/5HT2B/heartbeat)

A service to see when a device was last active. Works by pinging the server every minute, from any device, as long as said device is

unlocked and being used (ie, you typed or used the mouse in the last two minutes).

## Contributing

Contributions to fix code are welcome, as are any improvements.

See [`USAGE.md`](https://github.com/5HT2B/heartbeat/blob/master/USAGE.md)

for compiling + running + testing instructions.

## Running server or client in production

See [`DOCS.md#running-server-in-production`](https://github.com/5HT2B/heartbeat/blob/master/DOCS.md#running-server-in-production) for more

information.

## API

See [`DOCS.md#api`](https://github.com/5HT2B/heartbeat/blob/master/DOCS.md#api) for more information.