Skip to content

Commit d111d6e

Browse files
committed
updated the readme
1 parent b14180e commit d111d6e

1 file changed

Lines changed: 41 additions & 9 deletions

File tree

README.md

Lines changed: 41 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,33 +2,65 @@
22

33
CTFSolverScript is a tool designed to assist in solving Capture The Flag (CTF) challenges. It provides utilities and scripts to streamline the process of solving various types of CTF problems.
44

5+
This library has been created to suit my needs.
6+
7+
What I mean is, I was developing it when I was solving CTF challenges.
8+
By solving the ctf's with python, and automating the solutions, I collected many scripts.
9+
10+
Some functionalities came by request, some I implemented out of personal interest.
11+
12+
Some things will seem weird to others, such as the structure of the challenge folder, and the keywords used.
13+
14+
The documentation is still under development.
15+
516
## Features
617

718
- **Automated Scripts**: Pre-built scripts for common CTF tasks.
819
- **Modular Design**: Easily extendable to add custom scripts.
920
- **Cross-Platform**: Works on Linux, macOS, and Windows.
10-
- **Lightweight**: Minimal dependencies for quick setup.
1121

1222
## Installation
1323

14-
[official pypi link](https://pypi.org/project/ctfsolver)
24+
[installation instructions can be found here.](docs/sphinx/source/modules/installation.md)
25+
26+
## Usage
27+
28+
Can be used as a class for scripting and as a cli tool
1529

1630
```bash
17-
pip install ctfsolver
31+
ctfsolver --help
1832
```
1933

20-
## Usage
34+
```
35+
ctfsolver help
36+
```
37+
38+
[detailed usage instructions can be found here.](docs/sphinx/source/modules/usage.md)
39+
40+
[Automated Documentation can be found here.](https://nikolasfil.github.io/CTFSolverScript/)
41+
42+
When the repo is cloned locally you can find pdoc and sphinx generated documentation in the docs/ folder.
43+
44+
```bash
45+
make doc-pdoc-host
46+
```
47+
48+
```bash
49+
make doc-sphinx-host
50+
```
51+
52+
## Contributing
2153

22-
Either as a class or as a command-line tool.
23-
More documentation on the way.
24-
For now the documentation is autogenerated from docstrings using pdoc3
54+
Contributions are welcome! Please follow these steps:
2555

26-
[ctfsolver](https://nikolasfil.github.io/CTFSolverScript/ctfsolver/)
56+
1. Fork the repository.
57+
2. Create a new branch for your feature or bugfix.
58+
3. Submit a pull request with a detailed description of your changes.
2759

2860
## License
2961

3062
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
3163

3264
## Contact
3365

34-
Feel free to open a ticket on the [GitHub Issues page](https://github.com/nikolasfil/CTFSolverScript/issues) for any questions or suggestions.
66+
For questions or suggestions, feel free to open an issue or contact the maintainer at `filippatos.nikolas@gmail.com`.

0 commit comments

Comments
 (0)