From 00b3e7d3dbb2f63da22df3769527a55dc9db9f2a Mon Sep 17 00:00:00 2001 From: greweaver Date: Thu, 12 Nov 2026 10:02:54 +0000 Subject: [PATCH] REPACK.md --- REPACK.md | 62 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 REPACK.md diff --git a/REPACK.md b/REPACK.md new file mode 100644 index 0000000..2bec64d --- /dev/null +++ b/REPACK.md @@ -0,0 +1,62 @@ +# Repackaging Betterbird for Debian/Ubuntu + +I maintain this repository, which contains an **unofficial** repackage of [Betterbird](https://www.betterbird.eu/) for Debian-based systems (Ubuntu, Linux Mint, etc.). + +My goal is to provide a transparent, verifiable `.deb` package built from the official upstream binaries without any modifications to the application code. + +## Why I created this +Betterbird officially provides `.tar.xz` archives. While these can be extracted and run manually, a `.deb` package integrates better with the system (desktop menus, icons, and clean uninstallation). I created this project to bridge that gap. + +## The Build Process (Repack) +The `build-betterbird-deb.sh` script does the following: +1. **Downloads** the latest official Betterbird `.tar.xz` archive. +2. **Verifies** the download against the official `sha256` checksums provided by Betterbird. (The build aborts if the checksum does not match). +3. **Extracts** the archive into a standard Debian package structure (`/opt/betterbird`). +4. Adds an official `.desktop` file and icons (pulled directly from the Betterbird repository). +5. Sets up the `Depends:` list by analyzing the ELF binaries using `dpkg-shlibdeps`. +6. **Repackages** the directory into a `.deb` file using `dpkg-deb`. + +### Unmodified Binaries +The application binaries, libraries, and resources inside `/opt/betterbird` are **byte-for-byte identical** to the official upstream `.tar.xz` release. I do not recompile or alter the Betterbird code. + +## Verification Chain +To ensure you are getting exactly what the Betterbird developers released, I provide a full verification log in `out/betterbird_verification.txt`. +- **Upstream Hash:** Checked against the official `sha256-153.txt` from betterbird.eu. +- **Tarball Check:** `sha256sum -c` returns `OK` for the downloaded `.tar.xz`. +- **Integrity Check:** The unpacked contents of the `.tar.xz` are compared byte-for-byte (`diff -r`) against the extracted contents of my `.deb`. +- **No Maintainer Scripts:** The package contains no `preinst`, `postinst`, `prerm`, or `postrm` scripts. + +## Disclaimer +**This is NOT an official Betterbird package.** I (Gre Weaver) maintain this project under New Life Linux. If you encounter any bugs or issues, please report them to me first at: greweaver@newlifelinux.org + +--- +# Újracsomagolási útmutató (Magyar) + +Én tartom karban ezt a tárolót, amely a [Betterbird](https://www.betterbird.eu/) **nem hivatalos** újracsomagolását tartalmazza Debian-alapú rendszerekre (Ubuntu, Linux Mint, stb.). + +A célom egy átlátható, ellenőrizhető `.deb` csomag biztosítása, amely a hivatalos forrásbinárisokból készült, anélkül, hogy az alkalmazás kódját bármilyen módon módosítanám. + +## Miért hoztam létre? +A Betterbird hivatalosan `.tar.xz` archívumokat biztosít. Bár ezek kézzel kicsomagolhatók és futtathatók, a `.deb` csomag jobban integrálódik a rendszerbe (asztali menük, ikonok, tiszta eltávolítás). Ezt a rést áthidalva hoztam létre ezt a projektet. + +## A csomagolási folyamat +A `build-betterbird-deb.sh` szkript a következőket teszi: +1. **Letölti** a legfrissebb hivatalos Betterbird `.tar.xz` archívumot. +2. **Ellenőrzi** a letöltést a Betterbird által biztosított hivatalos `sha256` checksumokkal szemben. (A folyamat leáll, ha a hash nem egyezik). +3. **Kicsomagolja** az archívumot egy szabványos Debian csomagszerkezetbe (`/opt/betterbird`). +4. Hozzáadja a hivatalos `.desktop` fájlt és az ikonokat. +5. Beállítja a `Depends:` (függőségek) listát az ELF binárisok elemzésével. +6. **Újracsomagolja** a könyvtárat egy `.deb` fájlba. + +### Módosítatlan binárisok +A `/opt/betterbird` mappában lévő alkalmazás binárisok, könyvtárak és erőforrások **byte-azonosak** a hivatalos `.tar.xz` kiadással. Nem fordítom újra és nem módosítom a Betterbird kódját. + +## Ellenőrzési lánc +Hogy biztos lehess abban, hogy pontosan azt kapod, amit a Betterbird fejlesztők kiadtak, egy teljes ellenőrzési naplót biztosítok az `out/betterbird_verification.txt` fájlban. +- **Forrás Hash:** A betterbird.eu hivatalos `sha256-153.txt` fájljához ellenőrizve. +- **Tarball ellenőrzés:** A `sha256sum -c` `OK` eredményt ad a letöltött `.tar.xz`-re. +- **Integritás ellenőrzés:** A kicsomagolt `.tar.xz` tartalmát byte-azonosan (`diff -r`) összehasonlítottam a `.deb` kicsomagolt tartalmával. +- **Nincsenek telepítőszkriptek:** A csomag nem tartalmaz `preinst`, `postinst`, `prerm` vagy `postrm` szkripteket. + +## Jogi nyilatkozat +**Ez NEM egy hivatalos Betterbird csomag.** Én (Gre Weaver) tartom karban a New Life Linux égisze alatt. Ha bármilyen hibát találsz, kérlek, először nekem jelentsd ezen a címen: greweaver@newlifelinux.org \ No newline at end of file