- docs: https://txtorcon.readthedocs.org or http://timaq4ygg2iegci7.onion
- code: https://github.com/meejah/txtorcon
torsocks git clone git://timaq4ygg2iegci7.onion/txtorcon.git- MIT-licensed;
- Python 2.7, PyPy 5.0.0+, Python 3.4+;
- depends on Twisted, Automat, (and the ipaddress backport for non Python 3)
Caution
Several large, new features have landed on master. If you're working directly from master, note that some of these APIs may change before the next release.
txtorcon is an implementation of the control-spec for Tor using the Twisted networking library for Python.
This is useful for writing utilities to control or make use of Tor in event-based Python programs. If your Twisted program supports endpoints (like twistd does) your server or client can make use of Tor immediately, with no code changes. Start your own Tor or connect to one and get live stream, circuit, relay updates; read and change config; monitor events; build circuits; create onion services; etcetera (ReadTheDocs).
download (also python3 style)
from twisted.internet.task import react
from twisted.internet.defer import inlineCallbacks
from twisted.internet.endpoints import UNIXClientEndpoint
import treq
import txtorcon
@react
@inlineCallbacks
def main(reactor):
tor = yield txtorcon.connect(
reactor,
UNIXClientEndpoint(reactor, "/var/run/tor/control")
)
print("Connected to Tor version {}".format(tor.version))
url = 'https://www.torproject.org:443'
print("Downloading {}".format(url))
resp = yield treq.get(url, agent=tor.web_agent())
print(" {} bytes".format(resp.length))
data = yield resp.text()
print("Got {} bytes:\n{}\n[...]{}".format(
len(data),
data[:120],
data[-120:],
))
print("Creating a circuit")
state = yield tor.create_state()
circ = yield state.build_circuit()
yield circ.when_built()
print(" path: {}".format(" -> ".join([r.ip for r in circ.path])))
print("Downloading meejah's public key via above circuit...")
resp = yield treq.get(
'https://meejah.ca/meejah.asc',
agent=circ.web_agent(reactor, tor.config.socks_endpoint(reactor)),
)
data = yield resp.text()
print(data)For example, serve some files via an onion service (aka hidden service):
$ sudo apt-get install --install-suggests python-txtorcon
$ twistd -n web --port "onion:80" --path ~/public_htmlAll the documentation starts in docs/index.rst. Also hosted at txtorcon.rtfd.org.
You'll want to start with the introductions (hosted at RTD).