glosso notification relay - privately hosted
  • Python 86.2%
  • HTML 12.7%
  • JavaScript 1.1%
Find a file
2026-05-23 23:35:43 +01:00
glosson Initial glosson client 2026-05-23 23:29:42 +01:00
.gitignore Initial glosson client 2026-05-23 23:29:42 +01:00
pyproject.toml Initial glosson client 2026-05-23 23:29:42 +01:00
README.md Use public HTTPS client install URL 2026-05-23 23:35:43 +01:00

glosson

glosson runs Glosso push notifications from your own computer.

You get a personal page like:

https://username.glosson.kaylee.wtf

When the client is running, the relay only passes encrypted traffic between the browser and your machine. Your Glosso password is stored locally and is checked directly with glosso.ink; it is never sent to the relay server.

Install

python3 -m pip install 'git+https://git.32bit.cafe/kaylee/glosson.git'

Setup

python -m glosson setup

Setup will:

  • ask for your Glosso username
  • ask you to prove that you control that profile by adding a short phrase to your bio
  • save your Glosso password locally
  • check that the client can log into Glosso
  • get a browser-trusted certificate for your personal page

Run

python -m glosson run

Then open:

https://username.glosson.kaylee.wtf

From that page you can enable browser push notifications, send a delayed test notification, and check that the page is using the certificate held by your local client.

Commands

python -m glosson setup
python -m glosson run
python -m glosson status
python -m glosson renew

Local Files

The client stores runtime state under ~/.glosson/:

  • config: relay token, username, local Glosso password, certificate metadata
  • certs/: certificate and private key for your personal page
  • notif_state.json: push subscriptions, VAPID keys, notification history

Credit

The notification UI and polling behavior build on glossonotif.