├── .gitignore
├── LICENSE
├── README.md
├── app
    ├── __init__.py
    ├── templates
    │   ├── base.html
    │   └── index.html
    └── views.py
├── run.py
└── screenshots
    └── front.png


/.gitignore:
--------------------------------------------------------------------------------
1 | *.pyc
2 | *.pyo
3 | app.db
4 | search.db
5 | flask
6 | 
7 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2017 Satwik Kansal
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # tor-hidden-service-python
 2 | 
 3 | > A simple boilerplate of creating a `.onion` website for Tor using Flask and Python.
 4 | 
 5 | ## Table of Contents
 6 | 
 7 | - [Instructions](#instructions)
 8 | - [Screenshots](#screenshots)
 9 | - [Contributing](#contributing)
10 | - [License](#license)
11 | 
12 | ## Instructions
13 | 
14 | - Download Tor browser from the official site ([link](https://www.torproject.org/download/download))
15 | 
16 | - Configure your hidden service.
17 |     + Go to the Tor browser directory.
18 |     + Open the "torrc" file in an editor. (Probably located in `Browser/TorBrowser/Data/Tor` directory)
19 |     + Add the following lines to the file
20 |     ```
21 |     HiddenServiceDir /any/path/where/you/want/config/to/be/stored
22 |     HiddenServicePort 80 127.0.0.1:5000
23 |     ```
24 |     + Save and close the file.
25 | 
26 | - Clone this repository in your local system
27 | ```sh
28 | $ git clone https://github.com/satwikkansal/tor-hidden-service-python.git
29 | $ cd tor-hidden-service
30 | ```
31 | 
32 | - Install the pypi requirements
33 | ```sh
34 | $ pip -r requirements.txt
35 | ```
36 | 
37 | - Run the server
38 | ```sh
39 | $ python run.py
40 | ```
41 | 
42 | - Launch the Tor Browser
43 | 
44 | - Copy the url generated in the `hostname` file
45 | ```sh
46 | $ cat /path/to/config/directory/hostname
47 | >>> some-obfuscated-url.onion
48 | ```
49 | 
50 | - Open this copied url in the Tor Browser and it should work :tada:
51 | 
52 | 
53 | ## Screenshots
54 | 
55 | ![Screenshot](https://github.com/satwikkansal/tor-hidden-service-python/blob/master/screenshots/front.png)
56 | 
57 | 
58 | ## Contributing
59 | 
60 | All patches welcome!
61 | 
62 | 
63 | ## License
64 | 
65 | MIT License - see the [LICENSE](https://github.com/satwikkansal/tor-hidden-service-python/blob/master/LICENSE) file for details.
66 | 


--------------------------------------------------------------------------------
/app/__init__.py:
--------------------------------------------------------------------------------
1 | from flask import Flask
2 | 
3 | app = Flask(__name__)
4 | 
5 | from app import views


--------------------------------------------------------------------------------
/app/templates/base.html:
--------------------------------------------------------------------------------
 1 | <html>
 2 |   <head>
 3 |     <title>{{ title }}</title>
 4 |   </head>
 5 |   <body>
 6 |     <div><a href="/index">Home</a></div>
 7 |     <center><h1>{{ title }}</h1></center>
 8 |     <hr>
 9 |     {% with messages = get_flashed_messages() %}
10 |     {% if messages %}
11 |     <ul>
12 |     {% for message in messages %}
13 |         <li>{{ message }} </li>
14 |     {% endfor %}
15 |     </ul>
16 |     {% endif %}
17 |     {% endwith %}
18 |     {% block content %}{% endblock %}
19 |   </body>
20 | </html>
21 | 


--------------------------------------------------------------------------------
/app/templates/index.html:
--------------------------------------------------------------------------------
 1 | <!-- extend base layout -->
 2 | {% extends "base.html" %}
 3 | 
 4 | {% block content %}
 5 | 	<br>
 6 | 
 7 | 	<center>
 8 | 	<form action="/submit" id="textform" method="post">
 9 | 	    <textarea name="text" rows="4" cols="50" placeholder="Just write whatever you want to..."></textarea>
10 | 	    <br>
11 | 	    <input type="text" name="nick" placeholder="Your nick (optional)">
12 | 	    <input type="submit" value="Post">
13 | 	</form>
14 | 	</center>
15 | 
16 | 	<br>
17 | 
18 | 	<div style="margin-left: 20px;">
19 |     {% for post in posts %}
20 |     <p>
21 |       At <i>[{{ post.time }}]</i>, <u>{{ post.author.nickname }}</u> says: <b>{{ post.body }}</b>
22 |     </p>
23 |     {% endfor %}
24 |     </div>
25 | {% endblock %}
26 | 


--------------------------------------------------------------------------------
/app/views.py:
--------------------------------------------------------------------------------
 1 | import datetime
 2 | import random
 3 | 
 4 | from flask import render_template, redirect, request
 5 | from app import app
 6 | 
 7 | posts = []
 8 | 
 9 | @app.route('/')
10 | @app.route('/index')
11 | def index():
12 |     return render_template('index.html',
13 |                            title='Voice of the Internet!',
14 |                            posts=posts)
15 | 
16 | 
17 | @app.route('/submit', methods=['POST'])
18 | def submit_textarea():
19 |     post_content = request.form["text"]
20 | 
21 |     nickname = request.form["nick"]
22 |     if not nickname:
23 |         nickname = "Anon" + str(random.randint(100000, 999999))
24 | 
25 |     posts.append(
26 |         {
27 |           'author': {'nickname': nickname},
28 |           'body': post_content,
29 |           'time': datetime.datetime.now().strftime('%H:%M:%S')
30 |         })
31 | 
32 |     return redirect('/index')
33 | 


--------------------------------------------------------------------------------
/run.py:
--------------------------------------------------------------------------------
1 | #!flask/bin/python
2 | from app import app
3 | app.run(debug=True)
4 | 


--------------------------------------------------------------------------------
/screenshots/front.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/satwikkansal/tor-hidden-service-python/ce009f0837649beb6c6882e9adb090e69afc352e/screenshots/front.png


--------------------------------------------------------------------------------