╔╦╗┌─┐┌─┐┌┬┐┬─┐┌─┐  ┌┬┐┌─┐┌─┐  ╔═╗┌─┐┌┐ ┌─┐┌─┐
║║║├┤ └─┐ │ ├┬┘├┤    │││ │└─┐  ║  ├─┤├┴┐│ │└─┐
╩ ╩└─┘└─┘ ┴ ┴└─└─┘  ─┴┘└─┘└─┘  ╚═╝┴ ┴└─┘└─┘└─┘

SONYMAGIC

Controle de câmeras Sony pelo computador — captura, live view,
exposição, multi-câmera e PTZ. macOS · Apple Silicon.

⬇ Baixar a versão mais recente versões anteriores

App assinado com Developer ID + notarizado pela Apple — abre sem avisos do Gatekeeper.

1. Requisitos

Computador

Mac com Apple Silicon (M1 ou superior)
macOS 12.1 ou mais recente

Câmera

Modelo Sony compatível (ver lista)
Cabo USB ou rede Wi-Fi/Ethernet
Bateria carregada (conexão consome energia)

2. Preparar a câmera

Os nomes exatos dos menus mudam por modelo, mas o caminho é sempre este. Procure por “PC Remote” (também chamado Controle por PC ou Tether).

Opção A — Rede / Wi-Fi recomendado p/ mobilidade

Câmera e Mac na mesma rede (mesmo roteador/Wi-Fi).
MENU → Rede → Função PC Remote → Ligado.
Método de conexão PC Remote → Wi-Fi (ponto de acesso/infraestrutura) ou LAN com fio.
Conecte a câmera ao seu Wi-Fi (selecione a rede e digite a senha, ou WPS).
Anote o IP e o MAC da câmera em MENU → Rede → Wi-Fi / LAN com fio → Ver informações.
Na 1ª conexão a câmera pede pareamento — confirme no visor. (Modelos novos usam fingerprint/SSH; o app cuida disso automaticamente.)

Opção B — USB mais simples, sem pareamento

Ligue a câmera ao Mac com o cabo USB.
MENU → USB → Modo de conexão USB → PC Remote.
Pronto — não precisa de IP, MAC nem pareamento.

Onde salvar as fotos? O SONYMAGIC coloca a câmera em modo PC Remote e define o destino como “salvar no computador” automaticamente ao iniciar uma captura — você não precisa mexer nisso no menu.

Para os controles de exposição (ISO, abertura, obturador) terem efeito, a câmera precisa estar no modo correspondente (M / A / S) no seletor de modo.

3. Começar a usar

