base64

base64 – narzędzie służące do kodowania i dekodowania danych w formacie Base64, używane do przekształcania binariów w reprezentację tekstową.
Przydatne podczas przesyłania danych przez media, które nie obsługują danych binarnych (np. e-maile, JSON, XML).
Narzędzie z pakietu GNU Coreutils, dostępne domyślnie w większości dystrybucji Linux.

Składnia

base64 [opcje] [plik]

Jeśli plik nie jest podany, dane są czytane ze standardowego wejścia.
Domyślnie zakodowane dane trafiają na standardowe wyjście.

Parametry

Parametr	Opis
`-d, --decode`	Dekoduje dane zakodowane w Base64.
`-w <n>`	Ustawia szerokość linii wyjściowej (domyślnie 76 znaków; `0` = brak podziału).
`--ignore-garbage`	Ignoruje błędne znaki w wejściu przy dekodowaniu.
`--help`	Wyświetla pomoc programu.
`--version`	Pokazuje wersję programu.

Przykłady użycia

# Przykład 1: Kodowanie pliku do Base64
base64 obraz.jpg > obraz.b64

# Przykład 2: Dekodowanie pliku Base64
base64 --decode obraz.b64 > obraz.jpg

# Przykład 3: Kodowanie tekstu z echo
echo "tekst" | base64

# Przykład 4: Dekodowanie ze standardowego wejścia
cat obraz.b64 | base64 -d > nowy.jpg

Uwagi

Base64 a inne formaty: Base64 zwiększa rozmiar danych o ok. 33%, ale zapewnia zgodność z tekstowymi kanałami transmisji.
Bezpieczne przesyłanie: przydatne przy przesyłaniu plików binarnych przez e-mail lub w formacie JSON.
Alternatywy: do kodowania bardziej kompaktowego użyj base85 lub xxd (heksadecymalnie).

Najczęściej spotykane błędy i jak je naprawić

Błąd / Komunikat	Przyczyna	Rozwiązanie
`invalid input`	Dane nie są zakodowane w Base64 lub zawierają błędy	Użyj `--ignore-garbage` lub sprawdź źródło danych.
Brak efektu przy dekodowaniu	Nieprzekierowane wyjście	Użyj `> wynik` lub `cat` z `	`.
Nieczytelny wynik	Próba otwarcia danych binarnych jako tekst	Otwórz wynik dekodowania odpowiednim programem.

Linki i źródła

GNU Coreutils – base64 – dokumentacja narzędzia.
Wikipedia – Base64 – opis formatu kodowania.