deb build framework

README.md

@@ -0,0 +1,22 @@
+# navidrome-uploader
+
+Small Flask app that uploads audio files to a Navidrome music folder.
+
+## Debian packaging
+
+Debian packaging files are in `debian/`.
+
+The package installs:
+- app code in `/opt/navidrome-uploader`
+- environment file in `/etc/default/navidrome-uploader/.env`
+- systemd unit in `/lib/systemd/system/navidrome-uploader.service`
+- Python dependencies in `/opt/navidrome-uploader/venv` during `postinst`
+
+### Build a `.deb`
+
+```sh
+./release/build-deb.sh
+```
+
+The resulting package is written to the parent directory of the project.
+

debian/changelog

@@ -0,0 +1,6 @@
+navidrome-uploader (0.1.0) unstable; urgency=medium
+
+  * Add Debian packaging with systemd service integration and venv setup.
+
+ -- Arian Nasr <arian@example.com>  Tue, 07 Apr 2026 12:00:00 +0000
+

debian/control

@@ -0,0 +1,17 @@
+Source: navidrome-uploader
+Section: web
+Priority: optional
+Maintainer: Arian Nasr <arian@example.com>
+Build-Depends: debhelper-compat (= 13)
+Standards-Version: 4.7.0
+Rules-Requires-Root: no
+
+Package: navidrome-uploader
+Architecture: all
+Depends: ${misc:Depends}, adduser, python3, python3-pip, python3-venv
+Description: Lightweight web uploader for Navidrome music libraries
+ Flask application that provides a drag-and-drop web interface for uploading
+ audio files into a Navidrome music directory. The package installs a
+ hardened systemd service and manages Python dependencies in a dedicated venv
+ under /opt/navidrome-uploader.
+

debian/navidrome-uploader.dirs

@@ -0,0 +1,7 @@
+opt/navidrome-uploader
+opt/navidrome-uploader/templates
+opt/navidrome-uploader/static
+opt/navidrome-uploader/static/css
+opt/navidrome-uploader/static/js
+etc/default/navidrome-uploader
+

debian/navidrome-uploader.install

@@ -0,0 +1,9 @@
+main.py opt/navidrome-uploader/
+gunicorn.conf.py opt/navidrome-uploader/
+requirements.txt opt/navidrome-uploader/
+.env.example opt/navidrome-uploader/
+templates/* opt/navidrome-uploader/templates/
+static/css/* opt/navidrome-uploader/static/css/
+static/js/* opt/navidrome-uploader/static/js/
+contrib/navidrome-uploader.service lib/systemd/system/
+

debian/navidrome-uploader.postinst

@@ -0,0 +1,22 @@
+#!/bin/sh
+set -e
+
+APP_DIR="/opt/navidrome-uploader"
+VENV_DIR="${APP_DIR}/venv"
+
+case "$1" in
+    configure)
+        python3 -m venv "${VENV_DIR}"
+        "${VENV_DIR}/bin/pip" install --no-cache-dir --upgrade pip
+        "${VENV_DIR}/bin/pip" install --no-cache-dir -r "${APP_DIR}/requirements.txt"
+
+        if command -v systemctl > /dev/null 2>&1; then
+            systemctl daemon-reload || true
+            systemctl enable navidrome-uploader.service || true
+            systemctl restart navidrome-uploader.service || true
+        fi
+        ;;
+esac
+
+exit 0
+

debian/navidrome-uploader.postrm

@@ -0,0 +1,14 @@
+#!/bin/sh
+set -e
+
+if command -v systemctl > /dev/null 2>&1; then
+    systemctl daemon-reload || true
+fi
+
+if [ "$1" = "purge" ]; then
+    rm -rf /etc/default/navidrome-uploader
+    rm -rf /opt/navidrome-uploader/venv
+fi
+
+exit 0
+

debian/navidrome-uploader.preinst

@@ -0,0 +1,10 @@
+#!/bin/sh
+set -e
+
+if ! getent passwd navidrome-uploader > /dev/null 2>&1; then
+    printf "Creating navidrome-uploader user\n"
+    useradd --system --shell /usr/sbin/nologin --user-group navidrome-uploader
+fi
+
+exit 0
+

debian/navidrome-uploader.prerm

@@ -0,0 +1,14 @@
+#!/bin/sh
+set -e
+
+case "$1" in
+    remove|deconfigure)
+        if command -v systemctl > /dev/null 2>&1; then
+            systemctl stop navidrome-uploader.service || true
+            systemctl disable navidrome-uploader.service || true
+        fi
+        ;;
+esac
+
+exit 0
+

debian/rules

@@ -0,0 +1,10 @@
+#!/usr/bin/make -f
+
+%:
+	dh $@
+
+override_dh_install:
+	dh_install
+	install -d debian/navidrome-uploader/etc/default/navidrome-uploader
+	install -m 0640 .env.example debian/navidrome-uploader/etc/default/navidrome-uploader/.env
+

debian/source/format

@@ -0,0 +1,2 @@
+3.0 (native)
+

release/build-deb.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+set -eu
+
+SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+PROJECT_ROOT="$(CDPATH= cd -- "${SCRIPT_DIR}/.." && pwd)"
+
+cd "${PROJECT_ROOT}"
+dpkg-buildpackage -us -uc -b
+