Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

helium-backup

Plattformübergreifendes Backup- & Wiederherstellungswerkzeug für Helium Browser (GitHub)-Sessions (Chromium-basiert).

Unterstützt macOS, Linux und Windows. Bei Verwendung der vorgefertigten Binärdateien ist keine Python-Installation erforderlich.


Inhaltsverzeichnis


Funktionsweise

Exportieren — sichert das aktuelle Helium-Profil als komprimiertes .tar.gz-Archiv im selben Verzeichnis wie die Binärdatei. Cache-Verzeichnisse (GPUCache, Code Cache usw.) werden automatisch ausgeschlossen, um das Archiv klein zu halten. Zu jedem Archiv wird eine SHA-256-Prüfsummendatei angelegt.

Importieren — listet alle gefundenen Backups auf, prüft die SHA-256-Prüfsumme und stellt das Profil an den systemspezifischen Speicherort wieder her. Das aktuell vorhandene Profil wird dabei automatisch als .bak_<Datum> gesichert, bevor es überschrieben wird.


Installation & Nutzung

macOS

Voraussetzungen

  • macOS 11 (Big Sur) oder neuer
  • Apple Silicon (arm64) oder Intel (x86_64)

Schritt 1 — Binärdatei herunterladen

Die neueste Binärdatei von der Releases-Seite herunterladen (helium-backup-macos).

Schritt 2 — Ausführbar machen

chmod +x helium-backup-macos

Schritt 3 — Gatekeeper-Sperre aufheben

Da die Binärdatei nicht von Apple notarisiert ist, zeigt macOS beim ersten Start eine Warnung. Einmalig ausführen:

xattr -dr com.apple.quarantine helium-backup-macos

Alternativ: Systemeinstellungen → Datenschutz & Sicherheit → „Trotzdem öffnen" nach dem ersten fehlgeschlagenen Startversuch klicken.

Schritt 4 — Starten

./helium-backup-macos

Linux

Voraussetzungen

  • Eine aktuelle Distribution (Ubuntu 20.04+, Debian 11+, Fedora 38+, Arch usw.)
  • glibc 2.31 oder neuer (bei den meisten aktuellen Distributionen bereits vorhanden)

Schritt 1 — Binärdatei herunterladen

Die neueste Binärdatei von der Releases-Seite herunterladen (helium-backup-linux).

Schritt 2 — Ausführbar machen

chmod +x helium-backup-linux

Schritt 3 — Starten

./helium-backup-linux

Hinweis: Die Datei kann beliebig umbenannt und in ein Verzeichnis im PATH verschoben werden, z. B. ~/.local/bin/helium-backup, damit sie systemweit als helium-backup aufrufbar ist.


Windows

Voraussetzungen

  • Windows 10 (Version 1903 oder neuer) oder Windows 11
  • 64-Bit-System

Es wird keine Python-Installation benötigt.

Schritt 1 — Binärdatei herunterladen

Die neueste Binärdatei von der Releases-Seite herunterladen (helium-backup.exe).

Schritt 2 — SmartScreen-Warnung umgehen

Da die Datei nicht signiert ist, zeigt Windows beim ersten Start eine SmartScreen-Warnung.

  1. Doppelklick auf helium-backup.exe
  2. Es erscheint: „Windows hat den PC geschützt"
  3. Auf „Weitere Informationen" klicken
  4. Dann auf „Trotzdem ausführen" klicken

Diese Meldung erscheint nur beim ersten Start.

Schritt 3 — Starten

Doppelklick auf helium-backup.exe — es öffnet sich ein Terminal-Fenster mit dem interaktiven Menü.

Alternativ über die Eingabeaufforderung (cmd) oder PowerShell:

.\helium-backup.exe

Hinweis zu Antivirenprogrammen: PyInstaller-Binärdateien werden gelegentlich fälschlicherweise als verdächtig markiert. Falls das Antivirenprogramm Alarm schlägt, kann das Programm stattdessen direkt aus dem Quellcode ausgeführt werden (siehe unten).


Aus dem Quellcode bauen

Wer die Binärdatei selbst bauen möchte (z. B. weil dem heruntergeladenen Binary nicht vertraut wird), braucht lediglich Python 3.8+ und pip.

macOS / Linux:

# Repository klonen
git clone https://github.com/DEIN-USERNAME/helium-backup.git
cd helium-backup

# Binärdatei bauen
./build.sh

# Oder direkt aus dem Quellcode starten (kein Build nötig)
python3 helium-backup.py

Windows:

REM Repository klonen
git clone https://github.com/DEIN-USERNAME/helium-backup.git
cd helium-backup

REM Binärdatei bauen (installiert PyInstaller automatisch)
build.bat

REM Oder direkt aus dem Quellcode starten (Python muss installiert sein)
python helium-backup.py

Hinweis: PyInstaller bündelt immer die Python-Version des Build-Systems. Jede Plattform muss ihre eigene Binärdatei bauen — eine macOS-Binary läuft nicht unter Linux oder Windows.


Profilpfade

Das Skript erkennt den Speicherort des Helium-Profils automatisch:

Betriebssystem Standardpfad
macOS ~/Library/Application Support/net.imput.helium
Linux ~/.config/net.imput.helium
Windows %LOCALAPPDATA%\Helium\User Data

Falls Helium das Profil an einem anderen Ort speichert, kann der Pfad manuell gesetzt werden:

# macOS / Linux
HELIUM_SRC="/eigener/pfad/zum/profil" ./helium-backup

# Windows (Eingabeaufforderung)
set HELIUM_SRC=C:\eigener\pfad\zum\profil
helium-backup.exe

Lizenz

MIT

About

A quick way to tranfer your helium browser profiles between different systems

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages