English | 中文 | Español

English

LLMCal - AI-Powered Calendar Event Creator for PopClip

LLMCal is a powerful PopClip extension that uses AI to convert selected text into calendar events. It understands natural language descriptions and automatically creates events with proper titles, times, locations, meeting links, and reminders.

Features

• 🤖 AI-Powered: Uses Claude AI to understand natural language event descriptions
• ⚡️ Quick Creation: Create calendar events with a single click
• 🌐 Meeting Links: Automatically extracts and adds meeting URLs (Zoom, Teams, Google Meet, etc.)
• 📍 Location Support: Handles both physical and virtual meeting locations
• ⏰ Smart Reminders: Sets up event alerts based on text descriptions
• 🔄 Recurring Events: Supports various recurring event patterns
• 👥 Attendees: Automatically adds event participants from email addresses in the text
• 🌍 Time Zones: Understands and handles different time zones in event descriptions

Prerequisites

1. PopClip Installation

   • Download PopClip from https://www.popclip.app/
   • PopClip requires macOS 10.13 or later
   • After installation, allow PopClip in System Settings:
     • Go to System Settings > Privacy & Security > Accessibility
     • Enable PopClip in the list of allowed apps

2. Anthropic API Key

   • Sign up for an account at Anthropic
   • Create an API key from your dashboard
   • Keep this key handy for the LLMCal setup

Installation

1. Install LLMCal Extension

   • Download the latest release (LLMCal.popclipext.zip) from the Releases page
   • Double-click the downloaded file to install it in PopClip
   • When prompted, click "Install Extension"

2. Configure LLMCal

   • Open PopClip's preferences (click the PopClip icon in the menu bar and select the gear icon)
   • Find and click on the LLMCal extension in the extensions list
   • Enter your Anthropic API key in the settings field
   • Click "Save" to apply the changes

3. Verify Installation

   • The calendar icon should appear in the PopClip menu when you select text
   • If you don't see PopClip when selecting text:
     • Make sure PopClip is running (the icon should be visible in the menu bar)
     • Try selecting text again in any application
     • If needed, restart PopClip from the menu bar icon

Usage

1. Select any text that describes an event, for example:
   • "Team meeting tomorrow at 2pm for 1 hour"
   • "Weekly standup every Monday at 9:30am, 30 minutes, Zoom link: https://zoom.us/j/123"
   • "Lunch with John next Friday at noon at Starbucks downtown"
2. Click the calendar icon in the PopClip menu
3. The event will be automatically created in your calendar with all relevant details

Example Inputs

"Product demo next Tuesday 3pm with client@example.com, 1 hour on Zoom https://zoom.us/j/123, remind me 15 minutes before"

"Monthly team review on the last Friday of each month, 2pm-4pm, Conference Room A, reminder 1 day before"

"Weekly 1:1 with manager every Thursday 10am PST (my time 1pm EST), 30 minutes, Teams link: https://teams.microsoft.com/l/123"

Requirements

• macOS 10.15 or later
• PopClip 2022.5 or later
• Anthropic API key
• Calendar.app access permission
• Internet connection

Google Calendar Integration

While LLMCal currently works directly with Apple Calendar, you can still use it with Google Calendar by following these steps:

1. Add Google Calendar to Apple Calendar

   • Open System Settings on your Mac
   • Go to "Internet Accounts"
   • Click "Add Account" and select "Google"
   • Sign in with your Google account
   • Make sure "Calendar" is checked in the list of services
   • Your Google Calendar will now sync with Apple Calendar

2. Usage Tips

   • Events created through LLMCal will automatically sync to your Google Calendar
   • All events, reminders, and updates will be synchronized between both calendars
   • You can manage which calendars to show/hide in Apple Calendar's sidebar
   • The sync is bi-directional: changes made in Google Calendar will appear in Apple Calendar and vice versa

3. Troubleshooting

   • If events aren't syncing, check your internet connection
   • Ensure your Google account is properly connected in System Settings
   • Try removing and re-adding your Google account if issues persist
   • Check if you've granted necessary permissions to both calendars

Privacy & Security

• Your API key is stored securely in PopClip's settings
• No event data is stored or transmitted except to create the calendar event
• All natural language processing is done through Claude AI
• The extension only requires necessary permissions: text selection and calendar access

Troubleshooting

If you encounter any issues:

1. Make sure your Anthropic API key is correctly entered in the extension settings
2. Check that you've granted calendar access permissions to PopClip
3. Ensure your text selection includes all necessary event details
4. Verify your internet connection

Support

For issues, feature requests, or contributions, please visit the GitHub repository.

License

This project is licensed under the GNU Affero General Public License Version 3 (AGPLv3) with Commons Clause - see the LICENSE file for details. This license ensures that the software remains open source while protecting against commercial exploitation. Any modifications or derivative works must also be released under the same license terms.

中文

LLMCal - 基于 AI 的 PopClip 日历事件创建工具

LLMCal 是一个强大的 PopClip 扩展，使用 AI 将选定的文本转换为日历事件。它能理解自然语言描述，并自动创建包含适当标题、时间、地点、会议链接和提醒的事件。

特点

• 🤖 AI 驱动：使用 Claude AI 理解自然语言事件描述
• ⚡️ 快速创建：一键创建日历事件
• 🌐 会议链接：自动提取并添加会议 URL（Zoom、Teams、Google Meet 等）
• 📍 位置支持：处理实体和虚拟会议地点
• ⏰ 智能提醒：根据文本描述设置事件提醒
• 🔄 重复事件：支持各种重复事件模式
• 👥 参与者：自动从文本中的电子邮件地址添加事件参与者
• 🌍 时区：理解并处理事件描述中的不同时区

前提条件

1. PopClip 安装

   • 从 https://www.popclip.app/ 下载 PopClip
   • PopClip 需要 macOS 10.13 或更高版本
   • 安装后，在系统设置中允许 PopClip：
     • 转到系统设置 > 隐私与安全 > 辅助功能
     • 在允许的应用程序列表中启用 PopClip

2. Anthropic API 密钥

   • 在 Anthropic 注册一个账户
   • 从您的仪表板创建一个 API 密钥
   • 为 LLMCal 设置保留此密钥

安装

1. 安装 LLMCal 扩展

   • 从 发布页面 下载最新版本（LLMCal.popclipext.zip）
   • 双击下载的文件以在 PopClip 中安装
   • 出现提示时，点击“安装扩展”

2. 配置 LLMCal

   • 打开 PopClip 的偏好设置（点击菜单栏中的 PopClip 图标并选择齿轮图标）
   • 在扩展列表中找到并点击 LLMCal 扩展
   • 在设置字段中输入您的 Anthropic API 密钥
   • 点击“保存”以应用更改

3. 验证安装

   • 选择文本时，PopClip 菜单中应该出现日历图标
   • 如果您没有看到 PopClip：
     • 确保 PopClip 正在运行（菜单栏中应该可见图标）
     • 尝试在任何应用程序中再次选择文本
     • 如果需要，从菜单栏图标重新启动 PopClip

使用方法

1. 选择任何描述事件的文本，例如：
   • "明天下午2点开一小时的团队会议"
   • "每周一上午9:30的站会，30分钟，Zoom链接：https://zoom.us/j/123"
   • "下周五中午和约翰在市中心星巴克吃午饭"
2. 点击 PopClip 菜单中的日历图标
3. 事件将自动创建在您的日历中，包含所有相关详细信息

输入示例

"下周二下午3点与 client@example.com 进行产品演示，1小时，Zoom会议 https://zoom.us/j/123，提前15分钟提醒"

"每月最后一个周五下午2点到4点的月度团队回顾，会议室A，提前1天提醒"

"每周四上午10点PST（我的时间是EST下午1点）与经理进行30分钟的一对一会议，Teams链接：https://teams.microsoft.com/l/123"

系统要求

• macOS 10.15 或更高版本
• PopClip 2022.5 或更高版本
• Anthropic API 密钥
• Calendar.app 访问权限
• 互联网连接

Google 日历集成

虽然 LLMCal 目前直接与 Apple 日历一起工作，但您仍然可以按照以下步骤使用它与 Google 日历：

1. 将 Google 日历添加到 Apple 日历

   • 在您的 Mac 上打开系统设置
   • 转到“互联网账户”
   • 点击“添加账户”并选择“Google”
   • 使用您的 Google 账户登录
   • 确保服务列表中选中了“日历”
   • 您的 Google 日历现在将与 Apple 日历同步

2. 使用提示

   • 通过 LLMCal 创建的事件将自动同步到您的 Google 日历
   • 所有事件、提醒和更新都将在两个日历之间同步
   • 您可以在 Apple 日历的侧边栏中管理显示/隐藏哪些日历
   • 同步是双向的：在 Google 日历中进行的更改将出现在 Apple 日历中，反之亦然

3. 故障排除

   • 如果事件没有同步，请检查您的互联网连接
   • 确保您的 Google 账户在系统设置中正确连接
   • 如果问题持续，请尝试删除并重新添加您的 Google 账户
   • 检查是否已授予两个日历必要的权限

隐私与安全

• 你的 API 密钥安全存储在 PopClip 的设置中
• 除了创建日历事件外，不存储或传输任何事件数据
• 所有自然语言处理通过 Claude AI 完成
• 扩展仅需要必要的权限：文本选择和日历访问

故障排除

如果遇到任何问题：

1. 确保在扩展设置中正确输入了 Anthropic API 密钥
2. 检查是否已授予 PopClip 日历访问权限
3. 确保你的文本选择包含所有必要的事件详细信息
4. 验证你的互联网连接

支持

如有问题、功能请求或贡献，请访问 GitHub 仓库。

许可证

本项目采用带有 Commons Clause 的 GNU Affero 通用公共许可证第3版 (AGPLv3) 授权 - 详见 LICENSE 文件。该许可证确保软件保持开源的同时防止商业利用。任何修改或衍生作品也必须在相同的许可条款下发布。

Español

LLMCal - Creador de Eventos de Calendario Impulsado por IA para PopClip

LLMCal es una potente extensión de PopClip que utiliza IA para convertir texto seleccionado en eventos de calendario. Comprende descripciones en lenguaje natural y crea automáticamente eventos con títulos, horarios, ubicaciones, enlaces de reunión y recordatorios apropiados.

Características

• 🤖 Impulsado por IA: Utiliza Claude AI para comprender descripciones de eventos en lenguaje natural
• ⚡️ Creación Rápida: Crea eventos de calendario con un solo clic
• 🌐 Enlaces de Reunión: Extrae y añade automáticamente URLs de reuniones (Zoom, Teams, Google Meet, etc.)
• 📍 Soporte de Ubicación: Maneja ubicaciones de reuniones tanto físicas como virtuales
• ⏰ Recordatorios Inteligentes: Configura alertas de eventos basadas en descripciones de texto
• 🔄 Eventos Recurrentes: Soporta varios patrones de eventos recurrentes
• 👥 Participantes: Añade automáticamente participantes del evento desde direcciones de correo electrónico en el texto
• 🌍 Zonas Horarias: Comprende y maneja diferentes zonas horarias en las descripciones de eventos

Prerrequisitos

1. Instalación de PopClip

   • Descarga PopClip desde https://www.popclip.app/
   • PopClip requiere macOS 10.13 o posterior
   • Después de la instalación, permite PopClip en la configuración del sistema:
     • Ve a Configuración del sistema > Privacidad y seguridad > Accesibilidad
     • Activa PopClip en la lista de aplicaciones permitidas

2. Clave API de Anthropic

   • Registra una cuenta en Anthropic
   • Crea una clave API desde tu panel de control
   • Conserva esta clave para la configuración de LLMCal

Instalación

1. Instalar la extensión LLMCal

   • Descarga la última versión (LLMCal.popclipext.zip) desde la página de lanzamientos
   • Haz doble clic en el archivo descargado para instalarlo en PopClip
   • Cuando se te solicite, haz clic en "Instalar Extensión"

2. Configurar LLMCal

   • Abre las preferencias de PopClip (haz clic en el icono de PopClip en la barra de menús y selecciona el icono de engranaje)
   • Encuentra y haz clic en la extensión LLMCal en la lista de extensiones
   • Ingresa tu clave API de Anthropic en el campo de configuración
   • Haz clic en "Guardar" para aplicar los cambios

3. Verificar la instalación

   • El icono del calendario debería aparecer en el menú de PopClip cuando seleccionas texto
   • Si no ves PopClip cuando seleccionas texto:
     • Asegúrate de que PopClip esté en ejecución (el icono debería ser visible en la barra de menús)
     • Intenta seleccionar texto de nuevo en cualquier aplicación
     • Si es necesario, reinicia PopClip desde el icono de la barra de menús

Uso

1. Selecciona cualquier texto que describa un evento, por ejemplo:
   • "Reunión de equipo mañana a las 2pm por 1 hora"
   • "Reunión semanal todos los lunes a las 9:30am, 30 minutos, enlace de Zoom: https://zoom.us/j/123"
   • "Almuerzo con Juan el próximo viernes al mediodía en el Starbucks del centro"
2. Haz clic en el icono del calendario en el menú de PopClip
3. El evento se creará automáticamente en tu calendario con todos los detalles relevantes

Ejemplos de Entrada

"Demostración de producto el próximo martes a las 3pm con client@example.com, 1 hora en Zoom https://zoom.us/j/123, recordarme 15 minutos antes"

"Revisión mensual del equipo el último viernes de cada mes, 2pm-4pm, Sala de Conferencias A, recordatorio 1 día antes"

"Reunión semanal 1:1 con el gerente todos los jueves 10am PST (mi hora 1pm EST), 30 minutos, enlace de Teams: https://teams.microsoft.com/l/123"

Requisitos

• macOS 10.15 o posterior
• PopClip 2022.5 o posterior
• Clave API de Anthropic
• Permiso de acceso a Calendar.app
• Conexión a Internet

Integración con Google Calendar

Aunque LLMCal actualmente funciona directamente con Apple Calendar, puedes seguir utilizando Google Calendar siguiendo estos pasos:

1. Agregar Google Calendar a Apple Calendar

   • Abre la configuración del sistema en tu Mac
   • Ve a "Cuentas de Internet"
   • Haz clic en "Agregar cuenta" y selecciona "Google"
   • Inicia sesión con tu cuenta de Google
   • Asegúrate de que "Calendario" esté seleccionado en la lista de servicios
   • Tu calendario de Google ahora se sincronizará con Apple Calendar

2. Consejos de uso

   • Los eventos creados a través de LLMCal se sincronizarán automáticamente con tu calendario de Google
   • Todos los eventos, recordatorios y actualizaciones se sincronizarán entre ambos calendarios
   • Puedes gestionar qué calendarios mostrar/ocultar en la barra lateral de Apple Calendar
   • La sincronización es bidireccional: los cambios realizados en Google Calendar aparecerán en Apple Calendar y viceversa

3. Solución de problemas

   • Si los eventos no se sincronizan, verifica tu conexión a Internet
   • Asegúrate de que tu cuenta de Google esté correctamente conectada en la configuración del sistema
   • Intenta eliminar y volver a agregar tu cuenta de Google si persisten los problemas
   • Verifica si has otorgado los permisos necesarios a ambos calendarios

Privacidad y Seguridad

• Tu clave API se almacena de forma segura en la configuración de PopClip
• No se almacena ni transmite ningún dato de eventos excepto para crear el evento del calendario
• Todo el procesamiento del lenguaje natural se realiza a través de Claude AI
• La extensión solo requiere los permisos necesarios: selección de texto y acceso al calendario

Solución de Problemas

Si encuentras algún problema:

1. Asegúrate de que tu clave API de Anthropic esté correctamente ingresada en la configuración de la extensión
2. Verifica que hayas otorgado permisos de acceso al calendario a PopClip
3. Asegúrate de que tu selección de texto incluya todos los detalles necesarios del evento
4. Verifica tu conexión a Internet

Soporte

Para problemas, solicitudes de funciones o contribuciones, visita el Repositorio de GitHub.

Licencia

Este proyecto está licenciado bajo la Licencia Pública General de GNU Affero Versión 3 (AGPLv3) con Cláusula Commons - consulta el archivo LICENSE para más detalles. Esta licencia asegura que el software permanezca de código abierto mientras protege contra la explotación comercial. Cualquier modificación o trabajo derivado también debe ser publicado bajo los mismos términos de licencia.