https://github.com/rly0nheart/tor2tor
Capture screenshots of onion services on an onion service.
https://github.com/rly0nheart/tor2tor
darknet darkweb darkweb-crawler darkweb-links scraper
Last synced: 9 months ago
JSON representation
Capture screenshots of onion services on an onion service.
- Host: GitHub
- URL: https://github.com/rly0nheart/tor2tor
- Owner: rly0nheart
- License: mit
- Created: 2023-09-22T14:41:40.000Z (almost 3 years ago)
- Default Branch: latest
- Last Pushed: 2024-06-11T13:58:58.000Z (about 2 years ago)
- Last Synced: 2025-01-11T21:20:26.591Z (over 1 year ago)
- Topics: darknet, darkweb, darkweb-crawler, darkweb-links, scraper
- Language: Python
- Homepage: https://hub.docker.com/r/rly0nheart/tor2tor
- Size: 81.6 MB
- Stars: 50
- Watchers: 4
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
**Tor2Tor** scrapes a given onion link and captures screenshots of all links available on it.
[](https://github.com/rly0nheart/tor2tor/actions/workflows/docker-publish.yml)
[](https://github.com/rly0nheart/tor2tor/actions/workflows/codeql.yml)
***
# Installation ⬇️
## Note ⚠️
> This assumes the Firefox browser is installed on the user's machine.
**1.** Clone the repository
```commandline
git clone https://github.com/rly0nheart/tor2tor
```
**2.** Move to the tor2tor directory
```commandline
cd tor2tor
```
🐧 Linux
Run the installation script
> Assuming it has already been made executable with `sudo chmod +x install.sh`
```commandline
sudo ./install.sh
```
The installation script will install `tor` then download and setup the latest version of `geckodriver`, and
install `tor2tor` together with its dependencies (because we're all too lazy to manually do it)
***
🪟 Windows
Run the powershell installation script
```powershell
.\install.ps1
```
The installation script will download the `tor` bundle, `geckodriver`, and install `tor2tor` together with its
dependencies. The downloads will be stored in the `tor2tor` directory.
🐋 Docker Image
## Note ⚠️
> This assumes you have docker installed and running
You can just pull the docker image from [DockerHub](https://hub.docker.com/r/rly0nheart/tor2tor) by running:
```commandline
docker pull rly0nheart/tor2tor
```
***
# Usage ⌨️
🐧 Linux
To see available options/usage, call *Tor2Tor* with the `-h/--help` flag
```commandline
tor2tor --help
```
or
```commandline
t2t --help
```
Calling it with an onion url should look like the following
```commandline
sudo tor2tor http://example.onion
```
***
🪟 Windows
To see available options/usage, call *Tor2Tor* with the `-h/--help` flag
```commandline
tor2tor --help
```
or
```commandline
t2t --help
```
Calling it with an onion url should look like the following
```commandline
tor2tor http://example.onion
```
***
🐋 Docker Container
The *Tor2Tor* container can be called with `docker run` like so:
```commandline
docker run rly0nheart/tor2tor --help
```
Calling the container with an onion url should look like the following
```commandline
docker run --tty --volume $PWD/tor2tor:/root/tor2tor rly0nheart/tor2tor http://example.onion
```
## Note ⚠️
> --tty Allocates a pseudo-TTY, use it to enable the container to display colours (trust me, you will need this)
>> --volume $PWD/tor2tor:/root/tor2tor Will mount the *tor2tor* directory from the container to your host machine's
*tor2tor* directory.
***
# Updating ⬆️
🐧 Linux
[*update.sh*](https://github.com/rly0nheart/tor2tor/blob/latest/update.sh)
> Assuming it has already been made executable with `sudo chmod +x update.sh`
Navigate to the `tor2tor` directory that you cloned and find the `update.sh` file.
and run it
```commandline
sudo ./update.sh
```
The script will pull the latest changes (if any are available) then rebuild and install the package.
***
🪟 Windows
Navigate to the `tor2tor` directory that you cloned and find the `update.ps1` file.
```powershell
.\update.ps1
```
The script will pull the latest changes (if any are available) then rebuild and install the package.
***
🐋 Docker Container
As for the docker container, just run the docker pull command again.
```commandline
docker run rly0nheart/tor2tor --help
```
Calling the container with an onion url should look like the following
```commandline
docker run --tty --volume $PWD/tor2tor:/root/tor2tor rly0nheart/tor2tor http://example.onion
```
## Note ⚠️
> --tty Allocates a pseudo-TTY, use it to enable the container to display colours (trust me, you will need this)
>> --volume $PWD/tor2tor:/root/tor2tor Will mount the *tor2tor* directory from the container to your host machine's
*tor2tor* directory.
***
# Uninstalling ❌
🐧 Linux
## Note ⚠️
> Assuming it has already been made executable with `sudo chmod +x uninstall.sh`
Navigate to the `tor2tor` directory that you cloned and find the `uninstall.sh` file.
Run it!
```commandline
sudo ./uninstall.sh
```
This will uninstall `tor`, delete the `geckodriver` binary and uninstall `tor2tor`
***
🪟 Windows
Navigate to the `tor2tor` directory that you cloned and find the `uninstall.ps1` file.
Run it!
```powershell
.\uninstall.sh
```
This will delete the `geckodriver` and tor binaries then uninstall `tor2tor`
***
🐋 Docker Container
You can stop (if it's running) and remove the container by running:
```commandline
docker rm -f rly0nheart/tor2tor
```
***
# Important 🚧
As you probably already know,Tor routes data via three relays (servers) for your privacy.
As a result, connections become slower than an ordinary connection.
## Point ⚠️
Once you start **Tor2Tor**, give it at least 2 minutes tops to query the specified onion url and extract links from it.
If you want to work around this, you can always just use a cloud shell service.
# Screenshots
There's a dedicated repository of onion screenshots captured with **Tor2Tor**
at [Tor2Tor Archive](https://github.com/rly0nheart/tor2tor-archive)
## CI/CD Workflow 🌊
### Docker Image Building 🐳
- Pushing to or merging into the `latest` branch triggers an automatic build of the Docker image.
- This image is tagged as `latest` on Docker Hub, indicating it's the most stable release.
***
