ctft is a python cli tool to save and view stylised ctftime.org writeups locally in your terminal.
- Search for writeups by CTF name.
- View Stylised writeups from saved files
- Writeups are saved are as markdown files which can also be read as plaintext(even though it doesn't make sense to read plaintext over formatted 😒 )
VSCode users can also use markdown viewing extensions like Markdown Preview Enhanced to view writeups
The project took inspiration from mzfr's lswriteups but I wanted to further the ease of access and reduce browser dependence.
The tool currently scrapes only writeups on CTFTime.org and github READMEs. If you would like to add support for your site or your favourite author(with their permission ofcourse), feel free to contact me or make a pull request
➜ ctft -h
usage: ctft [-h] (-e EVENT | -v TASK NAME)
Get and view stylised ctftime writeups in your terminal
optional arguments:
-h, --help show this help message and exit
-e EVENT, --event EVENT
Name of the ctf event
-v TASK NAME, --view TASK NAME
View writeup in terminal
- The files are saved in your (home directory)/ctft_writeups
python3 ctft -e asisctf
You can also make an alias of ctft or add ctft to $PATH for easier usage
ctft -v Web\ Warm-up
pip3 install ctft
- Cone the repo:
git clone https://github.com/bajatin/ctft
- Install dependencies:
pip install -r requirements.txt
I started this project solely for educational purposes to familiarize myself with python and asynchronous programming. Pull requests or suggestions for imporvement are welcome. For major changes, please open an issue first to discuss what you would like to change.