Skip to content

Commit

Permalink
Merge pull request #219 from DedSecInside/use_gotor
Browse files Browse the repository at this point in the history
Use GoTor HTTP service
  • Loading branch information
KingAkeem authored Sep 21, 2021
2 parents 74e2436 + bab824c commit 8dbc7e5
Show file tree
Hide file tree
Showing 16 changed files with 281 additions and 1,364 deletions.
3 changes: 3 additions & 0 deletions .gitmodules
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[submodule "gotor"]
path = gotor
url = https://github.com/KingAkeem/gotor
41 changes: 14 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝

Open Source Intelligence Tool for the Dark Web

</pre>

<p align="center">
Expand All @@ -24,22 +24,6 @@
[![Code Triage](https://www.codetriage.com/dedsecinside/torbot/badges/users.svg)](https://www.codetriage.com/dedsecinside/torbot)
[![](https://img.shields.io/badge/Built%20with-❤-orange.svg?style=flat-square)]()
[![](https://img.shields.io/badge/Made%20with-Python-red.svg?style=flat-square)]()
## Working Procedure/Basic Plan
The basic procedure executed by the web crawling algorithm takes a list of seed URLs as its input and repeatedly executes
the following steps:
<code>
<pre>
URLs = input(url)
while(URLs is not empty) do
dequeue url
request page
parse for Links
for(link in Links) do
if (link islive && link is not visited) then
add link to URLs
store page content
</pre>
</code>

### Features
1. Onion Crawler (.onion).(Completed)
Expand All @@ -66,7 +50,7 @@ Contributor name will be updated to the below list. 😀
### OS Dependencies
- Tor
- Python ^3.7
- Golang 1.x (Not Currently Used)
- Golang 1.16

### Python Dependencies

Expand All @@ -80,6 +64,8 @@ Contributor name will be updated to the below list. 😀
- yattag
- numpy

### Golang Dependencies
- https://github.com/KingAkeem/gotor (This service needs to be ran in tandem with TorBot)

## Basic setup
Before you run the torBot make sure the following things are done properly:
Expand All @@ -100,7 +86,7 @@ Before you run the torBot make sure the following things are done properly:
On Linux platforms, you can make an executable for TorBot by using the install.sh script.
You will need to give the script the correct permissions using `chmod +x install.sh`
Now you can run `./install.sh` to create the torBot binary.
Run `./torBot` to execute the program.
Run `./torBot` to execute the program.

An alternative way of running torBot is shown below, along with help instructions.

Expand Down Expand Up @@ -128,29 +114,30 @@ optional arguments:
Read more about torrc here : [Torrc](https://github.com/DedSecInside/TorBoT/blob/master/Tor.md)


#### Using the GUI
#### Using the GUI


#### Using Docker

- Ensure than you have a tor container running on port 9050.
- Build the image using following command (in the root directory):

`docker build -f docker/Dockerfile -t dedsecinside/torbot .`
- Run the container (make sure to link the tor container as `tor`):

`docker run --link tor:tor --rm -ti dedsecinside/torbot`

## TO-DO
- [X] Visualization Module
- [x] Visualization Module
- [x] Implement BFS Search for webcrawler
- [X] Multithreading for Get Links
- [ ] Improve stability (Handle errors gracefully, expand test coverage and etc.)
- [X] Create a user-friendly GUI
- [x] Use Golang service for concurrent webcrawling
- [x] Improve stability (Handle errors gracefully, expand test coverage and etc.)
- [x] Create a user-friendly GUI
- [ ] Randomize Tor Connection (Random Header and Identity)
- [ ] Keyword/Phrase search
- [ ] Social Media Integration
- [ ] Increase anonymity and efficiency
- [ ] Increase anonymity
- [x] Increase efficiency

### Have ideas?
If you have new ideas which is worth implementing, mention those by starting a new issue with the title [FEATURE_REQUEST].
Expand Down
1 change: 1 addition & 0 deletions gotor
Submodule gotor added at ddf4a7
4 changes: 0 additions & 4 deletions src/api/__init__.py

This file was deleted.

36 changes: 0 additions & 36 deletions src/api/endpoints.py

This file was deleted.

Loading

0 comments on commit 8dbc7e5

Please sign in to comment.