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 c  |
|   | onfiguring |
|   | 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 pro  |
|   | grammatic  |
|   | ally 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 cont  |
|   | rollers    |
|   | can        |
|   | subscribe  |
|   | to be      |
|   | notified   |
|   | of. In     |
|   | this       |
|   | tutorial   |
|   | we’ll do   |
|   | just that, |
|   | writing a  |
|   | curses ap  |
|   | plication  |
|   | 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 info  |
| e | rmation    |
| ] | about      |
|   | relays in  |
|   | the Tor    |
|   | network.   |
|   | Relay inf  |
|   | ormation   |
|   | is         |
|   | provided   |
|   | through    |
|   | documents  |
|   | called **  |
|   | descripto  |
|   | rs**. 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 |
|   | applicati  |
|   | ons. Here  |
|   | we         |
|   | introduce  |
|   | some of    |
|   | them.      |
+---+------------+
| [ | [ i m a g  |
| i | e ] Inter  |
| m | active in  |
| a | terpreter  |
| 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 experi  |
|   | menting    |
|   | 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 appli  |
|   | cations    |
|   | that use   |
|   | Stem.      |
+---+------------+
