|
2 | 2 |
|
3 | 3 | 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. |
4 | 4 |
|
| 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 | + |
5 | 16 | ## Features |
6 | 17 |
|
7 | 18 | - **Automated Scripts**: Pre-built scripts for common CTF tasks. |
8 | 19 | - **Modular Design**: Easily extendable to add custom scripts. |
9 | 20 | - **Cross-Platform**: Works on Linux, macOS, and Windows. |
10 | | -- **Lightweight**: Minimal dependencies for quick setup. |
11 | 21 |
|
12 | 22 | ## Installation |
13 | 23 |
|
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 |
15 | 29 |
|
16 | 30 | ```bash |
17 | | -pip install ctfsolver |
| 31 | +ctfsolver --help |
18 | 32 | ``` |
19 | 33 |
|
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 |
21 | 53 |
|
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: |
25 | 55 |
|
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. |
27 | 59 |
|
28 | 60 | ## License |
29 | 61 |
|
30 | 62 | This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. |
31 | 63 |
|
32 | 64 | ## Contact |
33 | 65 |
|
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