# Plugins

## O que é um plugin {#plugins}

Um **plugin** é um dispositivo feito por outra pessoa: um sintetizador, um efeito, um sampler de outra empresa ou de um projeto de código aberto, instalado no seu computador separadamente do Flesance. Os músicos usam plugins para sons que um estúdio não tem embutidos, para um sintetizador específico de que gostam, ou para uma biblioteca de instrumentos gravados que precisa do próprio player. No estúdio, um plugin fica na cadeia de uma faixa como qualquer [dispositivo](/manual/devices): pode ser desligado, movido e removido do mesmo jeito.

Os dispositivos que vêm com o Flesance são desenhados e explicados do mesmo jeito em toda parte. Os knobs de um plugin aparecem no inspetor com os nomes e as unidades do próprio plugin, então podem ser menos diretos de ler.

Os plugins existem em vários formatos. O estúdio carrega plugins **CLAP** e **VST3**.

## Adicionando um plugin {#plugins-add}

Quando o estúdio inicia, ele procura os plugins instalados neste computador, nas pastas habituais do sistema. Os efeitos aparecem então no menu **Add effect** do inspetor, depois dos dispositivos do próprio estúdio, com o nome do fabricante embaixo de cada um; os plugins de instrumento aparecem na lista de instrumentos da faixa, em **Plugins**. Escolher um deles o inicia uma vez, separado da música, para aprender os knobs dele; depois o dispositivo entra na faixa. Notas, o pedal de sustentação e a roda de pitch bend chegam a um plugin de instrumento do mesmo jeito que chegam aos instrumentos do próprio estúdio.

A busca acontece em segundo plano, e o que foi encontrado fica guardado, então o próximo início só abre os arquivos que mudaram. Um plugin instalado enquanto o estúdio está aberto aparece na próxima vez que ele iniciar; **Clear** na lista de plugins, em **Storage** em Settings, faz o estúdio examinar tudo de novo. Um plugin que trava ou para de responder enquanto é examinado é ignorado: a barra de status diz o nome do arquivo dele e o motivo, e o estúdio segue em frente.

## A janela própria do plugin {#plugins-window}

A maioria dos plugins tem uma janela própria, desenhada por quem os criou. O botão de janela no dispositivo do plugin, no inspetor, a abre como uma janela separada, com o nome do plugin e da faixa dele, como *Crunch on Bass*. O que você muda ali é guardado com a música: assim que você solta os controles do plugin e passa um instante, a mudança vira um passo no histórico, então desfazer a reverte como qualquer outra edição.

## Encontrando um knob {#plugins-knobs}

Um plugin pode ter centenas de knobs. O inspetor mostra os 24 primeiros na face do plugin; o botão de busca, **Find a knob**, encontra qualquer knob por parte do nome, e escolhê-lo o mostra na face ou o tira dela. A face tem espaço para 24, então um novo knob ocupa o lugar do último. Essa escolha é guardada com a música. Alguns plugins dão nome aos knobs só na própria janela.

## Ouvindo outra faixa {#plugins-listen}

Um plugin de efeito com uma segunda entrada para outro som, como um compressor que abaixa sob o bumbo, ganha a mesma opção **Listen to** que a [Compressão](/manual/compressor#compressor-listen) do próprio estúdio. Escolha a faixa que ele deve ouvir; o plugin continua agindo sobre o som da própria faixa.

## Quando um plugin trava {#plugins-crashed}

Cada plugin roda num programa próprio, separado do estúdio. Quando um deles trava ou para de responder, o resto da música continua tocando: um plugin de instrumento fica em silêncio, e um plugin de efeito deixa o som passar intacto. A barra de status diz uma vez qual plugin parou, e o dispositivo no inspetor mostra o motivo. Na próxima vez que o estúdio iniciar, ele pode oferecer o envio de um relatório curto da parada, conforme a sua escolha de relatórios de falha em Settings; nada nele identifica você nem os seus projetos.

### Reiniciando um plugin {#plugins-restart}

Pressione **Restart**, à direita da linha que diz por que o plugin parou, para trazê-lo de volta com as suas configurações.

Essa é a principal diferença em relação aos estúdios que carregam os plugins dentro do próprio programa, onde um único plugin com defeito derruba o programa inteiro e, com ele, o trabalho não salvo.

## Quando falta um plugin {#plugins-missing}

Um projeto feito em outro computador pode usar um plugin que este não tem. O projeto abre mesmo assim: o dispositivo do plugin continua na cadeia, com os knobs e as configurações dele, a faixa toca sem ele, a barra de status diz qual plugin está faltando, e o dispositivo informa que ele não está instalado neste computador. Nada se perde ao salvar, então o som volta num computador que tenha o plugin.