diff --git a/README.md b/README.md new file mode 100644 index 0000000..cb336fb --- /dev/null +++ b/README.md @@ -0,0 +1,68 @@ +# 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`. +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 identical to the upstream tarball. +5. Outputs a single, unified `SHA256SUMS` file containing the checksums for both the upstream tarball and the resulting `.deb`. + +### 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. + +--- + +## 🇭🇺 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. +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 megegyeznek-e az upstream tarballal. +5. Kiírja egyetlen, egyesített `SHA256SUMS` fájlba mind az upstream tarball, mind az eredményül kapott `.deb` ellenőrzőösszegét. + +### 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 lefordított fájlok SHA256 ellenőrzőösszegét 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. + +--- + +## Maintainer / Karbantartó +Maintained by / Karbantartja: New Life Linux (greweaver). +GPG Key Fingerprint: `[Ide írd be a GPG kulcsod ujjlenyomatát, ha van!]` + +## License / Licenc +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. + +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. \ No newline at end of file