Skip to content

Commit

Permalink
README update
Browse files Browse the repository at this point in the history
  • Loading branch information
B34MR committed Jun 18, 2021
1 parent fc88929 commit 993d3da
Show file tree
Hide file tree
Showing 2 changed files with 90 additions and 1 deletion.
91 changes: 90 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,90 @@
# tooltime
![Supported Python versions](https://img.shields.io/badge/python-3.9-green.svg)

# ToolTime
A Python3 script that quickly downloads and or installs Pentesting tools from a customizable configuration file.

<br>

### Tool Configuration files are categorized by assessment type and are located at the following:
* External Network: ./tooltime/configs/external.ini
* Internal Network: ./tooltime/configs/internal.ini
* WebApp: ./tooltime/configs/webapp.ini
* Wireless: ./tooltime/configs/wireless.ini
<br>

<i>* Custom Tool Configuration files can also be used and may contain any filename.</i>

<br>

### Alias Configuration files can be used customize your aliases and Bash prompt:
* Alaises: ./tooltime/configs/alaises.ini
<br>

<i>* Custom Alias Configuration files can also be used, however it must use the 'aliases.ini' filename.</i>

<br>

*Tool Configuration file legend:* <br>
* tools_dir - The destination directory for Github and Binary tools.
* github_urls - Github repositories to download.
* binary_urls - Files from direct URLs to download.
* pip_packages - Python3-Pip packages to install.
* apt_packages - APT packages to install.
* '#' to comment out any tools you wish to omit.

<br>

*Sample Configuration File:*
```
[tools_dir]
/opt/tools/internal
[github_urls]
https://github.com/FortyNorthSecurity/EyeWitness
https://github.com/fox-it/BloodHound.py
# https://github.com/danielmiessler/SecLists
[binary_urls]
https://download.sysinternals.com/files/SysinternalsSuite.zip
[pip_packages]
virtualenv
mitm6
[apt_packages]
#powershell
tree
```

<br>

*Supported Operating System:*
```
Kali-Linux
```

*Installation*
```
apt install python3-pip
cd tooltime/
python3 -m pip install -r requirements.txt
```

*Usage:*
```
Customize one of the built-in Tool Configuration files or create your own.
Tooltime uses a positional argument for the config file selection.
Examples below:
python3 tooltime.py (defaults to configs/internal.ini)
python3 tooltime.py configs/internal.ini
python3 tooltime.py configs/external.ini
python3 tooltime.py configs/webapp.ini
python3 tooltime.py configs/wireless.ini
python3 tooltime.py /root/mycustomconfig.ini
```
<br>

*Tooltime Demo:*

![Tooltime Demo](demo/demo.gif)
Binary file added demo/demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 993d3da

Please sign in to comment.