Cyberdecks são computadores portáteis personalizados inspirados em ficção científica, cultura hacker e estética cyberpunk. Este projeto transforma seu Android em uma central Linux portátil.
- Sobre o Projeto
- Pré-requisitos
- Instalação automática
- Instalação e Configuração
- Ambientes Gráficos Suportados
- Script
- Inicialização
- Licença
Este script foi desenvolvido para automatizar a instalação de uma distribuição Linux completa com interface gráfica dentro do ambiente Termux no Android. A proposta é dar vida a um Cyberdeck, aproveitando ao máximo o hardware do seu dispositivo.
Nota: Na criação de um cyberdeck não existem regras — você pode criar utilizando desde um celular antigo até uma TV Box. Os requisitos abaixo servem como base para a nossa stack:
- Dispositivo: Android 5.0+ com conexão à internet.
- Espaço em Disco: Mínimo de 2 GB livres de armazenamento interno.
- Periféricos: Teclado, mouse e um Hub USB/OTG.
- Software: Versão mais recente do Termux via F-Droid.
- Principal: Muita criatividade.
Para uma configuração rápida, você pode rodar o instalador passando o ambiente gráfico desejado diretamente como parâmetro. Caso queira seguir com a instalação manual siga para instalação e configuração.
Verifique se o arquivo script-installation.sh está baixado e no diretório certo.
Verificar a integridade do script:
lsDeverá mostrar as pastas do sistema, ao baixar veja se o arquivo está na pasta Download ou em outra.
cd Downloads/Execute o comando abaixo no seu Termux:
bash ~/script-instalation.sh <parametro>
xfce4lxqtmatekde
Comportamento do Script:
- Se nenhum parâmetro for passado, o script abrirá um menu interativo para você escolher a interface.
- Se um parâmetro inválido ou inexistente for digitado, o script adotará o
xfce4como padrão automaticamente e seguirá com a instalação.
Exemplo de uso:
bash ~/script-instalation.sh xfce4
Siga os passos abaixo na ordem indicada para configurar o seu ambiente de forma correta:
Antes de abrir o script, precisamos ajustar as permissões e o sistema operacional:
- Abra o Termux e libere o acesso ao armazenamento interno executando:
termux-setup-storage- Ative o Modo Desenvolvedor no seu aparelho Android.
- Nas Opções do Desenvolvedor, procure por "Desativar restrições de processos filhos" (Disable child process restrictions) e desative-a. Isso evita que o Android feche o Linux em segundo plano.
Agora vamos clonar o repositório e rodar o instalador:
# Instala o git no Termux
pkg update && pkg install git -y
# Clona o repositório do projeto
git clone [https://github.com/lucasaguiar-la/linux-android.git](https://github.com/lucasaguiar-la/linux-android.git)
# Acessa a pasta clonada
cd linux-android
# Concede permissão de execução ao script
chmod +x script-termux.sh
# Executa o instalador
./script-termux.sh
- Durante a execução, selecione o ambiente desktop de sua preferência (veja a tabela abaixo) e aguarde a conclusão.
Para renderizar a interface visual do Linux, usaremos o servidor gráfico do Termux:
- Baixe e instale o Termux X11 (Versão Nightly) no seu Android.
- No Termux, inicie o ambiente Linux rodando:
cd && ./start-linux.sh
- Abra o aplicativo Termux X11 que você instalou. A interface gráfica do Linux já estará rodando!
| Ambiente | Performance | Recomendação de Uso |
|---|---|---|
| XFCE4 | 🟢 Média | Recomendado. |
| LXQt | 🟢 Muito Leve | Ideal para dispositivos fracos. |
| MATE | 🟡 Média | Alternativa estável. |
| KDE | 🔴 Pesado | Visual moderno e completo. Indicado apenas para dispositivos topo de linha. |
O script possui um sistema inteligente de detecção de hardware que configura o ecossistema de forma otimizada para o seu chip:
- Hardware: Identificação automática da marca (Samsung, Xiaomi, etc.).
- Gráficos: Detecção de GPUs Adreno (Qualcomm) ou genéricas.
- Drivers: Seleção automática entre os drivers gráficos Freedom ou Zink para máxima compatibilidade e aceleração de hardware.
Se você quer transformar seu dispositivo de forma definitiva em um Cyberdeck e deseja que o Linux inicie automaticamente assim que você abrir o Termux, siga estes passos:
# Abre o arquivo de configuração do terminal
nano ~/.bashrc
Adicione a seguinte linha ao final do arquivo:
./start-linux.sh
Salve o arquivo (CTRL + O, depois Enter) e saia (CTRL + X).
Aqui estão as respostas para as dúvidas mais comuns sobre o projeto. Clique na pergunta para expandir.
1. Consigo rodar o VS Code, Chrome ou programas pesados nesse ambiente?
O VS Code (versão OSS para ARM64) e navegadores como o Chromium rodam, mas o desempenho depende diretamente do processador e da RAM do seu Android. Dispositivos com menos de 4GB de RAM podem sofrer travamentos ao abrir muitos apps ao mesmo tempo.
2. O projeto precisa de ROOT no celular?
Não! O script foi projetado para rodar completamente em modo rootless (sem root) usando o PRoot para emular o sistema de arquivos Linux. Isso garante que qualquer aparelho saia de fábrica pronto para virar um Cyberdeck sem riscos de segurança.
3. Por que meu Linux fecha sozinho depois de alguns minutos?
Isso geralmente acontece porque o sistema de gerenciamento de bateria do Android (especialmente em interfaces como MIUI, OneUI ou em aparelhos Android 12+) "mata" processos em segundo plano. Certifique-se de seguir o Passo 1 (Desativar restrições de processos filhos) na seção de Instalação para corrigir isso. Vale ressaltar que o Termux e Termux X11 você deve verificar a restrição de uso de bateria. Geralmente fica em Economia de bateria (Battery saver), mude para Sem restrições (No restrictions).
4. Posso instalar jogos da Steam ou apps de PC normal (.exe ou x86)?
Nativamente não, porque o seu Android usa um processador de arquitetura ARM, e a maioria dos softwares de PC comuns são feitos para arquitetura x86/x64. Para rodar programas x86, você precisaria configurar ferramentas de tradução como o Box64 ou Fex-Emu dentro do ambiente. Entretanto, isso não lhe impedi de testar jogos de plataformas como Steam, Heroic, Epic Games, etc e análisar o seu desempenho (recomendo compartilhar sua experiência com a comunidade), os principais problemas que você deve encontrar é seu processador, memória RAM, armazenamento interno, etc.
5. O som e o microfone funcionam dentro do Linux?
Para o áudio funcionar, é necessário configurar o servidor PulseAudio no Termux. O script atual foca na estabilidade do ambiente gráfico.
6. Qual a diferença entre usar o modo DeX, uma Custom ROM ou este Cyberdeck?
Se você quer usar o Android como um computador, existem três caminhos principais. Cada um oferece um nível diferente de controle, liberdade e conhecimento técnico:
- Samsung DeX (e similares): É apenas uma "roupagem" visual (Launcher) oficial sobre o próprio Android. Os aplicativos ainda são os apps normais do celular (
.apk). É estável, mas totalmente limitado às regras da fabricante. Você não tem um terminal Linux real nem pode instalar pacotes viaaptou outro Gerenciador de Pacotes. - Custom ROM (Ex: LineageOS): Uma Custom ROM é uma versão do Android modificada por desenvolvedores e entusiastas que oferece uma experiência adaptada e otimizada. Essas ROMs trazem recursos ausentes nas builds oficiais dos fabricantes, como melhorias de desempenho, novas funções, interfaces personalizadas e a possibilidade de remover apps pré‑instalados indesejados.
- Cyberdeck: Roda um Linux completo e independente lado a lado com o seu Android atual através de emulação no espaço de usuário (usando
PRooteTermux X11). O risco é zero (não precisa de root), você mantém as funções do celular intactas e ganha total liberdade de um ecossistema Linux real.
| Característica | Samsung DeX | Custom ROM | Cyberdeck |
|---|---|---|---|
| Risco de quebrar o aparelho | ⚪ Nenhum | 🔴 Risco de Brick | ⚪ Nenhum |
| Exige modificação avançada | Não (Nativo apenas para Samsung) | Sim (Desbloquear Bootloader) | Não (Apenas instalar apps) |
| O que roda por baixo | Apps Android | ROM modificada | Distribuição Linux |
| Ferramentas de Dev | Muito limitado | Depende da ROM instalada, liberdade total | Liberdade Total |
Este projeto está sob a licença correspondente do repositório. Veja o arquivo LICENSE para mais detalhes.