Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Executar

O Flatty está em flatty.higreg.pl, e é lá que está sempre a versão mais recente. É gratuito — sem chave, sem conta, nada a registar.

Não há instalador, nada a registar e nenhum runtime a obter. O programa completo é um único executável, e até a fonte que desenha está incorporada. Desempacota-o onde guardas as tuas ferramentas e executa-o.

flatty_1.0.0_linux_amd64.tar.gz
├── flatty                  the program
├── LICENSE                 what you may do with it
└── THIRD-PARTY-NOTICES.md  the open-source components it is built on

Escolhe a versão que corresponde à tua máquina. Na página de download têm nomes como flatty_<version>_<system>_<chip> — windows_amd64, linux_amd64, darwin_arm64 para um Mac com Apple Silicon, darwin_amd64 para um Intel.

Windows

Clica direito no .zip e escolhe Extract All. Executa flatty.exe a partir da pasta que cria.

O Windows pode mostrar uma caixa azul “Windows protegeu o teu PC” na primeira vez. Isso é o SmartScreen reagindo a um programa que ainda não viu muita gente executar, não a nada que tenha encontrado no ficheiro. Clica em Mais informações, depois em Executar mesmo assim.

Não executes Flatty dentro do .zip — o Windows abre-o numa pasta temporária e tudo o que guardas daí desaparece.

macOS

Escolhe o arquivo arm64 para um Mac com Apple Silicon (M1 e posteriores) e o amd64 para um Mac Intel. O menu Apple → Sobre este Mac diz-te que chip tens — e no mesmo painel, que versão de macOS estás a executar. Vais precisar desse segundo número num momento.

Não há imagem de disco nem ícone de Flatty para arrastar para Aplicações, e isto é deliberado, não inacabado. A Apple só permite que uma aplicação abra sem aviso se o autor pagar uma conta de developer e submeter cada versão para varredura. O Flatty é gratuito e não o faz, por isso um pacote teria sido recusado pelo teu Mac tão firmemente quanto o programa simples é — enquanto parecia que deveria funcionar. Tens o programa em si e uma explicação honesta de como o executar.

Demora cerca de um minuto, uma vez.

O caminho curto, em qualquer versão de macOS

Abre Terminal e executa estas, uma linha de cada vez:

cd ~/Downloads
tar xzf flatty_*_darwin_arm64.tar.gz
xattr -d com.apple.quarantine flatty
./flatty

A linha xattr remove a bandeira que macOS coloca em tudo o que um navegador descarrega. Pode responder No such xattr — isso significa apenas que a bandeira não estava lá, e podes continuar para a próxima linha.

O Flatty agora está desbloqueado para sempre. Depois podes executá-lo clicando duas vezes nele no Finder como qualquer outra coisa.

O caminho do Finder, se preferes não usar Terminal

Clica duas vezes no .tar.gz para desempacotar, depois clica duas vezes em flatty. Será recusado na primeira vez. O que fazes depois depende da tua versão de macOS, e é aqui que a maioria das pessoas fica presa.

Em macOS 14 e anteriores — Monterey, Ventura, Sonoma:

Control-clica (ou clica direito) em flatty, escolhe Abrir, e confirma com Abrir novamente na caixa que segue. Pronto, permanentemente.

Em macOS 15 e posteriores — Sequoia, Tahoe:

A Apple removeu esse atalho, por isso Control-clique já não oferece Abrir. Em vez disso:

  1. Clica duas vezes em flatty e deixa-o ser recusado. Fecha a mensagem.
  2. Abre Definições do Sistema → Privacidade e Segurança e desliza para baixo até Segurança.
  3. Junto à linha que menciona flatty, clica em Abrir Mesmo Assim e confirma.

Faz essa parte prontamente. O botão Abrir Mesmo Assim aparece apenas durante cerca de uma hora depois de um lançamento recusado, e se voltares mais tarde simplesmente não estará lá. Clica duas vezes em flatty novamente para o trazer de volta, depois vai direto para Definições.

Uma janela de Terminal abre-se junto a Flatty

É o esperado e não é um erro. O Flatty é um programa simples, não um pacote de aplicação Mac, por isso o Finder executa-o através de Terminal e essa janela fica aberta enquanto o Flatty estiver. Fechá-la fecha o Flatty, por isso deixa estar e coloca-a atrás da janela principal.

