DAEMON landed packaging/nativehost/, packaging/systemd/{velox.service,velox.socket}
(real sd_listen_fds() socket activation) and cli/man/velox.1 on main while this was
in flight, duplicating paths this branch had drafted independently. Per CLAUDE.md
(packaging/nativehost/ is DAEMON's; the rest of packaging/ is PKG/QA's), DAEMON's
copies are kept as the single source and this branch's packaging/native-messaging/,
packaging/man/velox.1 and stale packaging/systemd/velox.service are dropped rather
than maintained twice. The root CMakeLists.txt's install() rules now point at
DAEMON's paths directly, install both systemd units (not just velox.service), and
docs/07-packaging.md / packaging/README.md no longer claim there's no socket
activation — there is, and this package now ships it.
Adds the local-test-only .deb itself: debian/{control,rules,postinst,postrm,
changelog,copyright}, a placeholder icon set, the desktop entry and PKG/QA's own
man pages (veloxd.8, velox-gui.1 — velox.1 stays DAEMON's). libveloxcore stays
static (no consumer needs a .so yet); pairing has no real approval UI in this
build (D1 unbuilt), so postinst and packaging/README.md both say VELOX_PAIR_AUTO=1
is required and print it prominently. No PPA, no GPG — local dpkg -i only.
Verified live: dpkg-buildpackage -us -uc -b, dpkg -i, socket activation (systemctl
--user enable --now velox.socket), `velox ls` against the running daemon, lintian
clean, dpkg -r removes the manifest/units and leaves $XDG_DATA_HOME/velox alone.
.gitignore now excludes dpkg-buildpackage's debhelper build tree and obj-*/ (the
debuild output dir) — debian/control et al. stay tracked, everything debhelper
regenerates does not.
Co-Authored-By: Claude Sonnet 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_0176u3fTrxegrGNm2yC7r69W
36 lines
879 B
Plaintext
36 lines
879 B
Plaintext
.TH VELOXD 8 "2026-09-12" "velox 0.1.0" "Velox Download Manager"
|
|
.SH NAME
|
|
veloxd \- Velox download manager daemon
|
|
.SH SYNOPSIS
|
|
.B veloxd
|
|
.SH DESCRIPTION
|
|
.B veloxd
|
|
is the background daemon behind the Velox download manager. It manages downloads,
|
|
segmented transfers and resume state in a local SQLite database, and exposes a
|
|
JSON-RPC API over a local Unix socket (for
|
|
.BR velox (1)
|
|
and
|
|
.BR velox-gui (1))
|
|
and a loopback WebSocket (for the Firefox extension).
|
|
.PP
|
|
It takes no command-line arguments. It is normally started as a
|
|
.B systemd --user
|
|
service:
|
|
.RS
|
|
.nf
|
|
systemctl --user enable --now velox.service
|
|
.fi
|
|
.RE
|
|
.SH FILES
|
|
.TP
|
|
.I $XDG_RUNTIME_DIR/velox/velox.sock
|
|
The Unix socket clients connect to.
|
|
.TP
|
|
.I $XDG_DATA_HOME/velox/velox.db
|
|
The task and settings database (default
|
|
.IR ~/.local/share/velox/velox.db ).
|
|
.SH SEE ALSO
|
|
.BR velox (1),
|
|
.BR velox-gui (1),
|
|
.BR systemctl (1)
|