- Desarrollar
- Contribuir
- Contacto
Instalación (+Uso)
El código funciona en varias plataformas. Requiere Python y las siguiente librerías:
- python-crypto - cryptographic algorithms and protocols for Python
- python-httplib2 - comprehensive HTTP client library written for Python
- python-pycurl - python bindings to libcurl
En sistemas basados en Debian (ex: Ubuntu), lanza:
- directamente:
sudo apt-get install python-crypto python-httplib2 python-pycurl
- usando setup-tools (http://pypi.python.org/pypi/setuptools):
easy_install 'paquetes'
En sistemas Windows, está funcionando (comprobado!) con:
- python 2.7 - http://www.python.org/getit/
- httplib2 0.7.4 - http://httplib2.googlecode.com/files/httplib2-0.7.4.zip
- pycrypto 2.3 - http://www.voidspace.org.uk/downloads/pycrypto-2.3.win32-py2.7.zip
- usando setup-tools (http://pypi.python.org/pypi/setuptools):
easy_install.exe 'paquetes'
------------------------
Paso 1) "Consumer" keys:
------------------------
+ Para usar OAuth con Twitter, necesitas estos tokens: 'consumer key' y 'consumer secret'.
- Primero, necesitas crear una aplicación de terceros en tu cuenta de desarrolladores de twitter.
- Entra aquí: https://dev.twitter.com
- En el icono de tu perfil, ve a: "My applications" y/o haz click en: "Create new application"
- Rellena los datos del formulario:
"Name : El nombre de tu aplicación (Esto será visible cuando mandes un mensaje)"
"Descripción: Una descripción (por ejemplo: AnonTwi")
"Website: La página web de tu aplicación (por ejemplo: http://anontwi.sf.net)"
"Si aceptas las reglas de Twitter, haz click en: 'Yes, I agree'"
"Resuelve el captcha" ;-)
"Haz click en: "Create your Twitter application"
- En "My application", haz click en tu application
- Busca: 'OAuth Settings' y guarda tus:
"Consumer key: xxxxxxxxxxxxxxxxxxxx
Consumer secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
- Abre el fichero "config.py" con un editor de textos, e introduce los tokens. Salva los cambios!.
- IMPORTANTE: Debes poner el nivel de acceso de AnonTwi a: Read, write, and direct messages
- Ahora, ya está todo listo para generar tus: secret "Token" keys. Paso 2.
---------------------
Paso 2) "Token" keys:
---------------------
+ Para utilizar AnonTwi como una API de Twitter, necesitas estos tokens: 'token key' y 'token secret'.
- Lanza: ./anontwi --tokens
- Sigue el link para leer tu "PinCode"
- Introduce el PinCode
- Después de unos segundos, recibirás una respuesta como la siguiente:
"Generating and signing request for an access token
Your Twitter Access Token key: xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Access Token secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+ Con estos tokens, ya puedes empezar a lanzar comandos de -AnonTwi-:
./anontwi [-m 'text' | -r 'ID' | -d @user | -f @nick | -u @nick] [OPTIONS] 'token key' 'token secret'
+ Recuerda que puedes EXPORTAR los tokens como variables de entorno de tu sistema operativo, para no tener que usarlos
cada vez que lanzar la herramienta.
Si lo hiciste, ya puedes empezar a lanzar comandos de -AnonTwi-:
./anontwi [-m 'text' | -r 'ID' | -d @user | -f @nick | -u @nick] [OPTIONS]
=========
Ejemplos:
=========
+ Para recordar:
- Las conexiones a la API utilizan cabeceras falsas de forma automática
- Para lanzar TOR, añade el siguiente comando: --proxy "http://127.0.0.1:8118"
- Chequea si estas haciendo geolocalización de tus mensajes (normalmente está 'off' por defecto)
- Puedes generar los 'token key' y 'token secret' todas las veces que necesites
- Puedes ver la salida de resultados con colores usando el parámetro: --rgb (mejor con fondo oscuro)
- Usa --gen para generar un PIN/llave segura (ex: --pin '1Geh0RBm9Cfj82NNhuQyIFFHR8F7fI4q7+7d0a3FrAI=')
- Trata de añadir el cifrado a tu vida diaria :)
-------------------------------------
Solicitar tus API tokens, usando TOR:
-------------------------------------
./anontwi --tokens --proxy "http://127.0.0.1:8118"
----------------------------------------------------
Generar llave PIN para cifrar y descrifrar mensajes:
----------------------------------------------------
./anontwi --gen
PIN key: K7DccSf3QPVxvbux85Tx/VIMkkDkcK+tFzi45YZ5E+g=
Comparte esta llave de forma privada con los destinatarios de tu mensaje cifrado.
No se la envíes a través de canales inseguros cómo el email, SMS, clientes de chat
o Twitter. Usa la sneakernet! ;)
---------------------
Lanzar Interfaz GTK+:
---------------------
Disfruta de tu experiencia en modo visual ;)
./anontwi --gtk
Click para hacer ZOOM
---------------------
Lanzar un bot de IRC:
---------------------
Lánzalo y tendrás un bot esclavo esperando tus órdenes en IRC.
./anontwi --irc='nickname@server:port#channel'
Sino pones un nombre al bot o eliges un canal, AnonTwi lo generará aleatoriamente por ti :)
./anontwi --irc='irc.freenode.net:6667'
----------------------------
Acortar una url, usando TOR:
----------------------------
./anontwi --short "url" --proxy "http://127.0.0.1:8118"
--------------------------------------------
Enviar un tweet en texto plano, usando TOR:
--------------------------------------------
./anontwi -m "Hello World" --proxy "http://127.0.0.1:8118"
------------------------
Enviar un tweet cifrado:
------------------------
./anontwi -m "Hello World" --enc --pin "K7DccSf3QPVxvbux85Tx/VIMkkDkcK+tFzi45YZ5E+g="
---------------
Borrar un tweet:
---------------
Necesitas el ID del tweet que quieras borrar.
- lanza "--tu @tu_nick 'num'" para ver los tweet IDs de tu usuario.
./anontwi --rm-m "ID"
----------------------
Retweetear un mensaje:
----------------------
Necesitas el ID del tweet que quieras RT.
- lanza "--tu @nick 'num'" para ver los tweet IDs de un usuario.
./anontwi -r "ID"
-------------------------------------------
Enviar un DM (Mensaje Directo), usando TOR:
-------------------------------------------
./anontwi -m "Nos vemos luego" -d "@nick" --proxy "http://127.0.0.1:8118"
---------------------
Enviar un DM cifrado:
---------------------
./anontwi -m "Nos vemos luego" -d "@nick" --enc --pin "K7DccSf3QPVxvbux85Tx/VIMkkDkcK+tFzi45YZ5E+g="
---------------
Borrar un DM:
---------------
Necesitas el ID del Mensaje Directo que quieras borrar.
- lanza "--td 'num'" para ver los IDs de los Mensajes Directos de tu cuenta.
./anontwi --rm-d "ID"
------------------------------------
Enviar un mensaje media, usando TOR:
------------------------------------
Twitter mostrará los enlaces media automáticamente. Por ejemplo, si pones el link a una imagen:
./anontwi -m "https://host/path/file.jpg" --proxy "http://127.0.0.1:8118"
-----------------------------------------------------
Enviar una respuesta en una conversación, usando TOR:
-----------------------------------------------------
Necesitas el ID del mensaje de la conversación.
- lanza "--tu @nick 'num'" para ver los IDS del 'timeline' de un usuario.
- launch "--tf 'num'" para ver los IDS de tu 'home'.
Añade los nombres de los usuarios que participan en la conversación al principio del mensaje.
./anontwi -m "@user1 @user2 text" --reply "ID" --proxy "http://127.0.0.1:8118"
----------------------------------------
Enviar solicitud de amistad, usando TOR:
----------------------------------------
./anontwi -f "@nick" --proxy "http://127.0.0.1:8118"
-----------------------------------------
Parar de seguir a un usuario, usando TOR:
-----------------------------------------
./anontwi -u "@nick" --proxy "http://127.0.0.1:8118"
----------------------------------
Crear un favorite, usando TOR:
----------------------------------
./anontwi --fav "ID" --proxy "http://127.0.0.1:8118"
----------------------------------
Destruir favorito, using TOR:
----------------------------------
./anontwi --unfav "ID" --proxy "http://127.0.0.1:8118"
----------------------------------
Bloquear a un usuario, usando TOR:
----------------------------------
./anontwi --block "@nick" --proxy "http://127.0.0.1:8118"
-------------------------------------
Desbloquear a un usuario, usando TOR:
-------------------------------------
./anontwi --unblock "@nick" --proxy "http://127.0.0.1:8118"
--------------------------------------------------
Ver un número de mensajes recientes de un usuario:
--------------------------------------------------
Puedes controlar el número de mensajes que son reportados.
Por ejemplo, los 10 últimos tweets, se hace de la siguiente forma:
./anontwi --tu "@nick 10"
-------------------------------------------------
Ver un número de mensajes recientes de tu 'home':
-------------------------------------------------
Puedes controlar el número de mensajes que son reportados.
Por ejemplo, los 10 últimos tweets, se hace de la siguiente forma:
./anontwi --tf "10"
-------------------------------------------------------
Show un número de favoritos recientes
-------------------------------------------------------
Puedes controlar el número de mensajes que son reportados.
Por ejemplo, los 10 últimos tweets, se hace de la siguiente forma:
./anontwi --tfav "@nick 10"
-----------------------------------
Dividir un mensaje largo en "olas":
-----------------------------------
Muy útil si quieres enviar mensajes largos.
Utiliza las restricciones de envio de Twitter de la forma más eficiente posible.
El cifrado está disponible, también. :)
./anontwi -m "éste es un mensaje muy largo con más de 140 caracteres..." --waves
---------------------------------------------
Enviar falsas coordenadas de geolocalización:
---------------------------------------------
Si no pones nada (--gps), las coordenadas serán aleatorias :)
./anontwi -m "texto" --gps "0.000000,0.000000"
----------------------------------------------------
Mostrar un número de Mensajes Directos de tu cuenta:
----------------------------------------------------
Puedes controlar el número de mensajes directos que son reportados.
Por ejemplo, los 5 últimos DMs, se hace de la siguiente forma:
./anontwi --td "5"
-------------------------------------------------
Mostrar los Trending Topics globales, usando TOR:
-------------------------------------------------
./anontwi --tt --proxy "http://127.0.0.1:8118"
----------------------------------------------------
Devolver las últimos menciones sobre ti, usando TOR:
----------------------------------------------------
Puedes controlar el número de mensajes que son reportados.
Por ejemplo, la última mención tuya que se ha hecho sería:
./anontwi --me "1"
------------------------------------------------------
Descifrar un tweet directamente desde URL, usando TOR:
------------------------------------------------------
Recuerda, para descifrar, necesitas el PIN/Key que otro usuario haya utilizado
para cifrar el mensaje (claves simétricas):
./anontwi --dec "http://twitter.com/encrypted_message_path" --pin "K7DccSf3QPVxvbux85Tx/VIMkkDkcK+tFzi45YZ5E+g=" --proxy "http://127.0.0.1:8118"
-----------------------------------------------------
Descifrar un tweet directamente desde código cifrado:
-----------------------------------------------------
Recuerda, para descifrar, necesitas el PIN/Key que otro usuario haya utilizado
para cifrar el mensaje (claves simétricas):
Para descifrar el mensaje con éste método, no necesitas los 'token key' y 'token secret' :)
./anontwi --dec "UK6+37fMdufVwcLxPFozlg==" --pin "K7DccSf3QPVxvbux85Tx/VIMkkDkcK+tFzi45YZ5E+g="
----------------------------------------------------------------------------
Salvar un número de tweets comenzando por el último (máx: 3200), usando Tor:
----------------------------------------------------------------------------
Puedes controlar el número de mensajes que son salvados.
Por ejemplo, los 1000 últimos tweets, se hace de la siguiente forma:
./anontwi --save "1000" --proxy "http://127.0.0.1:8118"
-------------------------------------------------------------------
Salvar un número de favoritos comenzando por el último, usando Tor:
-------------------------------------------------------------------
Puedes controlar el número de mensajes que son salvados.
Por ejemplo, los 100 últimos favoritos, se hace de la siguiente forma:
./anontwi --sfav "@nick 100" --proxy "http://127.0.0.1:8118"
-----------------------
Suicidarse, usando TOR:
-----------------------
Esto tratará de borrar los tweets, los mensajes directos y si es posible, la cuenta.
./anontwi --suicide --proxy "http://127.0.0.1:8118"
Desarrollar
El cliente se encuentra escrito en Python. Tiene licencia GPLv3.0 por tanto, es software libre.
Paquetes: http://sourceforge.net/projects/anontwi/files/
Existen varias ideas que es necesario programar (para siguientes versiones). Por ejemplo:
- limpiar el código de la API
- revisar los métodos de cifrado
- crear modulos y herramientas basadas en el "core"
- portar la herramienta para ser usada en Android, Iphone, etc
- crear noticias y difundir en las redes sociales
- crear paquetes para diferentes plataformas
Tienes un repositorio de código, con la última versión en desarrollo, en la siguiente dirección:
hg clone http://hg.code.sf.net/p/anontwi/code anontwi-code
Contribuir
Envía bitcoins al siguiente hash: 1Q63KtiLGzXiYA8XkWFPnWo7nKPWFr3nrc
Contacto
Para reportar errores, sugerencias o ideas: irc.freenode.net (canal: #AnonTwi)