Linux

tar xzf flatty_*_linux_amd64.tar.gz
chmod +x flatty
./flatty

O chmod é geralmente desnecessário — o arquivo carrega o bit de execução — mas custa nada e é a solução se receberes Permissão negada.

Ou escolhe o AppImage

Há uma segunda opção de download para Linux, terminando em .AppImage. É o mesmo programa no formato que o Linux usa para “um ficheiro que podes executar”: nenhum arquivo para desempacotar, e o teu desktop pega no seu nome e ícone.

chmod +x flatty_*_linux_amd64.AppImage
./flatty_*_linux_amd64.AppImage

Aqui o chmod não é opcional — um download chega sem o bit de execução, e sem ele nada acontece quando clicas.

Precisa de um sistema razoavelmente atual: Ubuntu 22.04, Debian 12, Fedora 36 ou mais recente, ou qualquer coisa dessa era. Em algo mais antigo, escolhe o .tar.gz. Nenhuma versão pode fazer nada que a outra não possa; escolhe a que se adequa a como gostas de guardar programas.

Se queres na tua pasta de aplicações em vez de numa pasta, uma ferramenta como Gear Lever ou AppImageLauncher a guardará para ti. Nada te obriga — funciona perfeitamente bem de onde quer que esteja.

De qualquer forma

Precisas de um controlador gráfico e de uma sessão de desktop, que qualquer instalação Linux normal tem. Num servidor simples não há nada em que desenhar e o programa não inicia.

Verifica que funciona

flatty -demo cloud

Abre o editor com um pequeno trabalho de arte já carregado, para que possas ver um modelo antes de teres desenhado nada.

Carrega em Ctrl+Q para sair — Esc deliberadamente não sai.

Onde o Flatty guarda as coisas

Dois sítios, e nada mais:

O quêOnde
o teu trabalhopastas que tu escolhes — ver Projetos
as tuas definições e lista de projetos recentesum ficheiro de configuração

As tuas paletas, texturas de pincel, temas e esquemas guardados vivem junto a esse ficheiro, uma pasta cada — ver As tuas bibliotecas.

PlataformaFicheiro de configuração
Linux~/.config/flatty/config.json
macOS~/Library/Application Support/flatty/config.json
Windows%AppData%\flatty\config.json

Há uma segunda pasta para coisas que o Flatty pode reconstruir por si — a lista de fontes na tua máquina e as miniaturas na galeria de mídia. Vive no diretório de cache do teu sistema, e apagá-la não te custa nada além dos poucos segundos que leva para preencher novamente.

Nada é escrito em mais lado nenhum, nada é instalado em toda o sistema, e remover o Flatty é uma questão de apagar o executável. Os teus projetos são pastas normais e não são afetados por isso.

O que podes fazer com isto

Os termos completos estão no ficheiro LICENSE ao lado do programa. A versão curta:

Tudo o que fazes com Flatty é totalmente teu. Os teus desenhos, os teus modelos exportados, e qualquer coisa que construas a partir deles. Sem royalties, sem partilha de receita, sem atribuição e sem permissão necessária — por mais bem-sucedido que o trabalho se torne. Vende-o, licencia-o, abre-o com open-source, coloca-o num jogo com um milhão de jogadores. Esta cláusula sobrevive ao resto do acordo: mesmo que a tua licença terminasse amanhã, o que já fizeste continua teu.

Podes usar o Flatty para qualquer fim, pessoal ou comercial, incluindo trabalho pago de cliente, e instalá-lo em quantas máquinas quiseres. Não há limite de quantas pessoas numa organização podem usá-lo.

Por favor, não redistribuas o programa em si — não o revendas, não o incorpores noutro produto, nem publiques cópias dele. É gratuito, mas não é open source, e a página de download é de onde deve vir.

Vem sem garantia — por isso guarda cópias de segurança do teu trabalho, como farías com qualquer ferramenta que escreve ficheiros.

THIRD-PARTY-NOTICES.md, também no arquivo, lista os componentes open-source dentro do Flatty e as suas licenças.

Próximo: O teu primeiro modelo.