Iniciar sesión Inicio Documentación de la API Agente Compartir Privacidad Soporte
Get Pling
aplicación para iPhone agente para macOS (.dmg) Linux Windows GitHub

Inicio / Instalar en macOS

Instala Pling Agent en tu Mac

Con Pling Agent puedes ver y controlar tu Mac desde tu iPhone, y Pling recibe las estadísticas y alertas del Mac. Una app de la barra de menús para macOS Sequoia (15) y posteriores, en Apple silicon e Intel.

⬇ Descargar para Mac Firmada y notarizada, macOS 15 o posterior, se actualiza sola

Configúralo en cuatro pasos

Abre la imagen de disco, arrastra Pling Agent a Aplicaciones y ábrela. Su asistente de configuración se encarga del resto:

  1. Inicia sesión en Pling con Apple o Google.
  2. Deja que tu iPhone vea y controle este Mac. Activa Pling Agent en Grabación de pantalla y del audio del sistema y Control de dispositivos y acceso a datos (Accesibilidad antes de macOS 27) en Privacidad y seguridad. El asistente abre cada ajuste y lo marca a medida que avanzas.
  3. Activa Sesión remota. Un clic en el asistente; macOS pide una vez la contraseña de un administrador.
  4. Abre Pling en tu iPhone. Con la misma cuenta, tu Mac ya aparece en Pantalla. ¿No has iniciado sesión allí? Escanea el código que muestra el asistente. La primera vez, Pling te pide la contraseña con la que inicias sesión en el Mac.
¿Por qué Sesión remota? Tu iPhone se conecta al Mac a través de Sesión remota, el inicio de sesión seguro integrado en macOS. Las estadísticas y alertas funcionan sin ella; ver la pantalla, no. El asistente la activa por ti. Si macOS no lo permite, abre General → Compartir, activa Sesión remota, haz clic en ⓘ y comprueba que Permitir acceso a te incluye (Todos los usuarios, o + para añadirte).

¿Quieres añadir otro iPhone? Haz clic en el icono de Pling Agent en la barra de menús y elige Connect iPhone… para volver a mostrar el código.

Instalar la app con Homebrew
brew install --cask jeramo/pling/pling-agent
Mac sin pantalla o servidor: instalación por línea de comandos

El agente de línea de comandos envía estadísticas y alertas y ejecuta comandos programados, sin la app de la barra de menús.

Homebrew (línea de comandos)

Para un Mac sin pantalla o un servidor, instala el agente de línea de comandos y luego configura tu token de API. set-token escribe la configuración e inicia el servicio de brew.

brew install jeramo/pling/pling
  pling set-token <YOUR_TOKEN>

Verifica que se está ejecutando:

pling status
  brew services list | grep pling
Dónde encontrar tu token: en la app del iPhone, abre Cuenta → Token API, cópialo y pásalo a set-token. Solo lo necesitan las instalaciones por línea de comandos; la app de la barra de menús inicia sesión en su lugar.

Una sola línea con curl

Omite Homebrew por completo. El instalador descarga el binario firmado y certificado más reciente, solicita tu token y registra un LaunchAgent por usuario.

curl -sSL https://raw.githubusercontent.com/Jeramo/pling-agent/main/install.sh | sh

El LaunchAgent se inicia automáticamente al iniciar sesión. Los registros se guardan en ~/Library/Logs/pling-agent.log.

Instalación manual

Elige esto cuando quieras control total o instalar en un Mac sin privilegios de administrador. Reemplaza arm64 por amd64 en los Mac con Intel.

curl -L -o pling \
    https://github.com/Jeramo/pling-agent/releases/latest/download/pling-darwin-arm64
  chmod +x pling
  sudo mv pling /usr/local/bin/
  pling set-token <YOUR_TOKEN>

Configurar

Imprime la ruta de configuración activa:

pling config

Edítalo en $EDITOR:

pling config edit

Campos típicos: api_url, token, metrics_interval.

Actualizar

Homebrew:

brew upgrade pling
  brew services restart pling

Instalación con curl: vuelve a ejecutar el script de instalación. Reemplaza el binario y reinicia el LaunchAgent.

Desinstalar

pling uninstall

Elimina el binario, la configuración y el registro del servicio. Las instalaciones con Homebrew también se pueden eliminar con brew uninstall pling.

Preguntas frecuentes

¿Por qué Pling necesita Sesión remota en macOS?

Tu iPhone se conecta al Mac a través de Sesión remota, el inicio de sesión seguro integrado en macOS. Las estadísticas, alertas y comandos programados funcionan sin ella; ver y controlar la pantalla, no. En las opciones ⓘ de Sesión remota, Permitir acceso a debe incluir tu cuenta: elige Todos los usuarios, o haz clic en + y añádete.

¿El agente de Pling funciona en Apple silicon?

Sí. Los binarios nativos arm64 se distribuyen junto con las compilaciones Intel x86_64. El instalador y el tap de Homebrew eligen la arquitectura correcta automáticamente.

¿Los binarios de macOS están notarizados?

Sí. Cada versión está firmada con Developer ID y notarizada por Apple, así que Gatekeeper no bloquea el binario.

¿Dónde está el archivo de configuración de macOS?

Cuando se instala mediante Homebrew, la configuración se encuentra en $(brew --prefix)/etc/pling/config.toml. El instalador de curl escribe /etc/pling/config.toml. Ejecuta pling config para mostrar la ruta activa en esta máquina.

¿Cómo veo los registros del agente?

Ejecuta pling logs -f para ver los registros en tiempo real. Las instalaciones con Homebrew pasan por brew services; las instalaciones con LaunchAgent escriben en ~/Library/Logs/pling-agent.log.

¿Cómo actualizo el agente de Pling?

Homebrew: brew upgrade pling && brew services restart pling. Instalación con curl: vuelve a ejecutar el script de instalación; reemplaza el binario y reinicia el LaunchAgent.

¿Instalando en otra plataforma? Linux, Windows