chore(changelog): update changelog for v0.2.3

- Introduces a workflow to sync Gitea releases with GitHub
- Supports manual dispatch and reacts to release events
- Utilizes secrets for secure token management

.gitea/workflows/sync-github.yml

@@ -0,0 +1,28 @@
+name: Sync Release to GitHub
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to synchronize"
+        required: false
+        type: string
+  release:
+    types: [published, edited]
+
+jobs:
+  sync-github:
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: Run Releases Sync Action
+        uses: https://git.0xmax42.io/actions/releases-sync@main
+        with:
+          gitea_token: ${{ secrets.RELEASE_PUBLISH_TOKEN }}
+          gitea_url: https://git.0xmax42.io
+          gitea_owner: maxp
+          gitea_repo: systemd-timer
+          tag_name: ${{ inputs.tag || github.event.release.tag_name }}
+          github_token: ${{ secrets.SYNC_GITHUB_TOKEN }}
+          github_owner: 0xmax42
+          github_repo: systemd-timer

.gitea/workflows/upload-assets.yml

@@ -1,38 +1,27 @@
-# ========================
-# 📦 Upload Assets Template
-# ========================
-# Dieser Workflow wird automatisch ausgelöst, wenn ein Release
-# in Gitea veröffentlicht wurde (event: release.published).
-#
-# Er dient dem Zweck, Release-Artefakte (wie z. B. Binary-Dateien,
-# Changelogs oder Build-Zips) nachträglich mit dem Release zu verknüpfen.
-#
-# Voraussetzung: Zwei Shell-Skripte liegen im Projekt:
-# - .gitea/scripts/get-release-id.sh → ermittelt Release-ID per Tag
-# - .gitea/scripts/upload-asset.sh → lädt Datei als Release-Asset hoch
-#
-# --------------------------------------
-
 name: Upload Assets
 
 on:
   release:
-    types: [published] # Nur bei Veröffentlichung eines Releases (nicht bei Entwürfen)
+    types: [published]
 
 jobs:
   upload-assets:
     runs-on: ubuntu-latest
 
+    strategy:
+      matrix:
+        include:
+          - target: linux
+            arch: amd64
+          - target: linux
+            arch: arm64
+
     steps:
-      # 📥 Checke den Stand des Repos aus, exakt auf dem veröffentlichten Tag
-      # So ist garantiert, dass die Artefakte dem Zustand des Releases entsprechen.
       - uses: actions/checkout@v4
         with:
-          ref: ${{ github.event.release.tag_name }} # z. B. "v1.2.3"
-          fetch-depth: 0 # vollständige Git-Historie (für z. B. git-cliff, logs etc.)
+          ref: ${{ github.event.release.tag_name }}
+          fetch-depth: 0
 
-      # 🆔 Hole die Release-ID basierend auf dem Tag
-      # Die ID wird als Umgebungsvariable RELEASE_ID über $GITHUB_ENV verfügbar gemacht.
       - name: Get Release ID from tag
         run: .gitea/scripts/get-release-id.sh "${{ github.event.release.tag_name }}"
 
@@ -40,8 +29,16 @@ jobs:
         with:
           deno-version: v2.x
 
-      - name: Build application
-        run: deno task build
+      - name: Build ${{ matrix.target }}-${{ matrix.arch }}
+        run: deno task build:${{ matrix.arch }}
 
-      - name: Upload CHANGELOG.md as RELEASE-NOTES.md
-        run: .gitea/scripts/upload-asset.sh ./dist/systemd-timer systemd-timer
+      - name: Generate SHA256 for ${{ matrix.target }}-${{ matrix.arch }}
+        run: |
+          FILE="./dist/systemd-timer-${{ matrix.target }}-${{ matrix.arch }}"
+          sha256sum "$FILE" > "$FILE.sha256"
+
+      - name: Upload binary for ${{ matrix.target }}-${{ matrix.arch }}
+        run: .gitea/scripts/upload-asset.sh ./dist/systemd-timer-${{ matrix.target }}-${{ matrix.arch }} systemd-timer-${{ matrix.target }}-${{ matrix.arch }}
+
+      - name: Upload SHA256 for ${{ matrix.target }}-${{ matrix.arch }}
+        run: .gitea/scripts/upload-asset.sh ./dist/systemd-timer-${{ matrix.target }}-${{ matrix.arch }}.sha256 systemd-timer-${{ matrix.target }}-${{ matrix.arch }}.sha256

