Skip to content

hackclub/lookout

Lookout

Simple time-lapsing for Hack Club Simple time-tracking via periodic screenshots as a service, designed to be embedded into Hack Club programs. Lookout was previously known as "Collapse".

There are currently two 2 official clients for this service:

Note

If you're a YSWS program author hoping to integrate Lookout into your program, please reach out to me via Slack.

If you're a Hack Clubber using Lookout and running into issues with Lookout, please reach out to the program's author (and not me). They'll forward the issue to me if needed. - @samliu

Why does this exist?

Lookout is a Lapse alternative with differing goals.

Lapse is a standalone, general purpose, time-lapse creation tool with Hackatime integration, to produce smooth time-lapse videos that is Hackatime compatible and can be shared.

Lookout is a service that processes screenshots for proof of time spent on a project. At it's core, Lookout accepts screenshots from clients (similar to Hackatime's heartbeats). Lookout needs to be integrated into other Hack Club programs to function.

How it works... in a nutshell

Lookout is designed to be simple, resilient, and easy to integrate. Here's how it works at a high level:

  1. A Hack Club program generates a session and shares it with the client.
  2. The client begins capturing screenshots once per minute, uploading them as they are taken.
  3. The server tracks the number and timing of screenshots received to validate time.
  4. When the session finishes, Lookout stitches the screenshots into a time-lapse video.
  5. The Hack Club program can retrieve the session results.

Sessions auto-pause after 5 minutes of inactivity and auto-stop after 30 minutes of being paused.

There is no concept of "users" or "accounts" in Lookout. Sessions are created to be shared to users and controlled by the Hack Club program that created it.

About

simple time-tracking via timelapses

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors