Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/snakeeater0x01/offsectoolman
A tools manager to Automate the offensive Security lab setup
https://github.com/snakeeater0x01/offsectoolman
Last synced: 7 days ago
JSON representation
A tools manager to Automate the offensive Security lab setup
- Host: GitHub
- URL: https://github.com/snakeeater0x01/offsectoolman
- Owner: snakeeater0x01
- Created: 2023-08-05T19:43:35.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-03-11T14:40:14.000Z (8 months ago)
- Last Synced: 2024-10-31T16:35:52.455Z (18 days ago)
- Language: Shell
- Size: 195 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 
**offsectoolman** is a tool manager designed to automate the setup of an offensive security lab. It allows you to install and manage various package managers and tools commonly used in offensive security tasks. The tool supports installation on Linux systems and provides a simple and efficient way to get your lab up and running quickly.
## Features
- **Package Managers Support:** Install, update, and remove tools using different package managers.
- **Tag Filtering:** Select tools based on tags for easier categorization and identification.
- **Type and Category Selection:** Choose tools based on their types and categories.
- **YAML Configuration:** Customize and add tools to the YAML configuration file.
- **Version Information:** Display the current version of OffSecToolMan.
- **Help Menu:** Access a detailed help message with the `-h` or `--help` option.
## Requirements
- Linux-based system
- Bash shell
## Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/offsectoolman.git
cd offsectoolman
```
2. Make the script executable:
```bash
chmod +x offsectoolman
```
## Running Directly from GitHub
You can run the `offsectoolman` script directly from GitHub without downloading or installing it on your system. Use the following one-liner command:
```
bash <(curl -sSL https://raw.githubusercontent.com/ousbaailyas/offsectoolman/master/offsectoolsman) [OPTIONS]
```
## Usage
```bash
./offsectoolman [-all] [-pm ] [--tag ] [--type ] [--category ] [-i] [-ia] [-u] [-ua] [-r] [-ra] [-v] [-f ] [-h]
```
## Options
- **-all:** Select all available tools.
- **-pm, --managers:** Comma-separated list of package managers.
- **--tag:** Comma-separated list of tags.
- **--type:** Comma-separated list of types.
- **--category:** Comma-separated list of categories.
- **-l, --list:** List selected tools.
- **-i, --install:** Install selected tools.
- **-u, --update:** Update selected tools.
- **-r, --remove:** Remove selected tools.
- **-f, --file:** Specify the YAML configuration file.
- **-v, --version:** Print version.
- **-h, --help:** Print this help message.
## Adding Tools to YAML Configuration File
To add tools to the YAML configuration file, follow this structure:
```yaml
managers:
# Tools based on Go package manager
go:
manager_action: "sudo apt install golang curl ca-certificates"
actions:
install: "go install -v"
upgrade: "go get -u"
remove: "go clean"
tools:
- name: pdtm
source: github.com/projectdiscovery/pdtm/cmd/pdtm@latest
description: "ProjectDiscovery's Open Source Tool Manager"
properties:
type: [CLI]
category: [development]
tag: [development, security, tool-manager]
- name: smap
source: github.com/s0md3v/smap/cmd/smap@latest
description: "A fast network scanner designed for Internet-scale"
properties:
type: [CLI]
category: [information-gathering]
tag: [information-gathering, security, network, scanner]
....
```
## Version
To display the current version of OffSecToolMan, use the following command:
```bash
./offsectoolman -v
```
Feel free to explore the various options and customize your security toolset with OffSecToolMan!