| Name | tor-downloader JSON |
| Version |
1.0.3
JSON |
| download |
| home_page | |
| Summary | Download dark web files using Tor. |
| upload_time | 2023-05-11 15:25:02 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.10 |
| license | MIT License Copyright (c) 2022 Ian Costa Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
tor
requests
stem
dark web
file download
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# TorDownloader
Download files from Tor websites. Used to download data from ransomware leak sites.
Uses streamed file downloads and restarts if a file is not fully downloaded.
Gets the list of URLs to download either from a JSON file or from another URL (work in progress).
## Installing TorDownloader
### Using Pip
TorDownloader can be easily installed through pip:
- First, create a virtual environment: `python -m venv .venv`
- Then activate it: `.venv\Scripts\activate` on Windows or `.venv/activate` on Linux
- Finally install the tor_downloader package: `python -m pip install tor-downloader`
If installing TorDownloader through pip, it will be installed in your Python path. This is important as the path is used for default options such as the output directory, input directory, and log directory.
Because of this, you can give TorDownloader the argument `path` to find the folder TorDownloader was installed into.
Example of this command:
```python -m tor_downloader path```
## Running TorDownloader
Links must be given to TorDownloader in a JSON file with a single list of links. By default, TorDownloader looks for a `links.json` file in the `tor_downloader/data/input` directory.
Configuration options can be given in either a JSON file or as command line arguments.
The config file must be a JSON file with a single dictionary.
The command line arguments must be formatted like so:
```CONFIG=SETTING```
Configuration options:
socks_port: Port of Tor Socks5 proxy.
max_downloads: Maximum number of downloads to run at once.
max_tor_checks: Number of times the Tor proxy will be checked to ensure Tor is working before crashing. Default is 5.
tor_path: Path to the Tor executable (tor.exe). Often found in Tor Browser if installed (Tor Browser\\Browser\\TorBrowser\\Tor\\tor.exe).
links_file: Path to the file containing the list of URLs to download. Must be a .json file with a single list of URLs.
log_file: Path to the log file. Log file will be created if it does not exist.
output_dir: Path to the directory to download the files to.
config: Path to the configuration file. Only usable through the command line arguments.
Example command:
```python -m tor_downloader max_downloads=7 tor_path="Tor Browser\\Browser\\TorBrowser\\Tor\\tor.exe" links_file=links.json output_directory=output```
## Getting Results
All files will be installed into the output directory specified in the config file or command line argument. By default, the output directory is `tor_downloader/data/input`.
Raw data
{
"_id": null,
"home_page": "",
"name": "tor-downloader",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "tor,requests,stem,dark web,file download",
"author": "",
"author_email": "Ian Costa <costa.ian18@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b4/2f/87d53dd98803b39471bb50c7051b4d42d378693931601c67a2fc41b170e9/tor_downloader-1.0.3.tar.gz",
"platform": null,
"description": "# TorDownloader\r\n\r\nDownload files from Tor websites. Used to download data from ransomware leak sites.\r\n\r\nUses streamed file downloads and restarts if a file is not fully downloaded.\r\nGets the list of URLs to download either from a JSON file or from another URL (work in progress).\r\n\r\n## Installing TorDownloader\r\n\r\n### Using Pip\r\n\r\nTorDownloader can be easily installed through pip:\r\n- First, create a virtual environment: `python -m venv .venv`\r\n- Then activate it: `.venv\\Scripts\\activate` on Windows or `.venv/activate` on Linux\r\n- Finally install the tor_downloader package: `python -m pip install tor-downloader`\r\n\r\nIf installing TorDownloader through pip, it will be installed in your Python path. This is important as the path is used for default options such as the output directory, input directory, and log directory.\r\nBecause of this, you can give TorDownloader the argument `path` to find the folder TorDownloader was installed into.\r\nExample of this command:\r\n```python -m tor_downloader path```\r\n\r\n## Running TorDownloader\r\n\r\nLinks must be given to TorDownloader in a JSON file with a single list of links. By default, TorDownloader looks for a `links.json` file in the `tor_downloader/data/input` directory.\r\n\r\nConfiguration options can be given in either a JSON file or as command line arguments.\r\nThe config file must be a JSON file with a single dictionary.\r\nThe command line arguments must be formatted like so:\r\n ```CONFIG=SETTING```\r\n\r\nConfiguration options:\r\n socks_port: Port of Tor Socks5 proxy.\r\n max_downloads: Maximum number of downloads to run at once.\r\n max_tor_checks: Number of times the Tor proxy will be checked to ensure Tor is working before crashing. Default is 5.\r\n tor_path: Path to the Tor executable (tor.exe). Often found in Tor Browser if installed (Tor Browser\\\\Browser\\\\TorBrowser\\\\Tor\\\\tor.exe).\r\n links_file: Path to the file containing the list of URLs to download. Must be a .json file with a single list of URLs.\r\n log_file: Path to the log file. Log file will be created if it does not exist.\r\n output_dir: Path to the directory to download the files to.\r\n config: Path to the configuration file. Only usable through the command line arguments.\r\n\r\nExample command:\r\n ```python -m tor_downloader max_downloads=7 tor_path=\"Tor Browser\\\\Browser\\\\TorBrowser\\\\Tor\\\\tor.exe\" links_file=links.json output_directory=output```\r\n\r\n## Getting Results\r\n\r\nAll files will be installed into the output directory specified in the config file or command line argument. By default, the output directory is `tor_downloader/data/input`.\r\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2022 Ian Costa Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "Download dark web files using Tor.",
"version": "1.0.3",
"project_urls": {
"Bug Tracker": "https://github.com/SammyTheBEAST/TorDownloader/issues",
"Homepage": "https://github.com/SammyTheBEAST/TorDownloader"
},
"split_keywords": [
"tor",
"requests",
"stem",
"dark web",
"file download"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b42f87d53dd98803b39471bb50c7051b4d42d378693931601c67a2fc41b170e9",
"md5": "1d1376d3fd2e7dbcd11c7c4041ba981c",
"sha256": "67e39b0b3e1b871ac7070fad218028a32f8e6abd09f3fdc1c975b8d8cd443e79"
},
"downloads": -1,
"filename": "tor_downloader-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "1d1376d3fd2e7dbcd11c7c4041ba981c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 12895,
"upload_time": "2023-05-11T15:25:02",
"upload_time_iso_8601": "2023-05-11T15:25:02.041841Z",
"url": "https://files.pythonhosted.org/packages/b4/2f/87d53dd98803b39471bb50c7051b4d42d378693931601c67a2fc41b170e9/tor_downloader-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-11 15:25:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SammyTheBEAST",
"github_project": "TorDownloader",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tor-downloader"
}
