Readme update 1
This commit is contained in:
@@ -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.
|
|
||||||
Reference in New Issue
Block a user