Repack.md
This commit is contained in:
@@ -0,0 +1,62 @@
|
||||
# Repackaging Betterbird for Debian/Ubuntu
|
||||
|
||||
This repository contains an **unofficial** repackage of [Betterbird](https://www.betterbird.eu/) for Debian-based systems (Ubuntu, Linux Mint, etc.).
|
||||
|
||||
The goal of this project is to provide a transparent, verifiable `.deb` package built from the official upstream binaries without any modifications to the application code.
|
||||
|
||||
## Why this exists
|
||||
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). This project bridges 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. We do not recompile or alter the Betterbird code.
|
||||
|
||||
## Verification Chain
|
||||
To ensure you are getting exactly what the Betterbird developers released, we 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 our `.deb`.
|
||||
- **No Maintainer Scripts:** The package contains no `preinst`, `postinst`, `prerm`, or `postrm` scripts.
|
||||
|
||||
## Disclaimer
|
||||
**This is NOT an official Betterbird package.** It is maintained by New Life Linux. If you encounter any bugs or issues, please report them to us first.
|
||||
|
||||
---
|
||||
# Újracsomagolási útmutató (Magyar)
|
||||
|
||||
Ez a tároló a [Betterbird](https://www.betterbird.eu/) **nem hivatalos** újracsomagolását tartalmazza Debian-alapú rendszerekre (Ubuntu, Linux Mint, stb.).
|
||||
|
||||
A projekt célja 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ánk.
|
||||
|
||||
## Miért jött 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). Ez a projekt áthidalja ezt a rést.
|
||||
|
||||
## 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ítjuk újra és nem módosítjuk 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ítunk 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ítottuk 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.** A New Life Linux tartja karban. Ha bármilyen hibát találsz, kérjük, először nekünk jelentsd.
|
||||
Reference in New Issue
Block a user