Readme update 1

This commit is contained in:
2026-11-14 04:58:29 +00:00
parent 9ee5467ceb
commit 792b4664a5
+55 -54
View File
@@ -4,101 +4,102 @@ This repository contains the transparent, reproducible build script used to comp
**This is an unofficial build.** I compile the upstream source code without modifying it. **This is an unofficial build.** I compile the upstream source code without modifying it.
## Key Features of this Build ## Key Features of This Build
- **Dynamic Linking:** Built natively against the system's FLAC and PortMIDI libraries for better compatibility and smaller size.
- **No AAC Support:** The `fdk-aac` library is intentionally excluded due to licensing restrictions. - **Dynamic linking:** Built natively against the system's FLAC and PortMIDI libraries for better compatibility and a smaller size.
- **Custom Icons:** Includes high-quality icons and a desktop entry provided by New Life Linux. - **No AAC support:** The `fdk-aac` library is intentionally excluded due to licensing restrictions.
- **Custom icons:** Includes high-quality icons and a desktop entry provided by New Life Linux.
## How It Works
## How it works
The `build-butt-dynamic.sh` script: The `build-butt-dynamic.sh` script:
1. Downloads the latest official Butt source code. 1. Downloads the latest official Butt source code.
2. Bootstraps the build environment. **(Docker is strongly recommended and used by default if you are not on the exact target OS).** 2. Bootstraps the build environment. **Docker is strongly recommended and is used by default if you are not on the exact target OS.**
3. Compiles the software with dynamic linking. 3. Compiles the software with dynamic linking.
4. Verifies that the compiled binary does NOT link to the `fdk-aac` library. 4. Verifies that the compiled binary does **not** link to the `fdk-aac` library.
5. Generates **separate** checksum files: `upstream_sha256_X.txt` (for the source code) and `SHA256SUMS_X.deb` (for the resulting `.deb`). 5. Generates **separate** checksum files: `upstream_sha256_X.txt` (for the source code) and `SHA256SUMS_X.deb` (for the resulting `.deb`).
## How to verify (Reproducible Builds via Docker) ## How to Verify (Reproducible Builds via Docker)
You don't have to trust me; you can build and verify it yourself! The **Docker method is the most reliable way** to ensure you are using the exact same environment as I did.
You don't have to trust me; you can build and verify the package yourself! The **Docker method is the most reliable way** to ensure you are using the exact same environment as I did.
1. Download the build script from this repository. 1. Download the build script from this repository.
2. Run the explicit Docker command for your target Ubuntu version (e.g., Ubuntu 22.04). This guarantees an isolated environment with the exact dependencies needed for the target OS: 2. Run the explicit Docker command for your target Ubuntu version (e.g., Ubuntu 22.04). This guarantees an isolated environment with the exact dependencies needed for the target OS:
```bash ```bash
docker run --rm -it -v "$PWD":/work -w /work ubuntu:22.04 bash ./build-butt-dynamic.sh 22.04 docker run --rm -it -v "$PWD":/work -w /work ubuntu:22.04 bash ./build-butt-dynamic.sh 22.04
```
(Note: If you just run ./build-butt-dynamic.sh 22.04 on your host machine, the script will automatically execute the Docker command above for you if you are not on Ubuntu 22.04). > **Note:** If you simply run `./build-butt-dynamic.sh 22.04` on your host machine, the script will automatically execute the Docker command above for you, unless you are already on Ubuntu 22.04.
Compare the SHA256 checksums of the .deb you just built with the one provided in the Releases page. If they match, you have mathematically proven that the package is authentic. 3. Compare the SHA256 checksum of the `.deb` you just built with the one provided on the [Releases](../../releases) page. If they match, you have verified that the package is authentic.
Security & GPG Public Key ## Security & GPG Public Key
To ensure the integrity of the packages, I provide my public GPG key. To ensure the integrity of the packages, I provide my public GPG key.
Download: butt-key.asc - **Download:** [`butt-key.asc`](butt-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 Import it with:
Import it:
bash
```bash
gpg --import butt-key.asc gpg --import butt-key.asc
```
Maintained by: New Life Linux (Gre Weaver) - greweaver@newlifelinux.org **Maintained by:** New Life Linux (Gre Weaver) – [greweaver@newlifelinux.org](mailto:greweaver@newlifelinux.org)
Butt DEB Csomagolás (Magyar)
Ez a tároló tartalmazza azt az átlátható, reprodukálható build scriptet, amely a hivatalos Butt (Broadcast Using This Tool) forráskódból (.tar.gz) egyetlen .deb csomagot fordít Ubuntu rendszerekre. ---
Ez egy nem hivatalos build. A hivatalos forráskódot módosítás nélkül fordítom le. # Butt DEB csomagolás (magyar)
A build fő jellemzői
Dinamikus linkelés: Natívan linkel a rendszer FLAC és PortMIDI könyvtáraihoz a jobb kompatibilitás és a kisebb méret érdekében. Ez a tároló tartalmazza azt az átlátható, reprodukálható build scriptet, amely a hivatalos Butt (Broadcast Using This Tool) forráskódból (`.tar.gz`) egyetlen `.deb` csomagot fordít Ubuntu rendszerekre.
Nincs AAC támogatás: Az fdk-aac könyvtár szándékosan ki van zárva a licencelési korlátozások miatt. **Ez egy nem hivatalos build.** A hivatalos forráskódot módosítás nélkül fordítom le.
Egyedi ikonok: A New Life Linux által biztosított kiváló minőségű ikonokat és asztali menüt tartalmazza. ## A build főbb jellemzői
Hogyan működik? - **Dinamikus linkelés:** Natívan a rendszer FLAC és PortMIDI könyvtáraihoz linkel a jobb kompatibilitás és a kisebb méret érdekében.
- **Nincs AAC-támogatás:** Az `fdk-aac` könyvtár licencelési korlátozások miatt szándékosan ki van zárva.
- **Egyedi ikonok:** Tartalmazza a New Life Linux által készített kiváló minőségű ikonokat és az asztali indítóbejegyzést.
A build-butt-dynamic.sh script a következőket teszi: ## Hogyan működik?
Letölti a legfrissebb hivatalos Butt forráskódot. A `build-butt-dynamic.sh` script a következőket teszi:
Előkészíti a build környezetet. (A Docker használata erősen ajánlott, és alapértelmezett, ha nem a pontos cél operációs rendszeren vagy). 1. Letölti a legfrissebb hivatalos Butt forráskódot.
2. Előkészíti a build környezetet. **A Docker használata erősen ajánlott, és alapértelmezetten akkor is ezt használja a script, ha nem a pontos célrendszeren futtatod.**
3. Dinamikus linkeléssel lefordítja a szoftvert.
4. Ellenőrzi, hogy a lefordított bináris **nem** linkel az `fdk-aac` könyvtárhoz.
5. **Külön** ellenőrzőösszeg-fájlokat generál: `upstream_sha256_X.txt` (a forráskódhoz) és `SHA256SUMS_X.deb` (a létrejött `.deb` csomaghoz).
Dinamikus linkeléssel lefordítja a szoftvert. ## Hogyan ellenőrizheted? (Reprodukálható buildek Dockerrel)
Ellenőrzi, hogy a lefordított bináris NEM linkel az fdk-aac könyvtárhoz. Nem kell feltétlenül megbíznod bennem; magad is lefordíthatod és ellenőrizheted a csomagot! A Docker a legmegbízhatóbb módszer, mert garantálja, hogy pontosan ugyanazt a környezetet használod, mint én.
Külön ellenőrzőösszeg-fájlokat generál: upstream_sha256_X.txt (a forráskódhoz) és SHA256SUMS_X.deb (a létrejött .deb-hez). 1. Töltsd le a build scriptet ebből a tárolóból.
2. Futtasd le az alábbi Docker-parancsot a célként használt Ubuntu-verziódnak megfelelően (pl. Ubuntu 22.04). Ez egy izolált környezetet biztosít a célrendszerhez szükséges pontos függőségekkel:
Hogyan ellenőrizd? (Reprodukálható Buildek Dockerrel) ```bash
docker run --rm -it -v "$PWD":/work -w /work ubuntu:22.04 bash ./build-butt-dynamic.sh 22.04
```
Nem kell feltétlenül megbíznod bennem; magad is lefordíthatod! A Docker módszer a legmegbízhatóbb út, mert garantálja, hogy pontosan ugyanazt a környezetet használod, mint én. > **Megjegyzés:** Ha egyszerűen csak lefuttatod a `./build-butt-dynamic.sh 22.04` parancsot a saját gépeden, a script automatikusan végrehajtja a fenti Docker-parancsot, kivéve, ha már Ubuntu 22.04-en vagy.
Töltsd le a build scriptet ebből a tárolóból. 3. Hasonlítsd össze az általad épített `.deb` fájl SHA256 ellenőrzőösszegét a [Kiadások (Releases)](../../releases) oldalon megadottal. Ha megegyeznek, igazoltad, hogy a csomag hiteles.
Futtasd le az alábbi, a cél Ubuntu verziódra vonatkozó Docker parancsot (pl. Ubuntu 22.04). Ez garantál egy izolált környezetet a cél operációs rendszerhez szükséges pontos függőségekkel: ## Biztonság és GPG nyilvános kulcs
bash
docker run --rm -it -v "$PWD":/work -w /work ubuntu:22.04 bash ./build-butt-dynamic.sh 22.04 A csomagok integritásának biztosítása érdekében közzéteszem a nyilvános GPG-kulcsomat.
(Megjegyzés: Ha egyszerűen csak lefuttatod a ./build-butt-dynamic.sh 22.04 parancsot a saját gépeden, a script automatikusan végrehajtja a fenti Docker parancsot, ha nem Ubuntu 22.04-en vagy). - **Letöltés:** [`butt-key.asc`](butt-key.asc)
- **Kulcs ujjlenyomata (fingerprint):** `58C2 7061 659D E241 945C 46D9 09F8 C5A9 DD99 F24C`
Hasonlítsd össze az általad lefuttatott build során kapott .deb SHA256 ellenőrzőösszegét a Kiadások (Releases) oldalon megadottakkal. Ha megegyeznek, matematikailag bebizonyítottad, hogy a csomag hiteles.
Biztonság és GPG Nyilvános Kulcs
A csomagok integritásának biztosítása érdekében közzéteszem a nyilvános GPG kulcsomat.
Letöltés: butt-key.asc
Kulcs lenyomat (Fingerprint): 58C2 7061 659D E241 945C 46D9 09F8 C5A9 DD99 F24C
Importálás: Importálás:
bash
```bash
gpg --import butt-key.asc gpg --import butt-key.asc
```
Karbantartja: New Life Linux (Gre Weaver) - greweaver@newlifelinux.org **Karbantartja:** New Life Linux (Gre Weaver) – [[email protected]](mailto:[email protected])
text
This response is AI-generated, for reference only.