# Macro Automation Studio download para Windows e Mac

> Baixe e instale o Macro Automation Studio no Windows 64 bits ou em um Mac Apple Silicon, entre com e-mail ou Google e veja onde ficam atualizações e projetos.

Source: https://automationmacro.com/pt-BR/docs/install (Início, updated 2026-09-05)

O download do Macro Automation Studio (MAS) está disponível para Windows e para Mac com Apple Silicon: é um app de desktop. Esta página cobre o download, o instalador em cada sistema, o login, o atualizador integrado e onde o MAS guarda seus arquivos.

## Antes de começar

- Windows: um computador com Windows 10 ou 11 de 64 bits e uma conta que possa aprovar o aviso de administrador.
- Mac: um Mac com Apple Silicon (M1 a M5) no macOS 12 Monterey ou mais novo. Não há build para Intel nem para Linux.
- A página de download lista 8 GB de RAM para Windows (16 GB recomendados) e 4 GB para Mac (8 GB recomendados). Um emulador precisa de memória própria além disso.
- Um endereço de e-mail ou uma conta Google para o login.

> [!NOTE]
> No Mac, o MAS em si roda nativamente no Apple Silicon. Ele ainda precisa de algo para controlar: um emulador Android que rode no seu Mac, um dispositivo na nuvem ou o seu próprio celular. Veja [Dispositivos](/docs/devices).

## Download do Macro Automation Studio

Pegue o instalador na [página de download](/download). O Windows recebe `MacroAutomationStudio-<version>.exe`. O Mac recebe um DMG compilado para Apple Silicon.

## Instalar no Windows ou em um Mac com Apple Silicon

<div class="doc-tabs" data-tabs="os">
<section data-tab="Windows">

1. Execute o instalador e aprove o aviso de administrador.
2. Se houver um MAS anterior instalado, o instalador oferece removê-lo primeiro. Clique em **Sim**.
3. Se o MAS estiver aberto, o instalador oferece fechá-lo. Deixe, ou feche o MAS você mesmo.
4. Aceite a licença e escolha se quer um ícone na área de trabalho.
5. Aguarde enquanto os arquivos são copiados para `C:\MacroAutomationStudio`. Em seguida o instalador cria o ambiente Python, o que pode levar alguns minutos.
6. Mantenha a opção de abrir o app marcada e clique em **Concluir**.

O instalador também coloca o adb, o Tesseract OCR e o gerenciador de pacotes `uv` em `C:\ProgramData\MacroAutomationStudio\3rdparty`. Nada mais é baixado durante a instalação.

</section>
<section data-tab="Mac">

1. Abra o DMG e mova **MacroAutomationStudio** para **Aplicativos**.
2. Abra o app pela pasta Aplicativos. Ele é assinado e notarizado; se o macOS pedir para confirmar a abertura de um app baixado da internet, clique em **Abrir**.
3. Na primeira abertura, o MAS cria seu ambiente Python em `~/Library/Application Support/MacroAutomationStudio/python_venv`. Isso pode levar alguns minutos.
4. O adb, o Tesseract OCR e o `uv` vêm dentro do pacote do app. Se o MAS informar "ADB executable not found", instale o adb com o Homebrew e reinicie o MAS:

```bash
brew install android-platform-tools
```

O MAS procura o adb primeiro dentro do pacote do app, depois no seu PATH e por fim nas pastas do Homebrew.

</section>
</div>

## Entrar

O MAS aceita duas formas de login. As duas levam à mesma conta.

1. Clique em **Entrar com o Google**. Seu navegador abre a página de login do Google. Depois que "Login Successful" aparecer, volte ao app.
2. Ou digite seu **Endereço de e-mail** e sua **Senha** e clique em **Entrar**.

Novo no MAS? Clique em **Cadastre-se**, informe seu e-mail e uma senha e digite a senha de uso único que o MAS envia por e-mail. Com a conta ativada, faça login.

> [!TIP]
> Uma conta criada com o Google não tem senha. Se o login com senha falhar com "This email is registered with Google", use **Entrar com o Google**.

## Verificação da assinatura

Depois do login, o MAS verifica sua assinatura. Com o teste gratuito ou um plano pago, todas as páginas abrem. Sem isso, o MAS abre **Assinatura** e mantém você ali até escolher um plano. Os planos estão na [página de preços](/pricing); a mecânica está na página [Cobrança](/docs/billing).

## Atualizações

O MAS se atualiza sozinho; você não baixa um instalador novo a cada versão.

1. Depois do login, o MAS consulta o servidor de versões sobre a versão mais recente.
2. Quando existe uma versão mais nova, a caixa de diálogo **Nova atualização disponível** abre com os dois números de versão e as notas da versão.
3. Clique em **Atualizar agora** para começar, ou em **Agora não** para continuar trabalhando. Enquanto o download roda, você pode clicar em **Minimizar**.
4. O MAS baixa o auxiliar de atualização, depois o pacote da atualização, e verifica o pacote com um hash SHA-256. No Mac, o auxiliar também confere a assinatura de código contra a equipe Apple do MAS antes de trocar o app.
5. A caixa mostra **Atualização concluída**. Clique em **Reiniciar agora** ou aguarde a reinicialização automática.

> [!NOTE]
> Versões muito antigas para Mac mostram "This version has no in-app update package". Baixe o DMG atual na [página de download](/download) e instale por cima do app antigo.

## Onde o MAS guarda seus arquivos

| Item | Windows | Mac |
|---|---|---|
| App | `C:\MacroAutomationStudio` | `/Applications/MacroAutomationStudio.app` |
| Projetos | `C:\ProgramData\MacroAutomationStudio\projects` | `~/Library/Application Support/MacroAutomationStudio/projects` |
| Logs | `C:\ProgramData\MacroAutomationStudio\logs` | `~/Library/Application Support/MacroAutomationStudio/logs` |
| Ambiente Python | `C:\ProgramData\MacroAutomationStudio\python_venv` | `~/Library/Application Support/MacroAutomationStudio/python_venv` |

Cada pasta de projeto se chama `<id>_<name>`, em que o nome fica em minúsculas com os espaços trocados por sublinhados. Dentro você encontra `src/app.py`, o `src/script_args.py` gerado quando o projeto tem um formulário de argumentos, e os assets que você adicionar. Projetos são repositórios git; veja [Projetos git e sincronização de código](/docs/git-and-code-sync).

`C:\ProgramData` fica oculta por padrão. Digite o caminho na barra de endereços do Explorador para abri-la.

## Solução de problemas

### MacroAutomationStudio is currently running

O instalador encontrou um MAS aberto. Clique em **Sim** para deixá-lo fechar o app, ou saia do MAS pela janela dele e rode o instalador de novo.

### O ambiente Python não terminou

O instalador registra um aviso e termina mesmo assim; o MAS repete a configuração na próxima abertura. Se o app informar "uv package manager not found", reinstale o MAS pela página de download.

### ADB executable not found

Só no Mac. O MAS não encontrou o adb no pacote do app, no seu PATH nem em `/opt/homebrew`. Rode `brew install android-platform-tools` e reinicie o MAS.

### A atualização falhou

A caixa de diálogo informa a causa. Para um erro de rede, clique em **Tentar novamente**. Para "Not enough disk space", libere espaço e tente de novo. Quando a caixa oferecer **Baixar manualmente**, instale a nova versão pela [página de download](/download).

## Próximo passo: adicione um emulador Android no Windows ou no Mac com Apple Silicon

Adicione um emulador Android, um dispositivo na nuvem ou o seu celular na página [Dispositivos](/docs/devices) e rode sua primeira macro com [Primeiros passos](/docs/getting-started).
