Skip to content

About

Ventana flotante de cámara para macOS: preview siempre visible, PiP, fotos, grabación y audio de tarjetas de captura HDMI.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

FloatingCam

Ventana flotante de cámara para macOS. Muestra una webcam o una tarjeta de captura HDMI encima del resto de las apps, sin icono en el Dock: vive en la barra de menú.

Sirve para tener el preview a la vista mientras editas, haces stream o compruebas una señal HDMI. Puedes bajar la opacidad, pasar a PiP, grabar o sacar una foto sin salir de la ventana.

Requiere macOS 13 o posterior.

Qué hace

  • Preview a pantalla completa dentro de la ventana, siempre por encima y en todos los Spaces.
  • Elige la cámara desde la barra o desde el menú de la barra de estado.
  • Opacidad de la ventana, del 20 % al 100 %.
  • Modo PiP: ventana pequeña, proporción del vídeo, sin barra de título.
  • Pantalla completa en el monitor actual, sin cambiar de Space. El mismo botón entra y sale.
  • Foto en JPEG y vídeo (solo imagen, MOV) con el mismo recorte que el preview (un poco de zoom, 1.08×, para quitar las bandas de overscan de muchas tarjetas).
  • Monitor de audio: el sonido de la tarjeta de captura sale por el dispositivo que elijas. macOS no ofrece ese “audio through” por sí solo. El vídeo grabado no incluye esa pista.
  • Notificación al guardar. Al pulsarla, Finder selecciona el archivo.
  • Si desconectas un monitor o cambia la resolución, la ventana vuelve a una pantalla visible.

Las fotos van a ~/Pictures/FloatingCam. Los vídeos van a ~/Movies/FloatingCam. El nombre lleva fecha y hora (yyyy-MM-dd HHmmss).

Permisos

La primera vez macOS pide:

  • Cámara, para el vídeo (webcam o tarjeta USB).
  • Micrófono, para oír el audio HDMI por la salida que elijas.
  • Notificaciones, para avisar cuando se guarda una captura.

Si deniegas la cámara, la ventana se abre igual y muestra el error. Puedes conceder el permiso después en Ajustes del Sistema → Privacidad y seguridad.

Uso

La app no aparece en el Dock. El icono de vídeo en la barra de menú abre el menú: mostrar u ocultar la ventana, elegir cámara, PiP, auto-ocultar controles, monitor de audio, salida de audio, foto, grabación y Salir.

Arrastra la ventana desde cualquier parte del vídeo. El botón rojo de cerrar solo oculta la ventana; la app sigue en la barra de menú.

La barra inferior tiene el selector de cámara, el estado, el slider de opacidad y los botones de audio, PiP, pantalla completa, foto, grabar, Finder y auto-ocultar. Si la ventana es estrecha, la barra se compacta.

El botón de audio: clic para activar o parar el monitor; clic derecho para elegir la salida. El botón del ojo oculta la barra al salir el puntero de la ventana y deja un chip para volver a mostrarla.

Atajos

Con la ventana activa, o desde el menú de la barra:

Atajo Acción
⌘W Mostrar u ocultar la ventana
⌘P Modo PiP
⌘⇧H Fijar o auto-ocultar los controles
⌘S Tomar foto
⌘R Empezar o detener la grabación
⌘F Mostrar la última captura en Finder
⌘Q Salir

⌘F solo aparece en el menú cuando ya hay una captura en esta sesión.

Compilar

Hace falta Xcode o las Command Line Tools, con Swift 5.9 o posterior.

./Scripts/build-app.sh
open dist/FloatingCam.app

El script compila en release, arma dist/FloatingCam.app y lo firma ad-hoc (codesign --sign -). dist/ y .build/ no se suben al repositorio.

También puedes ejecutar el binario sin empaquetar:

swift run -c release

La primera apertura de un binario firmado ad-hoc la bloquea Gatekeeper. Clic derecho en FloatingCam.app → Abrir, y confirma. En un Mac Apple silicon, si macOS dice que el desarrollador no se puede verificar, esa es la vía.

Release

La versión 0.1.0 está en Releases. El zip trae FloatingCam.app listo para copiar a /Applications. Misma firma ad-hoc: ábrelo una vez con clic derecho.

Licencia

MIT. Ver LICENSE.

About

Ventana flotante de cámara para macOS: preview siempre visible, PiP, fotos, grabación y audio de tarjetas de captura HDMI.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages