Update Readme file

This commit is contained in:
2026-11-12 19:18:58 +00:00
parent 68b25c214b
commit 877c30b8de
+49 -33
View File
@@ -7,7 +7,9 @@ This repository contains the transparent, reproducible build script used to repa
**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. **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 ### How it works
The `build-betterbird-deb.sh` script: 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). 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). 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. 3. Downloads the official `.desktop` file from the Betterbird repository and installs the official icons.
@@ -15,79 +17,93 @@ The `build-betterbird-deb.sh` script:
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. 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) ### How to verify (Reproducible Builds)
You don't have to trust the maintainer; you can verify the package yourself! You don't have to trust the maintainer; you can verify the package yourself!
1. Download the build script from this repository. 1. Download the build script from this repository.
2. Run it in a Docker container on Ubuntu 22.04: 2. Run it in a Docker container on Ubuntu 22.04:
```bash ```bash
docker run --rm -v "$PWD":/work -w /work ubuntu:22.04 ./build-betterbird-deb.sh docker run --rm -v "$PWD":/work -w /work ubuntu:22.04 ./build-betterbird-deb.sh
```
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. 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 ### Download and Install
Go to the Releases tab on the right to download the latest .deb file and the SHA256SUMS file. Go to the **Releases** tab on the right to download the latest `.deb` file and the `SHA256SUMS` file.
Security & GPG Public Key
### 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. 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 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 **Key Fingerprint:** `58C2 7061 659D E241 945C 46D9 09F8 C5A9 DD99 F24C`
To import and use the key, run this command in your terminal: To import and use the key, run this command in your terminal:
```bash
gpg --import betterbird-key.asc 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. ### License
Maintained by: New Life Linux (Gre Weaver) - greweaver@newlifelinux.org 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.
🇭🇺 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. **Maintained by:** New Life Linux (Gre Weaver) - [email protected]
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: ## 🇭🇺 Magyar
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). 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.
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). **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.
Letölti a hivatalos .desktop fájlt a Betterbird tárolójából, és telepíti a hivatalos ikonokat. ### Hogyan működik?
Ellenőrzi, hogy a csomagolt fájlok bájtra pontosan megegyeznek-e az upstream tarballal. A `build-betterbird-deb.sh` script a következőket teszi:
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. 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) ### Hogyan ellenőrizd? (Reprodukálható Buildek)
Nem kell feltétlenül megbíznod a karbantartóban; magad is ellenőrizheted a csomagot! Nem kell feltétlenül megbíznod a karbantartóban; magad is ellenőrizheted a csomagot!
Töltsd le a build scriptet ebből a tárolóból. 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:
Futtasd le egy Docker konténerben Ubuntu 22.04-en: ```bash
bash docker run --rm -v "$PWD":/work -w /work ubuntu:22.04 ./build-betterbird-deb.sh
```
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.
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
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.
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
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 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 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 **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: A kulcs importálásához futtasd ezt a parancsot a terminálban:
```bash
gpg --import betterbird-key.asc 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. ### Licenc
Karbantartja: New Life Linux (Gre Weaver) - greweaver@newlifelinux.org 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