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, orCtrl+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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.