# docrock/amazon-link-converter-short architecture

> Architecture diagram of the GitHub repository docrock/amazon-link-converter-short, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/docrock/amazon-link-converter-short
- Repository: https://github.com/docrock/amazon-link-converter-short

## Overview

This is a macOS background utility that watches the clipboard and turns copied Amazon product URLs into short affiliate links. Its documented flow extracts an ASIN, generates an amzn.com URL, and provides audio and desktop feedback while recording activity. Login startup is provided through a LaunchAgent. The README documents these capabilities, but no source excerpts were available, so internal script-to-script calls and the precise handling of clipboard and feedback operations cannot be verified.

Main entry points: [`amazon-link-watcher.sh`](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh) (Clipboard watcher), [`amazon-link-converter.sh`](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh) (Link converter), [`com.infophreak.amazonlinkconverter.plist`](https://github.com/docrock/amazon-link-converter-short/blob/main/com.infophreak.amazonlinkconverter.plist) (LaunchAgent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_conversion["Link conversion"]
  node_converter["Link converter"]
  node_asin["ASIN extraction"]
  node_shorturl["Short URL generation"]
  node_fallback["Fallback conversion"]
end

subgraph group_service["Background service"]
  node_watcher["Clipboard watcher"]
  node_launchagent["LaunchAgent"]
end

subgraph group_feedback["User feedback"]
  node_audio["Audio feedback"]
  node_notifications["Desktop notifications"]
  node_logs["Activity log"]
end

node_user(("User"))
node_clipboard["System clipboard"]

node_user -->|"copies URL"| node_clipboard
node_clipboard -->|"monitors"| node_watcher
node_watcher -.->|"converts via"| node_converter
node_converter -->|"extracts ASIN"| node_asin
node_converter -->|"generates link"| node_shorturl
node_converter -->|"falls back"| node_fallback
node_shorturl -->|"replaces URL"| node_clipboard
node_fallback -.->|"replaces URL"| node_clipboard
node_watcher -->|"plays feedback"| node_audio
node_watcher -->|"notifies user"| node_notifications
node_watcher -->|"records activity"| node_logs
node_launchagent -->|"starts at login"| node_watcher

click node_watcher "https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh"
click node_launchagent "https://github.com/docrock/amazon-link-converter-short/blob/main/com.infophreak.amazonlinkconverter.plist"
click node_converter "https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh"
click node_asin "https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh"
click node_shorturl "https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh"
click node_fallback "https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh"
click node_audio "https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh"
click node_notifications "https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh"
click node_logs "https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_converter,node_asin,node_shorturl,node_fallback,node_user toneBlue
class node_watcher,node_launchagent toneAmber
class node_audio,node_notifications,node_logs toneMint
class node_clipboard toneIndigo
```

## Components

### Link conversion

- [Link converter](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh): `amazon-link-converter.sh`
- [ASIN extraction](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh): `amazon-link-converter.sh`
- [Short URL generation](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh): `amazon-link-converter.sh`
- [Fallback conversion](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-converter.sh): `amazon-link-converter.sh`

### Background service

- [Clipboard watcher](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh): `amazon-link-watcher.sh`
- [LaunchAgent](https://github.com/docrock/amazon-link-converter-short/blob/main/com.infophreak.amazonlinkconverter.plist): `com.infophreak.amazonlinkconverter.plist`

### User feedback

- [Audio feedback](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh): `amazon-link-watcher.sh`
- [Desktop notifications](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh): `amazon-link-watcher.sh`
- [Activity log](https://github.com/docrock/amazon-link-converter-short/blob/main/amazon-link-watcher.sh): `amazon-link-watcher.sh`

### Other components

- **User**
- **System clipboard**

## Connections

- User → System clipboard: copies URL (evidence: `README.md`)
- System clipboard → Clipboard watcher: monitors (evidence: `README.md`)
- Clipboard watcher → Link converter: converts via
- Link converter → ASIN extraction: extracts ASIN (evidence: `README.md`)
- Link converter → Short URL generation: generates link (evidence: `README.md`)
- Link converter → Fallback conversion: falls back (evidence: `README.md`)
- Short URL generation → System clipboard: replaces URL (evidence: `README.md`)
- Fallback conversion → System clipboard: replaces URL
- Clipboard watcher → Audio feedback: plays feedback (evidence: `README.md`)
- Clipboard watcher → Desktop notifications: notifies user (evidence: `README.md`)
- Clipboard watcher → Activity log: records activity (evidence: `README.md`)
- LaunchAgent → Clipboard watcher: starts at login (evidence: `README.md`)