CHANGELOG.md

@@ -2,6 +2,44 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.3](https://git.0xmax42.io/maxp/systemd-timer/compare/v0.2.2..v0.2.3) - 2025-05-26
+
+### 🚀 Features
+
+- *(workflows)* Add GitHub release synchronization workflow - ([27c7367](https://git.0xmax42.io/maxp/systemd-timer/commit/27c7367ef1799428cc5a491b25036f77b65758af))
+
+### 📚 Documentation
+
+- *(readme)* Update project time badge interval - ([e3a3e61](https://git.0xmax42.io/maxp/systemd-timer/commit/e3a3e61bce0e62c2397bbc5bde3eff81b915c94a))
+- Add Englisch README - ([cf483de](https://git.0xmax42.io/maxp/systemd-timer/commit/cf483de06b555599052b1d9f97ee98e9233e5a86))
+
+## [0.2.2](https://git.0xmax42.io/maxp/systemd-timer/compare/v0.2.0..v0.2.2) - 2025-05-22
+
+### 🐛 Bug Fixes
+
+- *(install)* Enhance checksum validation with detailed comparison - ([0ca8ed9](https://git.0xmax42.io/maxp/systemd-timer/commit/0ca8ed94ccc4b9fe4ccac331957f01f852999094))
+- *(install)* Ensure compatibility with non-bash shells - ([20d1430](https://git.0xmax42.io/maxp/systemd-timer/commit/20d143035ec6893f680b68dc4a2f6319ca7a5b81))
+
+### 📚 Documentation
+
+- *(readme)* Update installation instructions with script - ([9853f85](https://git.0xmax42.io/maxp/systemd-timer/commit/9853f854c991d87b12cd4fb5e19fce55e7246024))
+
+## [0.2.0](https://git.0xmax42.io/maxp/systemd-timer/compare/v0.1.0..v0.2.0) - 2025-05-22
+
+### 🚀 Features
+
+- *(scripts)* Add installation script for systemd-timer binary - ([264b43c](https://git.0xmax42.io/maxp/systemd-timer/commit/264b43c9a667d344e27cca4ac2f17d7a4a25bffc))
+- *(workflows)* Add matrix build and SHA256 generation for releases - ([118e4e5](https://git.0xmax42.io/maxp/systemd-timer/commit/118e4e5a867a42c0d79efcc3b2a4db188affedec))
+- *(tasks)* Add build tasks for amd64 and arm64 targets - ([01898a3](https://git.0xmax42.io/maxp/systemd-timer/commit/01898a3a8e094dfbbf981ab6f1cf38d52f60ef5d))
+
+### 🐛 Bug Fixes
+
+- *(utils)* Handle file write failures with rollback - ([bd71b8e](https://git.0xmax42.io/maxp/systemd-timer/commit/bd71b8ee14a1856f1adaaaea198c8467b1a00d24))
+
+### 📚 Documentation
+
+- *(readme)* Add project time badge - ([a288dbc](https://git.0xmax42.io/maxp/systemd-timer/commit/a288dbc140fefbc46745f70cdcd71148802fdabf))
+
 ## [0.1.0] - 2025-05-21
 
 ### 🚀 Features

README.DE.md

@@ -0,0 +1,103 @@
+# systemd-timer
+
+![Project time](https://waka.0xmax42.io/api/badge/0XMax42/interval:any/project:systemd-timer?label=Project%20time)
+
+Ein einfaches CLI-Tool zum schnellen Erzeugen von systemd `.service` und `.timer` Units – als Ersatz oder moderne Ergänzung zu klassischen `cron`-Jobs.
+
+---
+
+## 🚀 Features
+
+- Erzeugt `.service` und `.timer` Dateien per CLI
+- Unterstützt `--user` Timer (für `~/.config/systemd/user/`)
+- Optionales Logging (`StandardOutput/StandardError`)
+- Unterstützt:
+  - `--calendar`
+  - `--exec`
+  - `--after`
+  - `--environment`
+  - `--output`
+  - `--dry-run`
+- Getestet und typisiert mit Deno + Cliffy
+
+---
+
+## 🛠️ Installation
+
+
+Du kannst `systemd-timer` direkt per Shell-Skript installieren:
+
+```bash
+curl -fsSL https://git.0xmax42.io/maxp/systemd-timer/raw/branch/main/scripts/install.sh | sh
+```
+
+Das Skript erkennt automatisch deine Plattform (Linux `amd64` oder `arm64`) und installiert die passende Binary nach `/usr/local/bin`, sofern dies erlaubt ist (ggf. mit `sudo`).
+
+**Hinweis:**
+- Für die Installation ist eine funktionierende Internetverbindung notwendig.
+- Die Integrität der Binary wird mittels SHA256-Prüfsumme verifiziert.
+- Du kannst das Skript vor der Ausführung auch manuell inspizieren:
+
+```bash
+curl -fsSL https://git.0xmax42.io/maxp/systemd-timer/raw/branch/main/scripts/install.sh -o install.sh
+less install.sh
+```
+
+Weitere Optionen und manuelle Installationswege findest du unter [`scripts/install.sh`](scripts/install.sh).
+
+---
+
+## 📦 Beispiel
+
+```bash
+./systemd-timer create \
+  --exec "/usr/local/bin/backup.sh" \
+  --calendar "Mon..Fri 02:00" \
+  --description "Backup Job" \
+  --user \
+  --logfile "/var/log/backup.log"
+```
+
+Erzeugt:
+- `~/.config/systemd/user/backup.service`
+- `~/.config/systemd/user/backup.timer`
+
+Anschließend aktivieren:
+
+```bash
+systemctl --user daemon-reload
+systemctl --user enable --now backup.timer
+```
+
+---
+
+## 🧪 Tests ausführen
+
+```bash
+deno task test
+```
+
+---
+
+## 🧰 Entwickeln
+
+```bash
+deno task start create --exec "/bin/true" --calendar "daily" --dry-run
+```
+
+---
+
+## 🔒 Rechte / Flags
+
+Das Tool benötigt beim Ausführen bzw. Kompilieren:
+
+- `--allow-env` (für `$HOME`)
+- `--allow-write` (zum Schreiben von `.service`/`.timer`)
+
+Beim Entwickeln wird meist `-A` (allow all) verwendet.
+
+---
+
+## 📝 Lizenz
+
+[MIT License](LICENSE)

README.md

@@ -1,39 +1,55 @@
 # systemd-timer
 
-Ein einfaches CLI-Tool zum schnellen Erzeugen von systemd `.service` und `.timer` Units – als Ersatz oder moderne Ergänzung zu klassischen `cron`-Jobs.
+- ![Project time](https://waka.0xmax42.io/api/badge/0XMax42/interval:any/project:systemd-timer?label=Project%20time)
+- [Deutsche Version dieser Readme](README.DE.md)
+
+A simple CLI tool for quickly generating systemd `.service` and `.timer` units — as a replacement or modern supplement to classic `cron` jobs.
 
 ---
 
 ## 🚀 Features
 
-- Erzeugt `.service` und `.timer` Dateien per CLI
-- Unterstützt `--user` Timer (für `~/.config/systemd/user/`)
-- Optionales Logging (`StandardOutput/StandardError`)
-- Unterstützt:
-  - `--calendar`
-  - `--exec`
-  - `--after`
-  - `--environment`
-  - `--output`
-  - `--dry-run`
-- Getestet und typisiert mit Deno + Cliffy
+* Generates `.service` and `.timer` files via CLI
+* Supports `--user` timers (for `~/.config/systemd/user/`)
+* Optional logging (`StandardOutput/StandardError`)
+* Supports:
+
+  * `--calendar`
+  * `--exec`
+  * `--after`
+  * `--environment`
+  * `--output`
+  * `--dry-run`
+* Tested and typed with Deno + Cliffy
 
 ---
 
 ## 🛠️ Installation
 
-```bash
-git clone https://git.0xmax42.io/maxp/systemd-timer.git
-cd systemd-timer
-deno task build
+You can install `systemd-timer` directly via shell script:
 
-# Binary liegt nun unter ./systemd-timer
-./systemd-timer --help
+```bash
+curl -fsSL https://git.0xmax42.io/maxp/systemd-timer/raw/branch/main/scripts/install.sh | sh
 ```
 
+The script automatically detects your platform (Linux `amd64` or `arm64`) and installs the appropriate binary to `/usr/local/bin`, if permitted (possibly using `sudo`).
+
+**Note:**
+
+* A working internet connection is required for installation.
+* The integrity of the binary is verified using a SHA256 checksum.
+* You can manually inspect the script before execution:
+
+```bash
+curl -fsSL https://git.0xmax42.io/maxp/systemd-timer/raw/branch/main/scripts/install.sh -o install.sh
+less install.sh
+```
+
+Additional options and manual installation methods are available under [`scripts/install.sh`](scripts/install.sh).
+
 ---
 
-## 📦 Beispiel
+## 📦 Example
 
 ```bash
 ./systemd-timer create \
@@ -44,11 +60,12 @@ deno task build
   --logfile "/var/log/backup.log"
 ```
 
-Erzeugt:
-- `~/.config/systemd/user/backup.service`
-- `~/.config/systemd/user/backup.timer`
+This creates:
 
-Anschließend aktivieren:
+* `~/.config/systemd/user/backup.service`
+* `~/.config/systemd/user/backup.timer`
+
+Activate afterwards:
 
 ```bash
 systemctl --user daemon-reload
@@ -57,7 +74,7 @@ systemctl --user enable --now backup.timer
 
 ---
 
-## 🧪 Tests ausführen
+## 🧪 Running Tests
 
 ```bash
 deno task test
@@ -65,7 +82,7 @@ deno task test
 
 ---
 
-## 🧰 Entwickeln
+## 🧰 Development
 
 ```bash
 deno task start create --exec "/bin/true" --calendar "daily" --dry-run
@@ -73,17 +90,17 @@ deno task start create --exec "/bin/true" --calendar "daily" --dry-run
 
 ---
 
-## 🔒 Rechte / Flags
+## 🔒 Permissions / Flags
 
-Das Tool benötigt beim Ausführen bzw. Kompilieren:
+The tool requires the following permissions when running or compiling:
 
-- `--allow-env` (für `$HOME`)
-- `--allow-write` (zum Schreiben von `.service`/`.timer`)
+* `--allow-env` (for `$HOME`)
+* `--allow-write` (to write `.service`/`.timer` files)
 
-Beim Entwickeln wird meist `-A` (allow all) verwendet.
+During development, usually `-A` (allow all) is used.
 
 ---
 
-## 📝 Lizenz
+## 📝 License
 
 [MIT License](LICENSE)

VERSION

@@ -1 +1 @@
-0.1.0
+0.2.3

deno.jsonc

@@ -2,7 +2,8 @@
     "tasks": {
         "start": "deno run -A src/mod.ts",
         "test": "deno test -A --coverage **/__tests__/*.test.ts",
-        "build": "deno compile --include=VERSION --allow-env --allow-write --output dist/systemd-timer src/mod.ts"
+        "build:amd64": "deno compile --target x86_64-unknown-linux-gnu --include=VERSION --allow-env --allow-write --output dist/systemd-timer-linux-amd64 src/mod.ts",
+        "build:arm64": "deno compile --target aarch64-unknown-linux-gnu --include=VERSION --allow-env --allow-write --output dist/systemd-timer-linux-arm64 src/mod.ts"
     },
     "compilerOptions": {},
     "fmt": {

scripts/install.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+
+# Fail-safe bash mode (only if bash is used)
+if [ -n "$BASH_VERSION" ]; then
+  set -euo pipefail
+else
+  set -eu
+fi
+
+# === Konfiguration ===
+REPO_URL="https://git.0xmax42.io/maxp/systemd-timer/releases/download/latest"
+BINARY_NAME="systemd-timer"
+INSTALL_PATH="/usr/local/bin"
+
+# === Systemarchitektur erkennen ===
+ARCH=$(uname -m)
+case "$ARCH" in
+  x86_64) ARCH="amd64" ;;
+  aarch64 | arm64) ARCH="arm64" ;;
+  *) echo "Unsupported architecture: $ARCH" >&2; exit 1 ;;
+esac
+
+OS=$(uname -s)
+case "$OS" in
+  Linux) OS="linux" ;;
+  *) echo "Unsupported OS: $OS" >&2; exit 1 ;;
+esac
+
+# === Download-URL zusammensetzen ===
+BINARY_FILE="${BINARY_NAME}-${OS}-${ARCH}"
+DOWNLOAD_URL="${REPO_URL}/${BINARY_FILE}"
+
+echo "📦 Installing ${BINARY_NAME} for ${OS}/${ARCH}..."
+echo "🌐 Downloading from: ${DOWNLOAD_URL}"
+
+# === Binary herunterladen ===
+TMP_FILE=$(mktemp)
+curl -fsSL "${DOWNLOAD_URL}" -o "${TMP_FILE}"
+chmod +x "${TMP_FILE}"
+
+# === SHA256-Check ===
+TMP_HASH=$(mktemp)
+curl -fsSL "${DOWNLOAD_URL}.sha256" -o "$TMP_HASH"
+EXPECTED_HASH=$(cut -d ' ' -f1 "$TMP_HASH")
+ACTUAL_HASH=$(openssl dgst -sha256 "$TMP_FILE" | awk '{print $2}')
+
+if [ "$EXPECTED_HASH" != "$ACTUAL_HASH" ]; then
+  echo "⚠️ Checksum mismatch!"
+  echo "Expected: $EXPECTED_HASH"
+  echo "Actual:   $ACTUAL_HASH"
+  exit 1
+fi
+
+# === Installation ===
+echo "🚀 Installing to ${INSTALL_PATH}/${BINARY_NAME}"
+if [ -w "$INSTALL_PATH" ]; then
+  install -m 755 "${TMP_FILE}" "${INSTALL_PATH}/${BINARY_NAME}"
+else
+  sudo install -m 755 "${TMP_FILE}" "${INSTALL_PATH}/${BINARY_NAME}"
+fi
+
+echo "✅ Installation complete: $(command -v ${BINARY_NAME})"
+"${BINARY_NAME}" --version || true

src/templates/unit-generator.ts

@@ -12,14 +12,20 @@ export async function generateUnitFiles(options: TimerOptions): Promise<void> {
         console.log(`\n===== ${name}.timer =====`);
         console.log(timerUnit);
     } else {
-        const { servicePath, timerPath } = await writeUnitFiles(
+        const result = await writeUnitFiles(
             name,
             serviceUnit,
             timerUnit,
             options,
         );
-        console.log(`Service unit written to: ${servicePath}`);
-        console.log(`Timer unit written to: ${timerPath}`);
+
+        if (result) {
+            const { servicePath, timerPath } = result;
+            console.log(`Service Unit geschrieben in: ${servicePath}`);
+            console.log(`Timer Unit geschrieben in: ${timerPath}`);
+        } else {
+            return;
+        }
 
         console.log(`\nℹ️  Hinweis:`);
 

src/utils/__tests__/fs.test.ts

@@ -24,7 +24,7 @@ Deno.test('writeUnitFiles schreibt .service und .timer korrekt', async () => {
         serviceContent,
         timerContent,
         options as TimerOptions,
-    );
+    ) as { servicePath: string; timerPath: string };
 
     // Überprüfe Pfade
     assertEquals(servicePath, join(tmp, 'test-backup.service'));

src/utils/fs.ts

@@ -1,4 +1,4 @@
-import { ensureDir } from 'https://deno.land/std@0.224.0/fs/mod.ts';
+import { ensureDir, exists } from 'https://deno.land/std@0.224.0/fs/mod.ts';
 import { join } from 'https://deno.land/std@0.224.0/path/mod.ts';
 import { TimerOptions } from '../types/mod.ts';
 
@@ -7,7 +7,7 @@ export async function writeUnitFiles(
     serviceContent: string,
     timerContent: string,
     options: TimerOptions,
-): Promise<{ servicePath: string; timerPath: string }> {
+): Promise<{ servicePath: string; timerPath: string } | undefined> {
     const basePath = resolveUnitTargetPath(options);
 
     await ensureDir(basePath);
@@ -15,8 +15,24 @@ export async function writeUnitFiles(
     const servicePath = join(basePath, `${name}.service`);
     const timerPath = join(basePath, `${name}.timer`);
 
-    await Deno.writeTextFile(servicePath, serviceContent);
-    await Deno.writeTextFile(timerPath, timerContent);
+    try {
+        await Deno.writeTextFile(servicePath, serviceContent);
+        await Deno.writeTextFile(timerPath, timerContent);
+    } catch (error) {
+        // Rollback: Remove any files that were written
+        try {
+            if (await exists(servicePath)) {
+                await Deno.remove(servicePath);
+            }
+            if (await exists(timerPath)) {
+                await Deno.remove(timerPath);
+            }
+        } catch (rollbackError) {
+            console.error('Rollback fehlgeschlagen:', rollbackError);
+        }
+        console.error('Fehler beim Schreiben der Units:', error);
+        return undefined;
+    }
 
     return { servicePath, timerPath };
 }