Files
betterbird-packaging/README.md
T
2026-11-12 19:18:58 +00:00

109 lines
5.3 KiB
Markdown

# Betterbird DEB Packaging / Betterbird DEB Csomagolás
## 🇬🇧 English
This repository contains the transparent, reproducible build script used to repackage the official Betterbird Linux release (`.tar.xz`) into a single `.deb` package.
**This is an unofficial repackage.** The contents of the `/opt/betterbird` directory are byte-for-byte identical to the official upstream tarball. No modifications are made to the binaries.
### How it works
The `build-betterbird-deb.sh` script:
1. Downloads the official Betterbird `.tar.xz` release and verifies its `sha256` against the official list. (Aborts if they do not match).
2. Extracts it and builds a `.deb` package using `dpkg-shlibdeps` (built on Ubuntu 22.04 for maximum compatibility).
3. Downloads the official `.desktop` file from the Betterbird repository and installs the official icons.
4. Verifies that the packaged files are byte-for-byte identical to the upstream tarball.
5. Generates **separate** checksum files: `sha256-X.official.txt` (verbatim from Betterbird) and `SHA256SUMS` (for the resulting `.deb`), ensuring local and upstream checksums are never mixed up.
### How to verify (Reproducible Builds)
You don't have to trust the maintainer; you can verify the package yourself!
1. Download the build script from this repository.
2. Run it in a Docker container on Ubuntu 22.04:
```bash
docker run --rm -v "$PWD":/work -w /work ubuntu:22.04 ./build-betterbird-deb.sh
```
3. Compare the SHA256 checksums of the files you just built with the ones provided in the Releases page. If they match, you have mathematically proven that the `.deb` you downloaded is exactly what this script produces from the official source.
### Download and Install
Go to the **Releases** tab on the right to download the latest `.deb` file and the `SHA256SUMS` file.
### Security & GPG Public Key
To ensure the integrity of the packages and verify that they are built by me (New Life Linux), I provide my public GPG key.
You can download the public key directly from this repository: [betterbird-key.asc](betterbird-key.asc)
**Key Fingerprint:** `58C2 7061 659D E241 945C 46D9 09F8 C5A9 DD99 F24C`
To import and use the key, run this command in your terminal:
```bash
gpg --import betterbird-key.asc
```
### License
The build scripts in this repository are licensed under the **MIT License**. Please note that this license applies only to the packaging scripts. The repackaged upstream software (Betterbird) retains its original **MPL 2.0** license.
**Maintained by:** New Life Linux (Gre Weaver) - [email protected]
---
## 🇭🇺 Magyar
Ez a tároló tartalmazza azt az átlátható, reprodukálható build scriptet, amely a hivatalos Betterbird Linux kiadást (`.tar.xz`) egyetlen `.deb` csomaggá alakítja.
**Ez egy nem hivatalos újracsomagolás.** Az `/opt/betterbird` könyvtár tartalma bájtra pontosan megegyezik a hivatalos upstream tarballal. A binárisokon semmilyen módosítás nem történik.
### Hogyan működik?
A `build-betterbird-deb.sh` script a következőket teszi:
1. Letölti a hivatalos Betterbird `.tar.xz` kiadást, és ellenőrzi annak `sha256` értékét a hivatalos listával szemben. (Ha nem egyeznek, leáll).
2. Kicsomagolja, és a `dpkg-shlibdeps` segítségével felépít egy `.deb` csomagot (Ubuntu 22.04-en futtatva a maximális kompatibilitás érdekében).
3. Letölti a hivatalos `.desktop` fájlt a Betterbird tárolójából, és telepíti a hivatalos ikonokat.
4. Ellenőrzi, hogy a csomagolt fájlok bájtra pontosan megegyeznek-e az upstream tarballal.
5. **Külön** ellenőrzőösszeg-fájlokat generál: `sha256-X.official.txt` (változatlanul a Betterbirdtől) és `SHA256SUMS` (a helyi `.deb`-hez), így a helyi és a hivatalos hash-ek soha nem keverednek össze.
### Hogyan ellenőrizd? (Reprodukálható Buildek)
Nem kell feltétlenül megbíznod a karbantartóban; magad is ellenőrizheted a csomagot!
1. Töltsd le a build scriptet ebből a tárolóból.
2. Futtasd le egy Docker konténerben Ubuntu 22.04-en:
```bash
docker run --rm -v "$PWD":/work -w /work ubuntu:22.04 ./build-betterbird-deb.sh
```
3. Hasonlítsd össze az általad lefuttatott build során kapott SHA256 ellenőrzőösszegeket a Kiadások (Releases) oldalon megadottakkal. Ha megegyeznek, matematikailag bebizonyítottad, hogy a letöltött `.deb` pontosan az, amit ez a script állít elő a hivatalos forrásból.
### Letöltés és telepítés
A jobb oldali **Releases** (Kiadások) fülön töltsd le a legfrissebb `.deb` fájlt és a `SHA256SUMS` fájlt.
### Biztonság és GPG Nyilvános Kulcs
A csomagok integritásának biztosítása és az én (New Life Linux) általi hitelesítés érdekében közzéteszem a nyilvános GPG kulcsomat.
A nyilvános kulcsot közvetlenül ebből a tárolóból töltheted le: [betterbird-key.asc](betterbird-key.asc)
**Kulcs lenyomat (Fingerprint):** `58C2 7061 659D E241 945C 46D9 09F8 C5A9 DD99 F24C`
A kulcs importálásához futtasd ezt a parancsot a terminálban:
```bash
gpg --import betterbird-key.asc
```
### Licenc
A tárolóban található build scriptek az **MIT Licenc** alatt állnak. Kérjük, vedd figyelembe, hogy ez a licenc csak a csomagoló scriptekre vonatkozik. Az újracsomagolt upstream szoftver (Betterbird) megtartja eredeti **MPL 2.0** licencét.
**Karbantartja:** New Life Linux (Gre Weaver) - greweaver@newlifelinux.org