Abra o SONYMAGIC.dmg e arraste o app para Aplicativos.
Dê duplo-clique no SONYMAGIC. Ele inicia um servidor local e abre o painel de controle no navegador (http://127.0.0.1:8080).
No painel: preencha IP e MAC da câmera, escolha o modelo e clique Conectar.
Use os blocos de Exposição, Captura, Live view e PTZ.

O painel web é a forma mais fácil. Para automação/scripts, há a API HTTP e a linha de comando.

4. Manual das funções

🔌 Conexão

Descobre/conecta a câmera por rede (IP/Wi-Fi) ou USB. A conexão por rede faz o pareamento automaticamente na primeira vez. Mantenha a câmera ligada e na mesma rede.

🎚️ Exposição

Controle	O que faz	Exemplo
ISO	Sensibilidade (0 = automático)	`800`
Abertura (f)	Profundidade de campo / luz	`2.8`
Obturador	Velocidade (fração ou segundos)	`1/250` ou `2`
EV	Compensação de exposição	`-0.7`

📸 Captura

Faz o autofoco, dispara o obturador e baixa a foto para o computador. Dá para disparar várias fotos em sequência. As imagens vão para a pasta de capturas.

🎬 Live view

Transmite a imagem ao vivo da câmera. No painel web aparece direto na tela; também é possível salvar os quadros como JPEG. Útil para enquadrar e para pipelines de visão/IA (o quadro é entregue como imagem JPEG).

🎥 Multi-câmera

Encontra todas as câmeras conectadas e dispara em todas de uma vez — cada uma salva com um prefixo próprio para não misturar os arquivos.

🕹️ PTZ (FR7, BRC e camcorders)

Ação	O que faz
Mover	Pan/tilt contínuo (esquerda/direita, cima/baixo)
Posição absoluta	Vai a uma coordenada de pan/tilt na velocidade dada
Home	Volta à posição inicial
Parar	Interrompe o movimento atual
Presets	Salvar, recuperar e limpar posições memorizadas

📊 Monitoração & análise no painel

Ferramentas de monitor profissional calculadas em tempo real a partir do live view:

Ferramenta	Para que serve
Configurações ao vivo	Lê da câmera: ISO, abertura, obturador, EV, modo, foco, WB, Kelvin e bateria
Histograma	Distribuição de luz por canal (R/G/B) + luma
Waveform	Mapa de luminância coluna a coluna — o jeito preciso de expor
RGB parade	Waveform separado de R, G e B lado a lado — análise de cor/WB
Vectorscope	Distribuição de croma (Cb/Cr) com linha de tom de pele
False color	Pinta a imagem por faixa de exposição (achar o estouro de pele/altas)
Zebra	Listra as áreas estouradas (altas clipando)
Focus peaking	Realça as bordas em foco
LUT de monitoração	Converte Log→Rec.709 no preview (vê a imagem “natural” gravando em Log)
Preview de looks	Aplica vários looks ao quadro atual — você escolhe clicando
Conselheiro	Sugere ajuste de exposição/WB e detecta imagem achatada (Log) automaticamente

5. API HTTP (automação)

No modo servidor, o app expõe uma API REST local para outro programa controlar a câmera. Requisições POST precisam de corpo (mesmo vazio: -d ''); os parâmetros vão na URL.

Método	Rota	Parâmetros
GET	`/status`	—
GET	`/`	painel web
POST	`/connect`	`ip`, `mac`, `ssh=0\|1`, `model`
POST	`/disconnect`	—
POST	`/exposure`	`iso`, `fnumber`, `shutter`, `ev`
POST	`/capture`	`shots`
GET	`/liveview.jpg`	quadro JPEG atual
GET	`/properties`	configurações atuais (JSON)
POST	`/ptz/move`	`pan`, `tilt`
POST	`/ptz/absolute`	`pan`, `tilt`, `speed`
POST	`/ptz/home` · `/ptz/stop`	—
POST	`/ptz/preset/{set\|recall\|clear}`	`num`

curl -s https://127.0.0.1:8080/status
curl -s -X POST "http://127.0.0.1:8080/connect?ip=192.168.1.10&mac=AA:BB:CC:DD:EE:FF&model=ILME_FR7" -d ''
curl -s -X POST "http://127.0.0.1:8080/exposure?iso=800&fnumber=2.8&shutter=1/250" -d ''
curl -s -X POST "http://127.0.0.1:8080/capture?shots=1" -d ''
curl -s "http://127.0.0.1:8080/liveview.jpg" -o frame.jpg

6. Linha de comando (avançado)

O binário dentro do app também roda no Terminal. Útil para scripts e time-lapse.

# listar câmeras conectadas (valida o ambiente)
sonymagic --enum

# conectar por rede e ajustar exposição
sonymagic --connect-ip 192.168.1.10 AA:BB:CC:DD:EE:FF --iso 800 --fnumber 2.8 --shutter 1/250

# disparar 3 fotos
sonymagic --capture 192.168.1.10 AA:BB:CC:DD:EE:FF --shots 3

# live view (janela, se a versão tiver OpenCV; senão salva JPEGs)
sonymagic --liveview 192.168.1.10 AA:BB:CC:DD:EE:FF --window

# todas as câmeras de uma vez
sonymagic --multi-capture --shots 1

# PTZ (FR7/BRC)
sonymagic --ptz 192.168.1.10 AA:BB:CC:DD:EE:FF --do move --pan 30 --tilt -10
sonymagic --ptz 192.168.1.10 AA:BB:CC:DD:EE:FF --do preset-recall --num 1

# subir o servidor + painel web manualmente
sonymagic --server --port 8080

Opções de exposição (--iso --fnumber --shutter --ev) valem em --connect-ip, --liveview e --capture.

7. Solução de problemas

Sintoma	O que verificar
Câmera não aparece / não conecta	“Função PC Remote” ligada? Câmera e Mac na mesma rede? IP/MAC corretos? Modelo certo selecionado?
Pede pareamento toda vez	Confirme o pareamento no visor na 1ª vez; alguns modelos exigem habilitar o acesso de rede/“SSH” no menu.
Exposição não muda nada	A câmera precisa estar no modo M/A/S; no modo automático a câmera ignora os valores.
Live view travando	Wi-Fi tem mais latência — aproxime do roteador ou use USB para fluidez.
Foto não baixa	Cartão cheio? Bateria fraca interrompe a transferência. Veja a pasta de capturas.

8. Câmeras compatíveis

Alpha (mirrorless)

α1α1 IIα9 II α9 IIIα7 IVα7 V α7R IV / IVAα7R Vα7S III α7Cα7C IIα7CR α6700ZV-E1ZV-E10 II ILX-LR1

Cinema Line

FX3 / FX3AFX30FX6 FX2FR7 (PTZ)

Camcorders / Broadcast / PTZ

HXR-NX800PXW-Z200PXW-Z300 PXW-Z380MPC-2610BRC-AM7 RX0 IIRX1R III

No app/API, informe o código do modelo (ex.: ILCE_7M4, ILME_FR7).