Tutorial
********

Getting started with any new library can be daunting, so let’s get our
feet wet by jumping straight in with some tutorials…

+---+------------+
| [ | [ i m a g  |
| i | e ] Basics |
| m | for        |
| a | talking    |
| g | with Tor.  |
| e | This will  |
| ] | step you   |
|   | through co |
|   | nfiguring  |
|   | Tor and    |
|   | writing    |
|   | your first |
|   | script to  |
|   | talk with  |
|   | it.        |
+---+------------+
| [ | [ i m a g  |
| i | e ] Rather |
| m | than       |
| a | talking to |
| g | Tor, we’ll |
| e | now talk * |
| ] | *through** |
|   | it. In     |
|   | this       |
|   | tutorial   |
|   | we’ll prog |
|   | rammatical |
|   | ly start   |
|   | Tor then   |
|   | use it to  |
|   | read a     |
|   | site       |
|   | through    |
|   | mother     |
|   | Russia!    |
+---+------------+
| [ | [ i m a g  |
| i | e ] As Tor |
| m | runs it    |
| a | generates  |
| g | a variety  |
| e | of         |
| ] | **events** |
|   | that contr |
|   | ollers can |
|   | subscribe  |
|   | to be      |
|   | notified   |
|   | of. In     |
|   | this       |
|   | tutorial   |
|   | we’ll do   |
|   | just that, |
|   | writing a  |
|   | curses app |
|   | lication   |
|   | that       |
|   | graphs the |
|   | bandwidth  |
|   | usage of   |
|   | Tor.       |
+---+------------+
| [ | [ i m a g  |
| i | e ] Hidden |
| m | services   |
| a | are a way  |
| g | of         |
| e | providing  |
| ] | a service  |
|   | that isn’t |
|   | easily     |
|   | trackable. |
|   | As a       |
|   | dissident, |
|   | for        |
|   | instance,  |
|   | this could |
|   | let you    |
|   | safely     |
|   | publish a  |
|   | blog       |
|   | without    |
|   | getting    |
|   | your door  |
|   | kicked     |
|   | down. Here |
|   | we’ll walk |
|   | you        |
|   | through an |
|   | example.   |
+---+------------+
| [ | [ i m a g  |
| i | e ]        |
| m | Getting    |
| a | and acting |
| g | upon infor |
| e | mation     |
| ] | about      |
|   | relays in  |
|   | the Tor    |
|   | network.   |
|   | Relay info |
|   | rmation is |
|   | provided   |
|   | through    |
|   | documents  |
|   | called **d |
|   | escriptors |
|   | **. This   |
|   | walks you  |
|   | through    |
|   | both where |
|   | to get     |
|   | them and a |
|   | small      |
|   | script to  |
|   | tell you   |
|   | the        |
|   | fastest    |
|   | Tor exits. |
+---+------------+
| [ | [ i m a g  |
| i | e ] Stem   |
| m | provides   |
| a | several    |
| g | utility    |
| e | modules    |
| ] | frequently |
|   | useful for |
|   | Tor        |
|   | controller |
|   | applicatio |
|   | ns. Here   |
|   | we         |
|   | introduce  |
|   | some of    |
|   | them.      |
+---+------------+
| [ | [ i m a g  |
| i | e ] Intera |
| m | ctive inte |
| a | rpreter    |
| g | for Tor    |
| e | that       |
| ] | provides   |
|   | you with   |
|   | direct     |
|   | access to  |
|   | Tor’s      |
|   | control    |
|   | interface  |
|   | via either |
|   | python or  |
|   | direct     |
|   | requests.  |
|   | This is an |
|   | easy way   |
|   | of experim |
|   | enting     |
|   | with Stem  |
|   | and        |
|   | learning   |
|   | what Tor   |
|   | can do.    |
+---+------------+
| [ | [ i m a g  |
| i | e ]        |
| m | Sometimes  |
| a | it’s       |
| g | easiest to |
| e | learn a    |
| ] | library by |
|   | seeing how |
|   | it’s used  |
|   | in the     |
|   | wild. This |
|   | is a       |
|   | directory  |
|   | of scripts |
|   | and applic |
|   | ations     |
|   | that use   |
|   | Stem.      |
+---+------------+
