Idioma / Language: Español | English

• Descripción general
• Quickstart (2 minutos)
• Descargas (Windows .exe)
• Motivación
• Entorno de pruebas real
• Arquitectura de alto nivel
• Qué hace este proyecto
• Qué NO hace este proyecto
• Metodología experimental
• Modos de prueba
• Resultados observados
• Análisis de logs de radio
• Conclusión principal
• Uso básico
• Dependencias
• Build local (Windows)
• CI/CD (GitHub Actions)
• Documentación extendida
• Ética y alcance
• Créditos
• Licencia
• Nota final

Este repositorio documenta una investigación técnica real y reproducible cuyo objetivo es analizar si es posible forzar la rotación de una dirección IPv4 pública utilizando un teléfono Android conectado a un computador mediante USB tethering, controlando el estado de red exclusivamente desde el PC usando ADB, sin acceso root y sin aplicaciones firmadas como sistema.

Este proyecto NO es una herramienta de anonimato ni de evasión.
Es un experimento diseñado para entender y documentar los límites reales de:

• Android (framework y radio)
• ADB
• El módem
• El operador móvil (CGNAT)

El valor del repositorio está en la honestidad técnica: mostrar qué funciona, qué no funciona y por qué.

• Python 3.11+
• ADB (Android platform-tools) instalado y disponible en PATH
• Teléfono Android con USB Debugging habilitado
• (Según el modo) USB tethering activo

git clone https://github.com/Nuulz/android-ip-rotator-adb.git cd android-ip-rotator-adb python -m pip install --upgrade pip pip install -r requirements.txt 

python menu.py 

Este repositorio genera un ejecutable de Windows automáticamente cuando se crea un Release.

ir a Releases y descargar android-ip-rotator.exe.

Existe una creencia común de que activar y desactivar el modo avión en Android siempre provoca un cambio de IP pública.
Este proyecto busca responder, con evidencia técnica, a las siguientes preguntas:

• ¿Es posible forzar ese comportamiento únicamente desde ADB?
• ¿El toggle vía ADB es equivalente al toggle manual de la interfaz?
• ¿Qué papel juega el operador móvil (CGNAT) en la persistencia de la IP?
• ¿Qué ocurre internamente a nivel de radio cuando la IP cambia o no cambia?

La meta no es “hacer que funcione”, sino entender como funciona.

PC (Python CLI) └─ ADB └─ Android Framework └─ Radio / RIL └─ Red del operador (CGNAT) 

El script actúa desde el PC, sin interacción manual durante la ejecución automática.

• Ejecuta experimentos controlados de reconexión de red
• Captura logs del subsistema de radio (logcat -b radio)
• Extrae eventos relevantes (attach/detach, cambios de estado)
• Registra ejecuciones (“runs”) de forma trazable
• Exporta resultados en JSON y CSV
• Permite limpiar logs de forma segura
• Documenta explícitamente las limitaciones del sistema

• No garantiza rotación de IP
• No evade CGNAT
• No es una herramienta de anonimato
• No utiliza exploits
• No modifica el firmware
• No ejecuta control profundo del módem

Cada experimento sigue este flujo:

1. Medir la IP pública desde el PC
2. Ejecutar cambios de estado de red vía ADB
3. Esperar reconexión
4. Medir la IP pública nuevamente
5. Comparar resultados
6. Capturar y analizar logs de radio
7. Registrar la ejecución en un índice persistente

airplane_mode ON → esperar → airplane_mode OFF 

Prueba si un corte lógico de radio es suficiente.

airplane_mode ON → datos OFF → esperar → airplane_mode OFF → datos ON 

Intenta forzar una desconexión más profunda.

IP BEFORE: 190.130.xxx.xx IP AFTER : 190.130.xxx.xx 

✔ Se observa renegociación completa del radio
✔ Cambios de canal y ancho de banda
✔ Nueva sesión de red
✔ Nueva IP pública asignada

IP BEFORE: 190.130.xxx.xx IP AFTER : 190.130.xxx.xx 

✘ No hay renegociación física consistente
✘ El módem no se desancla completamente de la celda
✘ El operador mantiene la misma sesión CGNAT

Se utilizan logs del buffer radio:

adb logcat -b radio -c adb logcat -b radio -v time | findstr /i "ServiceState RIL RADIO airplane" 

Hallazgos clave:

• El toggle manual dispara eventos completos del framework y RIL
• El toggle vía ADB suele modificar solo flags lógicos
• Sin detach físico, la IP pública permanece “sticky”

Este no es un problema del script.

Es una limitación arquitectónica intencional de android:

• ADB está sandboxeado por diseño
• El control profundo del radio requiere permisos de sistema
• La IP pública depende del attach físico y de políticas del operador
• Bajo CGNAT, las reconexiones rápidas reutilizan contexto de red

ADB no puede garantizar una rotación de IP sin acceso a APIs internas o control del RIL.

python menu.py 

El menú interactivo permite:

• Ejecutar experimentos
• Capturar logs
• Analizar resultados
• Extraer eventos
• Limpiar ejecuciones de forma segura

requirements.txt:

• requests>=2.31.0
• pyinstaller>=5.14.1

Nota: el workflow instala además pillow para generar el ícono.

pip install -r requirements.txt pip install pyinstaller pillow python tools/make_icon.py pyinstaller --onefile --name android-ip-rotator --icon icon.ico menu.py 

Workflow: .github/workflows/build.yml
Trigger: al crear un Release (on: release -> types: [created])

La documentación técnica detallada (metodología, logs, eventos, CGNAT, arquitectura interna) se encuentra en la Wiki del repositorio:

ESTO SE SIGUE CONSTRUYENDO

https://github.com/Nuulz/android-ip-rotator-adb/wiki

Este proyecto se desarrolló con fines educativos y de investigación:

• Todo se ejecuta en entornos controlados
• No se afecta infraestructura de terceros
• No se promueve evasión ni anonimato

Proyecto desarrollado por el autor del repositorio.

Herramientas de IA (ChatGPT, OpenAI) se utilizaron únicamente como apoyo para análisis, organización y redacción.
Toda la experimentación, validación y conclusiones provienen de pruebas reales sobre hardware y red.

Este repositorio no intenta “ganarle al sistema”.
Intenta entenderlo.

• Overview
• Quickstart (2 minutes)
• Downloads (Windows .exe)
• Motivation
• Real test environment
• High-level architecture
• What this project does
• What this project does NOT do
• Experimental methodology
• Test modes
• Observed results
• Radio log analysis
• Main conclusion
• Basic usage
• Dependencies
• Local build (Windows)
• CI/CD (GitHub Actions)
• Extended documentation
• Ethics & scope
• Credits
• License
• Final note

This repository documents a real, reproducible technical investigation focused on whether it is possible to force public IPv4 rotation using an Android phone connected to a computer via USB tethering, controlling network state from the PC only using ADB, with no root access and no system-signed apps.

This project is NOT an anonymity or evasion tool.
It is an experiment meant to understand and document real-world limits across:

• Android (framework + radio)
• ADB
• The modem
• The mobile carrier (CGNAT)

The value is technical honesty: showing what works, what doesn’t, and why.

• Python 3.11+
• ADB (Android platform-tools) installed and available in PATH
• Android device with USB Debugging enabled
• (Depending on the mode) USB tethering enabled

git clone https://github.com/Nuulz/android-ip-rotator-adb.git cd android-ip-rotator-adb python -m pip install --upgrade pip pip install -r requirements.txt 

python menu.py 

This repository builds a Windows executable automatically when a Release is created.

go to Releases and download android-ip-rotator.exe.

There is a widespread belief that activating airplane mode always forces a change in the public IP address.
This project aims to answer the following questions with technical tests:

• Can this be forced using only ADB?
• Is activating ADB equivalent to activating the user interface?
• How does the operator's CGNAT affect the “persistent” behavior of the public IP?
• What happens at the radio/RIL level when the IP changes (or does not change)?

The goal is not to “make it work,” but to understand how it works internally.

PC (Python CLI) └─ ADB └─ Android Framework └─ Radio / RIL └─ Carrier network (CGNAT) 

The script runs from the PC, with no manual interaction during automated execution.

• Runs controlled network reconnection experiments
• Captures radio subsystem logs (logcat -b radio)
• Extracts relevant events (attach/detach, state changes)
• Tracks runs in a persistent, traceable way
• Exports results to JSON and CSV
• Supports safe log clearing
• Explicitly documents system limitations

• Does not guarantee IP rotation
• Does not bypass CGNAT
• Is not an anonymity tool
• Does not use exploits
• Does not modify firmware
• Does not perform deep modem control

Each experiment follows:

1. Measure public IP from the PC
2. Apply network state changes via ADB
3. Wait for reconnection
4. Measure public IP again
5. Compare results
6. Capture/analyze radio logs
7. Persist the run in an index

airplane_mode ON → wait → airplane_mode OFF 

airplane_mode ON → data OFF → wait → airplane_mode OFF → data ON 

IP BEFORE: 190.130.xxx.xx IP AFTER : 190.130.xxx.xx 

IP BEFORE: 190.130.xxx.xx IP AFTER : 190.130.xxx.xx 

adb logcat -b radio -c adb logcat -b radio -v time | findstr /i "ServiceState RIL RADIO airplane" 

Key findings:

• UI toggle triggers full framework + RIL flows
• ADB toggles often change logical flags only
• Without a real physical detach, public IP remains “sticky”

This is not a scripting problem.

It is an intentional architectural limitation:

• ADB is sandboxed by design
• Deep radio control requires system privileges
• Public IP depends on physical attach + carrier policy
• Under CGNAT, fast reconnects may reuse network context

ADB cannot guarantee IP rotation without internal APIs or RIL-level control.

python menu.py 

The interactive menu can:

• Run experiments
• Capture logs
• Analyze results
• Extract events
• Safely clean runs/logs

requirements.txt:

• requests>=2.31.0
• pyinstaller>=5.14.1

Note: CI installs pillow to generate the icon.

pip install -r requirements.txt pip install pyinstaller pillow python tools/make_icon.py pyinstaller --onefile --name android-ip-rotator --icon icon.ico menu.py 

Workflow: .github/workflows/build.yml
Trigger: Release created (on: release -> types: [created])

Full technical documentation lives in the repository Wiki:

https://github.com/Nuulz/android-ip-rotator-adb/wiki

THIS IS STILL BEING WORKED ON

Educational + research use only:

• Controlled environments only
• No third-party infrastructure abuse
• No evasion/anonymity promotion

Project developed by the repository author.

AI tools (ChatGPT, OpenAI) were used only to support analysis, organization, and writing.
All experimentation, validation, and conclusions come from real hardware/network testing.

This repository is not trying to “beat the system”.
It is trying to understand it.