Files
blap/README.md
T
2026-07-02 13:29:23 -07:00

60 lines
2.2 KiB
Markdown

# Blap
A cozy, Discord-style social client for **[Matrix](https://matrix.org)**, built as a visual fork of
[Element Web](https://github.com/element-hq/element-web). Same Matrix protocol, crypto, and calling —
a rebuilt, voice-focused UI aimed at people coming from Discord.
## Download
Latest build for your platform on the **[Releases page](https://codeberg.org/Enkisu/Blap/releases)**:
| Platform | File |
|---|---|
| Windows | `Blap Setup X.Y.Z.exe` |
| Flatpak (Bazzite, etc.) | `Blap-X.Y.Z-x86_64.flatpak` |
| Debian / Ubuntu | `blap_X.Y.Z_amd64.deb` |
| Arch | `blap-X.Y.Z.pacman` |
| Portable | `blap-X.Y.Z.tar.gz` |
## Updating
- **Windows** updates itself in place (a "New update" prompt appears when a new version is out).
- **Linux** can't self-update (owned by the package manager / flatpak sandbox), so Blap **notifies**
you and you update with one command — see **[HOW-TO-UPDATE.md](./HOW-TO-UPDATE.md)**.
## Screen sharing audio
- **Windows / macOS** — system audio is shared with your screen automatically.
- **Linux** — Electron can't capture system audio for screen shares (a longstanding
Electron/Chromium limitation, not specific to Blap). Workaround on PipeWire (Debian, Bazzite,
etc.): in the call, open the **mic device dropdown** (the ⌄ next to the mic button) and pick
**"Monitor of \<your output device\>"** as your input — your system audio then rides in on the
mic channel. Note this replaces your microphone, so you share audio *or* talk (use `qpwgraph` /
`pavucontrol` to combine both if you need it).
## Building
Requires Node ≥ 22 and pnpm. From the repo root:
```bash
pnpm install
# web bundle
cd apps/web && pnpm run build
# desktop (Blap variant) — Linux deb/flatpak/tar.gz + Windows exe
cd ../desktop
pnpm exec asar p ../web/webapp webapp.asar
VARIANT_PATH=blap/build.json pnpm run build -- --linux --win
```
Publishing a release (uploads the built artifacts to the Codeberg release):
```bash
CODEBERG_TOKEN=xxxx node apps/desktop/scripts/release-codeberg.mjs
```
## License & credits
Blap is a fork of **element-web** (© New Vector Ltd and contributors) and keeps its
**AGPL-3.0-only / GPL-3.0-only** licensing. This is an independent fork, not affiliated with or
endorsed by Element.