Skip to content

readme-changed #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wxypereira wants to merge 1 commit into
base: master
Choose a base branch
from
Open

readme-changed #2

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
226 changes: 146 additions & 80 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,124 +1,190 @@
# 🎀 Tutorial de criação de cyberdeck usando um celular antigo ✨
# Cyberdeck: Linux no Android

## O que é um cyberdeck? 💻🩷
<div align="center">

<img width="500" height="333" alt="image" src="https://github.com/user-attachments/assets/b74871d7-954e-4015-857b-d3c84ebfdc04" />
![GitHub repo size](https://img.shields.io/github/repo-size/giovn-aguiar/linux-android?style=for-the-badge&color=8A2BE2)
![GitHub language count](https://img.shields.io/github/languages/count/giovn-aguiar/linux-android?style=for-the-badge&color=8A2BE2)
![GitHub forks](https://img.shields.io/github/forks/giovn-aguiar/linux-android?style=for-the-badge&color=8A2BE2)
![GitHub issues](https://img.shields.io/github/issues/giovn-aguiar/linux-android?style=for-the-badge&color=8A2BE2)

<img src="image.png" alt="Cyberdeck Banner" width="100%">

> *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.*

</div>

Cyberdecks são computadores portáteis personalizados inspirados em ficção científica, cultura hacker e estética cyberpunk.
Normalmente são feitos reaproveitando hardware antigo, adicionando acessórios, modificações estéticas e sistemas Linux personalizados ✨
---

A ideia é transformar um dispositivo comum em algo único, funcional e com muita personalidade ♡
## Índice
- [Sobre o Projeto](#sobre-o-projeto)
- [Pré-requisitos](#️pré-requisitos)
- [Instalação automática](instalação-automatica)
- [Instalação e Configuração](#instalação-e-configuração)
- [Ambientes Gráficos Suportados](#ambientes-gráficos-suportados)
- [Script](#otimização-automática)
- [Inicialização](#inicialização-automática)
- [Licença](#licença)

Neste tutorial, vamos utilizar um celular Android antigo para criar um ambiente Linux completo usando o Termux, transformando o aparelho em um mini computador portátil 💿⚡
---

## O que você vai precisar 🧃
## Sobre o Projeto
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.

Lembrando que aqui estou mostrando o que vou utilizar no cyberdeck que estou criando 🎀
Mas o mais legal de cyberdecks é que literalmente não existe regra — você pode criar utilizando até uma TV Box no lugar do celular e adaptar tudo do seu jeito ♡
---

- Um celular ou tablet Android 📱
- Powerbank 🔋
- Teclado Bluetooth ou USB ⌨️
- Mouse Bluetooth ou USB 🖱️
- Hub USB 🌐
- Aproximadamente 2GB livres 💾
- Criatividade para personalizar seu cyberdeck 💻🩷✨
## Pré-requisitos

# Projeto Android Linux - Termux
> **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:

## Descrição
* **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](https://f-droid.org/packages/com.termux/).
* **Principal:** Muita criatividade.

Script de configuração automatizada para instalar e gerenciar um ambiente Linux completo no Termux.
---

## Recursos
## Instalação automática

- Detecção automática do dispositivo e GPU
- Suporte a múltiplos ambientes desktop (XFCE4, LXQt, MATE, KDE)
- Aceleração gráfica otimizada por GPU
- Instalação simplificada e automatizada
- Compatibilidade com smartphones e tablets
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](instalacao-e-configuracao).
> Verifique se o arquivo script-installation.sh está baixado e no diretório certo.

## Ambientes Desktop Suportados
Verificar a integridade do script:

| Desktop | Peso | Recomendação |
|---------|------|--------------|
| XFCE4 | Médio | Recomendado |
| LXQt | Leve | Para dispositivos antigos |
| MATE | Médio | Alternativa estável |
| KDE | Pesado | Para dispositivos poderosos |

## Instalação

1. Instale o [Termux](https://f-droid.org/pt_BR/packages/com.termux/) do F-Droid
2. Abra o Termux e dê permissões para acesso ao armazenamento do celular:
```
termux-setup-storage
```bash
ls
```
3. Desbloqueie o modo Desenvolvedor no seu aparelho
4. Em 'Opções do Desenvolvedor' desabilite a opção 'Desativar restrições de processos filhos' (ou 'Disable child process restrictions')
5. Instale o git:
```
pkg install git
Deverá mostrar as pastas do sistema, ao baixar veja se o arquivo está na pasta Download ou em outra.

```bash
cd Downloads/
```
6. Clone este repositório:

Execute o comando abaixo no seu Termux:

```bash
bash ~/script-instalation.sh <parametro>

```
git clone https://github.com/lucasaguiar-la/linux-android.git

### Parâmetros disponíveis:

* `xfce4`
* `lxqt`
* `mate`
* `kde`

> **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 `xfce4` como padrão automaticamente e seguirá com a instalação.
>
>

Exemplo de uso:

```bash
bash ~/script-instalation.sh xfce4

```
7. Após execute:

---

## Instalação e Configuração

Siga os passos abaixo na ordem indicada para configurar o seu ambiente de forma correta:

### Passo 1: Preparação do Android
Antes de abrir o script, precisamos ajustar as permissões e o sistema operacional:
1. Abra o **Termux** e libere o acesso ao armazenamento interno executando:
```bash
termux-setup-storage
```

2. Ative o **Modo Desenvolvedor** no seu aparelho Android.
3. 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.

### Passo 2: Instalação do Script

Agora vamos clonar o repositório e rodar o instalador:

```bash
# 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

# Da permissões para executar o script
chmod +X script-termux.sh
# Concede permissão de execução ao script
chmod +x script-termux.sh

# Executa o script de instalação
# Executa o instalador
./script-termux.sh
```
8. Selecione o ambiente desktop desejado
9. Aguarde a instalação ser concluída
10. Rode o script:
```
# Voltar para a home
cd

#Executa o script
./start-linux.sh
```
11. Instale o [Termux X11](https://github.com/termux/termux-x11/releases/tag/nightly) para acessar a interface gráfica
12. Abra o Termux X11 e o provedor gráfico já estará funcionando

## Detecção de Hardware
4. Durante a execução, selecione o ambiente desktop de sua preferência (veja a tabela abaixo) e aguarde a conclusão.

O script detecta automaticamente:
- **Marca do dispositivo**: Samsung, Xiaomi, etc.
- **GPU**: Adreno (Samsung/Qualcomm) ou genérica
- **Driver gráfico**: Freedom ou Zink (compatibilidade)
### Passo 3: Inicialização e Interface Gráfica

## Requisitos
Para renderizar a interface visual do Linux, usaremos o servidor gráfico do Termux:

- Android 5.0+
- Termux instalado
- Termux: X11
- ~2GB de espaço livre
- Conexão com internet
1. Baixe e instale o [Termux X11 (Versão Nightly)](https://www.google.com/search?q=https://github.com/termux/termux-x11/releases/tag/nightly) no seu Android.
2. No Termux, inicie o ambiente Linux rodando:

## Notas
```bash
cd && ./start-linux.sh

- Use XFCE4 para melhor equilíbrio entre performance e funcionalidade
- Dispositivos antigos: prefira LXQt
- Dispositivos topo de linha: experimente KDE
- Para executar automatizamente o `./start-linux.sh` toda vez que abrir o Termux, faça o seguinte:
```

3. Abra o aplicativo **Termux X11** que você instalou. A interface gráfica do Linux já estará rodando!

---

## Ambientes Gráficos Suportados

| 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. |

---

## Script

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.

---

## Inicialização

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:

```bash
# Abre o arquivo de configuração do terminal
nano ~/.bashrc

# Cole o conteúdo abaixo:
```

Adicione a seguinte linha ao final do arquivo:

```bash
./start-linux.sh

```

Salve o arquivo (`CTRL + O`, depois `Enter`) e saia (`CTRL + X`).

---

## Licença

MIT
Este projeto está sob a licença correspondente do repositório. Veja o arquivo [LICENSE](LICENSE.md) para mais detalhes.