Skip to main content

blip-boop

A little company in your terminal.

Leave it open beside your code. You are a small colored pixel at the bottom of an otherwise quiet screen. When you contribute on GitHub, a white particle rises, drifts, and fades away. Other connected people share the space as colors.

No scores, leaderboards, or public usernames. Just a quiet sign that someone else is making something.

Install and join

Requires Linux or macOS, Python 3.10+, and a terminal with Unicode and 24-bit color support. Install with pipx:

pipx install blip-boop
blip-boop login
blip-boop

The hosted beta is invite-only. Get a one-time invitation from the operator before your first login. Login opens GitHub in your browser and displays a device code, then asks for the invitation in a hidden terminal prompt. The invitation is linked to your GitHub account; later logins do not need another code.

Authorize the GitHub App, then install it on the repositories you want to connect. No server setup or GitHub CLI installation is needed to participate. The client uses https://blip-boop-relay.onrender.com by default.

The beta supports 50 simultaneous accounts and one terminal per account. If the space is full, the client retries periodically without consuming another invitation. Windows is not currently supported.

What makes a particle?

  • A push, excluding branch or tag deletion: one particle per push.
  • A pull request opened.
  • An issue opened.
  • A review submitted.

Only supported GitHub events from connected participants produce particles. Local commits that have not been pushed and bot events are not tracked. GitHub webhook delivery may be delayed. Particles fade over 18–26 seconds.

Controls

  • c: change your color and save it for next time.
  • q, Esc, or Ctrl+C: quit.
  • A small dot marks your own pixel.
blip-boop status
blip-boop --help
blip-boop --version
pipx upgrade blip-boop

For another relay, run blip-boop login --server https://YOUR-RELAY. Settings and your relay session are saved in your user configuration directory.

Privacy

Peers receive pixel identifiers, colors, and contribution signals, not GitHub usernames, repository names, code, or commit messages. The relay uses your GitHub numeric user ID to match events to your pixel. It verifies a GitHub access token transiently at sign-in; the token is not saved by blip-boop.

Connecting a private repository shares the timing of its supported activity. Colors and timing can identify someone, so hidden usernames do not guarantee anonymity. All participants on the hosted relay share the same space.

License

MIT. The package includes client, relay, and operator command code. Hosted relay administration requires a separate secret credential; installing the package does not grant administrator access.

Metadata

Release files for blip-boop 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for blip-boop 0.1.0
File Size Uploaded Provenance Actions
blip_boop-0.1.0.tar.gz 35.0 kB With provenance Details for blip_boop-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for blip-boop 0.1.0
File Interpreter ABI Platform Actions
blip_boop-0.1.0-py3-none-any.whl Python 3 none any Details for blip_boop-0.1.0-py3-none-any.whl

Total release size: 54.1 kB

Release files / blip_boop-0.1.0.tar.gz

Download URL blip_boop-0.1.0.tar.gz
Size 35.0 kB
Tags Source
SHA-256 checksum
How to use checksums
906aad1a469d718098964ed1e80550ed51ba7bff1147248f50e39d8d026e17d3
BLAKE2b-256 checksum
How to use checksums
bfa5a027b822bfb604d4b3d37be5ac685c144aedb830b67db3901120a2666081
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / blip_boop-0.1.0-py3-none-any.whl

Download URL blip_boop-0.1.0-py3-none-any.whl
Size 19.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a4baef0a7bae93fc8b63cb12288566ae7cb74ea23f2717a4071452702226a659
BLAKE2b-256 checksum
How to use checksums
9217eb24e28637ccb8420188d7ec75ae0c61ca4b53a2c9f4a8f78fec66b134f9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for blip-boop 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for blip_boop-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page