# LinkyDink — User Guide

LinkyDink is a native Mac app for browsing, reading, adding and organizing the bookmarks on your self-hosted [linkding](https://linkding.link) server. It follows Apple's design conventions: a three-pane window, a menu bar shortcut, and a system-wide hotkey for saving pages.

## Getting connected

1. Open **Settings** (⌘,).
2. Enter your **Server URL** (for example `http://192.168.1.20:9090`, or the address you use for linkding over VPN) and your **API token** (in linkding: Settings › Integrations).
3. Click **Test Connection**, then **Save**.

The token is stored in your Mac's keychain. Plain `http://` is allowed only to private-network addresses (home network or VPN). **Sign Out** in Settings removes the token.

## The main window

| Pane | What it shows |
|---|---|
| **Sidebar** | *Library*: All Bookmarks, Unread, Untagged, Archived (with counts). *Tags*: every tag in use, with counts. Click to filter. |
| **List** | Title, description, favicon, website and date. A blue dot marks unread. Search from the toolbar (`#tag` searches by tag). |
| **Third pane** | **Page**: a header (site, date, tags, note) with the live page below. **Details**: description, tags, notes, dates and status. Switch with the Page / Details control. |

**Edit** turns the third pane into the editor (URL, title, description, tags, notes, unread / shared / archived). Selecting another bookmark ends editing.

**Open** sends the bookmark to your default browser or LinkyDink's built-in browser window (back, forward, reload, share). Choose in Settings › Opening Bookmarks. Double-clicking a bookmark does the same.

Right-click any bookmark for Open, Open in Default Browser, Copy URL, Edit, Mark Read/Unread, Archive and Delete.

## Adding bookmarks

- **⌘N**: New bookmark. As you type the URL, LinkyDink checks your server, suggests the title and description, and switches to editing the existing entry if it's already saved. Tags autocomplete.
- **⌃⌥⌘L** (from any app): Saves the current tab in Safari, Chrome, Arc, Brave, Edge, Vivaldi or Opera. In other apps it uses a URL on the clipboard.
- **⇧⌘V**: Adds the URL on the clipboard.

## Menu bar

The bookmark icon in the menu bar offers quick search (up to 10 results, plus **Show All Results in Window**), recent bookmarks, Add Current Tab, and shortcuts to the main window and Settings. LinkyDink keeps running there when the window is closed.

## Keyboard shortcuts

| Action | Shortcut |
|---|---|
| New bookmark | ⌘N |
| Add from clipboard | ⇧⌘V |
| Save current browser tab (anywhere) | ⌃⌥⌘L |
| Open bookmark | ⌘O |
| Edit | ⌘E |
| Mark Read / Unread | ⇧⌘U |
| Archive / Unarchive | ⌃⌘A |
| Copy URL | ⌥⌘C |
| Delete (asks first) | ⌘⌫ |
| Refresh | ⌘R |
| Settings | ⌘, |

## Installing and updating

- **This Mac:** `./build.sh --install` builds the app, installs it in /Applications and opens it.
- **Other Macs:** `./make-dmg.sh` creates `dist/LinkyDink-<version>.dmg` (Apple silicon and Intel, macOS 14+). On first launch, macOS may ask you to approve it in System Settings › Privacy & Security.
- **Fewer permission prompts:** create the `Linkding Local Signing` certificate (see README) so every build has the same signature.

Requires macOS 14 Sonoma or later and a linkding server.