Users visit the home page, enter their Nextcloud credentials and an admin password, and receive a unique webhook URL for AudioPen. A bookmarkable settings page (/?token=...) lets them update credentials later without needing the admin password. New users.json entries are written at runtime via POST/PUT API endpoints. Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
1.6 KiB
AudioPen Nextcloud Webhook
A Node.js service that receives notes from AudioPen and uploads them to Nextcloud via WebDAV. Includes a web UI for self-service setup — each user enters their own Nextcloud credentials and gets a unique webhook URL.
When AudioPen sends a webhook, the service:
- Validates the token in the URL
- Parses the note content (title, body, original transcript)
- Creates a timestamped Markdown file
- Uploads it to the user's configured Nextcloud folder
Example filename:
2026-05-19T22-15-10.123Z-my-note-title.md
Setup
1. Configure environment
Create a .env file in the project root:
ADMIN_PASSWORD=choose-a-strong-password
PORT=3000
# USERS_FILE=users.json # optional, defaults to users.json
ADMIN_PASSWORD is required to create new accounts via the web UI. Without it, registration is disabled (existing users can still update their settings).
2. Run
npm install
node server.js
3. Register users
Open http://localhost:3000 in a browser. Each user fills in their Nextcloud credentials and the admin password, then receives:
- A webhook URL to paste into AudioPen (
/webhook/<token>) - A settings page URL to bookmark for updating credentials later (
/?token=<token>)
Returning users
Visiting /?token=<token> pre-fills the form with existing settings and allows updating credentials without needing the admin password.
Manual user management
User credentials are stored in users.json (gitignored). You can also edit this file directly — see users.json.example for the format.