Skip to content

📱 Instalar no Termux

Jump to bottom
KillovSky edited this page Jun 2, 2024 · 1 revision

📝 Sumário

  1. 🔎 O que é Termux?
  2. ✓ Pré-Requisitos
  3. 🐧 Instalando o Ubuntu 22.04
  4. ⚙️ Instalando a Íris
  5. 📜 Configuração
  6. 🏁 Etapas Finais
  7. 🆙 Atualizando
  8. 🙏 Finalizando
  9. ❗ Dicas

🔎 O que é Termux?

Termux é um emulador de terminal para dispositivos Android que funciona como um ambiente de linha de comando semelhante ao Linux. Ele oferece a capacidade de executar programas Linux e até mesmo transformar seu dispositivo em um servidor Linux completo ao instalar uma interface.

✓ Pré-Requisitos

Antes de iniciar a instalação da Íris no Termux, certifique-se de atender aos seguintes Pré-Requisitos:

  1. Android 7.1.2 ARMHF, ArmV7, ARMV8, ARM64 ou superior/equivalente
  2. Termux
  3. Andronix
  4. Files
  5. Outro telefone, um espelho (modo hardcore) ou similar
    • Apenas se caso você escolher conectar via QR

🗑️ Básico (Uso BAIXÍSSIMO):

Recomendado para usuários com telefones mais simples, que quase não usam BOTS ou que não podem pegar uma VPS muito boa.
Exige conhecimento maior em Termux e Android, pois rodar algo tão básico exige optimizações boas, geralmente com ROOT!
Esses requisitos se aplicam a testes, nenhum grupo ou 1 unico grupo com poucos participantes ou apenas PV e baixissimo nível de mensagens.
Não use a Íris em um telefone "ruim" se tiver muitos grupos ou alto nível de mensagens! Ka-boom amigo, entendes? KA-BOOM!

  • RAM: 3 GBs LPDDR3 ou superior
  • Processador: Quad-Core 1.4 GHz ou superior
  • GPU: N/A
  • Espaço: 4 GBs
  • Conexão de Internet: 4G, 4.5G ou 5G Móvel, WiFi 80 Mbps
  • Recomendações (Opcionais, fazem MUITA diferença): Custom ROM, Root, conhecimento intermediário em modificação de Android's
  • Exemplo: Galaxy J6 Plus

😌 Normal (Uso MODERADO):

Recomendado para usuários novos em Termux com volume comum de mensagens e pouco menos de 10 grupos.

  • Conexão de Internet: 4G, 4.5G ou 5G Móvel, WiFi 120 Mbps W/5 GHz
  • RAM: 4 GBs LPDDR4 ou superior
  • Processador: Octa-Core 1.8 GHz ou superior
  • GPU: N/A
  • Espaço: 5 GBs
  • Outros (Opcionais, fazem MUITA diferença): Custom ROM, Root, conhecimento intermediário em modificação de Android's
  • Exemplo: Asus Zenfone 5

💥 Ultimate (Uso de ALTA INTENSIDADE):

Recomendado para usuários que têm em torno de 10 ou mais grupos com alto volume de mensagens.
Quanto mais grupos e mensagens houver, além de quanto mais APPs e você usar o aparelho, melhor deve ser ele, a Íris é muito bem otimizada, mas não espere milagres.
Tudo que tem no Normal, exceto:

  • RAM: 6 ~ 8 GBs LPDDR5 ou superior
  • Processador: Octa-Core 2 GHz ou superior
  • Espaço: 6 GBs
  • Conexão de Internet: 4G, 4.5G ou 5G Móvel, WiFi 250 Mbps W/5-6 GHz
  • Outros (Opcionais, fazem POUCA diferença): Custom ROM, Root, conhecimento intermediário em modificação de Android's
  • Exemplo: Xiaomi Poco F3 - Testado por mim (Custom ROM, Root, Sem GAPPS), meu xodó, roda TUDO!

🐧 Instalando o Ubuntu 22.04

  • Antes de começar, se quiser editar a Íris digite termux-setup-storage, tecle 'y' se pedir e agora continue a instalação abaixo.

Siga as etapas abaixo para instalar o Ubuntu 22.04 no Termux:

  1. Após instalar o Termux e o Andronix, abra o aplicativo Andronix.

  2. Selecione a opção Linux Distribution no Andronix.

  3. Escolha Ubuntu 22.04 como a distribuição Linux a ser instalada (outros sistemas podem funcionar, mas este guia se aplica ao Ubuntu 22.04).

  4. Selecione CLI Only para obter uma instalação somente de linha de comando. As outras opções instalarão interfaces, aumentando o consumo de recursos e a complexidade de uso, o que pode não ser adequado para iniciantes.

  5. Avance até a opção Open Termux aparecer.

  6. Selecione essa opção, e o comando será copiado automaticamente.

  7. Cole o comando no terminal do Termux e pressione a tecla Enter do seu teclado para executá-lo. Aguarde até que a instalação do Ubuntu 22.04 seja concluída. Você pode ser solicitado a responder a algumas perguntas durante a instalação, neste caso, digite a letra correspondente a default= e pressione Enter ou apenas pressione Enter para aceitar as opções padrão.

  8. Uma vez que a instalação esteja concluída, você estará no ambiente do Ubuntu 22.04, se não tiver certeza, você estará se estiver vendo root@localhost.

  9. Quando você sair do Termux, você deve digitar ./start-ubuntu22.sh para entrar novamente no sistema que você instará a Íris.

⚙️ Instalando a Íris

Uma vez que você tenha instalado todos os requisitos e Ubuntu 22.04, copie e cole os seguintes comandos para instalar os requisitos do ambiente da Íris, você pode copiar e colar o texto inteiro abaixo se preferir.

# Atualiza os repositórios e programas do Ubuntu 22.04  
apt update && apt upgrade -y

# Instala os requisitos para inserção da repo do NodeJS 20 | https://github.com/nodesource/distributions
apt install ca-certificates curl gnupg -y

# Cria a pasta keyrings para inserir as do NodeJS
mkdir -p /etc/apt/keyrings

# Obtém a keyring do NodeJS e insere na pasta criada
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

# Instala o repositório do NodeJS no sistema do Ubuntu 22.04
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list

# Atualiza os repositórios
apt update && apt upgrade -y

# Instala os programas necessarios de uma só vez
apt install nodejs sqlite build-essential zip unzip python2 python3 git tesseract-ocr nano libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev -y

# Baixa o Projeto Íris
git clone https://github.com/KillovSky/Iris.git

# Entra na pasta da Íris
cd Iris

# Inicia o download dos arquivos adicionais dela
npm i

# SÓ UTILIZE ESSE COMANDO SE OS COMANDOS CANVAS ESTAREM TODOS FALHANDO!
# Desatualiza o sharp para fazer o canvas voltar a funcionar junto
# IGNORE o monte de WARN aparecendo no terminal após finalizar, não são BUGs
npm i [email protected]

# Inicia (leia o resto do tutorial primeiro)
npm start

📜 Configuração

Uma vez que você tenha instalado tudo, feito todos os procedimentos acima, siga os passos abaixo para configurar seu número como dono da Íris e mudar a senha.

👨‍💻 Método Nº1 - Usando CLI

  1. Digite cd && cd Iris && sed -i 's/MyNumber/SeuNúmero/g' lib/Databases/Configurations/config.json.

    • Você deve trocar 'SeuNúmero' pelo seu número no formato: DDI+DDD+Número.
    • O número deve ser igual ao mostrado no WhatsApp, por exemplo: 's/MyNumber/55119987654321/g'
    • Se você quiser inserir outro número manualmente, deve usar o método 2, 3 ou 4 apartir de agora.

  2. Para mudar a senha padrão, digite: cd && cd Iris && sed -i 's/IrisBOT@Root#123/NovaPassword/g' lib/Databases/Configurations/config.json.

  3. Para ativar a conexão por pairing code, digite: cd && cd Iris && sed -i 's/"pairingCode": { "value": false,/"pairingCode": { "value": true,/g' lib/Databases/Configurations/config.json.

📁 Método Nº2 - Usando files

  1. Se você digitou termux-setup-storage antes de instalar Ubuntu, continue, se não, saia do Ubuntu e digite, depois conecte ao Ubuntu novamente e vá para a pasta da Íris.

  2. Agora abra o aplicativo Files, arraste para a direita para mostrar um menu de locais, lá estará o termux.

  3. Entre na opção e abra as pastas na seguinte ordem: ubuntu22-fs, root, iris.

  4. Parabéns, você agora está na pasta da Íris, aperte no arquivo que quer editar e abra com seu editor de código favorito.

  5. Siga as dicas abaixo ou acima sobre o formato do número de dono e pairing code, se certifique de mudar também a senha padrão.

💌 Método Nº3 - Usando nano

  1. Digite cd && cd Iris && nano lib/Databases/Configurations/config.json.

  2. Navegue até onde possui @s.whatsapp.net usando as setas do Termux, arrastar o dedo na tela também funciona.

    • Se tiver inserido um número antes, você verá ele ali.

  3. Vá até MyNumber e apague-o, digite seu número no lugar.

    • O número deve ser igual ao mostrado no WhatsApp, por exemplo: '55119987654321'

  4. Se já tiver editado antes, e quiser adicionar outro, vá até o final da linha, onde está ] e apague-o, então adicione , "outroNú[email protected]"].

    • Troque 'outroNúmero' pelo número em questão, no mesmo jeito da dica Nº3.

  5. Vá até IrisBOT@Root#123 e apague-o, digite uma nova senha no lugar.

  6. Se desejar conectar usando o código de pareamento, vá até pairingCode e troque o false abaixo para true.

  7. Quando tiver terminado, aperte Control + O e então aperte Enter, você terá inserido com sucesso seu número, então aperte Control + X para sair.

🌐 Método Nº4 - Usando o Terminal WEB da Íris

  1. Inicie a Íris, você receberá na tela um endereço de IP e porta que é acessível somente pela sua rede.

    • Se o IP mostrado for interno, você deve usar o IP do seu telefone, ele pode ser encontrado acessando as configurações de WiFi do aparelho ou indo em 'Sobre o Telefone'.

  2. Abra um navegador e digite o endereço de IP e a porta, ficando como 192.168.0.123:45678.

    • Pode aparecer um erro dizendo que a página não é segura, mas não se preocupe, isso é por conta da Íris rastrear quem ousar acessar essa página, apenas clique em 'Aceite o risco' e prossiga.
    • O rastreamento será mostrado no terminal, de forma que, se algum invasor tentar acessar caso você modifique para IP externo, você possa rastreá-lo.

  3. Insira o nome de usuário e senha mostrados no terminal, isso pode ser configurado a partir do arquivo utils.json da pasta Terminal, mas não é esse o foco desse guia.

  4. Uma vez conectado, você estará em uma página com um terminal Linux diretamente no navegador, não se confunda, ele é extremamente poderoso e você NÃO DEVE brincar aqui.

  5. Digite config.owner.value.push('[email protected]');, se o terminal exibir um 2, você estará pronto para seguir, se quiser ter certeza, digite config.owner.value, então seu número deve aparecer.

  6. Digite config.secretKey.value = 'NovaSenha', se o terminal retornar a mesma, você estará pronto, se quiser ter certeza, digite config.secretKey.value, sua nova senha deve aparecer.

  7. Para salvar eternamente digite fs.writeFileSync(path.normalize(irisPath+'/lib/Databases/Configurations/config.json'), JSON.stringify(config, null, 4));, isso não deve printar nada na tela, mas se algo aparecer e não for um erro, você pode continuar.

  8. Para ter certeza de que deu certo, você pode digitar JSON.parse(fs.readFileSync(path.normalize(irisPath+'/lib/Databases/Configurations/config.json')))?.owner?.value; e se o número estiver lá, tudo ocorreu bem e seu número já está salvo.

  9. Feche o navegador, volte ao Termux e continue o guia.

    • Se quiser executar Python, Bash, Node ou outras tarefas pelo Terminal WEB, você pode! Siga esse exemplo: Indexer('bash').bash('seu comando').value;.
    • Exemplo: Indexer('bash').bash('python -c "print("123")"').value;
    • Tenha em mente que processos demorados, como APT, podem causar problemas ou levar uma eternidade para funcionar, só use o que você entender.
    • Você também pode abrir jogos com isso, por exemplo, para abrir GTA V pela Steam: Indexer('bash').bash('start steam://rungameid/271590').value;
    • Basicamente, tudo pode ser feito neste terminal, desde coisinhas simples de JavaScript a coisas avançadas, como instalações e demais, tanto na rede local, como em outro país.

🌟 Método Nº5 - Usando o Editor Oficial da Íris

  • AVISO: Esse código não funcionará em sistemas CLI, para isso, você precisará instalar ou ter uma interface, o que pode ser complicado para iniciantes.

  1. Digite cd && cd Iris && python lib/Scripts/jsonexplorer.py

    • Você também pode abrir isso por meio da opção 16 no npm run toolbox.

  2. Aperte carregar e localize o arquivo config.json.

  3. Vá em owner e aperte no botão de expandir, vá então para value e aperte em 0, troque MyNumber por seu número.

    • O número deve ser igual ao mostrado no WhatsApp, por exemplo: '55119987654321'
    • Para inserir outro número, vá em value que está acima do 0 e aperte com botão direito do mouse, selecione Add to Array.
    • Na janela de adicionar em array, digite outroNú[email protected], como por exemplo: [email protected]

  4. Aperte em Save (Memory) para guardar o valor enquanto estiver indo editar outros.

    • Se você não apertar nesse botão, você perderá o valor que inseriu.

  5. Vá até secretKey, expanda como fez acima, aperte em value, troque IrisBOT@Root#123 por uma nova senha SEGURA.

    • Essa senha é o que determina se alguém sem dono pode executar comandos de dono.
    • Você deve manter as aspas no inicio e fim da senha.
    • Recomendação segura: Um misto de letras maiusculas, minusculas, números e simbolos, 8 digitos.
    • Lembrando que isso é uma recomendação, se você confia nos usuários, pode usar qualquer senha.
    • Lembre de apertar em Save (Memory) a cada edição finalizada.

  6. Se desejar conectar por pairing code, vá até pairingCode, aperte em value, troque false por true.

    • Lembre de apertar em Save (Memory) a cada edição finalizada.

  7. Quando tiver terminado, aperte em Salvar (Arquivo) e pronto.

🏁 Etapas finais

Parabéns por chegar até aqui! Agora só resta iniciar e aproveitar, para isso, siga os próximos passos:

  1. Digite cd && cd Iris para voltar até a pasta da Íris e então digite npm start para iniciar.

  2. Você receberá um QR code na tela ou um código se ativar a pairingCode, para logar você tem três alternativas, abaixo você verá as formas.

📊 Usando o código de pareamento (BETA)

  1. Na tela do Termux haverá um código de 8 digitos, anote-o e seja rápido!

  2. Vá para o WhatsApp e acesse "Aparelhos Conectados > Conectar um novo Aparelho", ou onde você escaneia QR Codes, então aperte em "Conectar usando Número".

  3. Digite o código anotado e aguarde conectar.

📞 Usando outro telefone

  1. Com outro telefone, tire uma foto da tela onde o QR code está.

  2. Rapidamente abra o WhatsApp no telefone que você deseja usar, abra o escaneamento de QR code e escaneie a foto.

  3. Aguarde a Íris dizer que a sessão iniciou, tenha em mente de estar atento a possíveis erros.

🤳 Usando dois espelhos e um pouco de mágica (habilidade)

  1. Reduza o tamanho da fonte do termux fazendo um gesto de pinça na tela.

  2. Vá até um lugar com um espelho na sua frente e um atrás.

  3. Abra o Termux no modo de tela dividida com o WhatsApp, ou se puder, use o WhatsApp em modo de balão flutuante, desde que o mesmo não ofusque o QR.

  4. Posicione o telefone de frente ao primeiro espelho de forma que você consiga fazer a camera visualizar o Termux pelo segundo espelho, dê zoom ou deixe-os bem próximos.

  5. Rapidamente escaneie o QR code na tela do Termux.

🆙 Atualizando

Não atualize com isso se fez a instalação no modo Universal. Caso você queira atualizar sua Íris mantendo as suas alterações, acesse a pasta dela com o terminal e siga as etapas abaixo, se não quiser salvar alterações, pule a etapa 1 e 3.

  1. Execute git stash para guardar as alterações locais em um stash temporariamente.
  • O stash no Git é uma área temporária para armazenar alterações locais quando você precisa mudar de branch ou aplicar atualizações do repositório remoto sem fazer um commit, os comandos básicos são:

git stash: Armazena as alterações.
git stash list: Lista as alterações armazenadas.
git stash apply: Devolve as alterações salvas no stash.
git stash drop: Remove o stash mais recente.

  1. Execute o git pull para atualizar seu repositório local com as alterações do repositório remoto.

  2. Execute git stash pop para reaplicar suas alterações do stash, note que este comando aplica o stash mais recente e, em seguida, o descarta automaticamente.

❌ Conflitos

Se o git apontou conflitos entre suas alterações locais e as alterações do git pull, você infelizmente precisará resolver esses conflitos manualmente, sendo mais fácil recomeçar do zero e editar novamente.

🔄 Recomeçando

Aviso: Este método irá descartar todas as alterações locais, certifique-se de ter backup ou esteja ciente de que essas alterações serão perdidas.

Se você deseja descartar completamente as alterações locais, incluindo aquelas no arquivo de configuração, e voltar para a atualização mais recente do repositório remoto, você pode usar esses passos para isso.

  1. Descarte as alterações locais:
git reset --hard HEAD # Isso irá redefinir o seu branch para o commit mais recente, descartando todas as alterações locais.
git clean -fdx # Isso remove todos os arquivos não rastreados, incluindo aqueles que foram gerados localmente.

  1. Obtenha a atualização executando git pull, feito isso, sua Íris deverá estar atualizada, igual ao repositório remoto.

  2. Execute npm i para reinstalar ou atualizar os módulos da Íris.

  3. Para finalizar, faça a Configuração e execute npm start para iniciar.

🙏 Finalizando

Parabéns por conseguir a instalação, agora você pode aproveitar a Íris em seu total controle!

❗ Dicas

  • Tome cuidado pois Íris tem a capacidade de rodar comandos de terminal linux no WhatsApp, não dê permissão de dono a qualquer um, eles podem causar danos a você.
  • Use npm run toolbox para facilitar seu trabalho, esse comando executará um menu de ferramentas super completo.

🏠 Página Inicial

⚙️ Instruções de Instalação

📝 Documentação

👮 Políticas e Diretrizes

🆕 Changelogs

🤝 Integrações

Clone this wiki locally