docs: document systemd-based auto-disable of Tailscale Funnel on boot

octoprint_tailscale_funnel/MANIFEST.in

@@ -1,7 +1,6 @@
 include README.md
 include LICENSE
-include requirements.txt
 include setup.py
-recursive-include static *
-recursive-include templates *
+recursive-include octoprint_tailscale_funnel/static *
+recursive-include octoprint_tailscale_funnel/templates *
 recursive-include tests *

octoprint_tailscale_funnel/README.md

@@ -30,6 +30,10 @@ Disclaimer: *This plugin was partially vibe-coded*.
 5. Configure the plugin settings in OctoPrint's settings panel
 6. Enable Funnel through the plugin interface
 
+### Latest Release
+
+Get the latest packaged release (wheel, sdist, zip) from Gitea: [Releases](https://gitea.elpatron.me/elpatron/octo-funnel/releases)
+
 ## Building from Source
 
 If you want to build the plugin from source, please refer to the [BUILDING.md](BUILDING.md) file for detailed instructions.
@@ -81,6 +85,43 @@ sudo tailscale funnel reset
 
 Enabling Funnel makes your OctoPrint instance accessible from the public internet. Only enable it when needed and disable it when finished. The plugin will show a confirmation dialog before enabling Funnel if the "Confirm Enable" option is checked.
 
+### Disable Funnel automatically on system boot (systemd)
+
+If you prefer to make sure the Tailscale Funnel is always off after a system reboot (independent of the plugin), you can add a small systemd unit that disables Funnel shortly after boot:
+
+1) Create unit file:
+```bash
+sudo tee /etc/systemd/system/octoprint-tailscale-funnel-off.service >/dev/null <<'UNIT'
+[Unit]
+Description=Disable Tailscale Funnel after boot
+After=network-online.target tailscaled.service
+Wants=network-online.target
+
+[Service]
+Type=oneshot
+User=octoprint
+ExecStart=/usr/bin/tailscale funnel reset
+# Optional: also turn off possible serve mappings on common ports
+ExecStart=/usr/bin/tailscale serve --http=80 off
+ExecStart=/usr/bin/tailscale serve --https=80 off
+
+[Install]
+WantedBy=multi-user.target
+UNIT
+```
+
+2) Enable and test:
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now octoprint-tailscale-funnel-off.service
+sudo systemctl status octoprint-tailscale-funnel-off.service
+```
+
+Notes:
+- Adjust `User=octoprint` if your OctoPrint runs under a different user (e.g. `pi`).
+- If sudo is required for tailscale on your system, add the corresponding sudoers entry as described above.
+- You can add a short delay by inserting `ExecStartPre=/bin/sleep 5` if Tailscale comes up late during boot.
+
 ## API Endpoints
 
 The plugin exposes the following API endpoints:

octoprint_tailscale_funnel/octoprint_tailscale_funnel/__init__.py

@@ -91,7 +91,7 @@ class TailscaleFunnelPlugin(octoprint.plugin.StartupPlugin,
 
     def get_assets(self):
         return dict(
-            js=["js/tailscale_funnel.js"],
+            js=["js/tailscale_funnel.js", "js/tailscale_funnel_navbar.js"],
             css=["css/tailscale_funnel.css"],
             less=["less/tailscale_funnel.less"]
         )
@@ -100,7 +100,8 @@ class TailscaleFunnelPlugin(octoprint.plugin.StartupPlugin,
 
     def get_template_configs(self):
         return [
-            dict(type="settings", custom_bindings=True, template="tailscale_funnel_settings.jinja2")
+            dict(type="settings", custom_bindings=True, template="tailscale_funnel_settings.jinja2"),
+            dict(type="navbar", name="Funnel", custom_bindings=False, template="tailscale_funnel_navbar.jinja2")
         ]
 
     ##~~ BlueprintPlugin mixin

octoprint_tailscale_funnel/octoprint_tailscale_funnel/static/css/tailscale_funnel.css

@@ -39,3 +39,14 @@
     border-color: #faebcc;
     color: #8a6d3b;
 }
+
+/* Navbar Button Farbkennung */
+#navbar_plugin_tailscale_funnel > a.tsf-enabled {
+    background-color: #5cb85c;
+    color: #fff;
+}
+
+#navbar_plugin_tailscale_funnel > a.tsf-disabled {
+    background-color: #777;
+    color: #fff;
+}

octoprint_tailscale_funnel/octoprint_tailscale_funnel/static/js/tailscale_funnel_navbar.js

@@ -0,0 +1,105 @@
+$(function() {
+    var lastEnabled = null;
+
+    function refreshNavbarStatus() {
+        var $status = $("#tsf_nav_status");
+        var $openLi = $("#tsf_nav_open_li");
+        var $open = $("#tsf_nav_open");
+        var $toggleText = $("#tsf_nav_toggle_text");
+        var $btn = $("#navbar_plugin_tailscale_funnel > a");
+        if ($status.length === 0) return;
+        $status.text("Checking...");
+        $.ajax({
+            url: PLUGIN_BASEURL + "tailscale_funnel/status",
+            type: "GET",
+            dataType: "json",
+            success: function(resp) {
+                if (resp && resp.status === "success") {
+                    var enabled = !!(resp.data && resp.data.funnel_enabled);
+                    var url = resp.data && resp.data.public_url ? resp.data.public_url : "";
+                    $status.text(enabled ? "Enabled" : "Disabled");
+                    $toggleText.text(enabled ? "Disable" : "Enable");
+                    $btn.toggleClass('tsf-enabled', enabled).toggleClass('tsf-disabled', !enabled);
+                    lastEnabled = enabled;
+                    if (enabled && url) {
+                        $open.attr("href", url);
+                        $openLi.removeClass("hidden");
+                    } else {
+                        $open.attr("href", "#");
+                        $openLi.addClass("hidden");
+                    }
+                } else {
+                    $status.text("Error");
+                    $toggleText.text("Enable");
+                    $btn.removeClass('tsf-enabled tsf-disabled');
+                    $openLi.addClass("hidden");
+                }
+            },
+            error: function() {
+                $status.text("Error");
+                $toggleText.text("Enable");
+                $btn.removeClass('tsf-enabled tsf-disabled');
+                $openLi.addClass("hidden");
+            }
+        });
+    }
+
+    // Refresh when dropdown opens, and on click of Refresh
+    $(document).on('show.bs.dropdown', '#navbar_plugin_tailscale_funnel', refreshNavbarStatus);
+    $(document).on('click', '#tsf_nav_refresh', function(e) {
+        e.preventDefault();
+        refreshNavbarStatus();
+    });
+
+    $(document).on('click', '#tsf_nav_toggle', function(e) {
+        e.preventDefault();
+        var enable = !(lastEnabled === true);
+        // Optional simpler confirm: nur beim Aktivieren
+        if (enable) {
+            var c = window.confirm("Enabling Funnel will make your OctoPrint instance accessible from the public internet. Continue?");
+            if (!c) return;
+        }
+        var action = enable ? 'enable' : 'disable';
+        var $status = $("#tsf_nav_status");
+        var $toggleText = $("#tsf_nav_toggle_text");
+        var $btn = $("#navbar_plugin_tailscale_funnel > a");
+        $status.text(enable ? 'Enabling...' : 'Disabling...');
+        $.ajax({
+            url: PLUGIN_BASEURL + 'tailscale_funnel/' + action,
+            type: 'POST',
+            dataType: 'json',
+            success: function(resp) {
+                if (resp && resp.status === 'success') {
+                    if (enable) {
+                        $status.text('Enabled');
+                        $toggleText.text('Disable');
+                        $btn.addClass('tsf-enabled').removeClass('tsf-disabled');
+                        var url = resp.data && resp.data.public_url ? resp.data.public_url : '';
+                        if (url) {
+                            $("#tsf_nav_open").attr('href', url);
+                            $("#tsf_nav_open_li").removeClass('hidden');
+                        }
+                        lastEnabled = true;
+                    } else {
+                        $status.text('Disabled');
+                        $toggleText.text('Enable');
+                        $btn.addClass('tsf-disabled').removeClass('tsf-enabled');
+                        $("#tsf_nav_open").attr('href', '#');
+                        $("#tsf_nav_open_li").addClass('hidden');
+                        lastEnabled = false;
+                    }
+                    // Finaler Abgleich mit Backendstatus
+                    setTimeout(refreshNavbarStatus, 250);
+                } else {
+                    $status.text('Error');
+                    $btn.removeClass('tsf-enabled tsf-disabled');
+                }
+            },
+            error: function() {
+                $status.text('Error');
+                $btn.removeClass('tsf-enabled tsf-disabled');
+            }
+        });
+    });
+});
+

octoprint_tailscale_funnel/octoprint_tailscale_funnel/templates/tailscale_funnel_navbar.jinja2

@@ -0,0 +1,14 @@
+<li id="navbar_plugin_tailscale_funnel" class="dropdown">
+    <a class="dropdown-toggle" href="#" data-toggle="dropdown" title="Tailscale Funnel">
+        <i class="fas fa-share-square"></i>
+        <span class="visible-lg">Funnel</span>
+    </a>
+    <ul class="dropdown-menu">
+        <li class="disabled"><a href="#"><strong>Status:</strong> <span id="tsf_nav_status">Checking...</span></a></li>
+        <li id="tsf_nav_open_li" class="hidden"><a id="tsf_nav_open" href="#" target="_blank" rel="noopener"><i class="fas fa-external-link-alt"></i> Open</a></li>
+        <li><a id="tsf_nav_toggle" href="#"><i class="fas fa-toggle-on"></i> <span id="tsf_nav_toggle_text">Enable</span></a></li>
+        <li class="divider"></li>
+        <li><a id="tsf_nav_refresh" href="#"><i class="fas fa-sync"></i> Refresh</a></li>
+    </ul>
+</li>
+

octoprint_tailscale_funnel/requirements.txt

@@ -1 +1,2 @@
+# Runtime dependency for installation via OctoPrint's Plugin Manager
 OctoPrint>=1.3.0

octoprint_tailscale_funnel/setup.py

@@ -14,7 +14,7 @@ plugin_package = "octoprint_tailscale_funnel"
 plugin_name = "OctoPrint-Tailscale-Funnel"
 
 # The plugin's version. Can be overwritten within OctoPrint's internal data via __plugin_version__ in the plugin module
-plugin_version = "0.1.6.2"
+plugin_version = "0.1.6.3"
 
 # The plugin's description. Can be overwritten within OctoPrint's internal data via __plugin_description__ in the plugin
 # module
@@ -88,7 +88,18 @@ setup_parameters = octoprint_setuptools.create_plugin_setup_parameters(
 )
 
 if len(additional_setup_parameters):
-    from octoprint.util import dict_merge
+    try:
+        from octoprint.util import dict_merge
+    except Exception:
+        # Fallback to allow building without the octoprint package installed
+        def dict_merge(a, b):
+            result = dict(a)
+            for k, v in b.items():
+                if k in result and isinstance(result[k], dict) and isinstance(v, dict):
+                    result[k] = dict_merge(result[k], v)
+                else:
+                    result[k] = v
+            return result
     setup_parameters = dict_merge(setup_parameters, additional_setup_parameters)
 
 setup(**setup_parameters)

octoprint_tailscale_funnel/update.json

@@ -1,4 +1,4 @@
 {
-  "version": "0.1.6.2"
+  "version": "0.1.6.3"
 }
 

requirements.txt

@@ -0,0 +1,7 @@
+setuptools>=68
+wheel>=0.41
+build>=1.0
+packaging>=23
+# Kompatible verfügbare Version laut Index
+octoprint_setuptools==1.0.3
+

scripts/build_plugin.sh

@@ -0,0 +1,147 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Usage: scripts/build_plugin.sh [VERSION]
+# - Läuft im Projekt-.venv
+# - Optional: VERSION (z.B. 0.1.6.4). Wenn gesetzt, wird setup.py gepatcht.
+# - Baut wheel + sdist und erstellt zusätzlich ein "normales" ZIP der sdist-Struktur.
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")"/.. && pwd)"
+PLUGIN_DIR="$ROOT_DIR/octoprint_tailscale_funnel"
+DIST_DIR="$PLUGIN_DIR/dist"
+VENV_DIR="$ROOT_DIR/.venv"
+
+VERSION_INPUT="${1:-}"
+
+echo "Project root: $ROOT_DIR"
+echo "Plugin dir:   $PLUGIN_DIR"
+echo "Venv dir:     $VENV_DIR"
+
+# Ensure venv
+if [[ ! -x "$VENV_DIR/bin/python" ]]; then
+  echo "Creating venv at $VENV_DIR"
+  python3 -m venv "$VENV_DIR"
+fi
+
+if [[ -f "$ROOT_DIR/requirements.txt" ]]; then
+  "$VENV_DIR/bin/pip" install -q --upgrade pip
+  "$VENV_DIR/bin/pip" install -q -r "$ROOT_DIR/requirements.txt"
+else
+  "$VENV_DIR/bin/pip" install -q --upgrade pip setuptools wheel build packaging octoprint_setuptools
+fi
+
+# Optional: bump version
+if [[ -n "$VERSION_INPUT" ]]; then
+  echo "Setting version to $VERSION_INPUT"
+  "$VENV_DIR/bin/python" - "$VERSION_INPUT" "$PLUGIN_DIR/setup.py" <<'PY'
+import sys, re, pathlib
+ver = sys.argv[1]
+setup_path = pathlib.Path(sys.argv[2])
+text = setup_path.read_text()
+new_text = re.sub(r'^(plugin_version\s*=\s*")([^"]*)(")', lambda m: m.group(1) + ver + m.group(3), text, flags=re.M)
+setup_path.write_text(new_text)
+print("Updated version to", ver)
+PY
+fi
+
+# Clean dist
+mkdir -p "$DIST_DIR"
+rm -f "$DIST_DIR"/*
+
+# Build wheel + sdist
+echo "Building (wheel + sdist)..."
+"$VENV_DIR/bin/python" -m build --no-isolation "$PLUGIN_DIR"
+
+# Create additional plain ZIP from sdist content (flat source zip)
+SDIST_TGZ=$(ls -1 "$DIST_DIR"/*.tar.gz | tail -n1 || true)
+if [[ -n "$SDIST_TGZ" ]]; then
+  echo "Creating plain ZIP from sdist: $SDIST_TGZ"
+  TMP_DIR="$(mktemp -d)"
+  tar -xzf "$SDIST_TGZ" -C "$TMP_DIR"
+  SRC_DIR="$(find "$TMP_DIR" -maxdepth 1 -type d -name 'octoprint_tailscale_funnel-*' | head -n1)"
+  if [[ -n "$SRC_DIR" ]]; then
+    ZIP_NAME="$(basename "$SRC_DIR").zip"
+    (cd "$SRC_DIR" && zip -rq "$DIST_DIR/$ZIP_NAME" .)
+    echo "Created: $DIST_DIR/$ZIP_NAME"
+  else
+    echo "WARN: Could not find extracted sdist directory to zip"
+  fi
+  rm -rf "$TMP_DIR"
+else
+  echo "WARN: No sdist .tar.gz found, skipping plain ZIP creation"
+fi
+
+echo "Artifacts in $DIST_DIR:"
+ls -lah "$DIST_DIR"
+
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Usage: scripts/build_plugin.sh [VERSION]
+# - Läuft im Projekt-.venv
+# - Optional: VERSION (z.B. 0.1.6.4). Wenn gesetzt, wird setup.py gepatcht.
+# - Baut wheel + sdist und erstellt zusätzlich ein "normales" ZIP der sdist-Struktur.
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")"/.. && pwd)"
+PLUGIN_DIR="$ROOT_DIR/octoprint_tailscale_funnel"
+DIST_DIR="$PLUGIN_DIR/dist"
+VENV_DIR="$ROOT_DIR/.venv"
+
+VERSION_INPUT="${1:-}"
+
+echo "Project root: $ROOT_DIR"
+echo "Plugin dir:   $PLUGIN_DIR"
+echo "Venv dir:     $VENV_DIR"
+
+# Ensure venv
+if [[ ! -x "$VENV_DIR/bin/python" ]]; then
+  echo "Creating venv at $VENV_DIR"
+  python3 -m venv "$VENV_DIR"
+fi
+
+"$VENV_DIR/bin/pip" install -q --upgrade pip setuptools wheel build packaging octoprint_setuptools
+
+# Optional: bump version
+if [[ -n "$VERSION_INPUT" ]]; then
+  echo "Setting version to $VERSION_INPUT"
+  "$VENV_DIR/bin/python" - "$VERSION_INPUT" "$PLUGIN_DIR/setup.py" <<'PY'
+import sys, re, pathlib
+ver = sys.argv[1]
+setup_path = pathlib.Path(sys.argv[2])
+text = setup_path.read_text()
+new_text = re.sub(r'^(plugin_version\s*=\s*")([^"]*)(")', lambda m: m.group(1) + ver + m.group(3), text, flags=re.M)
+setup_path.write_text(new_text)
+print("Updated version to", ver)
+PY
+fi
+
+# Clean dist
+mkdir -p "$DIST_DIR"
+rm -f "$DIST_DIR"/*
+
+# Build wheel + sdist
+echo "Building (wheel + sdist)..."
+"$VENV_DIR/bin/python" -m build --no-isolation "$PLUGIN_DIR"
+
+# Create additional plain ZIP from sdist content (flat source zip)
+SDIST_TGZ=$(ls -1 "$DIST_DIR"/*.tar.gz | tail -n1 || true)
+if [[ -n "$SDIST_TGZ" ]]; then
+  echo "Creating plain ZIP from sdist: $SDIST_TGZ"
+  TMP_DIR="$(mktemp -d)"
+  tar -xzf "$SDIST_TGZ" -C "$TMP_DIR"
+  SRC_DIR="$(find "$TMP_DIR" -maxdepth 1 -type d -name 'octoprint_tailscale_funnel-*' | head -n1)"
+  if [[ -n "$SRC_DIR" ]]; then
+    ZIP_NAME="$(basename "$SRC_DIR").zip"
+    (cd "$SRC_DIR" && zip -rq "$DIST_DIR/$ZIP_NAME" .)
+    echo "Created: $DIST_DIR/$ZIP_NAME"
+  else
+    echo "WARN: Could not find extracted sdist directory to zip"
+  fi
+  rm -rf "$TMP_DIR"
+else
+  echo "WARN: No sdist .tar.gz found, skipping plain ZIP creation"
+fi
+
+echo "Artifacts in $DIST_DIR:"
+ls -lah "$DIST_DIR"
+

scripts/release_gitea.sh

@@ -1,6 +1,131 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# Usage: scripts/release_gitea.sh <version> [--draft] [--prerelease]
+# Env: liest automatisch $ROOT_DIR/.env (GITEA_TOKEN, GITEA_BASE, OWNER, REPO)
+# Falls nicht gesetzt, werden GITEA_BASE/OWNER/REPO aus der Git-Remote-URL abgeleitet.
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: $0 <version> [--draft] [--prerelease]" >&2
+  exit 1
+fi
+
+VERSION="$1"
+shift || true
+DRAFT=false
+PRERELEASE=false
+for arg in "$@"; do
+  case "$arg" in
+    --draft) DRAFT=true ;;
+    --prerelease) PRERELEASE=true ;;
+  esac
+done
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")"/.. && pwd)"
+
+# Load .env if present
+if [[ -f "$ROOT_DIR/.env" ]]; then
+  set -a
+  # shellcheck disable=SC1090
+  . "$ROOT_DIR/.env"
+  set +a
+fi
+
+# Map alternative token variable name
+if [[ -z "${GITEA_TOKEN:-}" && -n "${GITEA_API_TOKEN:-}" ]]; then
+  GITEA_TOKEN="$GITEA_API_TOKEN"
+fi
+
+# Map API URL to base if provided
+if [[ -z "${GITEA_BASE:-}" && -n "${GITEA_API_URL:-}" ]]; then
+  # strip trailing /api/... from URL
+  GITEA_BASE="${GITEA_API_URL%%/api/*}"
+fi
+
+# Map owner/repo alternative names
+if [[ -z "${OWNER:-}" && -n "${GITEA_OWNER:-}" ]]; then
+  OWNER="$GITEA_OWNER"
+fi
+if [[ -z "${REPO:-}" && -n "${GITEA_REPO:-}" ]]; then
+  REPO="$GITEA_REPO"
+fi
+
+# Derive defaults from git remote if not provided
+if [[ -z "${GITEA_BASE:-}" || -z "${OWNER:-}" || -z "${REPO:-}" ]]; then
+  ORIGIN_URL=$(git -C "$ROOT_DIR" remote get-url origin 2>/dev/null || true)
+  if [[ "$ORIGIN_URL" =~ ^https?://([^/]+)/([^/]+)/([^/]+?)(\.git)?$ ]]; then
+    : "${GITEA_BASE:="https://${BASH_REMATCH[1]}"}"
+    : "${OWNER:=${BASH_REMATCH[2]}}"
+    : "${REPO:=${BASH_REMATCH[3]}}"
+  fi
+fi
+
+: "${GITEA_TOKEN:?Set GITEA_TOKEN (in .env oder Umgebung)}"
+: "${GITEA_BASE:?Set GITEA_BASE (z. B. https://gitea.elpatron.me)}"
+: "${OWNER:?Set OWNER (z. B. elpatron)}"
+: "${REPO:?Set REPO (z. B. octo-funnel)}"
+DIST_DIR="$ROOT_DIR/octoprint_tailscale_funnel/dist"
+
+TAG="v${VERSION}"
+
+echo "Creating git tag ${TAG} and pushing..."
+git tag -f "${TAG}"
+git push -f origin "${TAG}"
+
+echo "Creating Gitea release ${TAG}..."
+BODY=$(cat <<EOF
+Release ${TAG}
+
+Changes:
+- Navbar: Statusanzeige, Toggle, Farbkennung
+- Build-Skript & Quick-Build Docs
+- Version ${VERSION}
+EOF
+)
+
+CREATE_PAYLOAD=$(jq -n \
+  --arg tag_name "${TAG}" \
+  --arg name "${TAG}" \
+  --arg body "${BODY}" \
+  --argjson draft ${DRAFT} \
+  --argjson prerelease ${PRERELEASE} \
+  '{tag_name:$tag_name, name:$name, body:$body, draft:$draft, prerelease:$prerelease}')
+
+RELEASE_JSON=$(curl -sS -X POST "${GITEA_BASE}/api/v1/repos/${OWNER}/${REPO}/releases" \
+  -H "Authorization: token ${GITEA_TOKEN}" \
+  -H 'Content-Type: application/json' \
+  -d "${CREATE_PAYLOAD}")
+
+UPLOAD_URL=$(echo "$RELEASE_JSON" | jq -r .upload_url)
+ID=$(echo "$RELEASE_JSON" | jq -r .id)
+
+if [[ -z "$ID" || "$ID" == "null" ]]; then
+  echo "Failed to create release: $RELEASE_JSON" >&2
+  exit 1
+fi
+
+echo "Release created: ID=$ID"
+echo "Using: GITEA_BASE=$GITEA_BASE OWNER=$OWNER REPO=$REPO"
+
+function upload_asset() {
+  local file="$1"
+  local name
+  name=$(basename "$file")
+  echo "Uploading asset: $name"
+  curl -sS -X POST "${GITEA_BASE}/api/v1/repos/${OWNER}/${REPO}/releases/${ID}/assets?name=${name}" \
+    -H "Authorization: token ${GITEA_TOKEN}" \
+    -H 'Content-Type: application/octet-stream' \
+    --data-binary @"$file" > /dev/null
+}
+
+upload_asset "$DIST_DIR/octoprint_tailscale_funnel-${VERSION}-py3-none-any.whl"
+upload_asset "$DIST_DIR/octoprint_tailscale_funnel-${VERSION}.tar.gz"
+upload_asset "$DIST_DIR/octoprint_tailscale_funnel-${VERSION}.zip"
+
+echo "Release ${TAG} created and assets uploaded."
+#!/usr/bin/env bash
+set -euo pipefail
+
 # Load .env if present
 if [ -f "$(dirname "$0")/../.env" ]; then
   set -a