diff --git a/user-facing/productivity-and-creation/shelfmark.md b/user-facing/productivity-and-creation/shelfmark.md deleted file mode 100644 index 69173fb..0000000 --- a/user-facing/productivity-and-creation/shelfmark.md +++ /dev/null @@ -1,46 +0,0 @@ -# Shelfmark — Track What You Read & Listen To - -**Shelfmark** is a reading and listening tracker that integrates with [Calibre](https://calibre-ebook.com/) and [Audiobookshelf](../media-and-entertainment/audiobookshelf.md). It provides statistics, ratings, and a clean interface for managing your media consumption. - -## Access - -- **Web UI:** -- **Internal (home network):** - -## Features - -- Track books and audiobooks across Calibre and Audiobookshelf libraries -- Rate and review items after finishing them -- View reading/listening statistics (books per month, genres, etc.) -- Sync progress with downstream services automatically -- OIDC integration — sign in with your Nest account - -## Getting Started - -1. Open in your browser. -2. Click **Sign In** and choose **Sign in with The Nest**. -3. Shelfmark will automatically connect to your Calibre and Audiobookshelf libraries (if configured by admin). -4. Start rating and tracking your media! - -## How It Works - -Shelfmark connects to: - -- **Calibre library** — Pulls book metadata, covers, and reading status -- **Audiobookshelf** — Syncs listening progress and ratings -- **Keycloak** — Handles authentication via passkeys - -## Tips - -- **Ratings sync:** Ratings you give in Shelfmark can be pushed back to Calibre/Audiobookshelf (if enabled). -- **Statistics:** Check the stats tab for insights into your reading habits — most-read authors, genres, and yearly summaries. -- **Offline access:** Shelfmark is web-only. For offline tracking, consider a dedicated app like [Readest](https://github.com/readest/readest) or [Foliate](https://github.com/johnfactotum/foliate). - -## Related Services - -- [Calibre-Web](../media-and-entertainment/calibre-web.md) — E-book library (Shelfmark reads from this data) -- [Audiobookshelf](../media-and-entertainment/audiobookshelf.md) — Audiobook server (Shelfmark syncs with this) - ---- - -*TODO: Add screenshot of Shelfmark dashboard showing reading statistics.* diff --git a/user-facing/storage-and-files/nextcloud.md b/user-facing/storage-and-files/nextcloud.md index c12efd8..a6eb397 100644 --- a/user-facing/storage-and-files/nextcloud.md +++ b/user-facing/storage-and-files/nextcloud.md @@ -1,61 +1,88 @@ -# Nextcloud — File Sync, Sharing & Cloud Storage +# Nextcloud: Cloud Storage, Office Suite & Productivity Hub -**Nextcloud** is a self-hosted file sync and sharing platform. Store files, share them with others, and access them from any device — all under your control. - -## Access - -- **Web UI:** -- **Internal (home network):** -- **DAV / CalDAV / CardDAV:** `https://cloud.mynest.love/remote.php/dav/` - -## Features - -- File storage and synchronization across devices -- Share files and folders via link or with specific users -- Integrated calendar (CalDAV) and contacts (CardDAV) -- Office suite integration for viewing and editing documents -- End-to-end encryption support (optional) - -## Getting Started - -1. Open in your browser. -2. Click **Sign In** and choose **Sign in with The Nest**. -3. Upload files via the web interface or use a sync client. - -## Sync Clients - -Nextcloud provides official clients for: - -- **Desktop:** Windows, macOS, Linux ([Download](https://nextcloud.com/install/#install-clients)) -- **Mobile:** iOS and Android ([App Store](https://apps.nextcloud.com/)) -- **WebDAV:** Configure any DAV-compatible app with the URL above - -### Calendar & Contacts Sync - -Add these to your device's calendar/contacts app: - -| Type | Protocol | URL | -|------|----------|-----| -| Calendar | CalDAV | `https://cloud.mynest.love/remote.php/dav/principals/your-username/` | -| Contacts | CardDAV | `https://cloud.mynest.love/remote.php/dav/principals/your-username/` | - -Sign in with your Nest credentials when prompted. - -## Tips - -- **File versioning:** Nextcloud keeps previous versions of files. Right-click a file → **Versions** to restore an older copy. -- **Sharing links:** Create shareable links with expiration dates and password protection for sensitive files. -- **Offline access:** Use the desktop sync client to keep a local copy of your files for offline work. - -## Backups - -Nextcloud user data is backed up daily at 02:00 EST using Restic to Backblaze B2. Configuration files are snapshotted via Longhorn's recurring backup jobs. - -## Related Services - -- [Keycloak](../technical/security-and-identity.md) — Handles authentication -- [Vaultwarden](../communication-and-security/vaultwarden.md) — Store Nextcloud credentials securely +**Nextcloud** (Nextcloud Hub) is the primary cloud storage, document collaboration, and groupware platform for **The Nest**. Far more than a simple file dump, Nextcloud combines cross-device file synchronization, real-time collaborative document editing, shared calendars, contacts, and productivity tools into a unified, privacy-focused portal. --- -*TODO: Add screenshot of Nextcloud file browser with a sample folder.* +## 1. Web Access & Initial Setup + +1. Open **[cloud.mynest.love](https://cloud.mynest.love)** in your Web browser. +2. Click **Sign In** and select **"Sign in with The Nest"**. +3. Log in using your standard Nest passkey. + +--- + +## 2. Core Features & Capabilities + +* **File Storage & Synchronization:** Store files securely with continuous background sync across desktop and mobile devices. +* **File Versioning & Recovery:** Nextcloud automatically tracks file history. Right-click any file and select **Versions** to inspect or restore prior edits. +* **Secure File Sharing:** Share files and folders internally with Nest members or publicly via shareable links. Public shares can be secured with passwords, expiration dates, and download restrictions. +* **Project Management (Deck):** Organize team tasks and personal projects using built-in Kanban boards. +* **Activity Stream:** Track recent edits, file uploads, and comments across your shared folders in real time. + +--- + +## 3. Nextcloud Office Suite (Collaborative Editing) + +Nextcloud includes a full-featured, browser-based office suite (powered by Nextcloud Office) for working with documents, spreadsheets, and presentations: + +* **Real-Time Co-Authoring:** Multiple users can open and edit the same document simultaneously with live cursor tracking, in-document chatting, and revision history. +* **Native Microsoft & OpenDocument Support:** Seamlessly view, edit, and export formats including Word (`.docx`, `.doc`), Excel (`.xlsx`, `.xls`), PowerPoint (`.pptx`), and OpenDocument (`.odt`, `.ods`, `.odp`). +* **In-Browser Document Creation:** Create new text documents, spreadsheets, or presentation decks directly from the Nextcloud **Files** interface without needing local office software installed. +* **Comments & Annotations:** Add comments, tag team members using `@mentions`, and track suggested changes directly within documents. +* **PDF Viewing & Annotation:** View, search, and annotate PDF files directly inside your browser window. + +--- + +## 4. Calendar, Contacts & Tasks Integration (CalDAV / CardDAV) + +Nextcloud provides built-in CalDAV and CardDAV endpoints for syncing your calendars, address books, and tasks across mobile and desktop applications. + +> [!TIP] +> **Authentication Note for Native Apps (App Passwords)** +> Native calendar and contact apps on iOS, macOS, Android, or Thunderbird cannot use passkeys directly. +> +> * Before configuring your app, go to **Settings → Security → Devices & Sessions** in Nextcloud. +> * Generate a new **App Password** (e.g., named "iPhone Calendar"). +> * Copy the generated password and use it as your account password during device setup. + +### Integration Endpoints & Manual Setup + +| Type | Protocol | Base / Auto-Discovery URL | Direct Server Path | +| :--- | :--- | :--- | :--- | +| **Primary DAV Endpoint** | WebDAV / DAV | `https://cloud.mynest.love/remote.php/dav/` | Auto-discovers calendars & contacts | +| **Calendar (CalDAV)** | CalDAV | `https://cloud.mynest.love/remote.php/dav/` | `/remote.php/dav/principals/users//` | +| **Contacts (CardDAV)** | CardDAV | `https://cloud.mynest.love/remote.php/dav/` | `/remote.php/dav/principals/users//` | + +### Setting Up Sync on Your Devices: +* **iOS / macOS:** Go to **System Settings → Internet Accounts → Add Account → Add Other Account → CalDAV Account (or CardDAV)**. Select **Advanced** and set the Server Address to `cloud.mynest.love` and the Server Path to `/remote.php/dav/principals/users//`. Alternatively, copy the exact subscription link by opening the Nextcloud **Calendar app → ⚙ Calendar settings → Copy iOS/macOS CalDAV address**. +* **Android:** Install **[DAVx⁵](https://www.davx5.com/)** from Google Play or F-Droid, choose **Login with URL and user name**, and enter `https://cloud.mynest.love/remote.php/dav/` alongside your username and App Password. +* **Thunderbird / Desktop:** Thunderbird autodiscovers all calendars and address books simply by adding a new Calendar and logging in with your Nextcloud URL and credentials. + +*For detailed device-specific guides, consult the [Official Nextcloud Groupware Sync Documentation](https://docs.nextcloud.com/server/latest/user_manual/en/groupware/index.html).* + +--- + +## 5. Sync Clients & Mobile Apps + +* **Desktop Sync Client:** Sync local folders with Nextcloud on Windows, macOS, and Linux ([Download Clients](https://nextcloud.com/install/#install-clients)). Supports **Virtual Files** (files are visible locally but downloaded on demand to save disk space). +* **Mobile Apps (iOS & Android):** Browse files on the go and enable **Auto-Upload** in the app settings to automatically back up phone photos and videos directly to your Nextcloud cloud storage. + +--- + +## 6. Service Summary & Infrastructure Notes + +| Component | URL / Endpoint | Purpose | +| :--- | :--- | :--- | +| **Web UI** | [cloud.mynest.love](https://cloud.mynest.love) | Primary cloud portal, office suite, and web manager | +| **DAV / CalDAV / CardDAV** | `https://cloud.mynest.love/remote.php/dav/` | Synchronization endpoint for files, calendars, and contacts | + +### Backups & Data Protection: +* **User Data:** Backed up daily at **02:00 EST** using Restic to offsite Backblaze B2 storage. +* **Configuration & Database:** Application state and cluster configurations are snapshotted via Longhorn recurring backup tasks. + +--- + +## Related Nest Documentation: +* **[Forgejo](../technical/forgejo.md):** Git code hosting and package management. +* **[Matrix Chat](../communication-and-security/matrix.md):** Instant messaging and administrative support.